v2rayN 使用教程
导入订阅 → 选择代理模式 → 连接 → 验证是否生效。先完成普通代理连接，再考虑 TUN 与自定义规则。
开始前：客户端与订阅地址
本页按约十分钟的基础操作流程编排；实际用时取决于安装状态与网络情况。先从安装包页面选择适合设备的客户端，完成安装并打开主界面。准备一条由服务提供方提供的有效订阅链接。客户端负责读取配置与建立连接，本身不会自动生成可用的服务器账户。
订阅链接通常包含访问凭据，应按账户信息保管。复制时只取完整地址，不要连同说明文字、空格或换行一起粘贴。不要把地址贴到公开讨论区，也不要把包含地址的设置截图直接分享。若暂时没有订阅，先获取有效配置再继续；反复点击更新不能补齐缺失的账户信息。
首次操作只保留一个代理客户端运行，记录当前网络是否能正常访问常用页面。后续每次只改一类设置，出现问题就能回到上一状态。暂时不改 DNS、不导入陌生路由模板，也不启用 TUN，先把最短的连接路径跑通。
01 导入订阅：先让列表出现配置
订阅导入分成“保存地址”和“拉取内容”两件事。保存成功只代表客户端记住了地址；必须再执行更新，服务器列表才会出现可选择的条目。这里先检查内容是否被读取，不急着判断服务器能否连接。
v2rayN：新建订阅分组并更新
打开顶部“订阅分组”菜单，进入“订阅分组设置”，选择添加。给分组填写容易识别的备注，例如“日常订阅”，再把完整链接粘贴到订阅地址栏。首次配置保留其他默认项，尤其不要先填“服务器过滤（正则）”，否则过滤条件可能把刚拉取的条目全部隐藏。保存设置并返回主窗口。
再次打开“订阅分组”菜单，选择“更新订阅（不通过代理）”或具有同等含义的更新选项。首次尚未建立代理连接时，先尝试当前网络直接更新。等待操作结束，查看底部日志是否提示读取成功，再切换到刚建立的分组，确认列表中出现服务器条目。不要只看“全部”分组，因为其中可能混有以前导入的配置。
若直接更新失败，先核对地址是否复制完整、账户是否仍有效，以及当前网络能否访问订阅服务。只有已经存在可用代理连接时，才尝试“通过代理更新”。不要把“通过代理”理解成修复所有订阅错误的开关：没有可用连接时，它仍然无法完成请求。进一步处理见常见问题中的订阅更新排查。
v2rayNG：添加分组后拉取订阅
打开侧栏里的“订阅分组设置”，通过添加按钮新建一项，填写备注与订阅地址后保存。回到主界面，从右上角菜单执行“更新订阅”；如果界面提供当前分组与全部订阅两种更新范围，首次可选择刚建立的分组。更新结束后切换到该分组，检查是否出现服务器条目。
“从剪贴板导入”更适合已有单条分享配置的情况，不应把每一种订阅地址都当成单个服务器链接导入。若粘贴后出现解析错误，返回订阅分组设置添加地址，而不是连续重复导入。两类链接的区别在于：订阅地址用于拉取配置集合，单条分享链接用于描述某一项连接配置。
到这里，成功标志是对应分组里能看到服务器配置。这不等于已连接，也不表示列表中的每一项都可用。先保留订阅带来的原始参数，不手动改端口、传输方式或 REALITY 相关字段，接下来设置流量进入客户端的方式。
02 选择模式：入口与路由分开看
系统代理决定请求怎样进入客户端；路由规则决定进入后走哪个出站。两者不是同一个开关。
v2rayN：先用普通系统代理
在主窗口底部状态栏找到“系统代理”和“路由”相关选项；部分界面也可从托盘图标的右键菜单打开。首次连接采用普通系统代理方式，暂时保持“启用 Tun”关闭。在路由选项中，选择内置的“绕过局域网及大陆地址”或含义相近的预设；若版本命名不同，先阅读预设说明，确认它包含所需的直连与代理规则。
系统代理主要影响遵循系统代理设置的应用，例如使用默认网络设置的浏览器。它不是把设备上的所有连接都强制接管。某个应用仍然直连时，先检查它是否有独立的代理设置，不要立即认定服务器失效。后续确有接管更多应用流量的需要，再按照进阶配置手册处理 TUN 与权限。
“全局代理”通常是路由层面的选择，表示将进入客户端的常规请求统一交给代理出站，并不等于所有应用都会自动进入客户端。基础连接排查时，可以短暂使用该模式与分流模式对照；确认连接正常后，切回符合日常需要的预设。不要为了一个页面的问题同时改系统代理、路由和 DNS。
v2rayNG：保留默认路由，等待 VPN 授权
v2rayNG 通常通过 Android 的 VPN 接口接收应用流量，而不是要求逐个应用填写本地代理端口。首次操作先保留客户端默认路由，不启用自定义规则，也先不设置分应用代理。若以前设置过只代理部分应用，应检查测试用浏览器是否在接管范围内，否则连接已经启动，浏览器却可能没有经过客户端。
同一时间只保留一个需要占用系统 VPN 接口的工具。其他 VPN 服务或使用该接口的网络工具可能与客户端冲突。此时先停止其他连接，再继续下一步；不要把“VPN 已启动”当成远端服务器一定可用的证据，它只说明本机的流量入口已经建立。
本步骤完成后，应能说清当前方案：桌面端用系统代理接收浏览器请求，安卓端用 VPN 接口接收选定应用的请求；路由暂时保持内置规则。接下来再指定实际使用的服务器并启动连接。
03 启动连接：选中服务器再看日志
服务器列表里的“高亮行”和“活动服务器”不一定是同一状态。有些界面单击只是选中条目，仍需执行设为活动服务器的操作。先确认实际生效的配置，再启用流量入口，避免检查了一个条目，却用另一个条目发起连接。
v2rayN：设置活动服务器并启用系统代理
在订阅分组内选择一项服务器，双击条目，或通过右键菜单选择“设为活动服务器”。观察活动标记或主窗口状态是否随之变化。如果当前版本支持连接测试，可将结果作为筛选参考，但不要只依据测试结果判断最终可用性：测试目标与浏览器实际访问的目标可能不同。
接着将“系统代理”设为“自动配置系统代理”。选中活动服务器后，v2rayN 通常会启动或重载内核；若当前界面提供启动或重启服务的操作，按界面提示执行。打开日志区域，查看最近的启动记录。没有独立的“连接”按钮并不代表缺少一步，关键是活动配置已加载、内核正常运行、系统代理已指向客户端。
如果日志出现端口占用，先退出其他代理进程，再重启当前客户端；不要一开始就随意修改多个监听端口。如果出现配置解析失败，先重新更新订阅，确认不是手动编辑破坏了参数。如果启动后发生远端超时，则进入下一步做请求验证，区分本机入口问题与远端连接问题。
v2rayNG：点击连接并确认系统请求
回到主界面，点选准备使用的服务器，确认条目的选中标记，然后点击连接按钮。首次启动时，Android 会弹出建立 VPN 连接的系统请求。阅读请求内容，确认发起者是当前客户端后允许。若没有授权，客户端不能通过该接口接管应用流量。
启动后检查主界面的连接状态，以及系统显示的 VPN 状态提示。若刚连接就停止，打开客户端日志查看错误；如果是后台运行一段时间后才断开，先记录断开时机，再到常见问题检查电池优化与后台限制。首次测试保持应用在前台，能减少后台策略对判断的干扰。
现在只确认了客户端已尝试运行。窗口显示“运行中”、系统出现 VPN 标记或订阅更新成功，都不能替代实际访问验证。保持其他参数不动，打开浏览器检查请求是否按预期经过客户端。
04 验证生效：页面结果与日志对照
选择一个你明确预期经过代理的目标页面，用浏览器新建标签页访问。桌面端先使用遵循系统代理设置的浏览器，暂时关闭浏览器内单独接管代理的扩展。安卓端确认浏览器没有被分应用设置排除。尽量打开一个新页面，而不只是查看已经加载的旧标签，避免把缓存内容当成新的网络请求。
先确认流量进入，再确认远端响应
访问页面的同时查看客户端日志。如果当前日志级别记录访问请求，可以按访问时间查找对应域名，并查看连接成功、失败或出站信息。不同内核与日志设置显示的内容不同，没有出现域名记录本身不能直接证明请求没有进入。先确认日志功能与记录级别，再结合浏览器结果判断。
随后访问一个预期直连的常用页面，确认本地网络仍然正常。使用分流模式时，两个页面可能走不同出站，这是预期行为。若需要进一步确认出口地址，可使用可信的网络诊断页面，并与服务提供方说明对照；但一个地址结果只代表该次请求，不能证明设备上所有应用都经过代理。
结果不一致时，按层排查
列表为空，返回订阅步骤。检查分组、订阅地址与过滤条件。此时不应继续调整代理模式，因为客户端还没有可用的连接配置。若列表存在但配置解析失败，重新更新订阅，并确认当前客户端与内核能够识别订阅里的协议及传输参数。
内核已运行，但浏览器请求没有进入，检查流量入口。桌面端确认仍选中“自动配置系统代理”，浏览器没有固定为直连或使用另一套代理。安卓端确认 VPN 连接仍在，测试应用没有被排除。命令行工具和部分应用不会自动遵循系统代理，不适合作为首次基础验证的唯一依据。
请求已经进入，但远端连接失败，检查服务器与网络。先切换同一订阅中的另一项服务器，保持其他设置不变，再访问相同页面。若只有某个目标失败，检查是否为该网站、路由或 DNS 的局部问题；若所有目标都失败，记录日志里的错误类型，到故障排查说明继续定位。分享日志前先隐藏订阅地址、用户标识及其他账户信息。
遇到名称解析错误时，不要立即把所有 DNS 服务器替换成网上找到的地址。先确认普通连接是否可用，再区分本机解析、代理内解析与目标连接路径。DNS、FakeDNS 和自定义路由的完整关系放在进阶配置手册，本页先保持基础配置，避免把排查范围扩大。
结束使用：先恢复网络，再退出
桌面端停止使用时，先把系统代理切换为“清除系统代理”，再退出 v2rayN。仅关闭主窗口可能只是最小化到托盘，并不一定结束程序。若客户端意外退出后浏览器无法访问，而其他网络功能正常，先检查系统代理是否仍指向已经停止的本地端口。
安卓端在 v2rayNG 内点击停止连接，确认系统 VPN 状态提示已消失，再退出界面。若曾设置系统的始终开启 VPN 或阻止未经过 VPN 的连接，停止后的联网行为还会受这些系统选项影响，应回到相应设置检查，而不是反复删除订阅。
完成验证后，保留一套已经跑通的基础配置。以后增加分应用代理、订阅过滤或 TUN 时，一次只启用一项，并重复本节的页面与日志对照。需要更换客户端时查看选型指南；需要定制分流时再进入进阶配置，不用在首次连接时把所有高级选项同时打开。