代理客户端无法启动、闪退怎么办？排查与修复

代理客户端无法启动或闪退，最常见的原因是端口被占用、配置文件损坏，或被杀毒软件拦截。最快的办法是：彻底退出所有代理软件（包括托盘里的进程），确认 7890 等端口没被占用，再切换回默认配置启动客户端。

问题表现

原因	典型表现	处理方向
端口被占用	日志出现 `address already in use` 或 `Only one usage of each socket address`	结束占用进程或改端口
配置文件损坏	日志出现 YAML / JSON 解析错误，导入某个订阅后才打不开	切回默认配置
旧进程残留	托盘里还有旧实例或内核进程	结束全部相关进程
安全软件拦截	内核文件被隔离、删除	恢复文件并加入信任
缺少运行库	Windows 提示缺少 .NET 桌面运行时或 WebView2	按发布页安装运行库
系统签名限制	macOS 阻止打开未公证的应用	在隐私与安全性中允许
安装包不匹配	系统过旧，或下错了架构（x64 / ARM64）	下载对应版本

第一步：结束残留进程

Windows：在任务管理器中结束客户端以及 mihomo、verge-mihomo、clash、xray、sing-box 等内核进程；也可以在 cmd 中查看：

tasklist | findstr /I "mihomo clash xray sing-box"

pgrep -fl mihomo
pkill -f mihomo

第二步：检查端口占用（以 7890 为例）

netstat -ano | findstr :7890

lsof -nP -iTCP:7890 -sTCP:LISTEN

上面分别是 Windows cmd 和 macOS / Linux 的命令。有输出说明端口已被占用，处理方法见《端口被占用》。

第三步：查看日志

大多数客户端在设置中提供「打开日志目录」，日志最后几行通常直接写明失败原因。

第四步：单独校验配置文件

使用 mihomo 内核时，可以让内核只检查配置而不启动（路径换成实际位置）：

mihomo -t -d ~/.config/mihomo

Windows PowerShell 中写作 .\mihomo.exe -t -d "$env:USERPROFILE\.config\mihomo"。提示 configuration file ... test is successful 表示语法没问题。

第五步：检查安全软件和安装包

查看 Windows 安全中心或第三方杀毒软件的隔离记录，并确认下载的安装包与系统架构一致。

切换到默认配置：选中客户端自带的默认配置或空白配置启动。能启动说明问题出在订阅配置上，参见《订阅格式错误》。
修改端口：把混合端口改成未被占用的值（例如 7899），保存后重启客户端。
安全软件放行：从隔离区恢复内核文件，并把客户端安装目录加入排除列表。只对从官方发布页下载的客户端这样做。
安装运行库：v2rayN 依赖 .NET 桌面运行时，Clash Verge Rev 在 Windows 上依赖 WebView2，按各自发布页说明安装。
macOS 打开被阻止的应用：在「系统设置 → 隐私与安全性」中找到被阻止的应用，点击「仍要打开」。确认安装包来自官方后，提示「已损坏」时可在终端移除隔离属性（应用名换成实际名称）：

sudo xattr -r -d com.apple.quarantine "/Applications/Clash Verge.app"

只从客户端的官方仓库或发布页下载安装包。来源不明的「绿色版」「破解版」可能被植入恶意代码，也是闪退的常见原因。

某个客户端在你的系统上长期不稳定时，可以换用同类客户端，各平台的选择见《客户端大全》，例如 Windows 上在 Clash Verge Rev 与 v2rayN 之间切换。
客户端无法启动属于本地软件问题，一般不需要联系机场客服。只有导入机场订阅后才闪退、且确认是配置本身有语法错误时，才需要把报错日志发给机场。

先别急着降级。新版本经常调整配置格式或数据目录，先切回默认配置试试；仍打不开再查看发布页的更新说明，确认是否需要清理旧配置或重新安装。

不一定。可能是客户端版本太旧、不支持订阅中的新协议，也可能是覆写脚本出错。先升级客户端、关闭覆写再导入，仍报解析错误再联系机场。

代理内核会监听端口、修改网络设置，常被杀毒软件误报。只要来自官方发布页，一般可以放行；来源不明的安装包则不要放行，直接删除并重新下载。

会。它们通常默认使用相同或相近的端口，并争抢系统代理设置。建议只保留一个，另一个彻底退出或卸载。