首页 / 教程
ERROR CODE GUIDE

按错误现象,
逐步恢复连接

先记录现象与日志,再按订阅、系统、网络、端口和权限顺序排查。一次只改一个设置,便于定位真正原因。

Installation

安装前检查

先从下载页确认系统架构并校验 SHA-256。客户端不附带节点,只导入用户合法获得的兼容配置。

Windows

  1. 普通 Intel/AMD 电脑选择 x64,ARM 设备选择 ARM64。
  2. 界面无法启动时检查 WebView2,不要直接关闭系统防护。
  3. TUN 服务需要管理员授权,但无需长期以管理员身份运行全部程序。

macOS

  1. M 系列选择 ARM64,Intel Mac 选择 x64。
  2. 确认开发者和文件校验值,再处理系统安全拦截。
  3. 不要使用来源不明的“已破解”安装包。

Linux

  1. Debian/Ubuntu 使用 DEB,Fedora/RHEL 系使用 RPM。
  2. 通过系统包管理器解决依赖,避免未知一键脚本。
Troubleshooting

六类高频故障

每一项都包含判断依据、处理顺序和重新下载条件。

ERR_NODE_TIMEOUT

节点全超时

更新订阅并切换多个节点;同步系统时间;检查网络、DNS、防火墙。只有内核文件损坏时才需要重装。

ERR_SUB_401

订阅导入失败

确认链接完整、未过期且为 Clash/Mihomo 格式。订阅 URL 不要公开发送。

ERR_PORT_USED

端口被占用

退出其他代理客户端,检查 7890 等本地端口,或修改混合端口后重启。

ERR_TUN_SERVICE

TUN 无法开启

检查服务安装、管理员权限、虚拟网卡和其他 VPN 软件冲突。

ERR_CORE_START

mihomo 启动失败

读取日志中的配置行号,恢复有效 YAML,并检查内核是否被安全软件隔离。

ERR_DNS

部分网站打不开

检查规则命中与 DNS 配置,临时切换直连或全局模式以隔离问题范围。

Profile

正确导入订阅

1

进入订阅或配置页面。

2

从 URL 新建配置并粘贴兼容链接。

3

更新配置并确认出现策略组与节点。

4

测速后选择节点,开启规则模式与系统代理。

Clash Verge 配置完成后的流量监控界面
FAQ

排障常见问题

为什么全局模式可用,规则模式不可用?

通常是规则命中或策略组选择问题。查看目标连接匹配了哪条规则,并检查对应策略组。

重装后仍然打不开怎么办?

检查 WebView2、用户配置、系统权限和安全软件日志;重复安装相同损坏文件不会解决问题。

订阅更新会覆盖自定义规则吗?

直接修改订阅文件会被覆盖,建议使用 Merge、Script 或独立规则集。