2026-09-11 · 故障排查 · 约 9 分钟

v2rayN 本地端口被占用:10808 冲突排查与修改监听端口

用系统命令查出占用 10808、10809 端口的进程,再在 v2rayN 参数设置里更换本地 socks 与 http 端口,同步修改系统代理。

本文速览

适用于 Windows 上 v2rayN 提示监听失败、启动后浏览器无法连接本地代理的情况。先从日志确认出错端口,再把监听记录对应到进程;能够关闭重复实例就释放端口,否则改用已确认空闲的端口。最后更新系统代理和应用内代理,避免内核已恢复、应用却仍访问旧地址。

一、先辨认本地监听失败,不要先换节点

在 v2rayN 主界面的日志区域查看本次启动记录,重点找 listen、bind 和 127.0.0.1:10808。如果内核还没成功建立本地入口,请求就到不了节点。此时更新订阅、修改 VLESS 或 VMess 的服务器端口,都不能解除电脑上的监听冲突。

报错:bind: Only one usage of each socket address (protocol/network address/port) is normally permitted.

原因与解法:Windows 上常见的地址占用错误,对应错误码 10048。先查日志中所指端口的监听 PID,再决定退出重复进程还是更换本地入口。

报错:bind: An attempt was made to access a socket in a way forbidden by its access permissions.

原因与解法:常见于错误码 10013,可能涉及端口保留范围或安全策略,不等同于已有程序监听。没有查到 PID 时,继续检查排除端口范围,不要反复结束进程。

报错:No connection could be made because the target machine actively refused it.

原因与解法:应用连接的地址上没有可用监听服务,也可能仍指向修改前的旧端口。先确认内核成功启动,再核对应用实际使用的代理地址。

报错文本会随系统语言和内核版本变化,判断时以本地地址、端口和错误含义为准。127.0.0.1 是电脑自身的回环地址,不是订阅服务器地址;0.0.0.0 则表示监听所有 IPv4 接口,其端口占用也可能影响回环监听。

二、确认 10808 与 10809 在当前配置中的用途

打开「设置」→「参数设置」,查看本地监听相关字段。旧式双入口配置常把 SOCKS 放在 10808、HTTP 放在 10809;采用混合入口的配置则可以让 HTTP 和 SOCKS 共用一个端口。不要仅凭旧教程认定电脑上必须同时出现两个监听端口。

10808
常见 SOCKS 或混合入口端口
10809
旧式双入口常见 HTTP 端口
11808
本文替换示例,使用前先查占用
浏览器请求 本地代理入口 路由规则 远端节点

本地端口只决定应用如何进入客户端。路由分流决定进入后走哪个出口,远端节点端口决定内核连接哪里。三者不应混改。本文的 11808、11809 只是候选端口,不是保证空闲的固定答案。

三、用 netstat 找到占用端口的 PID

在 Windows 开始菜单搜索「终端」,打开 PowerShell 或命令提示符,先执行下面两条命令。普通权限通常可以查看连接记录;需要查看受保护进程的信息时,再使用管理员终端。

netstat -ano -p tcp | findstr ":10808"
netstat -ano -p tcp | findstr ":10809"

优先看本地地址一列与 LISTENING 状态。以下是格式示例,并非当前电脑的实测结果。最后一列 6420 是 PID,同一个进程可能同时建立 IPv4 与 IPv6 监听。

TCP    127.0.0.1:10808    0.0.0.0:0    LISTENING    6420
TCP    [::1]:10808        [::]:0       LISTENING    6420

将查询到的真实 PID 代入下一条命令。若结果只有 ESTABLISHED 或 TIME_WAIT,不要把其中的 PID 直接当成监听冲突来源;还要确认匹配到的是本地端口,而不是远端连接地址。

tasklist /FI "PID eq 6420"
  1. 看到另一个 v2rayN 实例:检查托盘区和任务管理器,优先从旧实例的托盘菜单选择退出。
  2. 看到代理内核进程:先确认所属客户端和文件位置,避免关闭当前正常工作的实例。
  3. 看到其他应用或系统服务:确认用途;如果还需要它,保留该服务并修改 v2rayN 本地端口。
  4. 看到不认识的进程:在任务管理器「详细信息」中按 PID 定位,查看「打开文件所在的位置」,不要只按名称猜测。

四、释放重复实例,或更换本地监听端口

