v2rayN 快速上手
订阅导入与连接验证

开始前：确认订阅与网络

准备一条从可信来源获得、仍在有效期内的订阅地址，并确认设备能够正常访问普通网页。客户端是读取配置和转发流量的工具，安装完成不等于已经具备可用服务器。只有客户端、没有订阅或单条服务器配置时，应先取得有效配置，再继续以下步骤。

订阅地址与单条分享链接用途不同：订阅地址通常用于更新一组配置，单条分享链接通常描述一台服务器。不要因为两者都能复制，就把它们粘贴到同一个入口。订阅地址还可能包含访问凭据，操作时不要把完整地址、二维码或配置截图发到公开讨论区；需要求助时，先遮住地址中的令牌、账号信息与服务器认证字段。

首次操作前，先退出其他正在接管流量的代理或 VPN 工具，保留当前网络环境，不急着更换 DNS、路由文件或内核。这样后续若出现问题，可以判断是本次配置带来的变化。遇到不熟悉的“订阅”“出站”“路由”等术语，可先查术语手册；本页只保留完成连接所需的设置。

第一步：导入订阅并更新配置

v2rayN：新增订阅分组

打开 v2rayN，在主窗口顶部找到“订阅分组”，进入“订阅分组设置”或名称相近的管理窗口，选择添加。备注填写便于识别的名称，例如“日常订阅”；地址栏粘贴完整订阅地址。检查开头和结尾没有多余空格、换行或聊天工具附带的标点，再保存设置。此时只是登记了订阅来源，服务器列表不一定会立即出现内容。

回到主窗口，打开“订阅分组”菜单，执行更新订阅。若菜单区分普通更新和通过代理更新，首次连接通常先尝试普通更新，因为当前还没有建立可用代理。等待本次操作结束，再查看订阅提示与服务器列表。成功后，列表应出现该订阅提供的配置；只有一个分组名称、列表仍为空，不能视为已经导入完成。

列表有内容后，先看配置名称与所属分组，确认它们来自刚刚添加的订阅。暂时不用批量修改传输参数，也不必先给每条配置测速。如果更新失败，先确认订阅是否过期、复制是否完整，以及当前网络是否能访问订阅服务。反复点击更新不会修复无效地址，也可能触发服务端的访问限制。

v2rayNG：订阅设置后返回列表更新

在 v2rayNG 主界面打开菜单，进入“订阅设置”，点击添加按钮，填写备注与订阅地址并保存。返回主界面后，在菜单中选择“更新订阅”或“更新当前组订阅”，等待结果。更新结束后，主列表应能看到服务器条目；如果仍停留在订阅编辑页面，应先返回主列表，而不是在地址栏继续重复粘贴。

如果拿到的是以 vmess://、vless:// 等形式开头的单条分享链接，应使用客户端的“从剪贴板导入”功能，而不是新增订阅地址。导入二维码也是同样的区别：二维码承载什么内容，就按对应配置类型处理。不要把订阅地址当成服务器地址填写到手动配置窗口。

第二步：选择代理模式与路由

v2rayN：先使用系统代理

在 v2rayN 的主窗口底部或托盘右键菜单中找到“系统代理”，选择“自动配置系统代理”。这个操作会将系统代理设置指向客户端的本地监听地址，让遵循系统代理设置的应用把请求交给 v2rayN。不要选成“清除系统代理”后又以为客户端已经接管了浏览器，也不要在首次配置时同时运行另一款修改系统代理的工具。

接着找到路由选择入口。初次使用可以从“绕过大陆”一类预设规则开始，但应理解它只是按规则选择出站，并非所有连接都交给远端服务器。若需要确认某个目标确实经过代理，可在验证阶段临时选择将流量送往代理出站的全局路由预设，测试后再恢复日常规则。不同版本的预设名称可能不同，应查看规则含义再选择。

系统代理与路由解决的是两件事：系统代理决定应用是否把请求交给客户端，路由决定客户端收到请求后走哪个出站。把路由设为全局，并不会让所有程序自动遵循系统代理。命令行工具、部分游戏或自带网络设置的软件仍可能直接连接，不能只凭模式名称判断它们已经走代理。

这次先保持 TUN 关闭。TUN 会涉及虚拟网络接口、权限与 DNS 接管，适合在基础连接验证通过后再配置。也不要为了“保险”同时打开系统代理、TUN 和多个浏览器代理扩展；多层接管容易掩盖问题。确实需要接管不遵循系统代理的应用时，再到全平台使用文档查看对应平台的 TUN 设置。

v2rayNG：确认 VPN 模式与应用范围

v2rayNG 通常通过安卓的 VPN 接口接管流量，不需要照着桌面教程寻找“自动配置系统代理”。在设置中确认使用的是 VPN 模式，而不是仅提供本地代理端口的模式。若此前修改过“分应用代理”，首次验证建议先关闭该选项，让测试应用处于接管范围内；验证成功后，再按实际需要选择应用。

随后查看路由设置，保留能够理解的预设即可。若开启了分应用代理，务必看清当前是“仅选中应用使用代理”，还是“选中应用绕过代理”，两种逻辑相反。此处暂不修改远程 DNS 或自定义路由规则。模式确认后，下一步才是选择具体服务器并启动连接。

第三步：选择服务器并启动连接

v2rayN：设为活动服务器并检查日志

