v2rayN 本地端口被占用：定位冲突进程与修改监听端口

先看日志：端口冲突不等于节点故障

本地监听端口是应用连接代理内核的入口，不是节点服务端口。浏览器访问 127.0.0.1:10808 时，请求先进入本机内核，再按路由规则走直连或代理出站。若内核绑定入口失败，换订阅、换 VMess 或 VLESS 节点通常不能解决问题。

先打开 v2rayN 主界面的日志区域，记录失败行中的地址、端口和错误文字。127.0.0.1:10808、0.0.0.0:10808 与 [::1]:10808 不能完全等同：它们涉及不同的监听范围或地址族。特别是绑定全部 IPv4 地址的进程，可能与只想绑定本机回环地址的进程冲突。

Windows：用端口找到 PID 与程序路径

在 PowerShell 中执行下面的查询。这里以日志里的 10808 为例；若报错写的是其他端口，替换数字即可。查询按本地端口和监听状态筛选，比只搜索包含数字的整行结果更准确。

Get-NetTCPConnection -LocalPort 10808 -State Listen -ErrorAction SilentlyContinue |
  Select-Object LocalAddress, LocalPort, State, OwningProcess

OwningProcess 是进程 PID。假设查到的是 6420，再执行下面两条命令；这个数字只是操作示例，必须换成当前电脑实际输出的 PID。

Get-Process -Id 6420 | Select-Object Id, ProcessName, Path

Get-CimInstance Win32_Process -Filter "ProcessId = 6420" |
  Select-Object ProcessId, ExecutablePath, CommandLine

路径和命令行有助于区分当前 v2rayN 启动的内核、另一个解压目录里的旧实例，以及其他程序。某些进程信息需要管理员权限才能完整读取；普通权限查询不全时，再以管理员身份打开终端。不要仅凭进程名称相同就判断它可以结束。

没有 PowerShell 查询结果时

netstat -ano -p tcp | findstr :10808
tasklist /FI "PID eq 6420"

• 在 netstat 输出中核对“本地地址”列，确认端口确实为 10808，且状态为 LISTENING。
• findstr 只是文本筛选，可能匹配远端地址或其他包含相同数字的端口，不能把每一行都当作本地占用。
• TIME_WAIT 不代表有一个仍在监听的代理进程，不要据此批量结束程序。
• 若错误明确涉及 UDP，再用 Get-NetUDPEndpoint -LocalPort 10808 检查；UDP 查询没有 TCP 的监听状态字段。

macOS：检查监听者并区分重复实例

打开“终端”，使用系统提供的 lsof 查询 TCP 监听端口。-nP 保留数字形式的地址和端口，便于与日志逐项对照。

lsof -nP -iTCP:10808 -sTCP:LISTEN

结果中的 COMMAND 为进程名，PID 为进程编号，NAME 显示监听地址。若普通查询为空但仍怀疑有其他账户的进程占用，可用 sudo lsof -nP -iTCP:10808 -sTCP:LISTEN 复查。不要把空结果直接理解成端口一定可用，还要核对失败日志是否来自刚刚这一次启动。

1. 查到 PID 后执行 ps -p 6420 -o pid,ppid,command，把示例 PID 换成实际值，查看启动命令和父进程。
2. 若来自另一个 v2rayN 实例，先通过对应菜单栏或应用菜单退出那个实例，再启动需要保留的实例。
3. 若属于正在使用的其他程序，保留该程序，为 v2rayN 选择另一个本地监听端口。
4. 仅在确认进程归属且正常退出无效时，才考虑通过“活动监视器”终止它；结束内核可能中断现有连接。

修改监听端口：以 10808 改为 20808 为例

如果占用者需要保留，修改本地入口更直接。以下按 v2rayN 7.x 常见界面说明；不同版本、桌面界面与经典界面的分组名称可能不同，以当前版本的“本地监听端口”字段为准。先查询 20808 是否已有监听，再修改配置，示例数字并不保证在所有电脑上都空闲。

1. 记录旧设置

   打开「设置」→「参数设置」，找到本地监听相关设置，记录原端口、是否启用混合入口、监听地址与局域网连接选项。不要改节点编辑窗口里的远端服务器端口。

2. 检查新端口

   Windows 将前面的查询改为 -LocalPort 20808；macOS 改用 lsof -nP -iTCP:20808 -sTCP:LISTEN。若已有占用，换一个数字继续检查。

3. 保存监听入口

   在「设置」→「参数设置」中，将对应的“本地监听端口”改为 20808，保存并按界面提示重启内核。若保存后未重新加载，可正常退出 v2rayN 再打开。

4. 重新设置代理

   在主界面或托盘菜单的「系统代理」中，先选择「清除系统代理」，再选择「自动配置系统代理」。使用手动代理的应用还需单独更新，不能只依赖这一步。

5. 核对最新日志

   重新查询 20808，确认预期内核已监听，再看此次启动是否还有绑定错误。仅修改数字但未成功启动内核，浏览器仍然无法连接。

同步代理地址：避免应用继续连接旧端口

改端口后仍然“连接被拒绝”，常见原因是应用还在访问旧入口。系统代理、浏览器扩展和终端环境变量是不同配置来源；某个应用恢复访问，不代表所有应用都已更新。

仅在当前入口支持 HTTP 代理时，下面的 PowerShell 示例才适用。它只修改当前终端进程的环境变量，不会自动更新其他已打开的终端，也不会持久写入系统设置。

$env:HTTP_PROXY = "http://127.0.0.1:20808"
$env:HTTPS_PROXY = "http://127.0.0.1:20808"

HTTPS_PROXY 的值采用 http:// 并不矛盾：这里描述的是连接本地 HTTP 代理的方式，HTTPS 目标通常通过 CONNECT 隧道访问。若使用 SOCKS 入口，应按具体工具支持的协议填写；不要仅把协议名称改掉就假定工具能够识别。

没有占用进程：检查排除范围与验证结果

Windows 上出现访问权限类绑定错误，但 TCP 监听查询为空时，可以检查系统排除的端口范围。虚拟化、容器或网络共享相关组件可能涉及这些保留区间；是否存在具体关联，应以本机输出为准。

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

如果失败端口落在某个区间内，优先选择区间外且没有监听者的端口。不要为了代理入口随意删除系统保留项，也不要把永久使用管理员权限当作通用修复方法。若端口不在范围内，再检查安全软件的拦截记录和内核日志，不必先关闭整套防护。

按三层结果验证

• 监听层：新端口由预期内核进程监听。Windows 可用 Test-NetConnection 127.0.0.1 -Port 20808 检查 TCP 是否可建立，但成功不代表代理协议和远端链路也正常。
• 代理层：在支持 HTTP 的入口执行下面的显式代理请求，绕开系统代理设置的歧义；SOCKS 入口使用第二条命令。根据入口类型选择其中一条。
• 应用层：显式代理请求成功后，再使用浏览器访问同一站点。若命令成功而浏览器失败，优先检查浏览器的独立代理、扩展和旧端口缓存。

curl --proxy http://127.0.0.1:20808 --connect-timeout 5 --max-time 15 -I https://example.com/

curl --proxy socks5h://127.0.0.1:20808 --connect-timeout 5 --max-time 15 -I https://example.com/

Windows PowerShell 中可将 curl 写成 curl.exe，避免部分环境中的同名别名影响参数解析。这里的 5 秒是连接超时上限，15 秒是整次请求上限，不是性能实测值。收到 HTTP 响应说明请求已有返回，但若该域名被路由规则直连，仍不能据此证明代理出站节点可用；需要结合内核日志核对实际出站。

常见问题：重启复发与端口修改边界