糖果云 Clash Verge Rev 端口被占用怎么办?
简答:先查看日志中的实际端口,不要默认认定一定是 7897 或 7890。依次执行“查端口占用→识别 PID→正常退出冲突程序或残留内核→修改 Mixed Port→同步手动代理设置→检查监听并测试网页”。这类报错发生在本机客户端启动阶段,通常不是订阅链接或远端节点故障。
定义:端口被占用,是指 Clash Verge Rev 内置的 mihomo 内核尝试监听某个本地代理端口时,该端口已经被其他程序、残留内核或服务占用;Mixed Port 是同时支持 HTTP(S) 与 SOCKS5 连接的本地代理入口。
先试这一步:确认实际端口,再决定结束进程还是改端口
看到“address already in use”“bind failed”或“端口被占用”时,先打开 Clash Verge Rev 的日志或端口设置,记录报错中的实际端口号。不同版本、旧配置或其他代理客户端可能使用不同端口,因此不要把 7897、7890 等数字当成固定值。Clash Verge Rev 项目资料显示,它是支持 Windows、macOS 和 Linux 的图形客户端,并内置 mihomo 内核;可查看项目仓库中的平台与内核说明。
| 现象 | 优先处理 | 不要先做什么 |
|---|---|---|
| 另一个代理客户端正在运行 | 退出另一客户端,或让两个客户端使用不同端口 | 不要反复重装 Clash Verge Rev |
| 界面已退出,但 verge-mihomo 仍监听端口 | 先记录 PID,再只结束已确认的对应进程 | 不要按名称批量结束未知进程 |
| 查不到监听进程,但仍无法绑定 | 换一个已确认空闲的端口,并检查系统保留端口提示 | 不要修改系统保留端口范围 |
| 改端口后浏览器正常、Git 或终端异常 | 同步手工填写的代理端口和环境变量 | 不要误判为订阅或节点故障 |
mihomo 文档将 mixed-port 定义为同时支持 HTTP(S) 与 SOCKS5 的代理入口,端口示例只是配置示例,实际值应以当前配置为准。查看 mihomo 端口字段说明。
Windows:用 netstat 找 PID,再用 tasklist 识别程序
- 入口:打开“终端”或“命令提示符”。动作:将下面的“端口号”替换成日志中的实际数字:
netstat -ano | findstr :端口号
判定:如果出现 LISTENING,记下最后一列 PID;如果没有输出,检查端口是否写错、是否属于其他协议,或进入改端口步骤。 - 入口:仍在终端中。动作:执行:
tasklist /FI "PID eq 进程ID"
判定:确认进程名后,再决定是否从对应程序界面正常退出。Microsoft Learn 说明,tasklist 可以列出本机进程,并支持按 PID 筛选;查看 tasklist 命令说明。 - 安全处理:如果确认是旧版代理客户端、重复启动的 Clash 实例或残留的 verge-mihomo,先回到对应程序界面退出;只有界面无法退出时,才在任务管理器中结束已确认的那个 PID。
- 不要结束:如果进程属于系统服务、驱动、杀毒软件,或你无法确认用途,不要直接强制结束。优先改用空闲端口,或者重启电脑后再次检查。
macOS 与 Linux:用 lsof 查看端口所属进程
- 入口:打开“终端”。动作:执行:
lsof -nP -i :端口号
判定:查看 COMMAND、PID、USER 和 NAME;如果出现监听进程,记下 PID 和用户,再回到对应软件正常退出。 - 权限分流:如果普通用户看不到结果,在确认端口号无误后再执行:
sudo lsof -nP -i :端口号
输入密码时终端通常不会显示字符,这是正常表现。 - 残留内核:如果界面已经退出但仍有 verge-mihomo 监听,确认 PID 后只处理这一进程;如果进程由系统服务或高权限用户反复拉起,不要连续强制结束,应先停用对应服务、重启电脑,或使用客户端自身的服务模式修复入口。
- 没有输出:检查报错中的端口是否正确,或进入修改 Mixed Port 步骤。没有发现本机监听进程,不能据此判断订阅、节点或远端服务器状态。
在 Clash Verge Rev 中修改 Mixed Port
- 入口:打开 Clash Verge Rev 设置页面,找到端口配置或 Clash 设置中的 Mixed Port。菜单名称和位置可能随版本变化,以当前界面为准。
- 备份:先记下原端口、当前配置名称和报错日志,不要直接覆盖订阅原文。
- 动作:将 Mixed Port 改为一个经过本机检查、确认没有监听且未被系统保留的端口,保存后重新启动或重新激活内核。不要照抄固定数字,示例端口不代表每台电脑都可用。
- 判定:返回主页后,内核状态应恢复运行,日志不再出现 bind 或 address already in use。mihomo 文档明确说明,Mixed Port 可同时接收 HTTP(S) 与 SOCKS5 代理连接;可核对 mixed-port 的定义。
如果只是临时解决一次启动冲突,可以先换端口;如果每次开机都冲突,应继续查找重复自启动、残留服务或多个客户端同时运行的原因。
改端口后必须同步检查哪些地方
| 位置 | 是否通常自动同步 | 检查动作 |
|---|---|---|
| Clash Verge Rev 的系统代理 | 以当前版本表现为准 | 关闭后重新打开系统代理,再查看系统代理地址和端口 |
| 浏览器手动代理或代理扩展 | 通常不会同步 | 把旧端口替换为当前 Mixed Port |
| 终端 HTTP_PROXY、HTTPS_PROXY | 通常不会自动同步 | 检查环境变量中的 127.0.0.1 端口 |
| Git、包管理器和开发工具 | 通常不会自动同步 | 检查各自保存的代理配置 |
| 手机或局域网设备 | 不会自动同步 | 若开启局域网共享,检查电脑局域网 IP、端口、防火墙和同一网络条件 |
系统代理、终端变量、浏览器插件、Git 或其他工具可能分别保存代理端口。改完端口后只测试浏览器,不能证明所有应用都已恢复。若使用 TUN 模式,还应把 TUN 是否启动与本地代理端口问题分开判断;mihomo 文档将 TUN 列为独立的流量接入方式,可查看入站配置说明。
改完端口后的复测与回滚
- 检查监听:Windows 重新执行
netstat -ano | findstr :新端口;macOS/Linux 执行lsof -nP -i :新端口。应看到 Clash Verge Rev 或 verge-mihomo 正在监听。 - 测试系统代理:打开一个普通网页,观察客户端连接或日志是否出现新的请求;如果浏览器仍使用旧端口,检查系统代理和浏览器扩展。
- 测试手工代理:仅在确实配置过终端、Git 或其他应用时,逐个把旧端口替换为新端口再测试。
- 分离问题:如果内核已成功启动但节点全部超时,端口冲突已经得到初步排除,下一步转到订阅、节点、DNS 或网络排查,不要继续反复改本地端口。
- 回滚:若新端口导致局域网设备或某个应用无法连接,关闭系统代理,恢复原端口设置或备份,再确认原端口是否仍被占用。
端口仍被占用时的进阶处理
- 重启后再次检查:适用于程序崩溃后残留进程尚未释放的情况。
- 检查重复启动:关闭多个 Clash 客户端、旧版客户端、开机自启项和重复服务模式,确保只启动一个实例。
- 检查系统保留范围:如果没有发现监听进程却仍无法绑定,优先换用已确认空闲且不在系统保留范围内的端口,不要为了保留原端口修改系统网络范围。
- 保留诊断信息:记录软件版本、操作系统、实际报错端口、PID、端口检查结果和首次失败日志。版本号与菜单路径无法统一确认时,以当前软件界面和项目发布资料为准。
- 最后再处理订阅:端口冲突发生在本机监听阶段,通常不需要删除订阅或反复更新订阅。只有内核能启动但节点为空、更新失败或连接超时,才进入对应的订阅或节点排查。
资料核验说明
本文资料核验日期:2026年11月2日。Clash Verge Rev 的版本号、默认端口和具体菜单名称可能随发布版本变化;本文不把 7897 或 7890 视为所有设备固定值,实际操作以日志、设置页和项目资料为准。本站是第三方使用指南站,不是 Candytally(糖果云)官方页面;订阅、账户和服务状态以相关官方信息为准。
常见问题
糖果云 Clash Verge Rev 端口被占用,是订阅坏了吗?
通常不是。端口被占用首先表示本机客户端无法监听本地代理入口,常见原因是另一个代理客户端、重复启动的内核或残留服务。先按实际报错端口查 PID;只有内核成功启动后仍无法更新订阅或连接节点,才继续排查订阅和网络。
Clash Verge Rev 的端口一定是 7897 或 7890 吗?
不一定。不同版本、旧配置和其他 Clash 客户端可能使用不同端口。应以当前设置页、日志和本机监听结果为准,不要直接照抄文章中的示例数字。
Windows 查到 PID 后可以直接 taskkill 吗?
只有在确认 PID 对应旧客户端、重复启动实例或残留 verge-mihomo 时才考虑结束。未知系统进程、驱动、杀毒软件或服务进程不要直接强制结束,优先正常退出、改用空闲端口或重启后复查。
改了 Mixed Port 后系统代理为什么仍然不能用?
检查系统代理是否重新启用,并确认浏览器扩展、终端环境变量、Git、包管理器或局域网设备是否仍写着旧端口。客户端自动处理的设置与手工填写的设置可能不是同一处。
端口改完后内核启动了,但节点仍然超时怎么办?
这说明端口冲突可能已经解决。先确认客户端能监听新端口,再单独检查订阅更新、节点选择、DNS、系统代理或本地网络,不要继续反复修改端口。
相关阅读
- 订阅导入失败时,先确认链接、格式和配置是否正常
- 如果端口正常但 TUN 无法启动,继续检查权限、服务和网卡
- 内核已启动但分流异常时,按规则命中结果排查
- Windows 系统代理仍无法连接时,继续按端口和代理设置分层检查
- 节点仍连接失败时,区分超时、DNS 和客户端配置问题