代理故障排查

代理问题优先按“连接信息、服务商限制、本机能力、环境关联”的顺序检查。排查时不要将真实密码、提取链接或完整代理连接信息发送到不受信任的位置。

检测代理失败

检查项	处理方式
协议不一致	确认 HTTP、HTTPS 或 SOCKS5 与服务商提供的连接类型一致；集成代理列表只支持 HTTP 和 SOCKS5 切换
主机或端口错误	自定义代理主机只能是 IPv4 或域名，端口必须是 1-65535 的整数
认证失败	核对账号、密码和服务商 IP 白名单；自定义代理保存时会去除账号和密码的首尾空格
服务商节点异常	使用服务商提供的连接工具或控制台确认节点状态、到期状态和地区限制
当前端不支持检测	代理检测需要桌面客户端，网页端不能执行本机检测

修正后，在列表的检测结果列重新检测。列表会同时更新检测状态和检测时间。

代理 API 无法提取

检查链接或保存失败时，依次确认：

1. 提取链接以 http:// 或 https:// 开头，且 URL 格式完整。
2. 链接返回的是可读取的文本，文本中包含有效的 IPv4:端口。
3. 返回端口在 1-65535 范围内。
4. 服务商是否要求当前网络出口加入白名单，或限制了提取频率。
5. 在桌面客户端中重试；网页端不能访问本机提取检查能力。

列表检测代理 API 时会优先检测已保存 IP。若该 IP 失效，客户端会重新提取并保存新地址；因此提取策略、链接可用性和服务商限频都会影响检测结果。

批量添加格式错误

批量自定义代理的每行格式为主机:端口[:账号[:密码]][{备注}]，可选前缀为http://、https://或socks5://。以下情况会导致解析失败：

• 主机不是 IPv4 或有效域名。
• 端口为空、不是整数或超出 1-65535。
• 字段超过四段，例如账号或密码中包含未处理的英文冒号。
• 备注超过 40 个字。
• 单次输入超过 500 条，或使用 IPv6 地址。

输入区会标出错误行。先修正所有格式错误，再选择是否启用仅添加检测成功的代理和校验重复代理。

集成代理同步、续费或删除受限

同步四叶天代理需要桌面客户端和有效授权。授权信息失效时，按客户端提示在系统浏览器完成授权，授权过程中不要离开当前页面。

四叶天同步的代理需要跳转服务商网站续费；中屹浏览器直接购买的集成代理可在列表使用续费和自动续费。直接购买的集成代理不能从列表删除，四叶天同步记录的删除仅移除中屹浏览器中的记录，不会影响服务商侧资源。

无法绑定环境或使用入口

现象	可能原因与处理方式
点击绑定数量没有反应	当前成员缺少代理绑定权限。联系团队管理员按照 管理成员与角色 分配权限
绑定弹窗无法确认	至少选择一个环境后才能保存
绑定列表为空	当前团队没有可选环境；具备环境创建权限时可从空状态创建环境
看不到新增、编辑或删除按钮	当前成员分别缺少代理创建、代理编辑或代理删除权限
无法复制密码或完整连接信息	完整凭据复制受代理编辑权限保护

环境启动后仍无法访问目标站点时，除代理本身外，还应按照 配置指纹与常用设置 检查环境的代理地区、时区、地理位置和语言设置是否合理一致。

下一步

• 检测、绑定与维护：重新检测并检查环境关联关系。
• 配置代理 API：核对提取链接和 IP 更新策略。