ClashVPNVELOCITY NETWORK
troubleshooting••修订于 2026年10月16日

端口冲突7890排查与系统网络重置

启动代理客户端提示端口已被占用的故障排查:使用终端命令行快速定位抢占进程、修改客户端默认监听端口并重置系统网络协议栈,彻底排除网络端口冲突报错。

撰文: ClashVPN 团队预计阅读需 5 分钟

端口冲突 7890/9090 报错彻底解决:Clash 启动失败与监听异常排查指南

在 Windows 或 macOS 上启动 Clash Verge、Clash for Windows 时,最令人头疼的错误莫过于控制台弹出的红字提示: listen tcp 127.0.0.1:7890: bind: address already in use 或 9090: address already in use。

这代表系统的 7890 端口(默认混合代理端口)或 9090 端口(RESTful API 控制外部控制器端口)已经被另一个正在运行的程序强行占用了。


一、排查到底是哪个程序占用了端口

1. Windows 平台排查

  1. 按 Win + X 打开菜单,选择 终端管理员 或 PowerShell (管理员)。
  2. 输入以下命令查找占用 7890 端口的进程 PID:
netstat -ano | findstr :7890
  1. 输出结果最后一行通常会显示一个数字(例如 14280),这就是该进程的 PID。
  2. 查看该 PID 属于哪个软件:
tasklist | findstr 14280

常见元凶往往是:

  • 之前非正常退出的老版本 Clash 残留后台僵尸进程;
  • v2rayN、Qv2ray、Charles 抓包工具等代理软件。
  1. 强制杀死该残留进程:
taskkill /F /PID 14280

2. macOS 平台排查

打开终端 (Terminal),执行:

sudo lsof -i :7890

找到对应的 PID,执行强制关闭:

sudo kill -9 <PID>

二、根本解决之道:直接修改 Clash 默认端口

如果某个系统服务必须长期占用 7890,最一劳永逸的方法是直接在 Clash 中换一个全新的空闲端口:

  1. 打开 Clash Verge Rev -> 进入左侧 设置 (Settings)。
  2. 找到 混合端口 (Mixed Port):
    • 将原有的 7890 修改为任意五位数空闲端口,例如 17890 或 27890。
  3. 找到 外部控制端口 (External Controller):
    • 将 9090 修改为 19090。
  4. 重启 Clash Verge 内核,所有端口冲突即刻迎刃而解,网络秒级恢复!

本文相关高频疑问

01按照文章步骤操作后无法联网怎么办?
建议首先查看客户端控制台日志(Logs),排查是否存在端口占用或 DNS 解析失败;同时确认网络配置中的“允许局域网连接”和“系统代理”状态设置是否恰当。
02配置文件中的规则更新后需要手动重启客户端吗?
大部分现代 Clash 客户端(如 Clash Verge Rev)支持静默热重载(Hot Reload),在更新或切换配置后会自动生效,无需重启软件。

相关技术文章推荐

SPEED & ACCELERATION

需要更多网络配置支持?

浏览我们的基础专题库,获取更多开箱即用的分流与路由优化经验。