在服务器列表中选择一条来源明确、仍可使用的配置，通过右键菜单设为活动服务器；有些版本也支持双击条目完成选择。观察列表中的活动标记，确认当前使用的是这条配置，而不是仅仅把鼠标选中行移到了它上面。随后按界面提示启动或重载内核；部分版本在切换活动服务器时会自动完成这一步。

打开主窗口的日志区域，等待内核启动结果。正常情况下不应连续出现启动失败、配置解析失败或端口被占用等错误。窗口能打开、托盘图标还在，只能说明图形界面正在运行，不能单独证明内核已经正常工作。若日志明确提示失败，应先处理该错误，不要跳到浏览器里反复刷新。

遇到本地端口被占用时，先确认是否同时打开了第二个客户端进程，或仍有另一款代理工具运行。关闭冲突程序后重试；需要改端口时，应同步检查应用中手动填写的代理端口。不要假定本地监听端口在每个版本、每台设备上都相同，以当前客户端设置显示的值为准。

v2rayNG：启动并允许系统 VPN 请求

在 v2rayNG 主列表中点选要使用的服务器，确认选中标记后，点击右下角的启动按钮。首次启动时，安卓通常会弹出 VPN 连接请求，核对请求来自 v2rayNG 后允许授权。拒绝授权会导致接管无法建立；反复切换服务器也不能代替这项系统权限。

启动后检查应用内状态，以及系统状态栏或系统 VPN 设置中的连接提示。不同设备的图标样式有所区别，以系统实际显示为准。若另一款 VPN 工具正在工作，先停止它再重新启动 v2rayNG。此时即使系统已经显示 VPN 运行，也仍需验证远端服务器与网页请求，因为本地接管成功不等于远端连接成功。

两类客户端都可以先用一条配置完成验证。若遇到超时，先保存错误提示，再换另一条已知可用的配置做对照；如果所有配置都出现相同错误，检查订阅有效期、设备时间是否自动同步、当前网络状态以及内核日志。每次只改一个条件，记录结果，比同时更换协议、DNS 和路由更容易定位原因。

第四步：验证网页与应用是否生效

先查运行状态，再发起真实请求

保持客户端运行，打开浏览器的新标签页，访问一个需要通过所选代理规则连接、且当前可用的 HTTPS 页面。不要只反复打开已经浏览过的页面，因为缓存可能让页面看起来正常，实际却没有建立新连接。再访问一个应当直连的普通页面，确认基础访问没有被当前设置破坏。

同时查看客户端日志或连接记录。部分版本只有在相应日志级别下才会显示目标请求，因此“没看到访问记录”本身不能直接判定失败；但若请求时出现域名解析失败、连接超时或认证失败，可以据此缩小范围。认证错误优先检查服务器配置与订阅状态，解析错误再检查 DNS，不要把所有问题都归为网络速度。

需要确认出口时，可以在连接前后使用同一个可信的出口地址查询页面作对照。比较时要让查询目标匹配代理规则，否则分流模式下显示本地网络出口可能正是预期行为。出口地址变化也不能证明所有应用都被接管，它只能说明这次查询请求的路径发生了变化，仍需测试实际要使用的软件。

浏览器正常后，检查目标应用

在 v2rayN 桌面端，如果浏览器能访问而命令行或其他应用失败，先检查该应用是否遵循系统代理。浏览器安装了代理扩展时，也要确认扩展没有覆盖系统设置。终端的代理环境变量与系统代理通常不是同一个配置入口；不要把“浏览器成功”直接等同于“所有软件成功”。需要继续处理这类差异时，可阅读浏览器与命令行分开排查的方法。

在 v2rayNG 安卓端，如果只有个别应用无效，返回分应用代理设置检查范围，并确认设备上没有其他应用替换当前 VPN 连接。如果前台使用正常、锁屏一段时间后断开，再检查系统对 v2rayNG 的后台运行和电池限制。不要在首次连接尚未成功时就修改所有省电选项，先区分“始终无法连接”和“后台运行后断开”。

测试正常退出，保留可重复的配置

确认使用正常后，再测试一次停止流程。v2rayN 使用系统代理时，退出前先选择“清除系统代理”，再关闭客户端；这样浏览器不会继续把请求发送到已经停止的本地端口。若客户端提供退出时恢复系统代理的选项，也应实际测试一次，不能仅凭勾选状态推断结果。v2rayNG 则点击停止按钮，确认系统 VPN 连接已经结束。

停止后再打开普通网页，确认原有网络访问恢复正常，然后重新启动客户端复测。如果“启动能用、停止能恢复、再次启动仍能用”，基础配置就形成了完整闭环。此时保留当前订阅分组、活动配置与路由选择，再逐项增加分应用代理或自定义分流。每改一项都重复同样的验证，出现问题就能回到上一组正常设置。

下一步：按实际问题查文档

如果已经可以正常使用，到这里即可，不必为了配置完整而继续打开所有高级选项。想弄清系统代理与 TUN 的差异、路由匹配或 DNS 的作用，先查术语手册；需要处理安装权限、平台特有设置与完整排查流程，再读全平台安装配置文档。

如果本地显示运行正常但网页仍然无法打开，保留当前配置，按节点可用性、系统时间、DNS、路由与本地端口的顺序逐项检查。可对照已连接却无法打开网页的排查清单继续操作。排查时只提供经过遮盖的错误信息，不公开完整订阅地址或服务器凭据。