与 Remote-Site 的连接失败

套件中的插件都带有“远程站点”区域：你可以在那里通过应用程序密码连接其他 WordPress 安装，并从这里操作它们。连接、测试和移除在所有插件中走的是同一份共享代码，因此各处的提示文字完全一致。本文把它们逐一对应起来。

各条提示的含义

• “请填写 URL（http/https）、用户和应用程序密码。”——某个字段为空，或者地址不是以 http:// 或 https:// 开头
• “站点无法访问。”——完全没有返回任何响应；建立连接时前面会写着“连接失败：”，之后检查时则是“测试失败：”
• “访问数据被拒绝（请检查应用程序密码）。”——目标站点返回了 401 或 403
• “没有有效的 REST 响应（代码 …）。”——返回了响应，但不是可解析的 JSON；提到的代码会一并写出
• “未找到站点。”——被点击的条目已不在本次安装的列表中

建立连接并核实

1. 在 WordPress 菜单中打开相应插件的页面，并在左侧的“网络”组中切换到“远程站点”。
2. 在“连接站点”卡片中填写“站点 URL”“用户名”和“应用程序密码”这几个字段。
3. 点击“连接 & 测试”。
4. 之后随时可以通过“已连接的站点”表格中的“测试”按钮检查现有连接。
5. 在“状态”列中读出该站点被记为“已连接”“错误”还是“未检查”。

该测试是对目标站点上 WordPress 自带用户路由的一次已登录调用。它有 20 秒时间，并且不跟随重定向。会尝试两种地址形式：先是带 rest_route 的形式，它在任何固定链接设置下都有效，然后是走 /wp-json/ 的方式。只有真正的 JSON 响应才算成功。随后测试会通过根路由补读站点名称；如果没能读到，列表中显示的就是主机名。

测试显示绿色，操作却仍然失败

• 每个站点旁边的操作会调用目标站点各自的路由：Backup 插件中的“远程状态”和“远程备份”，Performance 中的“状态”和“清空缓存”，Consent 中的“发送配置”，Security 中的“安全状态”，SEO 中的“SEO 状态”，以及 Analytics 中的“获取统计”
• 这些路由在目标站点上需要 manage_options 权限——因此应用程序密码必须属于一个拥有管理员权限的账户
• 相应的插件必须在目标站点上已安装并启用；否则返回的是“… 无法获取（目标站点上的插件启用了吗？代码 …）”
• “测试”显示绿色，只说明地址和访问数据是对的——关于对面站点上的插件，它什么也没说
• 在 Analytics 插件中，“远程站点”区域只对管理员显示