排障实战 · 网络原理 作者:clash 技术编辑部 · · 约 10 分钟阅读

Clash 常见报错排查手册与 TUN 模式/局域网共享代理原理

一、Clash 断网与报错的黄金四步排查法

当你的 Clash 突然连不上外网时,切忌反复卸载重装软件。按照自底向上的网络排障逻辑,通常 2 分钟就能准确定位根因:

  1. 核对系统时钟与日期:现代代理协议(尤其是 VMess、Trojan、VLESS Reality 及 TLS 证书握手)对时间戳高度敏感。如果电脑主板电池亏电或双系统切换导致时间偏差超过 90 秒,所有节点都会瞬间报 Timeout。请在系统日期设置中点击「立即同步时间」。
  2. 检查内核日志(Logs)与连接页(Connections):打开 Clash Verge Rev 左侧的「日志」与「连接」面板,观察发起请求时的实时记录。如果完全没有任何记录滚屏,说明浏览器流量根本没有进入 Clash(检查系统代理开关或浏览器插件如 SwitchyOmega 是否劫持了端口);如果有记录但全部显示 dial tcp ... i/o timeout,则问题出在上游节点或本地网络出口。
  3. 排查多软件代理冲突:同时开启 Clash、公司 VPN(如 Cisco AnyConnect / EasyConnect)、网易 UU 加速器或浏览器自带代理扩展,极易引发路由表与系统代理互抢。排障时务必先彻底退出其他所有网络加速与 VPN 工具。
  4. 核验机场订阅状态与流量余额:登录机场官网后台(建议收藏官方防失联发布页),确认套餐未过期且未触及流量上限,然后回到 Clash 点击订阅卡片右上角的「刷新」图标,拉取最新节点入口 IP。

二、六大高频报错对照表与根治方案

故障现象 / 报错信息 最常见根因 一键根治方案
ERR_PROXY_CONNECTION_FAILED 系统代理仍开启,但 Clash 已退出或监听端口变更 重启 Clash 并重开关「系统代理」;或到系统网络设置中手动关闭代理
订阅导入提示 YAML parse error 复制了非 Clash 格式链接,或使用了已停更的旧版客户端 更换为 Clash Verge Rev 最新版,确认复制的是 Clash 专属订阅 URL
所有节点测速 Timeout 系统时间不同步、订阅入口变更或机场流量用尽 同步系统时间 → 刷新订阅 → 登录机场后台核对流量与公告
打开 TUN 模式开关后自动弹回 未安装 Service Mode 系统服务,权限不足无法创建虚拟网卡 在「设置 → 系统设置」中点击安装「服务模式」并授权管理员权限
macOS 提示“应用已损坏,无法打开” 未经过苹果公证的开源应用被 Gatekeeper 添加隔离属性 终端执行 sudo xattr -rd com.apple.quarantine /Applications/Clash\ Verge.app
浏览器正常,但 Git / npm / Terminal 超时 命令行默认不读取系统代理设置 开启 TUN 模式,或在终端导出 HTTP_PROXY=http://127.0.0.1:7897

三、TUN 虚拟网卡底层原理:为什么能接管终端与游戏?

常规的「系统代理」只是在操作系统的注册表或网络偏好里写下一行提示:“请把 HTTP/SOCKS 请求发到 127.0.0.1:7897”。这是一项“君子协定”——浏览器会乖乖遵守,但 Git、Docker、Python pip、Steam 游戏客户端以及绝大多数 Windows UWP 应用会直接无视这行提示,继续走本地默认网关直连。

TUN 模式(Tunnel Interface) 则从操作系统网络协议栈底层彻底解决了这个问题。开启 TUN 后,Mihomo 内核会向系统注册一张虚拟网卡(如 Meta 或 utun),并通过 auto-route: true 接管默认路由表。无论应用程序是否支持代理,它发出的每一个 IP 数据包(包含 TCP 与 UDP)都会先落入这张虚拟网卡,被 Mihomo 读取目标域名/IP 后匹配分流规则:国内流量原样放行给物理网卡直连,海外流量则封装加密后发往代理节点。

