v2rayN 与 v2rayNG 使用教程

在 v2rayN 桌面端添加订阅

打开 v2rayN 后，先查看窗口顶部菜单。进入“订阅分组”或名称接近的订阅管理入口，再打开“订阅分组设置”。在设置窗口中选择新增，给这一组订阅填写一个容易辨认的备注，例如服务名称或用途分类，然后把完整订阅地址粘贴到地址栏。备注只用于本地识别，不会改变订阅内容。

保存后返回主窗口，再次打开订阅菜单，执行“更新全部订阅”或对刚才的分组单独更新。v2rayN 会读取订阅内容并把配置列到主界面。更新期间不要连续重复点击；先等待状态栏或提示信息结束。如果列表原来已有配置，更新后可根据分组名称确认新内容是否已加入，而不是只看总行数。

若菜单中同时出现“更新订阅”和“通过代理更新订阅”，首次操作通常先选择普通更新。当前网络无法直接访问订阅地址、但客户端已有可用连接时，才考虑通过现有代理更新。新安装状态还没有活动连接，通过代理更新往往不能解决首次导入问题。

在 v2rayNG 安卓端添加订阅

打开 v2rayNG，进入侧边菜单中的“订阅分组设置”。点击新增按钮后，填写订阅名称与订阅地址，并保存当前分组。部分版本会在保存后直接回到订阅列表，部分版本仍停留在编辑页面；只要新分组已经显示，就可以返回主界面继续更新。

随后打开右上角菜单，选择“更新订阅”。更新完成后，主列表会出现订阅中的配置名称。若列表仍为空，先回到订阅分组设置，重新打开刚才保存的条目，检查地址开头、结尾以及中间是否存在换行。不要在同一个输入框里连续粘贴两个订阅地址；需要添加多个来源时，应分别建立订阅分组，后续更新和排查都会更清楚。

确认第一步是否完成

订阅更新完成后，至少应看到一条可选配置。名称、地区标签和排列方式由订阅提供方决定，客户端不会自动判断哪一条更适合当前网络。如果更新提示解析失败、响应为空或地址不可访问，暂时不要进入代理模式设置，因为后面的步骤必须依赖有效配置。

此时应先确认链接可以完整复制、订阅仍在有效期内、设备日期与时间准确，并尝试切换一次本地网络后重新更新。关于订阅、节点、分享链接和协议之间的区别，可查看 订阅与节点术语。确认列表已经出现配置后，再继续选择代理模式。

先区分系统代理与路由模式

在 v2rayN 中，“系统代理”与“路由模式”属于两个层次。系统代理负责通知浏览器和遵循系统代理设置的应用，把请求发往 v2rayN 的本地监听端口；路由模式则由核心依据域名、IP 或规则集决定请求走代理出站、直连出站还是被阻止。只调整路由但没有让应用使用本地代理时，浏览器可能仍按原网络路径访问。

首次使用建议在 v2rayN 托盘菜单或主界面的系统代理菜单中选择“自动配置系统代理”或当前版本中含义相同的开启选项。随后在路由设置里采用客户端提供的默认规则模式。这样既能让常用浏览器接入客户端，也能保留默认分流逻辑，便于完成基础验证。

全局模式会把更多请求交给同一个代理出站，适合短时间判断规则是否造成访问差异，但不建议把它当作排查所有问题的第一选择。若规则模式下某个地址不能访问，而全局模式可以访问，问题更可能位于路由匹配；若两种模式都失败，则应回到活动配置、订阅有效性和本地网络继续检查。

v2rayNG 中的模式选择

v2rayNG 建立的是设备级连接通道，主界面中的路由设置决定请求如何分流。首次配置可以保留预置规则，不必立刻导入自定义规则文件。若设置页中存在“分应用代理”，先保持关闭，避免某个待测试应用因为没有被选中而绕过客户端。基础连接验证完成后，再根据实际用途设置应用范围。

不同版本对预置模式的命名可能略有不同，判断时应看说明而不是只看名称：规则模式会按照域名和 IP 条件选择出站，全局模式会让大部分请求使用活动代理配置，直连模式则主要用于暂停代理路径。此处选择规则模式后返回主界面，不需要反复切换。

暂时保留默认监听端口

v2rayN 通常会配置本地 HTTP、SOCKS 或混合监听端口。首次连接不必修改默认端口，也不要同时让另一个同类客户端占用相同端口。如果启动核心时明确提示端口被占用，应先退出其他正在运行的代理客户端，再重新启动 v2rayN。确实需要并行运行时，再到设置中更换本地监听端口，并同步修改手动配置过代理地址的应用。

路由中的 domain、ip、geosite 与规则优先级属于进阶配置。此时只需知道规则通常按既定顺序匹配，越早命中的规则越先决定出站。详细字段与 JSON 示例可继续阅读 路由配置字段，不必在首次连接阶段展开修改。

在 v2rayN 中设为活动服务器

回到 v2rayN 主列表，单击选中一条来自刚才订阅分组的配置。可以按 Enter 键，或通过右键菜单选择“设为活动服务器”。活动项通常会以颜色、粗体、标记或状态栏文字显示，具体形式随版本变化。关键是状态区域已经显示当前配置名称，而不是仅在列表中保持选中高亮。

