问题排查 · v2.5.5

新手最常遇到的三个问题：端口、权限、面板无响应

汇总新手最常遇到的三类问题——端口被占用、TUN 权限不足、界面能启动但无响应，给出各自的判断依据与处理顺序。

适用版本：v2.5.5 更新日期：2026-09-23 来源：官方 Releases、文档与公开 issue

端口被占用

表现为启动后无法接管流量或控制器无法连接。先用系统命令查看端口占用进程，确认是其他代理软件、容器还是残留进程，再决定改端口还是结束占用进程。具体端口值以客户端设置页显示为准。

Windows 依赖服务模式，Linux 依赖 clash-verge-service 与 root 权限（非 root 下开关可能灰显），macOS 会改写系统 DNS 为 223.6.6.6。多网卡与多网段冲突也会导致 TUN 下网络异常。

原因是 Tauri 界面依赖 WebView2，被卸载或禁用时程序可以启动但面板无响应。处理顺序为恢复 WebView2、重新安装 WebView2、改用发布页中带 fixed_webview2 字样的内置版本。

遇到问题第一步该做什么？

切到直连模式对比，确认问题是否来自客户端；再查看连接列表与日志中的具体报错行。

反馈问题要提供什么？

客户端版本、内核版本、操作系统版本、复现步骤与导出的日志文件。日志按约 30 天周期清理，需及时导出。