在 tun.stack 参数上,Mihomo 提供 system、gvisor 和 mixed 三种协议栈。2026 年推荐统一使用 mixed(混合栈):它让 TCP 连接走操作系统原生内核栈以获得极限吞吐和低 CPU 占用,同时让 UDP 走 gVisor 用户态栈以保证 NAT 穿透和 DNS 劫持的稳定性。

四、局域网共享代理实战:让 Switch / PS5 / 手机共用 Clash

家里有 Nintendo Switch、PlayStation 5、Xbox 或未越狱的智能电视,无法直接安装 Clash 客户端怎么办?利用 Mihomo 的 allow-lan: true 特性,你可以把电脑瞬间变成一台局域网代理网关:

  1. 开启局域网连接:在 Clash Verge Rev 左侧「设置 → 系统设置」中打开「允许局域网连接」,记下混合端口号(默认 7897)。
  2. 获取电脑局域网 IP:Windows 在命令提示符执行 ipconfig,macOS 在终端执行 ifconfig | grep "inet ",找到形如 10.0.0.108 的局域网地址。
  3. 放行系统防火墙:确保 Windows Defender 防火墙已允许 clash-verge.exe 与 verge-mihomo.exe 通过“专用网络”入站,否则同一 Wi-Fi 下的设备请求会被电脑拦截。
  4. 在游戏机/电视端填入代理:进入 Switch / PS5 的网络设置 → 代理服务器 → 选择「使用」,服务器填电脑局域网 IP(如 10.0.0.108),端口填 7897,保存测试连接即可享受满速下载与低延迟联机。
YAML Mihomo 局域网共享与混合栈 TUN 参考配置
# 开启局域网共享 + 混合栈 TUN 模式参考片段
mixed-port: 7897
allow-lan: true
bind-address: '*'

tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-redirect: true
  auto-detect-interface: true
  strict-route: true
  dns-hijack:
    - any:53
    - tcp://any:53

五、全屋无感分流:OpenWrt 旁路由部署 Mihomo 思路

如果你希望家里所有手机、平板、电脑、电视和游戏主机无需逐台配置,连上 Wi-Fi 就能自动分流,最优雅的终极形态是在局域网内接入一台运行 OpenWrt 的低功耗软路由(如 N100 迷你主机、树莓派或 NanoPi R4S),作为旁路由运行 Nikki (MihomoTProxy) 或 OpenClash(切换 Mihomo 内核)。主路由保持拨号与稳定 DHCP 职责不变,仅将需要科学上网设备的网关与 DNS 指向旁路由 IP,即使旁路由重启维护也不会影响全家正常上网。

对于全屋多设备共享或软路由场景,强烈建议搭配不限同时在线设备数且全节点 1× 倍率的专线机场,例如本站榜单前列的 唯兔云、微风网络 与 暮光机场,彻底告别设备数超限被封号或晚高峰掉线的烦恼。

常见问题解答(FAQ)

开启 Clash 后浏览器提示 ERR_PROXY_CONNECTION_FAILED 怎么解决? →

该报错说明系统代理指向的本地端口(如 127.0.0.1:7897)当前没有程序监听,常见于客户端异常闪退、重启电脑后未自动拉起内核,或者端口被其他软件占用。解决方法:重新打开 Clash Verge Rev 并关闭再重新打开「系统代理」开关;若彻底卸载客户端前忘记关闭系统代理,需在 Windows「设置 → 网络和 Internet → 代理」中手动关闭代理服务器。

为什么测速时所有节点都显示 Timeout(超时),但宽带本身能正常上百度? →

请按顺序排查四个高频原因:① 检查电脑系统时间与时区是否准确(误差超过 2 分钟会导致 VMess/Trojan/TLS 加密握手全部被拒);② 确认机场套餐流量未耗尽、未到期;③ 尝试更新订阅以同步机场最新的入口域名或 IP;④ 检查是否安装了旧版停更的 Clash for Windows 导致无法识别新版协议。

PS5、Nintendo Switch 或 Apple TV 能通过电脑的 Clash 共享代理吗? →

完全可以。只需确保电脑与游戏机处于同一局域网(同一路由器下),在 Clash Verge Rev 中打开「允许局域网连接(Allow LAN)」,放行 Windows 防火墙对应端口,再在游戏机的 Wi-Fi 高级设置中填入电脑的局域网 IP 和混合端口(如 7897)即可实现局域网代理共享。

延伸阅读与站内导航