设为活动服务器后，观察窗口底部状态栏或日志区域。核心能够正常启动时，通常会出现启动完成、本地监听已建立或当前配置已加载等信息。如果刚才已开启系统代理，浏览器等遵循系统设置的应用会开始把请求发送给 v2rayN。若系统代理仍处于关闭状态，核心虽然可能正在运行，但浏览器访问结果不会因此自动改变。

v2rayN 关闭主窗口后可能继续驻留在系统托盘。需要暂停时，应从托盘菜单清除系统代理或退出客户端，不要只依据主窗口是否可见判断运行状态。重新打开窗口后，也应先看当前活动配置和系统代理状态，再决定是否重复启动。

在 v2rayNG 中启动连接

在 v2rayNG 主列表中点击一条配置，使它成为当前选中项。随后点击主界面下方的连接按钮。首次建立设备连接时，系统会显示连接授权窗口；确认授权后，按钮状态会发生变化，系统状态区域也会出现连接标识。授权只负责允许客户端创建连接通道，不会替代订阅配置本身。

如果点击连接后立刻恢复为未连接状态，先打开日志查看最后几行错误。常见方向包括配置字段无法解析、服务器地址无法解析、网络连接超时或系统时间偏差。不要连续快速点击连接按钮，因为上一轮核心可能还在退出过程中；等待数秒，确认状态稳定后再重试。

如何处理单条配置连接失败

一条配置连接失败时，不应马上删除整个订阅。先在同一订阅分组中切换另一条配置，再执行相同连接动作。如果其他配置可以建立连接，说明客户端基础设置大体正常，问题更可能集中在原配置的可用状态或网络路径。如果同组所有配置都失败，则应重新更新订阅，并确认本地网络是否能够正常访问订阅地址。

客户端日志是判断阶段的主要依据。包含“解析”“连接超时”“拒绝连接”“端口占用”等信息的日志，对应的排查方向不同。首次使用只需记录错误发生在启动前还是连接后，不需要立即编辑完整 JSON。复杂日志与入站、出站字段的对应关系可在 入站配置 和 出站配置 中继续查询。

先检查客户端状态

在 v2rayN 中确认状态栏仍显示活动配置，核心没有停止，系统代理仍处于第二步选择的开启状态。随后查看日志末尾，正常运行时可以出现请求记录或连接建立信息，但不应持续重复同一条错误。偶尔一条连接失败不一定代表整体不可用，因为页面可能同时请求多个资源；应关注错误是否连续出现，以及浏览器访问是否同步失败。

在 v2rayNG 中确认连接按钮保持启动状态，系统连接标识没有消失。打开日志时，先记住开始测试的时间，再切换到浏览器发起一次访问，随后回到日志查看是否出现对应的新记录。这样比翻看启动前的旧日志更容易判断当前请求是否进入客户端。

用浏览器完成一次实际访问

打开常用浏览器，新建无痕窗口或关闭旧页面后重新打开一个熟悉的网站。使用新窗口可以减少缓存、已有连接和浏览器扩展对结果的干扰。若页面能够正常加载，再打开第二个不同域名的页面进行对照，避免单个网站自身故障造成误判。

桌面端若客户端显示运行但浏览器没有任何变化，检查浏览器是否使用独立代理设置。部分浏览器或扩展会覆盖系统代理，此时应暂时关闭冲突设置，或把浏览器恢复为“使用系统代理”。v2rayNG 若只有部分应用没有变化，应回到设置确认是否启用了分应用代理，以及目标应用是否包含在所选范围中。

按顺序定位验证失败

验证失败时，从最短路径开始，不要同时修改多个参数。第一，重新确认当前活动配置；第二，更新订阅并换一条配置；第三，检查系统代理或设备连接是否仍开启；第四，切换本地网络后再试。每做一次修改就重复同一个浏览器测试，这样才能知道是哪一项产生了变化。

如果浏览器完全无法打开任何页面，可先清除 v2rayN 系统代理或停止 v2rayNG 连接，确认本地网络自身是否正常。基础网络恢复后再重新连接客户端。如果直连正常、连接后全部失败，重点查看活动配置、核心日志和 DNS 错误；如果只有特定域名异常，则更可能与路由规则或 DNS 分流有关。

DNS 问题常表现为域名无法解析，但直接连接某些已知地址时路径仍可建立。首次教程不建议直接替换完整 DNS 配置，可先重启客户端、切换一条配置并重新测试。问题持续存在时，再阅读 DNS 配置字段，了解服务器列表、域名匹配和查询策略之间的关系。

完成后如何日常使用

日常启动通常不需要重复导入订阅。打开客户端后先更新订阅，确认活动配置，再开启系统代理或设备连接即可。服务提供方调整配置后，客户端只有执行订阅更新才能取得新内容；单纯重启核心不会自动替换旧订阅数据，除非设置中已明确开启启动时更新。

需要暂停时，v2rayN 应先清除系统代理，再退出客户端；v2rayNG 可直接停止当前连接。更换订阅时建议新增独立分组，确认新分组可以更新和连接后，再决定是否删除旧分组。这样能保留清晰的回退路径，也便于判断问题来自哪一个订阅来源。

到这里已经完成基础配置。协议含义、客户端与内核关系可从 V2Ray 术语表 查询；需要编写入站、出站、路由、DNS 或策略字段时，再进入 配置文件参考。基础连接能够稳定工作后再修改进阶字段，排查路径会更短。