客户端提示端口被占用？找出占用进程、决定改谁，以及改完要同步的三处
端口只能被一个程序监听。客户端起不来，往往不是它坏了，是位子被别人先坐了——而那个人常常是上一个还没退干净的它自己。
启动客户端时报错，提示大意是「端口已被使用」或「address already in use」。这句提示的含义很直接：
一个端口在同一时间只能被一个程序监听。 你的客户端想在某个端口上提供代理服务，但已经有别人坐在那个位子上了。
需要先分清的是，这个报错和网络、机场、订阅全都无关，它是纯粹的本机问题。查订阅、换节点、重装客户端都不会有帮助。
先确认是哪个端口
不同客户端的默认端口不一样，而且很多客户端会同时监听好几个：一个 HTTP 代理端口、一个 SOCKS 端口、一个混合端口、还有一个控制面板端口。
从错误提示或客户端日志里找到具体的端口号，不要凭记忆猜。有的客户端只在日志里写明是哪个端口冲突，界面上的提示很笼统——这时候日志是唯一可靠的来源。
如果报错里完全没有端口号，那先怀疑控制面板端口：它最容易和别的本地服务撞上，而且冲突时的表现常常是「客户端看起来启动了，但界面连不上」。
谁最可能占了这个端口
按概率从高到低：
| 占用方 | 典型场景 | 怎么处理 |
|---|---|---|
| 上一个还没退干净的自己 | 强制结束过客户端、更新后重启 | 结束残留进程 |
| 另一个代理客户端 | 同时装了好几个在试 | 只留一个 |
| 开发环境的本地服务 | 本地服务器、数据库、调试工具 | 改客户端的端口 |
| 虚拟化或容器工具 | 端口转发占用了一段 | 改客户端的端口 |
| 安全软件 | 拦截或代理本地流量 | 见下文 |
第一行占了大多数情况，而且它有一个明显特征：你刚刚强制结束过客户端，或者它刚自动更新过。进程没退干净时端口不会立刻释放，重新启动就撞上自己。
这种情况和关掉客户端后反而上不了网是同一个根源——客户端没能正常退出。区别只是那边留下的是系统代理设置，这边留下的是一个占着端口的僵尸进程。
找出占用进程：三个系统的办法
Windows
在命令提示符或 PowerShell 里按端口查找监听进程，拿到进程号之后再去任务管理器里按进程号（不是按名字）找到它。任务管理器默认不显示进程号，需要在「详细信息」标签页里把这一列打开。
macOS 与 Linux
用系统自带的命令按端口反查，它会直接给出进程名和进程号，比 Windows 少一步。
共通的注意点：
- 看清楚是监听（LISTEN）还是已建立的连接。 只有前者才是占用端口的那个，后者只是一条正在通信的连接，不影响新程序绑定。
- 进程名可能不是你以为的。 很多客户端的实际监听进程是它内部的内核程序，名字和你看到的应用名完全不同。看到一个陌生名字不要急着下结论，先按进程号确认它属于哪个应用。
该改端口，还是该关掉占用方
判断标准只有一条：那个占用方你还要不要用。
- 占用方是残留的自己 → 结束它，端口自然空出来。不用改任何配置。
- 占用方是你需要长期运行的服务（本地开发服务器、容器、数据库）→ 改客户端的端口。不要为了代理去关掉工作要用的东西。
- 占用方是另一个代理客户端 → 只留一个。同时开两个几乎没有好处，还会让后续所有排查结论变得不可靠，因为你无法确定某个请求走了哪一个。
- 占用方是安全软件 → 既不该关也不该硬抢，改客户端端口最省事。
改端口时避开两类数字：1024 以下的（多数系统上绑定需要管理员权限，普通启动会直接失败），以及常见服务的默认端口。在 10000 到 60000 之间挑一个不常用的数字就行，具体是多少没有讲究。
改了端口之后，必须同步改的三处
这是最容易出问题的一步——端口改了但依赖它的地方没跟上，表现为「客户端起来了但还是不能上网」，很容易被误判成新的故障。
第一，系统代理设置。 如果客户端会自动写入系统代理，通常它会自己更新成新端口；但如果你之前手动配过系统代理，那里还指着旧端口。去系统代理设置里确认一次。
第二，手动配置过代理的程序。 浏览器里的手动代理、某些工具自带的代理设置、下载器的代理配置——这些都不会自动跟随，需要逐个改。
第三，终端里的代理环境变量。 如果你为命令行配过代理，那几个变量里写死了旧端口。它们通常写在 shell 的配置文件里，改完要重新加载或者新开一个终端才生效。命令行代理的完整配置方式见 Claude Code 与 API 在终端里连不上，那篇讲的方法对所有命令行场景通用。
顺序很重要：先确认客户端在新端口上能正常启动并监听，再去改这三处。顺序反了的话，出问题时你分不清是端口没改对还是别处没跟上。
端口没被占用，却还是启动失败
如果查过之后确认端口是空的，客户端依然起不来，那就不是端口问题了。去看客户端日志里的具体报错，常见的有三类：
- 配置文件解析失败：订阅内容的格式和当前内核版本对不上。这一类的排查见订阅能下载但导入时提示配置错误。
- 内核文件缺失或被拦截：部分安全软件会把客户端内部的内核程序误判并隔离，表现为启动即失败。检查安全软件的隔离区。
- 权限不足：常见于把端口设成了 1024 以下，或者客户端需要的虚拟网卡权限没给。
这三类在界面上的提示都可能很笼统，日志是唯一能区分它们的地方。各客户端的日志位置见 Clash Verge 使用教程与 v2rayN 使用教程。
把这个问题一次性消掉
- 退出客户端时用它自己的退出菜单，不要强制结束。这一条能消灭掉最常见的那一类冲突。
- 把端口改成一个不常见的数字并固定下来。 避开所有默认值，以后基本不会再撞。
- 不要同时安装多个代理客户端并让它们都开机自启。 要对比就一个一个来。
- 改完端口后，把新端口记在一个地方。 下次配置终端代理或手动代理时会用到，临时去客户端里翻很耽误事。
启动之后仍然不能上网的话，问题已经换了一层，按完全上不了网的四步定位继续。更多按症状分类的入口见网络诊断栏目。