一、核对订阅是否更新并成功加载

先确认内核运行的是哪份配置。节点列表仍然可见,有时只是因为客户端保留了上次成功加载的内容。更新订阅、应用配置、内核启动是三个不同的步骤。

  1. 在客户端的配置页找到当前启用的条目,手动更新一次,记下更新时间和错误。若条目从未启用,更新成功也不会改变当前连接。
  2. 如果更新返回 HTTP 401 或 403,核对订阅地址和账号状态,并确认服务端是否限制访问;如果返回 404,核对地址是否迁移。这些是订阅请求的结果,不能直接用来判定节点离线。
  3. 如果下载完成但加载失败,查看日志中第一条解析错误。若返回的是登录页面或错误页面,修复订阅地址;若报错指向协议类型或字段,先核对客户端实际使用的内核和版本,再对照配置要求。
  4. 应用配置后检查代理页是否出现预期的节点和策略组。若配置用 proxy-providers 单独获取节点,还要检查对应提供者的更新时间和日志。主配置更新成功不代表提供者也取到了新列表。

二、检查本地代理端口是否监听

先验证应用能否连到本机内核。mixed-port 是 HTTP 与 SOCKS 共用的本地代理入口,不是远端节点的端口。以下片段使用 7890 举例;实际测试应读取客户端生效设置,因为客户端可能覆写订阅里的端口。

mixed-port: 7890
allow-lan: false

先看监听,再发一个显式代理请求

在 Windows 的 PowerShell 中查看监听端口。将 OwningProcess 对照任务管理器「详细信息」里的 PID,确认监听者是当前客户端的内核,而不是另一个代理进程。

Get-NetTCPConnection -State Listen -LocalPort 7890 |
  Select-Object LocalAddress, LocalPort, OwningProcess

再用 curl 明确指定本机 HTTP 代理。Windows 使用下面的 curl.exe;macOS 和 Linux 可将命令名换成 curl。连接阶段最多等待 5 秒,整个请求最多等待 15 秒;这些是测试参数,不是节点测速结果。

curl.exe -v --noproxy "" --proxy http://127.0.0.1:7890 --connect-timeout 5 --max-time 15 https://example.com/
  • 连接本地端口被拒绝:先检查内核是否启动、端口是否写对、监听地址是否包含本机的 IPv4 回环地址。若启动日志显示端口被占用,先确认占用进程,再关闭旧实例或更换端口;更换后同步更新系统代理和测试命令。
  • 本地连接建立,但随后失败:端口入口已经可达。下一步检查同一时刻的内核日志,区分本地代理认证、域名解析、规则拒绝和出站连接超时。
  • 成功返回目标响应:如果还要验证具体节点,仍需确认日志里实际走的是该节点,而不是 DIRECT。一次成功只验证这次请求经过的路径。

三、区分系统代理、应用代理和 TUN

显式代理请求成功、浏览器却打不开时,优先查浏览器有没有把请求交给内核。对同一目标发起访问,并观察连接页或日志是否出现相同时间的记录。没有记录时,先核对代理入口,不要直接换节点。

入口检查位置判断与处理
Windows 11 系统代理 「设置」→「网络和 Internet」→「代理」 如果客户端使用手动系统代理,核对地址和端口是否与监听一致,并检查目标是否落入代理例外。
应用独立代理 该应用的网络或代理设置 确认应用跟随系统,还是使用独立地址。独立配置为 SOCKS 时,要使用支持 SOCKS 的端口,不能照搬仅支持 HTTP 的入口。
TUN 模式 客户端的 TUN 开关、内核启动日志 若故障只在启用 TUN 后出现,检查虚拟接口、路由与 DNS 接管是否生效,并核对是否有其他 VPN 同时修改默认路由。

系统代理只影响采用该设置的应用。TUN 通过虚拟接口处理被路由到该接口的流量,两者不是同一个开关。排查时一次只切换一种入口,并用同一目标复测。客户端代理页自带的节点测速通常由内核发起,即使系统代理关闭也可能运行,因此测速结果不能证明浏览器已经接入。

