Network Error Code Diagnostic Database
VPN与代理故障排查代码库
面对网络连接中断与报错无须慌张。本代码库汇总最常见的 5 类核心错误代码及针对性的排查解决方案。
含推广链接，通过链接注册可能为本站带来佣金，不影响用户支付价格。
一线排障手册
7,100 字深度实战
17分钟精读 节点全红超时与无法联网排障宝典：握手失败、系统代理残留与DNS泄漏秒级修复 →
【一线排障手册】节点测速全部超时（Handshake Timeout）、关闭代理后连不上国内网、ChatGPT 频繁出现 Access Denied？本文针对 Windows/macOS/iOS 6大高发网络故障，提供注册表修复命令、TUN 虚拟网卡冲突解决方案及长效防风暴双专线推荐。
包含: Handshake Timeout 4大根因 · netsh 注册表一键急救 · ChatGPT 403 规避
查看完整 7,100 字排障指南 → STEP 01
校准系统北京时间
超过 90% 的突然连不上都是由于系统时间偏差大于 1 分钟导致 TLS 认证失败。
STEP 02
更新订阅配置文件
服务商若更换节点 IP 或域名，必须在客户端中点击「更新订阅」拉取新列表。
STEP 03
检查系统代理端口
检查是否有其他代理软件占用 7890 端口，或电脑杀毒软件误拦截了 TUN 虚拟网卡。
[错误代码] Handshake Timeout (握手超时)
传输层 / TLS 握手阶段 典型症状：客户端测速显示不可达或延迟为 Timeout，点击节点无法建立连接。
可能原因：
- 该节点所属的国内中转入口临时维护或遭受外部网络波动。
- 本地运营商网络（如移动/长宽宽带）对目标 IP 的端口进行了 QoS 丢包限制。
- 本地设备系统时间与国际标准时间相差超过 90 秒，导致 TLS 证书时间校验失败。
推荐修复方案：首先校准电脑/手机系统时间；随后在客户端右键更新订阅，切换其他地区备用节点；若仍超时，可尝试切换本地网络为手机 5G 热点排查宽带限制。
[错误代码] Connection Reset by Peer (连接被对端重置)
TCP 协议层 典型症状：浏览器打开网页瞬间显示连接被重置（ERR_CONNECTION_RESET）。
可能原因：
- 明文传输的数据包触发了中间网络设备的关键字深度检测（DPI）。
- 使用的代理协议已过时（如未开启 TLS 混淆的传统旧协议）。
推荐修复方案：优先选用经过 TLS 封装的现代协议（如 VLESS-Reality 或 WireGuard 混淆隧道）；在客户端开启「规则分流」，避免国外加密流量漏走直连通道。
[错误代码] Listen Address Conflict :7890 (端口被占用)
本地操作系统 Socket 端口 典型症状：客户端启动报错，提示 7890 或 1080 端口已被其他进程占用。
可能原因：
- 系统后台残留了上一次未彻底关闭的旧版 Clash 或其他代理软件后台进程。
- 其他杀毒软件或开发调试工具占用了 7890 常用端口。
推荐修复方案：打开任务管理器，彻底结束所有相关进程；或在客户端设置（Settings）中将 Mixed Port（混合端口）从 7890 改为 7895 或 8888 并保存。
[错误代码] SSL/TLS Certificate Verify Failed (证书无效)
应用安全层 (HTTPS) 典型症状：能连通节点，但打开所有网页均警告“您的连接不是私密连接”。
可能原因：
- 客户端开启了本地中间人解密功能但未正确安装根证书。
- 系统本地受信任根证书库损坏或系统时间严重偏差。
推荐修复方案：关闭客户端中不必要的「HTTPS 解密」插件功能；确保系统时间与网络授时服务器（NTP）同步。
[错误代码] 关闭客户端后无法上网 (网页全打不开)
系统网络设置 (System Proxy) 典型症状：退出代理软件后，电脑完全无法正常浏览任何国内国外网页。
可能原因：
- 软件意外崩溃或非正常关机，未能在退出时自动清除 Windows/macOS 系统代理注册表。
推荐修复方案：Windows 进入「设置 → 网络和 Internet → 代理」，将「使用代理服务器」开关手动关闭即可瞬间恢复；或重新打开客户端，先手动关闭代理开关再正常退出。