故障处理

Clash Verge Rev 怎样从启动报错找到占用端口的进程

出现 address already in use 时,先从报错定位无法使用的端口,再核对监听程序。处理冲突后,还需确认请求转发和退出清理都能完成。

  • 客户端
  • address already in use
  • mixed-port
  • 端口占用
  • 服务模式
阅读导航

窗口消失并不代表后台程序已经停止。遇到端口争用,先保住能够正常联网的状态,再把错误中的端口对应到具体进程;确认身份后才决定退出程序、调整端口或修复服务。

如何从启动错误找到冲突入口?

阅读启动日志时,把最早出现的 Bind failed、address already in use 或 Start Mixed(http+socks) server error 连同端口一起记下。绑定没有成功,后面的启动状态就需要沿着这条错误继续查。

mixed-port、DNS 和 external-controller 各有自己的监听入口。查询前从当前日志取值,示例里的端口不能直接作为本机设置。

mixed-port 能接收 HTTP(S) 和 SOCKS 连接。若新启动的内核占不到这个入口,原有进程仍可能继续转发,因此网页能打开也不能说明这次启动已经成功。

页面所列问题记录涉及两种场景:macOS 界面异常结束后后台内核仍在运行,以及 Linux 再次登录时旧进程与新进程争用监听入口。

这些个案可用于寻找相似日志;是否发生了同一种冲突,仍要查看当前设备的进程信息。

从绑定失败的日志提取查询条件
Start Mixed(http+socks) server error: listen tcp :7890: bind: address already in use
Start DNS server(TCP) error: listen tcp 0.0.0.0:1053: bind: address already in use
Start DNS server(UDP) error: listen udp 0.0.0.0:1053: bind: address already in use

按报错位置选择检查方向

可观察的表现应检查的对象后续操作
mixed-port 无法完成绑定已有应用、未退出的内核及系统端口保留设置核对入口的进程归属
DNS 与 mixed-port 一起报绑定失败检查是否有旧进程同时监听这些入口比较账户和启动时刻
冲突仅涉及 external-controller管理接口的监听设置可能重叠检查控制通道的端口
只报 connection refused,未见绑定失败先确认目标入口是否已经启动查看配置校验及启动过程
网络异常仅涉及某个站点查看解析、规则匹配与连接路径暂不终止后台程序

完整退出后还需要继续查吗?

先保存当前配置、监听设置与起始错误,再关闭系统代理及 TUN,确认普通联网不依赖客户端。接着通过托盘退出,检查用来求助的记录是否已隐藏密码等敏感内容。

给退出过程留出完成时间,再查相同端口。监听已经消失时,可以重新打开客户端观察;若仍存在监听,再追查它属于谁。

把进程编号与账户和执行路径对应起来

查询结果中的 PID 只是起点。把运行账户、可执行文件位置、创建时间和进程名称放在一起比较,才能判断它是正在工作的内核,还是退出后留下的进程。

下面是查询命令的写法。运行前换成本机端口及进程编号;没有查到结果时,继续检查日志,不随意挑选同名程序结束。

PowerShell 中查看 TCP 和 UDP 的归属
$Port = 7890
$Tcp = Get-NetTCPConnection -LocalPort $Port -State Listen -ErrorAction SilentlyContinue
$Tcp | Select-Object LocalAddress, LocalPort, OwningProcess
$Tcp | ForEach-Object {
  Get-Process -Id $_.OwningProcess | Select-Object Id, ProcessName, Path
}
Get-NetUDPEndpoint -LocalPort 1053 -ErrorAction SilentlyContinue |
  Select-Object LocalAddress, LocalPort, OwningProcess
macOS 中读取监听及进程详情
PORT=7890
sudo lsof -nP -iTCP:${PORT} -sTCP:LISTEN
sudo lsof -nP -iUDP:1053
ps -o user,pid,ppid,lstart,command -p 12345
Linux 中列出入口对应的进程
sudo ss -ltnp 'sport = :7890'
sudo ss -lunp 'sport = :1053'
ps -o user,pid,ppid,lstart,cmd -p 12345

怎样按监听者身份解除争用?

入口正被其他网络工具或开发服务使用

在相关应用内正常退出,或为需要同时运行的程序分配不同端口。身份不明的系统进程不要终止。

界面退出后仍能查到原内核的监听

先保存该进程的身份信息。确认它确属退出遗留后,再按系统对应的方法处理指定 PID,保留其他进程。

