QUICK SETUP / 首次配置

v2rayNG 与 v2rayN 使用教程

订阅导入 → 代理模式 → 连接 → 验证。先跑通一条访问链路，再动进阶参数；检修台上一次只拧一颗螺丝。

开始前，请从下载中心安装适合系统的客户端，并准备服务提供方给出的有效订阅地址。客户端是配置和连接工具，安装完成不会自动获得服务器。需要有可用的订阅或单条配置，后面的连接步骤才有目标。

把订阅地址当作账户凭据保存：不要贴进公开评论、共享截图或未经确认的在线转换工具。确认设备日期和时间正确，网络可以正常访问订阅服务。首次配置先保留默认设置，不同时修改 DNS、传输参数和路由；这样出错时能知道是哪一步出了问题。

STEP 01 / SUBSCRIPTION

导入订阅：保存地址，再更新清单

先分清拿到的内容。订阅地址通常是以 https:// 开头的网址，客户端请求它以后才能取得节点清单；vmess://、vless:// 等开头的内容通常是分享链接，直接描述一个配置。两者入口不同。不要仅凭“都是一串链接”就塞进同一个输入框，也不要把服务商的登录页面地址当成订阅地址。

v2rayN：在「订阅分组设置」中新增分组

打开主窗口，进入顶部「订阅分组」菜单，选择「订阅分组设置」，再点击「添加」。在备注栏填写方便辨认的名称，在地址栏粘贴订阅地址。检查前后是否夹着空格或换行，确认复制的是完整地址，再保存。备注只负责显示，不参与认证；不要为了让备注好看而修改地址里的参数。

回到主窗口，从「订阅分组」菜单执行更新订阅。尚未建立可用连接时，优先选择名称带「不通过代理」的更新项，让订阅请求使用当前普通网络。不同版本可能提供当前分组和全部分组两种范围，首次只更新刚添加的分组即可。更新完成后，切换到对应分组，应该能看到服务器记录，而不只是一个分组名称。

v2rayNG：从侧边菜单添加订阅

打开左上角侧边菜单，进入「订阅分组设置」，点右上角添加按钮。填写备注和订阅地址后保存，再返回主界面，从右上角菜单执行「更新订阅」。如果版本把更新项区分为通过代理和不通过代理，第一次优先尝试不通过代理。等待操作完成，确认配置列表中出现条目，再进入下一步；只保存地址还不等于已经取得配置。

如果得到的是单条分享链接，则先复制完整内容。v2rayN 在「服务器」菜单使用「从剪贴板导入分享链接」；v2rayNG 在主界面右上角菜单使用「从剪贴板导入」。导入后核对备注、服务器地址和端口是否存在。分享链接没有订阅的自动更新语义，后续地址发生变化时，需要重新导入或手动修改。

至此，配置已经进入客户端，但浏览器流量还不一定会进入它。接下来处理代理入口与路由，这两件事要分开看。

STEP 02 / PROXY & ROUTING

选择代理模式：入口与分流分开设置

“系统代理”和“全局路由”不是同一个开关。系统代理告诉遵循该设置的应用把请求交给客户端；路由规则决定收到的请求走代理、直连还是其他出站。只选全局路由，却没有让应用接入客户端，流量仍可能绕开它。反过来，系统代理已经启用，但路由命中直连，看到直连访问也不一定是配置失败。

v2rayN：先用系统代理跑通浏览器

在主窗口底部或托盘菜单找到「系统代理」，选择「自动配置系统代理」。它会把系统代理入口指向客户端的本地监听地址。保持客户端运行，并确认浏览器没有被扩展或自身的代理设置覆盖。不是所有应用都遵循系统代理，因此首次验证先用常规浏览器，不拿一个自带联网逻辑的应用作为唯一判断依据。

然后找到「路由」选择项。日常使用可以先选预设中对应「绕过大陆」的规则，具体名称以当前版本列表为准。这类规则通常让局域网及匹配的大陆地址直连，其他请求交给代理出站。需要临时排查分流影响时，可以短暂切换到全局代理路由；测试结束再恢复原来的预设，不必把全局当作所有场景的固定答案。

v2rayNG：确认 VPN 模式与路由预设

在侧边菜单进入「设置」，确认使用「VPN 模式」。这个模式通过系统 VPN 接口接入设备流量，适合首次上手。若改成仅提供本地代理入口的模式，其他应用还需要自行配置连接入口，操作链路会变长。回到路由相关设置，选择「绕过局域网及大陆地址」对应的预设；版本之间可能把路由入口放在单独菜单中。

如果此前调整过应用分流，请同时查看是否只有部分应用被纳入 VPN，或者测试浏览器被排除了。首次验证时保持测试应用能够进入 VPN。这里的分应用范围与域名、IP 路由是不同层：应用一开始就没进来，后面的路由规则再精细也接不到请求。

本步先不改「Mux 多路复用」、DNS 地址或嗅探参数。尤其不要把其他教程中的某个开关当成通用修复按钮：传输、内核和服务端配置不同，适用条件也不同。需要了解 TUN、DNS 和规则优先级时，转到全平台安装配置文档继续阅读。当前只要确定流量入口与日常路由，就可以开始连接。

STEP 03 / CONNECT

连接：选活动服务器，检查运行状态

