代理客户端端口冲突:端口被占用的排查与修改方法
问题诊断 · 发布 2026-10-12 · 更新 2026-11-18 · 约 6 分钟读完
快速答案
端口冲突是因为两个程序同时想监听同一个本地端口,常见于同时安装了多个 Clash 类客户端、旧进程没退出,或其他软件恰好占用了 7890 / 7897。用命令找到占用端口的进程并结束它,或者在客户端里把混合端口改成一个未被占用的端口即可。
目录
30 秒速查清单什么是端口冲突症状、原因与处理对照表Windows:查找并结束占用端口的进程macOS:查找占用端口的进程Clash Verge Rev 修改端口手机端与 Shadowrocket常见报错原文对照小结:端口冲突与机场无关常见问题30 秒速查清单
- 彻底退出其他代理客户端:旧版 Clash for Windows、ClashX、v2rayN、各种加速器,从托盘或菜单栏完全退出,而不是只关窗口。
- 重启电脑:最简单也最有效,能清掉残留进程。
- 换一个端口:在客户端设置里把混合端口改成 7899、17890 等不常用的端口。
- 查找占用进程:Windows 用
netstat -ano | findstr :7890,macOS 用lsof -i :7890。 - 改完端口后同步修改其他地方:Telegram 的代理设置、终端的环境变量、浏览器插件里写死的端口都要一起改。
- 关闭冲突的服务模式:Clash Verge Rev 的服务模式和普通模式不要同时运行两份。
什么是端口冲突
代理客户端运行时,会在本机开放一个或几个端口(例如 HTTP 端口、SOCKS 端口、混合端口、控制端口),浏览器和系统把请求发送到 127.0.0.1:端口,再由客户端转发给机场节点。一个端口同一时间只能被一个程序监听,如果另一个程序已经占用了这个端口,新启动的客户端就会报错,或者看起来启动了但实际上没有工作。
Clash 系客户端常见的默认端口包括 7890(老版本 Clash 常用)、7897(Clash Verge Rev 常用的混合端口)、9090 或 9097(外部控制端口)。v2rayN 也会占用 10808、10809 等端口。不同客户端默认值可能随版本变化,以设置页面显示为准。
症状、原因与处理对照表
| 症状 | 原因 | 处理 |
|---|---|---|
| 启动时报 address already in use | 端口已被其他进程监听 | 结束占用进程或换端口 |
| 客户端显示运行中,但网页打不开 | 系统代理指向的端口被另一个程序接管 | 检查端口与系统代理是否一致 |
| 控制面板打不开、显示连接失败 | 外部控制端口(如 9090)冲突 | 修改外部控制端口 |
| 开机后第一次能用,重启客户端后不能用 | 旧进程退出不完整 | 任务管理器结束残留进程 |
| TUN 模式无法开启 | 另一个虚拟网卡或服务模式冲突 | 卸载旧客户端的服务和网卡 |
Windows:查找并结束占用端口的进程
- 按 Win 键搜索“命令提示符”或“终端”打开。
- 输入
netstat -ano | findstr :7897(把端口换成报错中的端口),最后一列数字就是进程 PID。 - 输入
tasklist | findstr PID号查看是哪个程序。 - 如果是残留的代理客户端,用
taskkill /PID PID号 /F结束,或在任务管理器“详细信息”页找到同 PID 的进程结束。 - 如果占用者是系统服务或你需要的软件,不要强行结束,改为修改代理客户端的端口。
netsh interface ipv4 show excludedportrange protocol=tcp 查看保留范围,把代理端口改到范围之外。macOS:查找占用端口的进程
- 打开“终端”,输入
lsof -i :7897,可以看到进程名和 PID。 - 确认是残留进程后,用
kill PID号结束;无效时用kill -9 PID号。 - 如果同时装过 ClashX、Clash Verge、Stash 等多个客户端,建议只保留一个,并在“系统设置 → 通用 → 登录项”里关闭其他客户端的开机自启。
macOS 上客户端的选择,参考 macOS 客户端怎么选。
Clash Verge Rev 修改端口
- 打开“设置”,找到“端口设置”或“混合代理端口”,改成一个未被占用的端口,例如 7899。
- 保存后客户端会自动重启内核,并把系统代理指向新端口。
- 如果外部控制端口冲突,在“外部控制”中一并修改。
- 修改后,检查以下地方是否写了旧端口:终端里的
http_proxy/https_proxy环境变量、git 和 npm 的代理设置、Telegram 自定义代理、浏览器的 SwitchyOmega 等代理插件。终端代理设置可参考 终端 / git / npm 代理。
Clash Verge Rev 的完整设置说明见 Clash Verge Rev 教程。
手机端与 Shadowrocket
手机端很少出现端口冲突,因为 iOS 和安卓的代理客户端通常以 VPN 方式工作。但也有例外:
- Shadowrocket:同时启用了其他 VPN 配置时,会互相顶替,表现为一个连上另一个断开。到 iPhone“设置 → 通用 → VPN 与设备管理”中只保留一个启用。
- 安卓:同时运行 CMFA 和 v2rayNG,只有一个能拿到 VPN 权限;若在 CMFA 中开启了“允许局域网连接”并给其他设备提供代理,需注意端口不要与手机上其他服务重复。
常见报错原文对照
| 报错 | 说明 |
|---|---|
listen tcp 127.0.0.1:7890: bind: address already in use | 端口已被占用(macOS / Linux) |
Only one usage of each socket address is normally permitted | 端口已被占用(Windows) |
An attempt was made to access a socket in a way forbidden by its access permissions | 端口在系统保留范围内 |
external controller listen error | 控制端口冲突 |
Failed to start core | 内核启动失败,端口冲突是常见原因之一 |
小结:端口冲突与机场无关
端口冲突完全是本地问题,与机场线路、节点无关,换机场也解决不了。处理办法就是“只保留一个客户端 + 换一个空闲端口 + 同步修改其他地方写死的端口”。如果修好端口后节点依然无法连接,再按 节点全部超时排查 和 系统代理不生效排查 继续检查;确认是节点本身不稳定时,再考虑从 稳定机场推荐 或 机场推荐总榜 中更换机场。
常见问题
Clash 提示端口被占用怎么办?
先彻底退出其他代理客户端或重启电脑;仍报错就用 netstat(Windows)或 lsof(macOS)找到占用进程,或者直接在客户端设置里换一个空闲端口。
7890 端口被占用是什么程序?
通常是另一个 Clash 类客户端或残留进程。Windows 执行 netstat -ano | findstr :7890 获取 PID,再用 tasklist 查看程序名。
改了 Clash 端口后要改哪些地方?
终端代理环境变量、git / npm 代理、Telegram 自定义代理、浏览器代理插件中写死的端口都要同步修改。参考 终端代理设置。
Windows 端口没被占用却无法监听?
可能处于 Hyper-V / WSL 的系统保留端口范围,用 netsh 命令查看保留范围,把代理端口改到范围之外即可。
端口冲突需要换机场吗?
不需要。端口冲突是本地软件问题,与机场无关。只有端口修好后节点仍不可用,才需要排查机场,参考 稳定机场推荐。
问题诊断 · 继续阅读
机场节点全部超时:从客户端到订阅的完整排查
节点全部超时,九成以上是本地原因:系统时间不准、订阅没更新、客户端内核或协议不支持、被其他代理软件占用。先校准时间、更新订阅、换内核测速;如果换网络、换设备仍全部超时,且官网公告无说明,才是机场本身的问题。
机场订阅更新失败:常见报错与逐项解决方法
订阅更新失败最常见的原因是机场订阅域名在国内被污染,直连拉取不到。先在客户端里开启“通过代理更新订阅”,再确认订阅链接没有被重置、套餐没过期;仍失败就到机场后台复制备用订阅地址。
ChatGPT 提示 Too many requests:原因、排查与节点选择
Too many requests 有两种来源:一是账号在短时间内消息过多触发了限额,等一段时间即可;二是你使用的节点 IP 被很多人共用,OpenAI 按 IP 限流。后者换一个人少的节点、固定使用同一地区节点,并清理浏览器缓存,通常就能恢复。
Claude 地区不支持:从节点地区到 DNS 泄漏的排查方法
Claude 提示地区不支持,通常是当前出口 IP 位于香港、中国大陆等不支持地区,或部分请求走了直连导致 IP 不一致。改用美国、日本、新加坡等支持地区的固定节点,确认 claude.ai 和 anthropic.com 全部走代理,并清除缓存后重新打开即可。
Google 频繁人机验证:异常流量提示的原因与解决
Google 频繁人机验证,根本原因是当前节点出口 IP 被很多人共用,Google 判定该 IP 有异常流量。换一个使用人数较少的节点、避开热门香港节点、固定节点并登录 Google 账号,通常能明显减少验证。
机场速度慢:从测速、协议到线路的全面排查
机场速度慢先区分“延迟”和“带宽”:延迟低不代表下载快。先换几个不同地区的节点做下载测速,关闭本地限速因素(Wi-Fi 信号、路由器、杀毒软件、TUN 模式开销),再看是否只在晚高峰变慢。全天都慢且换节点无效,多半是机场线路或超售问题。