节点手册 NODE HANDBOOK

v2rayN macOS端口占用

跨核心切换后出现 address already in use ,按 v2rayN macOS开启TUN切换核心报address already in use 核对;其他Core错误继续从总排查入口分流。

专题 / 问题排查

机场订阅与代理连接故障排查

处理订阅更新失败、节点连不上、浏览器或应用无法联网,并按症状逐项验证。

先区分三个阶段

  1. 获取配置: 订阅能否更新,内容是否有效?
  2. 建立连接: 节点和基础网络是否可用?
  3. 应用访问: 请求是否被接管,异常是否只出现在一个网站?

一次改变一个条件,记录原值与结果。不要把清空全部配置当作第一步。

故障排查 TOP

开了 TUN 模式却连不上

连接显示成功但网页打不开、或开了 TUN 后整机断网:先建立系统代理与 TUN 的三态基线,再按服务权限、虚拟网卡、路由冲突、DNS 四层逐项排除。

11分钟阅读
故障排查 TOP

路由器、NAS 或公司内网打不开

公网正常但 192.168.x.x、局域网域名或内网系统不可达:先分清是规则把内网送进了代理,还是 fake-ip 把域名解析成了假地址。

10分钟阅读

Clash Verge Rev 远程配置解析失败

遇到 the remote profile data is invalid yaml 时,先按 响应格式与 YAML 解析 核对;更新成功但无节点另行排查。

Hiddify Linux TUN 启动错误

授权后出现 exit status 127 时,按 帮助进程与共享库路径 核对;订阅为空和连接后断网另行排查。

v2rayN Geo 文件缺失与 EOF

内核日志出现 failed to open geosite.dat 时,按 文件路径、下载与完整性 逐步排查;普通 Core 启动失败仍由原总排查页承接。

sing-box 远程规则集启动失败

如果日志指向 route.rule_set 的远程文件,请按 冷启动下载与解析故障排查 核对缓存、实际返回内容和内核版本。普通客户端订阅报错仍按 订阅更新失败 处理。

全部 20 个错误码索引

上面逐条拆解的报错,对应的错误原文已整理成一张索引表,可按报错字符串直接查: clash-error-codes 错误码索引 。表里按「错误原文 → 失败阶段 → 最短修复路径」组织,判断口径与站内文章一致;客户端之间的平台与内核差异另见 proxy-client-matrix 。

也可以前往 全部文章 浏览。