适合第一次使用 v2rayN、已经拿到订阅但还没跑通连接的用户。按安装、导入、选节点、接管应用、定位故障的顺序操作；先让一个浏览器通过一个节点访问成功，再调整分流或 TUN。文中以中文桌面界面为例，菜单随版本可能略有差异，端口一律以本机显示值为准。
一、v2rayN 是什么，下载后还需要准备什么？
v2rayN 是客户端，不是节点服务。它负责管理服务器配置、调用代理内核，以及提供系统代理和路由设置。下载客户端不会自动获得可用服务器；还需要有效订阅，或者包含服务器地址、端口、认证与传输参数的节点分享链接。
桌面系统使用 v2rayN。安卓端则有采用 Xray 内核的 v2rayNG，以及采用 V2Fly 内核的 v2flyNG。协议能否使用取决于对应内核及版本，不能因为都能导入订阅，就认定所有节点都兼容。尤其是 VLESS + REALITY，应确认客户端内核明确支持。
- Windows：在「设置」→「系统」→「系统信息」确认系统类型，按处理器架构选择安装包。
- Linux：可运行
uname -m；x86_64通常对应 x64，aarch64通常对应 ARM64，再按发行版选择包格式。 - macOS：在「关于本机」查看芯片信息，区分 Apple 芯片与 Intel 处理器。
- 首次启动：压缩包先完整解压，再运行主程序；需要安装的包按系统提示安装。不要只从压缩包里拖出一个可执行文件。
二、订阅链接怎么导入，分享链接又放在哪里？
订阅地址通常用于获取一组节点；以 vmess:// 或 vless:// 开头的内容则通常是单个节点分享链接。两者入口不同。订阅地址应保存到订阅分组，单节点链接则通过剪贴板导入，不能只凭链接很长就判断是哪一种。
-
复制订阅
从服务提供方复制完整订阅地址，检查首尾没有引号、空格或换行。地址里的令牌属于访问凭据，不要发到公开群聊。
-
新增分组
打开「订阅分组」→「订阅分组设置」，点击新增按钮，填写备注与地址，再保存。备注可以写成“日常使用”，便于识别。
-
更新节点
在「订阅分组」菜单选择「更新全部订阅（不通过代理）」。首次配置尚无可用代理时，先尝试直接获取。
-
检查列表
切换到对应分组，确认出现服务器条目。只有分组名称、没有节点，说明配置保存了，但订阅尚未成功获取或解析。
如果拿到的是单节点分享链接，先复制完整内容，再用主界面「服务器」→「从剪贴板导入批量 URL」，也可使用界面提示的 Ctrl + V。导入成功后仍需选中节点、设为活动服务器，并配置应用的代理入口。
三、订阅更新失败，应该反复重试还是换更新方式？
先读错误，再决定是否切换代理获取。“不通过代理”表示客户端直接请求订阅地址；“通过代理”需要现有节点已经可用。第一次导入时若没有可用节点，反复选择通过代理通常只会形成循环依赖。
| 表现 | 优先检查 | 下一步 |
|---|---|---|
| 请求超时 | 本地网络与订阅域名可达性 | 已有可用节点时，再尝试通过代理更新 |
| HTTP 401 或 403 | 令牌是否失效、服务是否到期 | 回服务管理页重新复制地址；403 也可能来自访问限制 |
| HTTP 404 | 地址路径是否完整 | 重新复制，不手动删改路径参数 |
| 获取成功但解析失败 | 返回内容与订阅格式 | 确认不是登录页、错误页或仅供其他格式使用的入口 |
订阅链接相当于访问钥匙。排查时可以记录错误码、发生时间和客户端日志，但截图要遮住完整 URL、用户标识与认证字段。不要为了测试，把订阅交给来源不明的在线转换页面。
四、导入很多节点后，怎样选中并确认当前节点？
在服务器列表选中一个节点，右键选择「设为活动服务器」；以当前活动标记和启动日志为准。仅仅高亮一行，不一定代表已经切换。切换后检查日志是否重新加载配置，是否出现认证、证书或传输连接错误。
- 先选一个：
- 再测延迟：右键菜单中的延迟测试可帮助筛选，但 TCP 建连成功只说明端口能够建立连接，不代表认证和网页请求都成功。
- 最后测访问：使用真实请求测试，并在浏览器打开目标网页。延迟数值不是下载速度，也不能单凭数值最低就认定体验最好。
例如，一个节点 TCP 延迟为 80 毫秒，却在访问时提示认证失败，仍然不能使用；另一个节点延迟为 150 毫秒，但请求正常完成，反而更适合继续排查本地设置。这些数值是判断示例，不是本站实测结果。
五、系统代理选哪项，“不改变”和“清除”有什么区别？
第一次测试浏览器，优先选择「自动配置系统代理」。可从托盘图标右键菜单进入「系统代理」选择对应选项。它会将系统代理指向客户端的本地监听端口，但是否使用这个入口，仍取决于应用是否读取系统代理设置。
自动配置系统代理
推荐让读取系统代理的应用连接到 v2rayN 的本地代理入口。首次测试时更容易把浏览器流量与客户端日志对应起来。
适合:首次配置、浏览器日常访问
清除系统代理
清除系统中的代理指向，不等于关闭内核。手动设置了代理地址的应用，仍可能继续连接客户端。
适合:恢复直接访问、退出前排查残留代理
不改变系统代理
保持系统当前设置，不主动写入或清除。如果之前已经设置了代理，选择这一项不会自动恢复直连。
适合:手动管理应用代理、保留已有系统设置
Linux 桌面环境与应用对系统代理的支持存在差异；终端工具通常还需要自身参数或环境变量。不要用“系统代理已开启”推断所有程序都已接管。若浏览器装有代理扩展，也要检查它是否覆盖了系统设置。
六、本地地址和端口怎么填，为什么不是服务器端口？
应用连接的是本机代理入口，内核再把请求发给远端服务器。远端节点的 443 等端口用于客户端到服务器的连接，不能直接填进浏览器的本地代理设置。先在「设置」→「参数设置」中查看本地监听端口；具体字段随版本和入站类型有所不同。
应用使用 HTTP 代理
- 地址
- 127.0.0.1
- 端口示例
- 10808
- 前提
- 该端口接受 HTTP 代理请求
仅在本机确实启用 HTTP 或混合入站时使用，端口照本机配置填写。
应用使用 SOCKS5
- 地址
- 127.0.0.1
- 端口示例
- 10808
- 前提
- 该端口接受 SOCKS5 请求
两卡共用端口仅用于说明混合入站；若本机分开监听，应分别填写对应端口。
若日志出现 address already in use，说明监听地址或端口已被占用。先关闭重复运行的客户端实例，再检查其他程序；修改本地端口后，手动配置代理的应用也必须同步修改。不要为了让本机浏览器连接，随意把监听地址开放到所有网卡。
七、显示已连接，却打不开网页，按什么顺序检查？
界面的运行状态通常表示本地内核已经启动，不是对所有网站的连通保证。问题可能出在应用没有走代理、节点认证失败、域名解析失败，或者路由把请求送到了错误出口。按链路从近到远检查，比一次改十个开关更有效。
-
确认本地入口
查看日志是否成功监听本地端口。若有端口占用、配置解析失败或内核退出，先处理这些错误。
-
确认应用接入
开启自动配置系统代理，暂时关闭浏览器代理扩展；或在应用中明确设置本地 HTTP、SOCKS5 入口。
-
确认请求到达
刷新网页并查看连接日志。若当前日志级别记录访问，应能找到对应请求；没有记录时，先检查应用是否绕过代理。
-
确认远端响应
认证失败优先检查订阅与节点信息；超时优先检查线路和服务器状态；证书错误先检查系统时间与服务端证书配置。
-
单独验证解析
若日志明确提示域名解析失败，再检查 DNS 设置。不要把所有连接超时都归因于 DNS，也不要靠关闭证书验证处理连接问题。
系统已提供 curl 时，可以绕过系统代理设置，直接测试指定本地入口。下面命令假设本地 HTTP 或混合端口为 10808，目标使用本站页面；它只验证这一条请求路径，不代表所有业务都已正常。
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://v2raywrt.com/若命令成功而浏览器失败，优先检查浏览器自身代理、扩展和缓存连接；若提示无法连接本地端口，先检查监听地址与内核状态。若已经连上本地入口，随后远端超时，再换一个确认可用的节点做对照。
八、路由选全局还是分流，国内网站变慢怎么办？
日常使用通常从客户端提供的分流预设开始。系统代理决定应用如何把请求交给客户端，路由规则决定客户端收到请求后走代理、直连还是阻断。这是两个不同环节：系统代理开启，不等于所有目标都一定走远端节点。
- 国内站点变慢：查看当前路由预设是否把这些域名交给代理出口；先恢复适合本地网络的分流预设，再测试。
- 只有某个站点失败：查看域名规则、规则顺序与实际命中的出口，不要立即重置全部配置。
- 临时全局测试：可短暂选择使待测流量走代理的路由模式。测试结束恢复原预设，避免把临时诊断设置当长期配置。
- 规则数据库错误：如果日志提示找不到 GeoIP 或 GeoSite 数据，再检查规则文件与更新状态；不要只修改节点协议。
分流结果还可能受 DNS 与域名识别方式影响。测试时固定同一个节点、同一个目标，每次只改一个路由选项，并重新建立连接；浏览器已有的长连接可能暂时保留原来的出口，造成“设置没生效”的错觉。
九、什么时候需要 TUN，开启后为什么反而断网？
TUN 通过虚拟网络接口接管流量，适合不读取系统代理、又不方便单独设置代理的应用。它不是速度增强开关，也不能修复失效节点。新手应先在普通系统代理模式下确认节点可用，再引入 TUN，减少排障变量。
- 开启前：记录当前系统代理和路由设置，关闭其他会修改默认路由的网络工具，确认系统允许创建虚拟网络接口。
- 权限要求：按客户端与系统提示授权；不要为了省事，给不相关程序长期提升权限。
- 开启后：分别测试网页、原本不跟随系统代理的应用和局域网服务。网页能开，不代表 UDP 或局域网访问一定正常。
- 出现断网：先关闭 TUN，确认基础网络恢复，再检查虚拟接口、DNS 接管和路由冲突；不要同时改订阅、内核与全部 DNS 参数。
十、关闭 v2rayN 后不能上网，怎样恢复并保留排障信息？
常见原因是系统仍指向本地代理，但客户端已退出，本地端口不再监听。先重新打开 v2rayN，在「系统代理」中选择「清除系统代理」，再正常退出。这里应选“清除”，而不是“不改变”。如果开启过 TUN，也应先关闭并等待网络恢复。
- 检查系统代理：Windows 可到「设置」→「网络和 Internet」→「代理」查看残留的手动代理或设置脚本；受单位策略管理的设备不要擅自修改。
- 检查应用设置：浏览器扩展、终端环境变量及应用手填的
127.0.0.1代理不会必然随系统代理一起清除，应分别恢复。 - 重新建立连接：重启受影响的应用后测试直接访问；若仍失败，再检查网络连接、系统 DNS 与虚拟接口状态。
- 保留有效信息：记录操作系统、客户端版本、内核类型、错误发生时间，以及一小段相关日志。隐藏订阅令牌、用户标识和服务器认证信息。
下次遇到问题，可按“本地网络 → 内核监听 → 应用代理 → 节点连接 → 路由与 DNS”的顺序复查。每次只改变一个条件，并记录改变前后的结果。这样才能分清是客户端设置问题、服务端问题，还是特定应用的接入方式不同。