回到配置列表，先选一个订阅仍然有效、字段完整的服务器。备注里的地区或名称只是识别信息，不代表当前一定可用。客户端的测试结果也只能辅助判断：某种测试请求没有响应，不足以直接证明所有实际访问都会失败。首次连接优先用服务提供方明确标注可用的配置，避免一边排查客户端，一边猜服务器是否存在。

v2rayN：设为活动服务器并确认内核运行

在服务器列表中右键目标条目，选择「设为活动服务器」。确认活动标记已经移动到这条记录；单纯把鼠标点在某行上，有时只是选中表格行，并没有切换实际使用的服务器。切换以后，客户端通常会重新生成运行配置并启动或重载内核。保持主窗口或托盘中的客户端进程运行，再确认「系统代理」仍处于「自动配置系统代理」。

观察窗口下方的信息或日志区域。先看有没有明确的配置解析错误、端口占用或内核启动失败；这些错误说明请求还没到远端，换服务器不一定有用。端口占用时，先退出另一套正在运行的代理客户端，再让 v2rayN 重新加载。不要直接编辑客户端生成的临时配置文件，它可能在下一次切换时被覆盖。

本教程暂时不启用 TUN，也不要求用管理员权限启动。系统代理足够完成浏览器的首次验证。若你已经开启 TUN，则先确认不会与其他网络工具同时接管流量；无法判断时，回到本教程的系统代理路径建立基线，后续再单独配置更广的应用接入范围。

v2rayNG：点选配置，再允许 VPN 请求

在主界面点选目标配置，确认选中标记对应的是计划使用的条目，然后点击右下角连接按钮。第一次使用时，系统会弹出 VPN 连接请求，确认应用名称是 v2rayNG 后允许。取消授权会让客户端无法建立 VPN 接口，即便配置列表看起来完全正常，也不能靠继续更新订阅解决。

连接后，观察按钮状态、客户端状态提示，以及系统状态栏是否出现 VPN 标识。VPN 标识只说明本地接口已经建立，不说明远端服务器已经完成所有连接。若刚启动就自动停止，打开日志，先找第一条具体错误；后续成串的失败可能只是同一个原因的重复表现。分享日志前遮住订阅地址、用户标识和服务器凭据。

设备同一时刻通常只能由一个应用占用主要 VPN 接口。如果系统提示已有其他 VPN 连接，先停止正在使用该接口的应用，再返回 v2rayNG 连接。连接成功但锁屏后经常停止时，再检查系统的后台运行和电池限制；首次操作不要先到处关闭省电设置，先确认前台访问能够正常完成。

STEP 04 / VERIFY

验证生效：用实际访问对照日志

打开浏览器的新标签页，访问一个已知可用的 HTTPS 页面，并确认页面能够完成加载，而不只是出现标题。优先选择你熟悉、能够判断是否正常的网站；第一次测试不要使用来源不明的检测链接。也不要用之前一直开着的页面判断，缓存内容可能让断开的连接看起来仍然正常。

只看页面打开还不够。绕过类路由会让一部分请求直连，因此“网页能看”不能独立证明代理出站工作正常。打开客户端日志，在发起新访问时观察有没有对应请求；若当前日志级别不显示每条请求，不要把空白日志直接判成流量没进入，可临时提高日志详细程度辅助检查，完成后恢复日常设置，避免留下过多访问记录。

如果日志显示请求进入客户端，再检查它命中的出站。配置中常见的 direct 表示直连，但出站标签由配置定义，不能只凭一个固定词判断所有客户端。关键是核对当前路由规则与目标地址：本应直连的局域网页面走直连是正常结果，本应走代理的测试访问才适合验证代理链路。

访问失败时，按入口顺序排查

先查配置来源。确认订阅更新成功、服务仍在有效期内、当前活动配置来自正确分组。若服务商刚调整了地址，先更新一次订阅再重试。不要对同一份过期配置连续切换路由；路由不会把失效凭据修成有效凭据。

再查流量入口。桌面确认 v2rayN 仍在运行，系统代理没有被其他工具改写，浏览器没有独立代理扩展抢先处理请求；安卓确认 VPN 仍在连接，测试应用没有被分应用设置排除。如果日志提示连接被拒绝且目标是本地回环地址，优先检查本地监听和客户端进程，而不是远端服务器。

最后查路由和解析。请求已经进入客户端却持续超时，可以换一条已知可用的配置重试，或暂时切换全局代理路由排除规则影响。若日志明确指向域名解析失败，再检查 DNS 设置与网络环境。每次只改一项，记住原值；“DNS、Mux、路由一起改”很容易得到一个能用但无法解释的结果，下次出错又得重来。

完成后，测试停止与恢复

在 v2rayN 中，先选择「清除系统代理」，再退出客户端，避免遵循系统代理的应用继续连接已经停止的本地端口。再次使用时，启动客户端、确认活动服务器，再启用「自动配置系统代理」。在 v2rayNG 中，点击连接按钮停止 VPN；之后重新连接，确认授权和访问仍然正常。这样既检查了启动，也检查了日常退出路径。

验证完成后，可以记下分组备注、活动服务器备注、路由预设和使用的接入方式，不要记录或公开凭据。下次遇到问题先恢复这套已知可用的设置，再逐项测试新配置。订阅更新后节点名称或排序可能变化，重新确认活动配置即可，不必把整个客户端卸载重装。