macOS 代理端口被占用怎么办？3 步精准排查监听进程与安全释放冲突
简答：macOS 提示代理端口（如混合端口 7890）已被占用时，通常是由于后台残留的守护进程、重复启动的客户端实例占据了该端口。排查的核心原则是：使用带权限的 <code>lsof</code> 命令精准锁定处于 <code>LISTEN</code> 状态的监听进程，避免误杀正常网络连接，再通过安全信号或客户端设置完成释放。
定义：macOS 代理端口被占用是指本地网络代理客户端（如 Clash 系列、sing-box 等）在启动时，其指定的本地监听端口（mixed-port 或 port）已被系统中另一个正在运行的进程所占据，导致当前应用无法正常绑定端口并启动服务。
一、为什么会提示代理端口被占用？
当你在 macOS 上启动代理客户端、或在日志中看到诸如端口冲突或绑定失败的报错时，往往是因为以下几种常见原因：
- 残留的后台进程或守护进程： 上一次退出的客户端未彻底关闭，或者其辅助服务（如服务模式、开机自启 helper）仍在后台静默运行。
- 多客户端端口冲突： 同时安装了多个不同的代理工具，它们的默认混合端口（mixed-port）恰好冲突（例如均占用 7890 端口）。
- 权限与连接混淆： 普通用户执行端口查询时若遗漏了系统级进程或需要管理员权限的守护进程，可能无法查到真正占用端口的源头。
二、3 步精准定位并释放代理端口
在进行任何操作前，请先通过客户端自带的菜单选择完全退出，避免直接使用强制终止手段。若退出后仍提示占用，请按以下 3 步排查：
第 1 步：用 lsof 命令精准锁定监听进程
打开 macOS 的“终端”应用。为了防止将正在通过代理联网的浏览器等常规连接误认为是占用者，我们只排查处于监听状态（LISTEN）的进程。以排查默认的 7890 端口为例，输入以下命令：
sudo lsof -nP -iTCP:7890 -sTCP:LISTEN注：输入该命令后终端会要求你输入开机密码（输入时密码不显示，输完直接回车）。普通用户权限下若不加 sudo，可能会漏掉由系统守护进程占用的端口。
第 2 步：识别监听方并安全终止进程
查看终端返回的结果，重点关注 COMMAND（进程名）和 PID（进程号）两列。例如：
| COMMAND | PID | USER | 说明 |
|---|---|---|---|
| mihomo / clash | 12345 | username | 残留的客户端核心进程 |
如果确认该 PID 属于残留的代理核心，请先尝试发送标准终止信号（SIGTERM，安全退出）：
kill 12345如果数秒后再次用第 1 步命令检查发现该进程依然存在，再使用强制终止命令（SIGKILL）：
sudo kill -9 12345第 3 步：检查后台守护进程与客户端配置
部分客户端（如开启了“服务模式”或辅助守护进程的软件）在被手动 kill 后可能会由系统的 launchd 自动拉起，导致端口再次被占。此时你需要：
- 打开对应的客户端设置面板，关闭“服务模式”或“开机自启”。
- 如果不需要默认的 7890 端口，也可以在客户端的设置或配置文件（如 Clash 的
mixed-port或 sing-box 的inbounds中的listen_port）中将其修改为其他未被占用的端口，修改后保存并重启客户端。
三、修改端口后同步检查系统代理
当你成功释放端口或更改了客户端的监听端口后，别忘了同步核对操作系统的代理状态，避免旧的系统代理设置指向失效端口。具体可参考 macOS 系统代理怎么设置：HTTP、SOCKS5、PAC 与排查步骤 进行复核与调整。
常见问题
为什么不加 sudo 有时候查不到占用端口的进程？
如果该端口是由系统管理员权限进程或受保护的守护进程所占用的，普通用户权限执行 lsof 无法遍历所有系统进程，从而导致看起来端口被占但终端显示为空。加上 sudo 可以确保完整检索。
修改了客户端的混合端口（mixed-port）后，还需要改其他地方吗？
修改客户端监听端口后，如果你的局域网其他设备有通过该 Mac 共享代理的需求，或者某些第三方脚本指定了旧端口，需要同步更新对应的端口号。部分客户端（如开启了系统代理开关的客户端）会自动更新，具体以所用客户端界面为准。
为什么用 kill -9 结束了进程，过一会儿端口又被占用了？
这通常是因为客户端开启了守护进程、服务模式（Service Mode）或系统的 launchd 任务检测到了核心异常退出并自动将其重启。建议先在客户端界面内彻底关闭服务模式或开机自启选项，再进行端口排查。