FIRST RUN
首次连接
采用常规系统代理或标准连接入口，路由保留默认设置，先验证基础链路。
// QUICK SETUP · 10 MIN
v2rayN 配置教程：从订阅导入到连接验证
按固定顺序完成四件事：导入订阅、选择代理模式、建立连接、验证结果。每一步都说明入口位置、正常界面应出现的内容，以及进入下一步前需要确认的状态。
// PREPARATION
开始前检查：客户端、订阅链接、本机网络
开始配置前，先确认客户端能够正常打开。桌面端启动后应能看到主窗口或系统托盘图标，安卓端启动后应进入配置列表页面。首次运行时列表为空属于正常状态，因为客户端尚未获得任何服务器配置。此时不要反复点击连接按钮，空列表下没有可供启动的活动服务器。
第二项准备内容是完整的订阅链接。订阅链接通常由服务提供方给出，应从链接开头复制到结尾，不要遗漏字符，也不要把说明文字、前后空格或换行一并复制进去。订阅是服务器配置的来源，客户端负责读取和更新这些配置；它不是单个服务器名称，也不是手工输入的备注。若拿到的是单条分享链接，导入入口可能与订阅管理入口不同，相关格式区别可前往疑难解答继续确认。
最后确认本机原有网络可以正常访问普通网页。配置过程依赖本机网络读取订阅并建立连接，如果当前网络本身已经断开，客户端日志通常只会连续出现超时信息。先处理基础网络，再进行后面的订阅和代理设置，可以减少多个问题叠加造成的误判。
CLIENT
客户端可以打开
主窗口、配置列表或托盘入口能够正常显示。
SUBSCRIPTION
订阅链接完整
复制完整地址，不带说明文字与额外空格。
NETWORK
基础网络正常
关闭客户端连接时，普通网页仍能正常打开。
// STEP 01
导入订阅并更新服务器列表
订阅导入分为两个动作：先保存订阅地址，再主动执行一次更新。只完成保存而没有更新时，客户端可能已经记住订阅信息，但主界面的服务器列表仍然为空。因此本步骤的完成标志不是“订阅窗口里有一行记录”，而是“主列表里已经出现可选择的服务器配置”。
v2rayN 桌面端：新增订阅分组
打开 v2rayN 主窗口，在顶部菜单中找到“订阅分组”或名称接近的订阅管理入口，再进入订阅分组设置。不同版本的菜单排列可能略有变化，但入口中通常同时包含分组管理和更新订阅两个动作。进入设置窗口后选择新增，给订阅填写一个便于识别的备注，例如按用途或提供方命名，然后把完整订阅链接粘贴到地址栏。
保存前再次检查地址开头和结尾。地址栏中不应出现中文引号、空格或额外说明。保存并关闭设置窗口后，回到订阅菜单，执行“更新全部订阅”或对刚建立的分组执行更新。更新过程中可以打开日志区域观察结果。正常情况下，日志会显示订阅读取和配置处理过程，随后主窗口的服务器列表出现多行记录，记录中通常包含别名、地址、端口或协议类型等字段。
订阅分组
订阅分组设置
新增并保存
更新订阅
v2rayNG 安卓端：添加订阅配置
打开 v2rayNG 后进入顶部菜单，在订阅设置中新增一条订阅记录。填写名称并粘贴完整链接后保存，然后返回配置列表，使用“更新订阅”功能读取服务器配置。部分版本会在更新完成后自动返回列表，部分版本会用短提示说明更新结果。只要配置列表出现可选择的条目，就可以继续下一步。
如果更新后仍为空，先不要进入代理模式设置。重新打开订阅记录，检查链接是否被截断，并确认当前网络能够访问订阅来源。还可以查看日志中是否出现解析失败、连接超时或返回内容为空等信息。订阅格式、单条分享链接与完整订阅之间的区别较多，本页不展开格式转换；遇到这类情况可在疑难解答中按“安装配置”分类继续排查。
服务器配置进入列表后，下一步不是立刻反复测试所有条目，而是先确定客户端如何接管流量。代理模式决定哪些应用会使用连接，也决定后续验证时应该观察哪个状态。
// STEP 02
选择代理模式：先用默认范围完成首次连接
代理模式可以理解为“哪些流量交给客户端处理”。首次配置的目标是建立一条可验证的连接，不需要一开始就调整复杂路由、TUN 参数或自定义规则。先使用客户端提供的常规系统代理或标准连接方式完成测试，确认订阅与服务器可用后，再按实际需求细化分流规则。这样可以把问题限制在较小范围内。
桌面端先区分系统代理与路由规则
在 v2rayN 中，“系统代理”和“路由模式”承担不同职责。系统代理决定浏览器等遵循系统网络设置的程序是否把请求交给客户端；路由模式则决定请求进入客户端之后采用直连、代理或阻断等处理方式。初次使用时，可以在系统托盘菜单或主窗口相关菜单中选择自动配置系统代理，再保留一套默认的规则路由。此时不要同时打开多个第三方代理程序，以免不同程序重复修改同一个系统代理入口。
如果只启动了内核，却没有启用系统代理，客户端日志可能显示运行正常，但浏览器流量仍按原路径访问。这并不一定表示服务器配置错误，而是流量尚未交给客户端。相反，如果系统代理已经打开但客户端内核没有运行，浏览器可能直接显示连接失败。因此后续连接步骤需要同时确认“活动服务器”“运行状态”和“系统代理状态”。
安卓端使用标准连接入口
v2rayNG 的基础使用路径更集中：先在配置列表中选择服务器，再点击右下角连接按钮。首次连接时，系统会显示网络连接授权提示，确认后客户端才能建立本地连接通道。若拒绝该提示，配置仍会保留在列表中，但连接无法进入工作状态。授权完成后，状态栏通常会出现连接标识，应用内按钮的状态也会发生变化。
路由设置建议先保留客户端默认选项。默认规则适合用来判断基础连接是否成立，自定义 domain、ip、geosite 规则以及更完整的 TUN 使用方法属于进阶配置，可在连接成功后阅读系统教程。如果首次测试同时修改订阅、路由、DNS 和传输参数，一旦失败将很难判断是哪一项造成结果变化。
AFTER VERIFIED
连接稳定后
再根据应用范围调整路由规则、DNS 行为与其他进阶设置。
模式确定后，客户端仍需要一条明确的活动服务器。接下来从订阅列表中选中配置，启动连接，并通过状态和日志判断启动过程是否完整。
// STEP 03
选择活动服务器并建立连接
服务器列表出现配置后，需要明确选中其中一条。列表里存在配置不等于该配置已经成为活动服务器；尤其在首次导入、切换订阅分组或删除旧配置后，客户端可能还没有当前选项。选择时先用订阅提供的默认推荐条目，不必一开始逐条修改传输参数。订阅生成的协议、地址、端口和传输字段应作为一个整体使用。
在 v2rayN 中设置活动服务器
回到主窗口，在服务器列表中单击目标行，再使用回车、双击或右键菜单中的“设为活动服务器”操作。具体触发方式会随版本设置变化，判断是否成功应看列表中的选中标记、当前服务器提示或窗口底部状态信息。活动服务器确定后，启动服务，并在系统代理菜单中选择前一步决定的自动配置方式。
随后打开日志区域。正常启动时，日志会先显示配置载入，再显示内核开始运行和本地监听入口建立。日志中出现本地端口监听信息，说明客户端已经准备接收来自系统代理的请求。若启动后立即停止，重点查看停止前的第一条错误，而不是只看最后一行结束提示。端口占用、配置字段不完整和本机安全策略拦截都可能使启动过程提前结束。
在 v2rayNG 中启动选中的配置
在配置列表中点击目标条目，使其进入选中状态，然后点击右下角连接按钮。首次连接确认系统授权后，等待按钮和顶部状态发生变化。连接建立后不要马上退出客户端，先停留在当前页面几秒并查看日志。若按钮很快恢复到未连接状态，说明启动没有持续成功，需要打开日志读取原因。
订阅中存在多条配置时，可以先测试一条，再在失败后切换另一条。切换前先停止当前连接，选中新配置后重新启动，避免把旧连接的日志与新连接混在一起。测试过程中不要手工改写服务器地址、用户标识、传输方式或安全参数，因为任意字段不匹配都可能导致连接无法建立。
活动服务器明确
列表存在选中项，状态区域能识别当前配置。
客户端持续运行
启动后没有立即停止，连接按钮保持工作状态。
日志建立监听
日志完成配置载入，并开始接收本地请求。
客户端显示运行只代表本地进程已经启动，最终仍要确认真实应用流量是否经过当前连接。最后一步将界面状态、浏览器结果和日志放在一起核对。
// STEP 04
验证是否生效：状态、网页与日志交叉确认
验证连接不能只看按钮颜色，也不能只看某一个网页是否打开。较稳妥的方法是同时检查三项：客户端是否保持运行、需要测试的应用是否使用了当前代理入口、日志是否出现与访问动作对应的新记录。三项结果一致时，才能确认从应用到客户端再到服务器的完整路径已经工作。
先检查客户端与系统状态
桌面端先查看活动服务器是否仍然存在，内核状态是否处于运行中，系统代理菜单是否保持在自动配置状态。若浏览器已经在客户端启动前打开，可以新建一个窗口或完全关闭后重新打开，使浏览器重新读取系统网络设置。安卓端则确认连接按钮仍处于工作状态，系统状态栏保留连接标识，并且没有被电池管理立即终止后台运行。
再执行一次可观察的网页请求
打开浏览器，先访问一个平时能够正常打开的网页，确认启用客户端后基础访问没有被破坏；再访问实际需要测试的目标页面。测试时尽量关闭浏览器中的其他下载和自动刷新页面，这样日志里的新请求更容易识别。如果普通网页也全部失败，优先检查系统代理是否指向一个未运行的本地端口，或者客户端是否在启动后已经停止。
网页请求发出后立即回到客户端日志。正常情况下，日志会新增与当前访问时间接近的连接记录。若浏览器报错而日志完全没有新内容，通常表示流量没有进入客户端，应回到第二步检查系统代理或连接授权。若日志能够看到请求，但随后出现超时或连接关闭，则说明流量已经进入客户端，排查重点应转向当前服务器配置、本机网络质量或订阅状态。
按固定顺序处理失败结果
第一，执行一次订阅更新，确认配置不是旧记录；第二，停止当前连接，切换同一订阅中的另一条服务器后重新启动；第三，恢复默认路由设置，排除自定义规则对测试请求的影响；第四，暂时退出其他会修改系统代理或本地端口的工具；第五，重新检查本机基础网络。每次只改一项，并在修改后重复同一个网页测试，这样才能知道是哪一步改变了结果。
如果日志提示端口已被占用，需要关闭占用同一端口的程序，或在客户端设置中改用未冲突的本地端口后重启。若订阅更新一直失败，应返回订阅设置核对链接，而不是继续切换代理模式。若配置可以启动但特定网页表现不同，则可能涉及路由规则或 DNS 设置，这类问题可转到疑难解答查看对应条目，完整的路由与 DNS 原理则在系统教程中展开。
| 观察结果 | 说明 | 下一步 |
|---|---|---|
| 客户端运行，网页正常，日志新增请求 | 应用流量已经进入客户端，基础连接完成 | 保留当前设置，进入日常使用 |
| 客户端运行，网页失败，日志没有新请求 | 流量没有进入客户端 | 检查系统代理、连接授权与应用代理设置 |
| 日志出现请求，随后连接超时 | 本地入口正常，远端链路未完成 | 更新订阅并切换另一条服务器测试 |
| 启动后立即停止 | 客户端未完成配置载入或本地监听 | 查看停止前第一条错误并处理端口冲突 |
// DAILY USE
日常使用：保持简单的更新与切换顺序
订阅更新后再切换服务器
服务器列表需要定期从订阅来源更新。更新前先停止当前连接，执行订阅更新，确认列表刷新后再选择活动服务器并重新启动。若更新后某条旧配置消失，通常表示订阅内容已经调整，不应继续依赖本地残留记录。
修改设置时一次只改一项
路由模式、DNS、本地端口和启动行为都会影响最终结果。连接已经可用时，先记录当前设置，再逐项调整并重复验证。一次修改多个选项会让日志变化难以对应具体原因。
切换网络后重新观察状态
设备从一个网络切换到另一个网络后，原连接可能需要重新建立。先停止再启动客户端，并查看日志是否恢复请求记录。不要把网络切换造成的短暂中断直接判断为订阅失效。
复杂配置转到系统教程
基础流程稳定后，再学习自定义路由、domain 与 ip 匹配、geosite 规则、TUN 和日常维护。完整概念与配置关系集中在系统教程，本页保留十分钟上手所需的操作路径。
// NEXT REFERENCE
需要继续排查或深入配置
界面报错、订阅为空和连接中断可前往疑难解答；路由分流、TUN 与维护方法可继续阅读系统教程。