v2rayN 配置教程：从订阅导入到连接验证

开始前检查

准备客户端与有效的V2Ray 订阅链接

开始前需要准备两项内容：已经安装并能正常启动的客户端，以及服务提供方给出的完整订阅链接。订阅链接通常是一段以 https:// 开头的地址，用于获取一组服务器配置。它不是单个节点名称，也不是客户端安装地址。复制时应从开头到结尾完整选中，避免混入空格、换行或聊天软件附加的标点。

首次启动桌面客户端时，系统可能要求确认网络访问权限。允许客户端在当前网络环境中通信，否则内核即使成功启动，也可能无法建立出站连接。Android 首次连接时会显示系统级连接确认框，需要明确同意；这是创建本地网络通道所需的标准步骤。若此前拒绝过，可停止客户端后重新点击连接按钮，再按系统提示确认。

打开客户端后先观察主界面。v2rayN 通常显示服务器列表、状态栏和日志区域；新安装状态下列表可能为空。v2rayNG 的主界面会显示当前配置名称，尚未导入时通常没有可选服务器。列表为空并不表示程序异常，只说明下一步需要添加订阅。此时不要急于修改端口、DNS、传输协议或内核参数，默认设置足以完成首次连接。

如果还没有安装客户端，先前往下载页选择对应平台。桌面端使用 v2rayN；Android 可先使用 v2rayNG。安装完成后返回本页，从订阅导入开始操作。涉及协议差异、V2Fly 与 Xray 内核关系、订阅兼容性等内容，可在完成基础连接后查看技术参考。

步骤一

导入并更新v2rayN 订阅

在 v2rayN 桌面端，先打开顶部的“订阅分组”菜单，进入订阅分组设置。不同版本的菜单文字可能略有差异，但入口会同时包含“订阅”与“分组”含义。点击添加后，填写一个便于识别的备注名称，例如“日常订阅”，再把完整链接粘贴到地址栏。其余更新间隔、用户代理或高级选项先保持默认，然后保存并关闭设置窗口。

仅保存订阅地址还不会立即出现服务器。回到主窗口，再次打开订阅分组菜单，执行“更新全部订阅”或当前分组的更新命令。首次更新建议选择不经过代理的更新方式，因为此时客户端尚未建立可用连接。更新过程中查看底部状态栏或日志区域：正常情况下会出现获取完成、解析完成一类提示，随后服务器列表中增加多条记录。

在 v2rayNG 中，打开侧边菜单或右上角菜单，进入“订阅分组设置”。点击新增按钮，填写订阅名称与链接并保存。返回订阅列表后，点击更新按钮；部分版本也可从主界面菜单直接执行“更新订阅”。更新完成后回到主界面，当前配置名称应当发生变化，服务器列表中可以看到订阅返回的项目。

看到服务器列表后，不需要逐项打开修改。订阅返回的地址、端口、协议、传输方式和安全参数是一组关联配置，手动改动其中一个字段就可能使连接失效。首次配置只需要确认列表不是空的，并且每条记录有可识别的别名或地址。客户端显示的名称由订阅内容决定，名称长短本身不影响连接。

更新后仍然没有服务器时

先回到订阅设置，检查地址开头、结尾和中间是否存在空格。可以删除原地址后重新复制一次，避免只修改局部造成遗漏。随后确认设备当前可以正常访问普通网页，再使用不经过代理的方式更新。如果日志提示返回内容为空、格式无法识别或访问超时，不要连续反复点击更新；应先确认链接仍有效，并检查客户端是否为当前维护版本。

订阅链接属于配置入口，不适合发布在公开页面、截图或群聊中。需要录制操作过程时，应遮挡地址栏内容。若链接已经公开，应在提供方的管理页面重新生成，而不是只删除本地记录。更完整的解析失败原因与自查顺序收录在技术参考的兼容性章节。

步骤二

选择系统代理与路由模式

订阅导入后，下一步不是立即修改服务器参数，而是确定哪些流量交给客户端。这里需要区分两个概念：系统代理负责让支持系统代理的程序把请求发送到本地端口；路由模式负责决定这些请求采用代理出口还是直接连接。两者处于不同层级。桌面端只选了服务器但没有开启系统代理时，浏览器通常不会自动使用客户端。

在 v2rayN 中，找到“系统代理”菜单，首次使用可选择“自动配置系统代理”。启用后，任务栏或状态区域的图标状态会发生变化，客户端也会把本地代理地址写入系统设置。接着打开路由设置，先选择客户端提供的规则模式或默认规则。规则模式会根据已有规则分别处理连接，适合作为首次配置的起点，也便于检查普通网站与目标网站是否都能正常访问。

如果选择全局模式，进入客户端的流量会统一交给当前服务器处理。这个模式便于做短时间对照测试，但会改变更多程序的网络路径。首次连接建议先用规则模式；只有在确认服务器本身可用、且需要排除路由规则影响时，再临时切换到全局模式。测试结束后可恢复规则模式，避免把一次排查设置长期保留。

在 v2rayNG 中，点击主界面的路由设置或从侧边菜单进入设置页，选择预置的规则配置。Android 客户端建立的是系统级本地通道，因此不需要寻找桌面端的“系统代理”开关。若设置中启用了按应用代理，还要确认目标应用已包含在选定范围内；首次测试可暂时关闭按应用筛选，先验证整个连接链路，再按实际需要缩小范围。

