适合已安装 v2rayN、准备导入订阅或排查连接问题的桌面用户。按服务器列表、订阅分组、流量入口、日志、参数设置的顺序阅读，可分清“选中了服务器”“核心已经启动”和“应用流量进入代理”的区别，并建立一次只改一项的排查流程。
主窗口分区：配置、入口与运行状态
v2rayN 是桌面图形客户端，负责管理服务器配置、调用代理核心并提供系统代理等入口。服务器列表里出现一条 VMess 或 VLESS 记录，只说明配置已保存，不代表核心已经成功连接，更不代表浏览器正在使用它。界面上的列表、状态栏和日志需要一起看。
不同平台和界面版本的按钮位置可能不同，菜单文字也可能有细微差异。下文以中文桌面界面的常见名称说明；参数值以本机界面与实际启动日志为准，不把某个端口或内核当成所有安装包的固定默认值。
| 界面区域 | 主要用途 | 应核对的内容 |
|---|---|---|
| 服务器列表 | 查看、编辑与选择服务器 | 活动标记、协议、地址、端口、分组 |
| 订阅分组 | 保存订阅来源、更新列表 | 更新范围、更新方式、失败信息 |
| 系统代理与路由 | 决定流量如何进入及离开核心 | 系统代理状态、当前路由配置 |
| 日志面板 | 查看启动、请求与错误记录 | 报错时间、目标地址、错误类型 |
| 参数设置 | 调整本地监听、日志及运行行为 | 端口、监听范围、实际使用的核心 |
服务器列表：选中行与活动服务器不是一回事
单击一行通常只是选中记录，供编辑、复制或测试使用。要切换实际使用的服务器，应在该行右键菜单中执行「设为活动服务器」，再检查活动标记和启动日志。不要只根据行背景颜色判断连接对象，也不要把延迟列中的数字当成当前连接状态。
右键菜单中的编辑功能用于核对服务器地址、服务端端口、用户标识、传输方式和 TLS 等字段。这些值必须与服务端一致；尤其不要把本地监听端口填进服务器端口。订阅生成的记录被手动修改后，后续更新可能覆盖修改，长期调整应先确认订阅来源的管理方式。
- 设置活动服务器：切换后先观察核心是否正常启动，再进行网页访问测试。已有的长连接可能仍需应用重新建立。
- 编辑服务器：排查时逐项对照服务端资料。VMess 与 VLESS 的字段要求不同，不能只替换协议名称。
- 复制或导出：分享链接可能包含完整认证信息。不要把它放进公开截图、聊天群或问题反馈中。
- 多选操作：删除、测试等批量动作先确认选中范围。删除分组记录前，应保留可恢复的订阅来源。
- 延迟与速度测试：TCP 建连测试不等于代理请求测试，测速也不等于日常应用体验。不同测试结果不要混在一起排序比较。
测试超时不一定表示服务器失效。测试目标不可达、当前 DNS 解析异常或测试方式不匹配，都可能影响结果。先选一条配置明确的记录，结合日志完成实际请求，再决定是否删除。
订阅分组：导入、定向更新与代理更新
订阅分组保存的是配置来源及其管理信息，不是网络线路本身。切换分组标签一般只是筛选可见记录，不应据此判断活动服务器已经改变。建议按来源建立分组，避免把不同账户或不同服务的记录混在一个名称下。
-
建立分组
打开「订阅分组」→「订阅分组设置」，新增分组，填写可识别的备注和服务方提供的完整订阅地址。若界面提供「+」入口，也可从该入口进入新增窗口。
-
确认更新范围
返回主窗口，切到目标分组，在「订阅分组」菜单选择更新当前订阅的操作。首次排查先更新一个分组，确认内容和日志正常后，再更新全部订阅。
-
选择更新方式
来源可直接访问时，使用不通过代理的更新方式；直连失败且已有可用服务器时，先设为活动服务器，再选择通过代理的更新方式。菜单若区分两种操作，应明确选中对应项。
-
核对导入结果
检查列表是否生成记录，查看协议、备注和所属分组，再设置活动服务器。更新后记录变空，应先看更新日志和分组筛选条件，不要立刻连续重复导入。
通过代理更新依赖当前可用的本地代理入口与连接链路，不能凭空修复已失效的订阅。如果一个可用服务器都没有，应先恢复来源的直连可达性，或使用服务方另行提供的有效配置。订阅地址通常带有账户令牌，反馈问题时只提供脱敏后的域名与错误信息。
系统代理与 TUN：先确定流量入口
「设置系统代理」与路由模式解决的是两个问题：前者让遵循系统代理设置的应用把请求交给本地端口，后者决定进入核心后的请求走哪个出口。即使选择了代理出口，如果应用没有把流量交给客户端，修改路由也不会产生效果。
入口选择：先使用系统代理，再按需测试 TUN
系统代理入口
- 在主窗口或托盘菜单的「系统代理」中选择「自动配置系统代理」。
- 适合先验证遵循系统代理的浏览器请求。
- 应用可能采用独立代理配置，需要另外检查。
- Linux 桌面环境下还需确认应用是否读取桌面代理设置。
TUN 入口
- 通过虚拟网络接口接管符合配置的流量，接管范围受路由及排除规则影响。
- 启用前确认当前平台、权限和客户端运行组件满足要求。
- 初次验证时暂停其他同类网络接管工具，减少路由冲突。
- 出现异常先关闭 TUN，回到已验证的系统代理链路。
一次只验证一种入口。入口正常后再调整分流，能区分“请求没有进入客户端”和“进入后出口选择错误”。
路由配置中的直连、代理、阻断是出口决策，不等于界面上的订阅分组。修改路由后，用同一个测试目标重新发起请求，并在访问日志中核对命中的出口标签。不要仅以某个网站能否打开推断整套路由都已生效。
参数设置：先检查监听端口与监听范围
打开「设置」→「参数设置」，优先核对本地监听相关项目。不同版本可能把项目分在不同选项页；以下两张卡是用于说明的配置示例，不是固定默认值，也不是要求直接照填的远程服务器参数。启用混合监听时，同一端口可同时接受 HTTP 与 SOCKS 请求；是否提供该模式，以当前界面为准。
本机访问示例
- 监听地址
- 127.0.0.1
- 示例端口
- 10808
- 入口类型
- 混合监听，需确认已启用
- 允许局域网
- 关闭
本机应用使用实际监听端口；若该端口被占用，应更换空闲端口并同步应用配置。
日志排查示例
- 日常日志级别
- warning
- 临时排查级别
- info
- 测试请求数
- 1 次明确目标的请求
- 排查结束
- 恢复原日志级别
访问日志与错误日志可能分别控制；只有 warning 输出时，看不到每次成功请求是正常现象。
「允许来自局域网的连接」会改变监听范围。仅本机使用时不需要打开；确有共享需求时，还要核对防火墙、访问控制和所在网络的可信程度。监听在所有网络接口上与监听在 127.0.0.1 上的暴露范围不同，不应为了排查单机浏览器而随手放开。
- 端口冲突：先退出重复运行的客户端，再修改本地端口。若浏览器使用手动代理，端口变更后必须同步修改浏览器。
- 核心选择：若设置中提供「Core 类型」或核心相关选项，确认所选核心支持当前配置。v2rayN 是管理界面，V2Ray 与 Xray 是不同核心，不能只看客户端名称判断协议能力。
- 自动启动：登录后启动客户端、自动选择服务器、配置系统代理是不同动作。勾选启动项后仍应重启登录验证实际状态。
- 修改生效：保存后按界面提示重启核心或程序，再看新的启动日志。不要依据保存前的日志判断新配置。
日志面板：按启动、入口、出口顺序读
排查时先记下复现时间，清理面板显示后只执行一个动作，例如切换一次活动服务器或打开一次目标网页。日志面板可能同时显示订阅更新、客户端运行和核心输出；要先区分消息来自哪一层，再判断故障发生在哪里。
| 日志线索 | 常见含义 | 下一步检查 |
|---|---|---|
address already in use | 本地监听地址或端口已被占用 | 退出重复实例，检查实际监听端口 |
connection refused | 目标端口主动拒绝连接 | 分清目标是本地入口还是远程服务，再查地址与端口 |
timeout | 某阶段未在时限内完成 | 结合目标和上下文区分 DNS、连接、TLS 或读取超时 |
no such host | 域名解析失败 | 检查服务器域名拼写、当前网络与 DNS 配置 |
certificate 相关错误 | 证书验证或 TLS 参数可能不匹配 | 检查系统时间、服务端证书与配置要求的服务器名称 |
下面命令用于 Windows 终端中验证一个本地 HTTP 代理入口。仅当实际监听地址、端口与入口类型均符合示例时执行；否则先替换为本机值。这是测试命令，不是实测结果，也不代表对某个服务器性能的保证。
curl.exe --proxy http://127.0.0.1:10808 --head --max-time 15 https://example.com/若命令提示无法连接 127.0.0.1，先检查核心与本地监听，而不是更换远程 DNS。若本地入口已接收请求，再出现远程连接或 TLS 错误，继续检查活动服务器的配置与网络路径。临时增加日志详细程度后，反馈前删去订阅令牌、用户标识及其他认证内容。
常见问题：列表正常，但使用结果不符合预期
已经点了服务器，浏览器为什么还是直连？
先右键目标行执行「设为活动服务器」，再检查「系统代理」→「自动配置系统代理」的状态。若浏览器使用独立代理或扩展控制代理，应核对浏览器自己的入口设置；单击选中行并不完成这些操作。
订阅更新显示成功，列表怎么还是空的？
先切回全部分组并清除搜索筛选，再确认正在查看刚更新的分组。若仍无记录，查看更新日志是否有解析失败；来源返回了网页或不兼容内容时，网络下载成功也不等于服务器配置导入成功。
延迟有数字，为什么网页打不开？
核对测试类型。TCP 建连成功只能说明相应连接阶段可达，不能证明认证、传输路径和 TLS 配置全部正确。设置该服务器为活动项后，执行一次实际请求，按同一时间点查看核心报错。
退出客户端后，浏览器反而无法联网？
重新打开客户端，在「系统代理」中执行「清除系统代理」后再退出，并检查系统网络代理设置。若使用过手动代理，还要删除应用内指向本地端口的配置；本地核心退出后，该端口不再提供服务。
一次完整验证应能回答四个问题：当前活动服务器是哪条、应用请求进入哪个本地端口、核心选了哪个出口、日志中的失败发生在哪个阶段。记录这四项后再调整设置，比同时更新订阅、切换核心和开启 TUN 更容易定位原因。