快连无法连接时如何快速诊断本地端口占用？
功能定位：为什么端口冲突会让快连“假死”
kuailian 的本地 SOCKS5/HTTP 代理默认监听 7890/7891，一旦端口被 Steam、迅雷或本地 Web 调试器抢先绑定，客户端会卡在“正在建立隧道”却永远收不到握手包，看上去就像“无法连接”。把问题拆成一句话：谁先占用，谁说了算。诊断目标因此简化为：找出肇事进程→释放或改端口→验证连通。
诊断三步法：Windows / macOS / Linux 通用
1. 查端口占用
netstat -ano | findstr ":7890"
# 记录最后一列 PID
# macOS / Linux
lsof -i :7890 -sTCP:LISTEN -n -P
如果命令返回空行，说明端口空闲；若出现 LISTEN 行，立即记下 PID 与进程名，为下一步锁定目标。
2. 定位进程
tasklist /FI "PID eq 1234"
# macOS / Linux
ps -fp 1234
经验性观察：开发机上的“常客”是 Docker 代理、P2P 下载器或 IDE 内置服务器；看到熟悉的进程名就能秒判优先级。
3. 决策：释放 or 改端口
- 进程可关：直接退出，再点一次快连连接即可。
- 进程必须常驻：在快连设置里把本地端口换成
7892-7900区间任意未被占用的数字，保存后重启客户端。
平台差异：最快入口在哪
| 平台 | 最短路径 | 备注 |
|---|---|---|
| Windows 10/11 | 托盘图标→右键→设置→本地代理→端口 | 需管理员权限才能改系统代理 |
| macOS 14+ | 菜单栏→快连→Preferences→Network→Local Port | 若端口被系统 AirPlay 占用，需重启 CoreAudio |
| Android 14 | 侧边栏→设置→高级→本地 HTTP 代理端口 | 仅影响“分应用代理”模式 |
| iOS 17 | 设置→快连→本地代理端口（灰色需关闭系统 privacy tool 再改） | iOS 不允许非 privacy tool 进程监听 80/443 |
常见分支：端口改了仍连不上？
防火墙未放行：Windows Defender 要把快连加入“允许应用”列表；macOS 需在“设置-网络-防火墙-选项”里勾选“自动允许已下载软件”。
代理链死循环：浏览器插件（如 SwitchyOmega）把流量指回本地同一端口，导致自我循环。临时把插件设为“直接连接”即可验证。
配置文件残留：升级后旧版 config.json 仍写死 7890，需在安装目录下手动改值并重启客户端。路径因版本而异，请以实际为准。
验证与验收：如何判断已恢复
- 客户端日志出现
local proxy 127.0.0.1:xxxx started且没有bind: Address already in use。 - 浏览器访问
http://127.0.0.1:xxxx/proxy.pac能下载到 PAC 文件（返回 200）。 - curl 验证：
curl -x socks5://127.0.0.1:xxxx https://ipinfo.io返回节点 IP 而非本机宽带 IP。
不适用场景清单
- 公司网络采用白名单出口，禁止所有非 80/443 的本地监听，此时改端口无效，需联系网管申请放行。
- 校园网 802.1X 认证客户端强制占用 7890-7899，且进程守护无法结束，建议改用“浏览器插件代理”模式，绕过本地端口。
- iOS 版因系统沙箱限制，本地端口仅能在 privacy tool 通道内部使用，无法被其他 App 调用，若出现占用实为系统缓存，重启设备即可。
最佳实践速查表
决策规则
① 先查端口→② 再决定关进程 or 改端口→③ 改完必验证 PAC→④ 日志无 bind 错误即通关。
端口区间建议
个人用户：7892-7900；公司批量部署：30000-30100，避开常见 P2P 段。
可复现命令
Windows 一键脚本（管理员 PowerShell）：
for ($p=7892; $p -le 7900; $p++) { if (!(netstat -ano | findstr ":$p")) { echo "可用端口:$p"; break } }
FAQ（使用 FAQPage Schema）
改端口后浏览器还是走旧代理怎么办？
在浏览器地址栏输入 chrome://restart 或重启系统代理服务，确保 PAC 缓存刷新。
netstat 提示“不是内部命令”？
Windows 家庭版默认缺组件，可在“设置-应用-可选功能-添加功能”里勾选“RSAT 网络工具”，或直接使用 PowerShell 的 Get-NetTCPConnection。
如何批量检查多台电脑端口冲突？
用 Ansible 推送脚本：ansible windows -m win_shell -a "netstat -ano | findstr ':7890'"，返回非空即需处理。
收尾：下一步行动
端口占用是快连无法连接的最高频本地原因，却也是最快可逆的。记住“查-定-改-验”四步，多数场景下 30 秒内即可自愈。若按本文流程仍卡住，把日志中 bind error 行与 netstat 截图一并提交官方工单，可缩短排障往返。现在就打开终端，输入第一条命令，确认你的 7890 是否真的空闲。