此阶段不要同时开启多个同类网络工具。多个程序可能争用本地端口、重复写入系统代理，或同时尝试创建网络通道，最终表现为客户端显示运行但网页无法打开。关闭其他工具后，重新启动当前客户端，让系统代理与路由状态保持单一来源。浏览器中单独安装的代理配置也应暂时停用，避免绕过客户端设置。

什么时候考虑 TUN 模式

部分程序不会读取系统代理设置，这类程序即使在 v2rayN 已开启系统代理后，也可能继续直连。TUN 模式通过虚拟网卡接管更广范围的流量，但需要额外权限，也更容易受到安全软件、虚拟机网络和其他网卡工具影响。首次配置不必立即开启。先用浏览器完成本文流程，确认订阅和服务器都正常，再根据具体程序需求查看TUN 模式原理与设置步骤。

步骤三

选择服务器并建立连接

回到服务器列表，先选择一条订阅配置。在 v2rayN 中，单击列表行后通过右键菜单将其设为活动服务器，也可以使用界面提供的快捷操作。被选中的记录通常会出现颜色、图标或状态标记变化。随后确认底部状态栏显示当前服务器名称，并观察内核是否已经启动。部分版本会在选择服务器后自动重启内核，这是正常的配置加载过程。

在 v2rayNG 中，点击主界面显示当前配置的区域，进入服务器列表后选择一条记录。返回主界面，确认顶部或中部显示的是刚选中的名称，再点击圆形连接按钮。系统首次询问连接权限时选择允许。按钮图形和状态文字变化后，说明客户端已开始运行；此时还要等待几秒，让域名解析、协议握手和路由加载完成。

“客户端正在运行”与“服务器可以使用”不是同一个状态。运行状态只说明本地内核进程已经启动，远端连接仍可能因为地址不可达、端口关闭、时间错误或配置过期而失败。因此不要只看连接按钮颜色，应同时观察日志。正常启动日志通常会显示配置加载完成和本地监听端口已经建立；如果第一行就出现配置字段错误或端口占用，后续连接不会成功。

第一次测试不必批量测速。测速结果受测试方式和目标地址影响，数值低也不等于所有应用都能稳定连接。更直接的方法是先选择订阅中一条常用配置，建立连接后进入下一步做实际访问验证。如果失败，再换另一条配置进行对照。连续切换时应等待客户端完成内核重启，避免把上一条连接尚未结束的状态误判为新配置结果。

连接按钮没有反应或立即停止

先关闭客户端再重新打开，并确认系统时间与时区正确。随后检查日志第一段，而不是只看最后一行。出现“address already in use”一类信息时，通常表示本地端口被其他进程占用；关闭其他网络工具或在确认用途后调整本地端口。出现配置解析错误时，先重新更新订阅，不要直接编辑复杂字段。出现证书或握手相关错误时，可换同一订阅中的其他服务器进行对照。

桌面端还要检查系统代理状态是否随客户端启动而保持开启。如果客户端异常退出，系统代理可能仍指向已经停止的本地端口，表现为所有网页都无法打开。此时重新启动 v2rayN，或在系统代理菜单中先清除代理再重新开启。Android 端若连接后立刻断开，可检查系统是否限制了客户端后台运行，并确保没有另一个程序占用系统级连接通道。

步骤四

验证V2Ray 连接是否生效

连接建立后，先完全关闭测试用浏览器窗口，再重新打开。这样可以减少旧连接、缓存和常驻进程对结果的影响。先访问一个平时能够正常打开的普通网站，确认基础网络没有因为代理设置中断；随后访问需要通过当前服务器处理的目标页面。两类页面都能打开，说明系统代理、路由规则和远端连接已经形成完整链路。

接着可使用可信的网络信息查询页面，对比连接前后的出口地址。测试前先记录未连接时的结果，连接客户端后刷新页面。如果规则模式没有让该查询页面经过代理，结果可能保持不变，这不一定是故障。可临时切换到全局模式重新测试；若出口信息随之变化，说明服务器连接正常，差异来自当前路由规则。测试完成后再恢复原来的规则模式。

不要仅凭浏览器中的一个页面判断所有程序。桌面应用是否生效，取决于它是否读取系统代理，或是否由 TUN 模式接管。Android 应用是否生效，还取决于按应用范围设置。若浏览器正常而某个程序无法连接，说明基础订阅和服务器大概率可用，排查重点应转向该程序的代理支持、应用范围和本地防火墙，而不是反复更换订阅。

还应检查本地网络资源是否符合预期。规则模式下，局域网设备、打印服务或开发环境通常应按既有规则访问。若连接后本地地址无法打开，先确认路由规则是否把私有地址交给了代理，再检查是否启用了范围过大的接管方式。不要为了修复单个地址立即重置全部设置，先停止连接进行对照，可以更快确定问题处于客户端、路由还是本地网络。

保存一套可复现的正常状态

确认连接有效后，记住当前使用的订阅分组、服务器名称、路由模式与系统代理状态。后续出现问题时，先恢复这组已验证配置，再逐项改变设置。一次只调整一个变量，才能判断是哪项操作造成差异。客户端更新订阅后服务器名称或顺序可能变化，因此不应只依赖列表位置，优先按名称和分组识别。

日常使用中，订阅更新不需要删除现有分组。直接执行更新即可让客户端读取服务端的新配置。若更新后当前服务器被移除，重新选择一条记录并连接。更换网络环境后出现连接失败，可先停止客户端、确认基础网络可用，再重新启动；这样能够清理旧连接并让系统重新应用路由。