setup / first connection
v2rayN 配置教程
从订阅导入到连接验证
按固定顺序完成四项操作：导入订阅、选择代理模式、连接配置、验证结果。每一步都说明入口位置、正常状态和进入下一步前需要确认的内容。
before / setup
开始前准备
准备一条有效订阅地址，并确认客户端已经完成安装。首次配置不需要手动编辑 config.json，也不需要先调整高级路由字段。
订阅地址通常由服务提供方给出，它的作用是让客户端读取一组连接配置。复制时应保留完整地址，不要附带前后的空格、换行或说明文字。订阅属于个人配置资料，不适合粘贴到公开页面、截图或聊天记录中。若手头只有单条 VMess、VLESS 或其他分享链接，也可以使用客户端的“从剪贴板导入”入口，但本页以更常见的订阅分组方式为主。
打开客户端后，先观察主界面是否能够正常显示。v2rayN 桌面端通常会看到服务器列表、菜单栏以及窗口底部的状态区域；v2rayNG 安卓端通常会看到配置列表和连接控制区域。此时列表为空属于正常情况，因为订阅尚未写入。若客户端无法启动、窗口打开后立即关闭，或系统提示缺少运行环境，应先返回下载页核对平台与安装包类型，再继续本教程。
首次设置建议暂时保持客户端默认端口、默认 DNS 和默认路由规则。一次只修改一个关键项目，更容易判断问题发生在哪一环。完成本页四步并确认基本连接有效后，再进入系统教程的路由分流章节调整域名规则、GeoSite、GeoIP 或 TUN 模式。
subscription / import
导入订阅
这一阶段的目标不是立即连接，而是让客户端成功读取订阅，并在主列表中生成可以选择的配置记录。只有列表出现内容后，下一步的代理模式和连接操作才有明确对象。
v2rayN 桌面端：建立订阅分组
打开 v2rayN 主窗口，在顶部菜单中找到“订阅分组”或名称接近的订阅管理入口，然后进入“订阅分组设置”。不同版本可能把入口放在“订阅”菜单下，也可能直接显示为工具栏按钮。进入设置窗口后，点击新增，在备注或别名一栏填写便于识别的名称，例如“常用订阅”；在地址一栏粘贴完整订阅链接。名称只用于本地识别，不影响连接结果。
填写完成后点击确认或保存，返回主窗口。此时只是保存了订阅来源，服务器列表不一定已经更新。再次打开“订阅分组”菜单，执行“更新全部订阅”或选中刚创建的分组后执行更新。客户端会读取订阅内容，并把解析出的记录写入服务器列表。等待更新结束后，主窗口中应出现协议类型、地址、端口、别名等栏目；具体栏目数量会随版本和窗口宽度变化。
如果更新后列表仍为空，先回到订阅分组设置，检查地址开头、结尾是否带有空格，再确认订阅分组处于启用状态。若状态栏显示订阅读取失败，不要连续修改代理模式，因为当前问题发生在配置获取阶段。可以先在服务提供方的管理页面重新复制地址，再覆盖原有内容并执行一次更新。更完整的订阅错误分类可查看系统教程中的订阅管理。
v2rayNG 安卓端：新增并更新订阅
打开 v2rayNG，进入侧边菜单或右上角菜单，找到“订阅分组设置”。点击新增按钮，在备注栏输入分组名称，在可选地址栏粘贴订阅链接，然后保存。返回配置列表后，从菜单中选择“更新订阅”。如果页面中存在多个订阅分组，应先确认当前更新的是刚才新增的分组，避免把旧分组的内容误认为新订阅结果。
更新完成后，配置列表会出现一条或多条记录。每条记录通常显示名称以及协议相关信息。此时先不要点击连接按钮，先确认列表不是空白，并检查记录名称是否与订阅来源中的命名大致对应。若同一批记录重复出现，通常是重复新增了相同地址，可以进入订阅分组设置删除多余分组，再更新一次列表。
routing / mode
选择代理模式
代理模式决定哪些流量交给当前配置处理。首次使用建议从规则分流开始：常见本地网站和局域网地址保持直连，需要代理的请求再交给活动服务器。这样更容易兼顾访问范围与日常应用兼容性。
先区分两个容易混淆的设置
v2rayN 桌面端通常同时存在“系统代理”和“路由模式”两组设置。系统代理决定浏览器和遵循系统代理设置的应用是否把流量送入 v2rayN；路由模式决定流量进入内核后走代理出站、直连出站还是阻断出站。只改路由模式却没有启用系统代理，浏览器可能仍然直接访问；只启用系统代理但选错路由规则，则可能出现部分网站结果与预期不一致。
v2rayNG 安卓端连接时会建立系统级的本地连接通道，路由设置负责决定流量如何分配。界面中的“预定义规则”“路由设置”或相近名称，都属于这一阶段。首次使用不建议立即开启复杂的分应用控制，也不建议导入多套自定义规则。先用一套清楚、可复现的规则完成连接，验证成功后再逐项扩展。
三种常见模式怎么选
在 v2rayN 中，先从路由设置中选择一套规则分流方案，再从系统托盘图标或主窗口的系统代理菜单中选择“自动配置系统代理”或含义相同的选项。不要选择“清除系统代理”，因为该状态会让大多数浏览器绕过客户端。若只希望某个手动配置了 SOCKS 或 HTTP 代理的程序使用 v2rayN，可以保留系统代理不变，但这种方式需要单独填写本地监听端口，不适合作为首次配置路径。
在 v2rayNG 中，进入设置中的路由配置，优先选择客户端提供的预定义规则。返回主列表后，确认没有同时开启互相冲突的分应用规则。全局代理可以作为排查工具：如果规则分流下某个目标无法访问，而全局代理可以访问，问题更可能位于路由匹配或规则数据；如果两种模式都失败，则应继续检查订阅记录、连接状态和网络环境。
规则分流涉及 routing.rules、域名分类、IP 分类与出站标签之间的关系。首次连接只需理解“匹配后决定走向”这一点，不必在这里展开全部字段。需要自定义规则时，可转到路由分流系统教程逐段配置。
client / connect
连接配置
连接前需要完成两个动作：选中一条具体配置，并让客户端进入运行状态。列表中存在记录并不等于记录已经被使用，活动项、系统代理和内核运行状态需要分别确认。
v2rayN 桌面端：设为活动服务器
回到 v2rayN 主窗口，在服务器列表中单击一条记录。首次测试时，优先选择名称清楚、来源明确的记录，不要一次勾选多条。选中后按 Enter，或使用右键菜单中的“设为活动服务器”。成功后，当前记录通常会出现颜色、字体、选中标记或状态栏文字变化，具体表现取决于客户端版本。
接着检查窗口底部或日志区域。正常启动时会看到内核开始运行、本地入站端口开始监听等状态信息。这里的端口通常由客户端自动管理，首次使用无需手动修改。然后查看系统托盘中的 v2rayN 图标，确认系统代理处于自动配置状态。若刚才已经设置代理模式但随后重启了客户端，也应重新检查一次托盘菜单，避免系统代理状态被手动切回直连。
若选中记录后日志立即出现连接失败，不要快速轮换大量配置。先确认本机日期与时间正确，再在同一订阅中选择另一条记录进行一次对照。只有某一条失败时，问题更可能与该条记录有关；所有记录都失败时，应检查订阅是否过期、网络是否可用、本地端口是否冲突。端口冲突的定位方法见系统教程的本地端口章节。
v2rayNG 安卓端：选中配置并启动
在 v2rayNG 配置列表中点击一条记录，使它成为当前配置。被选中的记录通常会出现单选标记或高亮状态。随后点击页面底部的连接按钮。首次启动时，系统会显示连接授权窗口，核对应用名称后确认。授权只负责允许客户端建立本地连接通道，不会替代订阅配置本身。
连接成功后，底部按钮状态会发生变化，系统状态区域也会出现正在连接的标识。返回 v2rayNG 主界面，确认当前配置名称仍是刚才选中的记录。如果点击连接后很快恢复为未连接状态，应打开日志查看最后几行错误，而不是重复点击按钮。常见原因包括配置不可用、网络切换后连接中断、订阅记录参数不完整或系统时间偏差。
从无线网络切换到移动网络，或从移动网络切回无线网络后，已有连接可能需要重新建立。切换网络时先观察客户端状态；若连接标识消失，返回主界面重新点击连接。不要同时运行多个承担相同系统代理职责的客户端，否则应用流量可能被不同本地端口重复接管，导致验证结果不稳定。
network / verify
验证代理是否生效
按钮显示已连接，只能说明客户端进入运行状态；最终验证要看真实应用流量是否经过预期路径。验证应从新打开的浏览器窗口开始，再扩展到其他应用。
先建立连接前后的对照
打开浏览器新窗口，通过搜索引擎查询“当前 IP 地址”，记录页面显示的出口信息。随后保持客户端运行，刷新查询页面或重新打开一个窗口。若出口结果发生符合预期的变化，说明浏览器流量已经进入客户端。使用规则分流时，不同查询页面可能被不同规则处理，因此应结合客户端日志判断，而不是只依赖一个页面。
v2rayN 桌面端若显示运行正常，但浏览器结果始终不变，优先检查浏览器是否遵循系统代理。有些浏览器扩展会覆盖系统设置，也有些应用使用自己的代理参数。可以先关闭会改写代理的浏览器扩展，再确认 v2rayN 托盘菜单中的系统代理状态。如果浏览器手动填写过本地代理地址，应核对端口是否与客户端当前监听端口一致。
v2rayNG 安卓端连接后，可先完全关闭浏览器再重新打开，避免旧连接复用。若浏览器验证正常而某个应用仍无法访问，应检查该应用是否被分应用规则排除，或是否使用了独立网络通道。不要立即改动订阅内容，因为浏览器已经成功意味着订阅、服务器记录和基础连接链路大体正常，排查重点应转向应用范围和路由规则。
结合日志判断流量路径
打开客户端日志，随后在浏览器访问一个新页面。正常情况下，日志会新增连接记录，并显示目标域名、目标地址或匹配到的出站标签。日志的价值在于区分“请求没有进入客户端”和“请求进入后连接失败”：前者通常与系统代理、应用代理或连接授权有关；后者通常与服务器记录、路由规则、DNS 或网络环境有关。
如果日志没有任何新增内容，说明当前应用很可能没有把流量交给客户端。v2rayN 应再次核对系统代理开关和应用自身代理设置；v2rayNG 应核对连接状态以及分应用范围。如果日志有记录，但出现超时或无法建立连接，可在同一订阅中切换另一条配置做对照。切换时保持代理模式不变，避免同时改变两个变量。
若网页能够打开但图片、视频或部分域名加载失败，常见原因是分流规则或 DNS 结果不一致。可以临时改为全局代理进行一次对照：全局模式恢复正常，说明基础连接可用，下一步应检查规则匹配；全局模式仍然异常，则继续检查当前配置与网络状态。完成对照后应恢复原定模式，避免把排查状态长期当作日常配置。
确认其他应用是否符合预期
浏览器验证通过后，再打开一个平时需要联网的应用进行测试。v2rayN 的系统代理主要覆盖遵循系统代理设置的程序，并不保证所有桌面程序都会自动使用；某些程序需要在自身设置中选择“跟随系统代理”，或者手动填写本地 HTTP、SOCKS 地址。需要接管更多类型流量时，可以研究 TUN 模式，但应先阅读系统教程中的 TUN 章节，了解权限、DNS 和路由变化后再启用。
验证完成的标准是：客户端保持稳定运行，浏览器出口符合所选模式，日志能够看到新请求，常用应用的访问范围与预期一致。满足这些条件后，首次配置已经完成。后续更新订阅时不必重复全部步骤，只需执行订阅更新、确认活动记录仍然存在，再做一次简短的连接验证。
finish / checklist
首次配置完成检查
按顺序核对以下状态。前一项未通过时，先处理该项，不要跳到后面的高级设置。
-
订阅列表存在配置
订阅分组已经保存，更新操作可以正常完成，主列表中至少有一条可选择的记录。
-
代理模式与使用范围一致
日常使用优先采用规则分流；排查规则时可短暂切换全局代理，并在测试结束后恢复。
-
活动配置与运行状态明确
v2rayN 已设置活动服务器并启用系统代理，或 v2rayNG 已选中配置并保持连接状态。
-
实际流量完成验证
浏览器出口、客户端日志和常用应用的访问结果能够相互对应，而不是只观察连接按钮。
setup > completed
继续配置路由与 TUN
首次连接完成后，再按实际需求学习订阅维护、路由规则、DNS、TUN 模式和故障定位。系统教程按阶段展开，不需要在首次设置时一次改完。
setup / quick answers
首次设置常见情况
订阅更新成功，但列表里没有新增记录怎么办？
先确认更新的是刚创建的订阅分组，再检查分组是否启用。随后重新复制完整订阅地址，覆盖旧地址并保存。如果客户端提示解析失败，应向订阅提供方确认地址状态，不要通过修改代理模式处理订阅读取问题。
为什么客户端显示已连接，浏览器出口却没有变化？
v2rayN 需要确认系统代理已经启用，并检查浏览器是否被扩展或手动代理设置覆盖。v2rayNG 可完全关闭浏览器后重新打开，再检查分应用规则。若客户端日志没有新增请求，重点排查流量是否进入客户端。
规则分流和全局代理应该长期使用哪一个？
日常使用通常选择规则分流，让不同目标按规则走直连或代理。全局代理更适合做短时对照测试，用来判断问题是否来自路由匹配。具体规则结构可在系统教程中继续学习。
更新订阅后需要重新设置全部选项吗？
通常不需要。更新后确认原活动记录是否仍存在，并检查当前选中的配置。若订阅方修改了记录名称或删除了旧记录，需要重新选中一条配置，然后执行一次连接与出口验证。