订阅链接导入教程:v2rayN 与 v2rayNG 的入口位置与常见订阅格式说明

单节点链接则直接描述一条配置，常见开头包括 vmess:// 与 vless://。它适合临时导入一条配置，但不会自动形成可定期刷新的订阅关系。把单节点链接填进“订阅地址”输入框，或者把订阅网址交给“从剪贴板导入 URL”，都可能造成导入结果为空。

客户端版本升级后，菜单文字可能出现“订阅分组”“订阅设置”或“订阅分组设置”等小幅差异，但判断入口的方法不变：需要保存网址并反复更新，就进入订阅分组；只导入一条以协议头开头的文本，就使用剪贴板导入。

v2rayN 桌面端添加与更新订阅

开始前先完整复制订阅网址，避免漏掉末尾的访问参数。若网址中包含问号、等号或连接符，应当原样保留，不要手动截断。订阅属于访问凭据，不宜贴进公开日志、截图说明或共享文档。

1. 打开分组

   启动 v2rayN，在主界面选择「订阅分组」→「订阅分组设置」。部分 7.x 界面可直接从左侧分组区域进入管理页。

2. 新建订阅

   点击「添加」或「+」，在备注中填写便于识别的名称，把完整 HTTPS 地址粘贴到 URL 输入框。

3. 保存分组

   确认启用状态后保存。此时只是记录订阅地址，服务器列表未必已经出现新配置。

4. 执行更新

   返回主界面，选择「订阅分组」→「更新全部订阅（不通过代理）」。当前网络无法直连订阅地址时，再尝试通过代理更新。

5. 选择配置

   更新完成后展开对应分组，双击一条配置或通过右键菜单设为活动服务器，再开启系统代理。

如果剪贴板里拿到的是 vmess:// 或 vless://，不要新建订阅分组。使用「服务器」→「从剪贴板导入批量 URL」，导入后检查地址、端口、传输方式和 TLS 相关字段。单条 URI 不会因为点击“更新全部订阅”而自动变化。

v2rayNG 安卓端添加订阅

v2rayNG 的订阅管理与单配置导入同样是两个入口。订阅网址应进入“订阅分组设置”，而二维码、剪贴板协议链接属于单配置导入。本文以 1.10.x 系列界面为基准，不同屏幕尺寸下，侧边菜单可能显示为左上角菜单按钮。

1. 进入设置

   打开侧边菜单，进入「订阅分组设置」。不要先点主界面的单配置添加按钮。

2. 填写地址

   点击右上角「+」，填写订阅备注和完整地址。需要时开启自动更新，但首次添加仍建议手动更新一次。

3. 保存并返回

   保存订阅分组后回到主界面，打开右上角菜单，执行「更新订阅」。等待完成提示后再查看配置列表。

4. 选中配置

   点击列表中的目标配置，使其成为当前活动项，然后点击连接按钮。首次连接会出现系统网络连接确认提示。

5. 核对结果

   连接后查看实时日志，确认没有 DNS、握手、证书名称或连接超时错误，再用浏览器访问普通 HTTPS 页面复测。

若复制的是单节点 URI，可在主界面使用「从剪贴板导入配置」。导入前确认剪贴板中只有目标链接，避免前后混入说明文字。多条链接批量导入时应当一行一条；某一行损坏通常不会改变其他行的协议参数，但可能让客户端给出部分解析失败提示。

• 更新后列表为空：先回到订阅分组设置，确认该分组已启用，地址首尾没有空格。
• 更新成功但数量不变：检查当前查看的分组是否正确，并确认服务端返回内容确实发生变化。
• 连接按钮立即恢复：打开日志核对端口、核心启动状态和配置解析错误，不要反复删除订阅。
• 需要切换内核：v2rayNG 使用 Xray 内核；需要 v2fly 内核的安卓客户端可使用 v2flyNG，但不能假定两者对新协议参数的支持范围完全相同。

Base64、VMess 与 VLESS 格式怎么识别