先在托盘菜单将系统代理设为「清除系统代理」,避免调整期间应用一直连接失效入口。如果确认只是误开了两个实例,退出多余实例后重新启动保留的客户端即可,不一定要换端口。

  1. 记录原值

    进入「设置」→「参数设置」,记录当前本地监听端口、是否允许来自局域网的连接,以及使用独立入口还是混合入口。字段名称可能随版本变化,以当前界面为准。

  2. 查询候选端口

    按上一节的方法查询 11808;若当前配置有独立 HTTP 入口,同时查询 11809。存在监听记录就换一组候选值,不要覆盖其他服务。

  3. 修改本地入口

    在「设置」→「参数设置」的本地监听配置中,将 SOCKS 端口改为 11808;若有单独的 HTTP 端口字段,将其改为 11809。若界面只有混合入口,只修改该入口为 11808,不必额外寻找或创建 11809。

  4. 保存并重启

    点击「确定」保存,按界面提示重启内核;若仍显示旧值,退出 v2rayN 后重新打开。随后查看日志,确认新的本地地址没有再次出现 bind 错误。

  5. 检查新监听

    重新查询 11808 和实际配置的 HTTP 入口。监听 PID 应属于当前运行的客户端内核;只有旧端口消失,不能证明新端口已经启动成功。

netstat -ano -p tcp | findstr ":11808"
netstat -ano -p tcp | findstr ":11809"

如果使用的是自定义配置文件,监听地址通常来自配置中的 inbounds,界面端口不一定覆盖该文件。先备份,再检查实际加载配置的 listen、port 和 protocol,避免只改界面、运行时却仍加载旧端口。

五、同步系统代理与应用内代理

内核开始监听新端口后,在 v2rayN 托盘菜单的「系统代理」中选择「自动配置系统代理」。随后到 Windows「设置」→「网络和 Internet」→「代理」查看生效地址。不要把「自动配置系统代理」误解为所有应用都会自动更新自己的手动代理配置。

使用位置双入口示例混合入口示例检查重点
Windows 系统代理127.0.0.1:11809127.0.0.1:11808应指向支持 HTTP 代理的入口
应用手动 SOCKS5127.0.0.1:11808127.0.0.1:11808主机、端口与代理协议同时核对
应用手动 HTTP127.0.0.1:11809127.0.0.1:11808不能指向仅支持 SOCKS 的入口
终端环境变量按 HTTP 或 SOCKS 类型填写按应用支持的代理类型填写旧终端可能仍保留旧值

如果浏览器使用独立代理设置,需要在浏览器内部同步修改。命令行程序也不一定读取 Windows 系统代理:检查已有的 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY 环境变量,尤其留意仍包含 10808 或 10809 的值。修改用户环境变量后,新开终端再测试。

结论:监听恢复后,优先查旧端口引用

如果部分应用已恢复、只有一个应用仍提示连接被拒绝,先检查该应用的手动代理和进程环境,不要立刻再次换端口。让应用指向已确认监听的新入口,通常比重置整套订阅配置更直接。

六、查不到监听进程时,检查保留端口和启动方式

端口查询没有输出,却持续出现访问权限类报错时,在管理员终端检查 Windows 的 TCP 排除端口范围。虚拟化、容器或系统网络组件可能使用这些范围,普通的监听查询未必能显示占用它们的 PID。

netsh interface ipv4 show excludedportrange protocol=tcp
netsh interface ipv6 show excludedportrange protocol=tcp

更换本地端口通常不需要新增防火墙入站规则。仅供本机使用时保留回环监听即可;把监听地址改成 0.0.0.0 并不能消除端口冲突,反而可能让局域网设备也能访问代理入口。只有确实需要共享时,才单独评估访问范围和防火墙规则。

七、按三层结果确认修复完成

先检查本地 TCP 入口,再检查应用代理设置,最后才检查节点连通性。下面的 PowerShell 命令只验证本机端口能否建立 TCP 连接,不会证明远端节点、DNS 或路由分流都已正常。

Test-NetConnection -ComputerName 127.0.0.1 -Port 11808
  1. 本地层:结果中的 TcpTestSucceeded 为 True,日志没有新的监听错误,PID 对应正确的内核进程。
  2. 应用层:系统代理和手动代理均指向新端口,完全退出再打开测试应用,排除旧进程保留设置。
  3. 出站层:使用原来需要访问的页面或服务测试。若本地入口正常,但日志开始出现远端连接超时,再检查节点地址、订阅有效性和网络状况。

Android 上的 v2rayNG 使用 Xray 内核,但它的 VPN 授权与分应用代理不是 Windows 系统代理设置。本文命令针对 Windows 上的 v2rayN,不应照搬到手机。桌面端排查时也不需要修改手机配置,除非手机确实通过局域网连接这台电脑的代理入口。

客户端下载v2rayNG / v2rayN