为什么代理测试失败？

代理测试由 MaskPilot 客户端从当前设备发起。失败通常来自节点信息错误、服务限制、本机网络拦截，或多跳链路中某一跳不可用。

先判断影响范围

1. 检测同一分组中的另一个已知可用节点。
2. 如果所有节点都失败，优先检查本机网络、防火墙、VPN、DNS 或公司网络策略。
3. 如果只有一个节点失败，优先检查该节点的协议、地址、端口、认证和有效期。
4. 如果单个节点正常但链路失败，执行「检测完整连接」并从页面指出的第一处失败跳开始排查。

根据页面诊断处理

代理认证失败

• 重新复制用户名和密码，注意前后空格及大小写。
• 确认服务是否使用 IP 白名单，而不是用户名密码。
• 检查订阅或节点是否已到期。
• 如果凭据含特殊字符，使用服务商提供的完整 URL 或正确的 URL 编码。

连接超时

• 稍后复测，排除短时网络波动。
• 确认节点允许当前地区或来源网络连接。
• 暂时排除本机 VPN、安全软件或公司网络策略的影响。
• 向服务商确认节点是否正在维护。

端口无法连接

• 核对服务器地址和端口是否填反或重复填写。
• 确认连接方式与服务商给出的协议一致。
• 不要因为端口在其他工具中显示开放，就认定代理协议一定可用。

代理配置不支持

• 普通代理只选择 HTTP、HTTPS 或 SOCKS5。
• 高级代理先使用「检查配置」，确认可以识别协议、服务器和端口。
• 不要把订阅页面地址、二维码文本或路由规则直接当成节点配置。
• 高级代理需要修改时，使用修正后的配置重新导入。

排查多跳连接

「检测完整连接」会按连接顺序逐步增加节点。例如结果显示“第 2 跳不可用”，表示第一跳可以工作，但经过前两跳的连接无法完成。

依次检查：

1. 第一跳能否访问第二跳的地址和端口。
2. 第二跳是否只允许特定来源 IP。
3. 每一跳的认证、TLS 和传输参数是否正确。
4. 链路中的代理是否被删除、过期或由服务商更换。

修改任何一跳后都应重新执行完整连接检测。

仍然失败时

保留页面显示的诊断类型、失败跳数和节点服务商信息，并自行记录测试的大致时间。不要发送完整密码或未经遮盖的高级配置；向支持人员提供可复现步骤和已脱敏的地址即可。

如果「检测连接」成功，但账号在启动前的出口信息检查中失败，请查看“为什么绑定代理后账号无法启动？”中的处理步骤。