“Base64 订阅”通常表示订阅响应正文经过 Base64 编码，解码后才是一行一条的协议链接。Base64 是文本编码方式，不是代理协议，也不决定连接是否加密。客户端更新订阅时会负责识别和解码，正常情况下无需手工处理。

VMess 单节点常以 vmess:// 开头，后面可能是编码后的 JSON 数据，解码后可见地址、端口、用户标识、传输方式等字段。VLESS URI 通常直接用查询参数表达加密层、传输层、服务器名称、指纹和流控等设置，因此肉眼更容易看到参数结构。

订阅网址结构：
https://sub.example.com/client/feed?id=7319&token=8f2d1a

单节点结构：
vmess://编码后的配置文本
vless://[email protected]:443?security=reality&type=tcp&flow=xtls-rprx-vision#示例名称

上面的内容用于说明结构。实际导入时不要把示例地址当成可连接配置。尤其是 VLESS URI，security、type、flow、sni、fp 与公钥等字段存在组合关系；只保留地址和端口，通常不足以建立连接。

更新订阅时客户端实际做了什么

点击更新后，客户端先请求订阅地址，再识别响应是明文 URI 列表、Base64 文本还是兼容的结构化内容，随后解析每一条配置并写入对应分组。请求成功不等于每一条配置都解析成功，因此要同时观察更新提示、配置数量和日志。

部分订阅会在配置名称、服务器地址或协议参数变化时替换旧记录。手工修改订阅生成的配置，下一次更新后可能被远程数据覆盖。需要长期保留的本地调整，应复制为独立配置，并在名称中标记来源，避免与自动更新项混淆。

1. 请求阶段：解析订阅域名，建立 HTTPS 连接并等待响应。此阶段失败通常表现为超时、域名解析失败或证书错误。
2. 解码阶段：识别响应正文并尝试 Base64 解码。内容被登录页面、错误页或网关提示替换时，可能出现格式错误。
3. 解析阶段：逐条读取 VMess、VLESS 等配置，检查必要字段能否转换为客户端内部结构。
4. 写入阶段：把结果归入指定订阅分组，并根据名称或内部标识处理已有项目。
5. 使用阶段：用户选中活动配置，核心读取参数并启动本地监听端口；这一步才会产生实际连接。

导入失败按这个顺序排查

排查重点是先确定失败发生在请求、解码、解析还是核心启动阶段。若订阅更新时已经报错，就不必先调整系统代理端口；若配置已经出现但无法连接，则应转向协议参数、核心日志和本地监听状态。

还可以用交叉测试缩小范围：同一订阅在 v2rayN 能更新、在 v2rayNG 不能更新时，优先检查安卓端网络权限、系统时间和客户端版本；两端都失败时，优先检查订阅地址有效期、请求参数和服务端响应。不要在尚未确认订阅能正常返回数据时频繁更换核心设置。

导入完成后的验证清单

订阅导入只是把配置写入客户端。是否能够正常使用，还取决于活动配置、核心支持范围、系统代理或网络连接状态、DNS 处理方式以及远端参数是否匹配。按固定顺序验证，可以避免把本地代理未开启误判为订阅失效。

• 目标订阅分组已启用，更新后能看到预期数量的配置。
• 当前活动项来自正确分组，地址、端口和协议类型不是空值。
• v2rayN 核心能够启动，本地监听端口未被其他进程占用。
• 桌面端已按需要开启系统代理；v2rayNG 已完成系统连接确认。
• 核心日志没有持续出现握手、证书名称、Reality 参数或 DNS 错误。
• 更新订阅后重新选择活动配置，避免继续使用已被替换的旧记录。
• 单节点链接与订阅网址分别使用正确入口，不把两种导入方式混用。

需要迁移设备时，优先在新客户端中重新添加订阅地址并执行更新，而不是逐条复制订阅生成的节点。这样可以保留分组关系，也能在后续继续刷新。只有本地手工创建、不会由远程订阅提供的配置，才需要单独导出或重新填写。