高权限进程被结束后自行重新出现

暂停重复终止操作,转入客户端提供的服务维护入口检查。

重新进入会话或连续启动时才发生争用

检查是否配置了重复启动入口。旧进程退出尚未完成时启动新进程也可能冲突,整理启动方式后再观察。

系统未列出监听,但绑定依旧失败

在 Windows 上继续查询 excluded port range,核对该端口是否被系统保留。

仅在确认是退出遗留进程后,才使用终止命令。macOS 和 Linux 可先发 TERM;Windows 的 Stop-Process 会结束目标,-Confirm 只提供操作确认。按指定 PID 处理,避免批量结束同名内核。

macOS 与 Linux:向已确认的进程发送终止请求
# 把 12345 换成刚才确认的 PID
sudo kill -TERM 12345
PowerShell:核对目标后结束指定进程
# 把 12345 换成刚才确认的 PID
Stop-Process -Id 12345 -Confirm

未找到占用程序时核对系统保留区间

页面列出的 Windows 个案提到改端口后恢复使用,并建议核对绑定日志与系统保留范围。只有绑定错误明确、同时又查不到监听者时,才沿这条路径检查。

当前端口确实位于保留区间时,另选已查明空闲的入口,保存设置后重新打开系统代理。若已有内核持有原端口,换号本身并没有处理那个进程。

列出系统预留的 TCP 与 UDP 范围
netsh interface ipv4 show excludedportrange protocol=tcp
netsh interface ipv4 show excludedportrange protocol=udp
netsh interface ipv6 show excludedportrange protocol=tcp
netsh interface ipv6 show excludedportrange protocol=udp
为新入口查询现有监听
# 17890 只是示例,不能保证每台电脑都可用
Get-NetTCPConnection -LocalPort 17890 -ErrorAction SilentlyContinue
Get-NetUDPEndpoint -LocalPort 17890 -ErrorAction SilentlyContinue

反复产生遗留进程时检查服务生命周期

页面引用的服务实现包含安装、卸载、重装及 repair 路径。操作入口会随系统和构建变化,按当前客户端提供的设置执行,保留系统服务文件。

发布记录中对服务管理的改进,不能单独证明所有退出争用都已解决。恢复后仍需核对进程与端口的实际状态。

依次恢复服务运行条件

  1. 先保留直连能力

    停用 TUN 与系统代理,确认退出应用后普通网络仍可访问。

  2. 保存故障现场

    记下起始绑定错误,以及端口、运行账户、PID 和应用版本。

  3. 从设置维护服务

    通过应用入口停用或卸载旧服务。Windows 需先核对服务组件是否满足项目安全公告中的修复条件;条件不明时保持关闭。其他系统也应等权限操作完成后再继续。

  4. 必要时重新进入系统

    若高权限进程仍占着入口,重启后先查监听,再打开客户端。

  5. 分项恢复网络接管

    先验证原配置和系统代理,确认可用后再决定是否开启 TUN。

检查监听、请求转发与退出清理

向当前代理入口发送新的请求
# 把 7890 换成当前 mixed-port
curl -I -x http://127.0.0.1:7890 https://example.com

可逐项确认的恢复表现

  • 打开应用之前,入口没有不明进程监听
  • 应用启动后,监听归属于预期的内核进程
  • 本轮启动记录未再出现绑定失败
  • 经代理入口发出的 curl 请求返回 HTTP 响应
  • 系统代理使用新设置,连接页能找到对应请求
  • 完整退出后监听消失,系统网络能够恢复
  • 再次登录或打开应用时未出现遗留进程争用

先完成系统代理下的 HTTPS 访问,再按需验证 TUN。若启用 TUN 才中断且没有绑定报错,继续检查路由和解析路径。

故障加重时撤销改动并整理日志

更改端口或服务后表现恶化时,先停用网络接管,恢复普通联网。确认原入口可用后再恢复旧值;服务重装未完成时不要继续删除系统文件。

求助记录应描述亲眼看到的变化、操作顺序和报错,不直接给出未经证实的原因。共享副本需移除密码、凭据以及完整配置中的敏感信息。

便于后续定位的信息

  • 应用的完整版本及获取渠道
  • 设备系统版本与处理器架构
  • 自启动、服务和 TUN 的启用情况
  • 界面当时通过何种方式结束
  • 最先出现的绑定错误及所指入口
  • 监听进程的账户、PID、路径及创建时刻
  • 退出和服务维护之后的端口变化

来源索引