四、区分节点服务器 DNS 与目标网站 DNS

先看日志里到底是哪个域名没解析出来。节点的 server 若填的是域名,解析失败会阻断节点连接本身;如果失败的是访问目标,则需根据实际分流与代理协议,确认解析发生在应用、本地内核还是远端。

查询内核正在使用的解析入口

下面是 mihomo 的 DNS 配置片段,用于说明字段分工:nameserver 提供常规解析,proxy-server-nameserver 专门用于节点服务器域名。示例采用 IP 形式的上游地址;只有当前网络允许访问这些上游时,配置才有诊断价值。备份原配置后再做单项测试,不要覆盖正在使用的分流解析配置。

dns:
  enable: true
  listen: 127.0.0.1:1053
  nameserver:
    - 1.1.1.1
  proxy-server-nameserver:
    - 223.5.5.5

如果系统已安装 dig,可向示例中的监听端口发送一次查询。该命令只验证内核的 DNS 监听是否能回答这次查询,不会验证节点服务器专用上游,也不会自动改变系统的 DNS。

dig @127.0.0.1 -p 1053 example.com A +time=2 +tries=1
  • 查询超时:先确认 DNS 模块确实监听了 127.0.0.1:1053,再检查上游是否可达。只运行不带服务器参数的系统查询,测到的可能是另一条解析路径。
  • 查询有回应,但日志仍显示节点域名解析失败:检查节点地址拼写,以及节点服务器专用上游在当前网络下是否可用。目标域名查得到,不能替代这项检查。
  • 返回 198.18.0.x 一类地址:如果启用了 fake-ip,且地址落在配置的 fake-ip 网段内,这通常是用于映射域名的虚拟地址。不要用 ping 该地址来判断远端节点是否在线。

五、核对规则命中与策略组选项

内核收到请求后,先查当时命中了哪条规则,再查该策略组实际选中了什么。规则模式按顺序匹配,先命中的规则会决定处理路径。命中 DIRECT 的请求没有经过远端节点,命中 REJECT 的请求也不能作为节点连通性测试。

例如,当前配置已存在名为「手动选择」的策略组时,可以将下面的具体域名规则临时插入现有 rules 列表,放在可能先匹配它的规则之前。不要添加第二个顶层 rules,也不要用示例替换整套规则。

- DOMAIN,example.com,手动选择

在该组内选定一个待测节点,再发送一次同样的请求。记录目标域名、命中规则、策略组和最终节点。如果仍显示直连,先检查当前是否处于规则模式、组内是否选了 DIRECT,以及请求是否命中更靠前的规则。若客户端日志没有显示预期域名,也要检查应用是否直接访问了 IP。复测结束后移除临时规则。

六、用同目标对照定位单节点或测速故障

只有请求确认经过待测节点,才适合比较节点。固定设备、网络和目标地址,用同一个手动选择组分别测试节点 A 与节点 B。每换一个节点都建立新连接,避免沿用之前的浏览器连接。先做同网对照,再决定是否用另一条获准使用的网络复测。

观察结果下一步
A 超时,B 能访问同一目标 查看 A 的出站错误。连接超时优先检查服务器地址、端口和网络路径;TLS 或认证错误则核对订阅下发的参数、设备时间和内核兼容性,不要通过关闭证书验证来排查。
测速全红,网页却能通过已确认的节点访问 单独检查测速地址是否能经该节点访问,以及响应状态是否符合配置要求。测速和业务访问的目标不同;测速失败不能直接判定所有节点离线。
多个节点都在同一阶段失败 回到共享环节,核对节点域名解析、共同的服务器地址或端口,以及当前网络的连接条件。不要把一批相同错误当成多个独立故障。

提交故障记录时,至少附上失败时间、内核版本、测试目标、脱敏后的节点标识,以及同一时刻的规则命中和首条出站错误。标明错误发生在「连接本机」「解析域名」「连接远端」还是「握手」阶段,比只写「全部节点超时」更容易定位问题。