适合 v2rayN 启动内核时遇到绑定失败的 Windows 和 macOS 用户。先从日志抄下监听地址、协议和端口,再查进程编号。重复实例可以正常退出;需要保留的进程不动,给 v2rayN 换端口。最后确认新端口确实由本次启动的内核监听,并更新仍指向旧端口的应用。
从启动日志确认冲突端口
先看 v2rayN 主窗口日志中最新一轮启动记录。若日志写着 listen tcp 127.0.0.1:10808,失败的是本机的 TCP 入站。这个端口供应用连接本地代理,与节点地址里的远程端口是两回事。改节点端口、更新订阅或切换路由规则,都不能释放本机的监听端口。
报错: bind: address already in use
原因与解法: 请求绑定的本地地址与端口和现有套接字冲突。按报错前面的端口查监听进程,确认是应当退出的旧实例,还是需要保留的程序。
报错: bind: Only one usage of each socket address (protocol/network address/port) is normally permitted.
原因与解法: Windows 拒绝了重复占用套接字地址的绑定请求。按日志中的协议和端口检查,不要只查默认的 SOCKS 端口;失败的也可能是同一份配置的另一条入站。
日志中的 127.0.0.1 和 ::1 分别是 IPv4 和 IPv6 回环地址。查询时先不限定地址:绑定在 0.0.0.0 上的监听也覆盖 IPv4 回环;看到 :: 时,还要结合该监听是否使用双栈判断。端口号相同不等于冲突,TCP 和 UDP 要分开查。
在 Windows 和 macOS 查询占用进程
以下以 TCP 10808 为例。运行时替换成日志里的端口。只关注本地监听;输出里某条已建立连接的远端端口恰好是 10808,不能据此认定该进程占用了本地端口。
Windows:用 PowerShell 查监听
Get-NetTCPConnection -LocalPort 10808 -State Listen -ErrorAction SilentlyContinue |
Select-Object LocalAddress, LocalPort, OwningProcess
Get-Process -Id 7420 | Select-Object Id, ProcessName, Path
把第二条命令里的示例编号 7420 换成第一条返回的 OwningProcess。若启动日志写的是 listen udp,用 Get-NetUDPEndpoint -LocalPort 10808 查看对应端点,再根据 OwningProcess 查进程。若进程路径不可见,可在有权限的会话中复查。
macOS:用 lsof 查监听
lsof -nP -iTCP:10808 -sTCP:LISTEN
ps -p 7420 -o pid=,command=
从 lsof 的 PID 列取实际编号,再用 ps 看启动命令。UDP 用 lsof -nP -iUDP:10808,不加 TCP 的监听状态筛选。普通用户看不到其他账户的进程时,可在有管理员权限的情况下用 sudo lsof 复查。
| 查询结果 | 下一步 |
|---|---|
| 监听归属另一个目录启动的旧内核 | 通过旧客户端的退出入口停止它,再查原端口是否释放。仅关闭窗口可能仍会保留托盘进程。 |
| 监听归属仍在使用的应用或服务 | 保留该进程,给 v2rayN 换本地端口。不要仅凭进程名强制结束服务。 |
| 启动失败后查不到监听 | 对照同一轮的完整日志,检查失败端口是否由自定义配置中的两条入站重复申请。内核退出后,先前已绑定的监听也会消失。 |
判断依据:进程路径比进程名更有用
两个内核进程可能同名。如果查询结果出现熟悉的内核名,先核对路径或启动命令,确认它属于哪套配置,再决定退出旧实例还是迁移端口。
在 v2rayN 参数设置中换端口
以下以 v2rayN 7.x 常规节点为例。把 10818 当作候选,不当作预留端口。有的配置使用同一个混合入口处理 SOCKS 和 HTTP,有的配置使用独立入站。不要按 10808、10809 的顺序推算新端口,最终以实际加载的配置和监听结果为准。
记下原设置
记录报错端口、当前节点和系统代理状态。如果原先由 v2rayN 接管系统代理,可先通过「系统代理」→「清除系统代理」停止向旧地址转发,避免迁移期间继续访问失效的监听。
查候选端口
把前面的查询命令改为
10818。如果启用了额外入站,也要查它们将使用的端口;实际启用 UDP 时,再查对应的 UDP 端点。查询未发现占用,只代表查询当时的状态。修改本地端口
打开「设置」→「参数设置」,在基础设置中找到本地监听端口字段;显示「本地混合监听端口」时,改的就是混合入站端口。填入
10818并保存。仅供本机使用时,保持局域网连接关闭,不必为换端口扩大监听范围。重启并查监听
退出托盘中的 v2rayN,再重新打开并启动原节点。查看最新日志,用同一条查询命令确认新端口已监听且归属正确。若这次报错指向另一个端口,继续查那条入站,不要反复修改已经绑定成功的端口。
同步代理入口
原先使用系统代理的用户,可在 v2rayN 的「系统代理」菜单重新选择「自动配置系统代理」。手动配置了浏览器扩展、终端环境变量或开发工具的用户,要在各自的设置里替换旧端口,且保留与监听入口相符的代理协议。
如果当前运行的是自定义配置,改完参数仍看到内核尝试绑定旧端口,应检查实际加载的配置。Xray/V2Ray 风格的 JSON 可查看 inbounds 中对应入站的 listen 和 port。先备份自定义文件,再改由该文件定义的入站;不要把客户端临时生成的配置当作长期修改入口。
分别验证 HTTP、SOCKS 和应用设置
系统查询显示端口在监听,只能确认本地套接字已打开。下一步显式指定代理地址,避开浏览器扩展和系统代理设置的干扰。下面假设 10818 是混合入站。如果 HTTP 与 SOCKS 分开监听,分别代入各自的端口。Windows PowerShell 下使用 curl.exe 执行相同参数。
curl --noproxy "" --max-time 15 -I --proxy http://127.0.0.1:10818 https://v2rayapi.com/
curl --noproxy "" --max-time 15 -I --proxy socks5h://127.0.0.1:10818 https://v2rayapi.com/
- 本地连接被拒绝:先确认新端口仍在监听,再核对监听地址。如果内核只绑定在
::1,用127.0.0.1测试不会连到该监听。 - 能连本地但握手失败:核对测试协议和实际入站类型。把 HTTP 请求送到仅提供 SOCKS 的端口,即使端口确实打开也不能正常转发。
- 收到目标站的 HTTP 响应:说明这次请求经指定的本地入口得到响应。HTTP 代理的
200 Connection established只是隧道建立提示,还要看随后的目标站响应;至于内核选了直连还是代理出站,要看路由配置和日志。
显式测试成功但浏览器或终端仍失败时,重点查该应用保存的旧地址。检查浏览器扩展是否覆盖系统代理;检查当前终端里的 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY。如果变量由终端启动配置设置,改完后开一个新会话再测,已有会话不会自动继承新值。
换端口后的常见问题
原来的 10808 必须空出来吗?
不必。如果它由另一个正常使用的程序监听,保留即可。只要 v2rayN 已监听新端口,且调用方已改用新地址,两个服务就能使用各自的入口。
为什么换了端口还是报旧的 10809?
先确认日志是保存后新产生的,再核对是否存在独立 HTTP 入站、附加入站或自定义配置。用 10809 重新查监听归属,不要假设修改一个字段会同步改掉所有入站。
Windows 查不到占用,却提示访问权限错误?
如果错误包含 forbidden by its access permissions,它不等同于已有进程在监听。执行 netsh interface ipv4 show excludedportrange protocol=tcp,查看候选端口是否落入 IPv4 TCP 排除范围;如果落入,另选范围外且未监听的端口,不必删除系统保留项。
开机后才冲突,手动重启却正常?
在故障刚发生时查一次进程归属,重启后再查一次。若路径显示同时启动了两份 v2rayN,保留需要的一份,并检查客户端自启设置和系统启动项是否重复。若进程属于另一个常驻服务,给 v2rayN 固定使用不冲突的端口。