先看链接前缀,再选导入入口。vmess:// 与 vless:// 通常承载单个节点的连接参数;订阅地址用于获取可更新的节点列表。本文适合首次配置 v2rayN 或 v2rayNG 的用户,按链接识别、剪贴板导入、订阅更新和故障排查的顺序操作,并说明哪些参数不能随意改动。
分享链接与订阅地址:导入对象不同
分享链接是连接配置的文本表示。常见的 vmess:// 链接在前缀后放置 Base64 编码的配置,解码后通常包含服务器地址、端口、用户标识、传输方式和备注。vless:// 常采用 URI 结构,把用户标识、地址、端口放在主体中,其他选项放在查询参数中。两种链接都不是供浏览器访问的普通网页。
订阅地址通常以 https:// 开头。客户端向这个地址发起请求,再解析返回的节点列表。返回内容可能是逐行排列的分享链接,也可能是这些文本的 Base64 编码形式;具体格式由提供方决定。一个订阅也可能只返回一个节点,不能单凭节点数量判断是否为订阅。
订阅地址
推荐为节点列表建立更新来源。提供方调整地址或增加节点后,客户端需要成功更新订阅才会取得变化;不是保存地址后就实时同步。
适合:提供方明确提供客户端订阅,且需要长期维护节点列表。
单条分享链接
导入当前这份节点参数。服务器更换端口、用户标识或传输设置后,旧配置不会自行修改,需要重新导入或手动编辑。
适合:临时测试一个节点,或接收管理员提供的独立连接配置。
判断:先确认提供方标注的用途
收到 vmess:// 或 vless:// 就使用分享链接导入入口;收到 HTTPS 地址时,先确认它是“订阅地址”而非登录页、购买页或说明页,再添加订阅分组。
链接参数:服务器端口与本地端口不能混用
下面是用于解释结构的 VLESS 示例。域名与用户标识仅作演示,没有对应的可用服务。真实链接必须使用提供方给出的完整参数,不能把示例直接当作节点。
vless://[email protected]:443?encryption=none&security=tls&type=ws&host=node.example.com&path=%2Fproxy&sni=node.example.com#demo-ws
| 字段 | 示例含义 | 导入时的检查项 |
|---|---|---|
node.example.com:443 | 服务器地址与远端端口 | 不要替换成本机代理监听端口。 |
encryption=none | VLESS 的协议参数 | 不等于整个连接没有加密;示例由 TLS 保护传输。 |
security=tls | 启用 TLS 传输安全 | 按服务端要求配置,不随意关闭证书验证。 |
type=ws | 使用 WebSocket 传输 | 传输类型、Host 与路径必须匹配服务端。 |
path=%2Fproxy | URL 编码后的路径 /proxy | 保留原链接编码,不用聊天软件排版后的文本替代。 |
sni | TLS 握手使用的服务器名称 | 可能与连接地址不同,不能直接删掉。 |
#demo-ws | 节点备注 | 用于列表识别,不是账号密码。 |
VMess 和 VLESS 是代理协议,WebSocket 是传输方式,TLS 是传输安全层。分享链接能被识别,不代表所选内核支持其中每一个选项。v2rayNG 使用 Xray 内核;v2flyNG 使用 V2Fly 内核。若提供方要求特定的 Xray 功能,应先确认客户端和内核支持情况,而不是只看链接是否以 vless:// 开头。
v2rayN 导入:剪贴板与订阅分组分开操作
桌面端先复制完整文本,再选择相应入口。以下使用常见中文菜单名称;不同版本或桌面界面的文字可能略有差异,但“导入分享链接”和“更新订阅”是两条独立流程。操作前建议记下当前分组名,避免把测试节点混入长期使用的列表。
单条或多条分享链接
- 复制从
vmess://或vless://开始的完整链接,不带说明文字、引号或代码围栏。多条链接通常可以每行一条批量复制。 - 打开 v2rayN,在「服务器」菜单中选择「从剪贴板导入分享链接」。支持该快捷键的桌面版本也可在主窗口使用
Ctrl+V。 - 检查新增记录的地址、端口、协议与传输方式。备注为空不一定是导入失败,但地址或用户标识缺失就需要重新检查原文。
- 选中目标节点并设为活动服务器。随后按需求设置系统代理;“已导入”只说明配置进入列表,不表示应用流量已经走代理。
添加订阅并获取列表
- 复制提供方明确标注的订阅 URL。进入「订阅分组」→「订阅分组设置」,新增分组。
- 填写可辨识的分组名称,在地址字段粘贴完整 URL 并保存。若界面显示更新开关,确认该分组允许更新。
- 回到「订阅分组」,执行更新当前分组或更新全部订阅。菜单提供「不通过代理」与「通过代理」两种方式时,按订阅地址实际可达性选择。
- 确认分组下出现节点,并查看更新结果。若只有分组名而没有记录,先排查下载与解析,不要反复新建同名分组。
v2rayNG 导入:先添加配置,再建立 VPN 连接
安卓端的剪贴板导入同样只处理配置。首次启动连接时,系统会请求授权建立 VPN 连接;授权用于让客户端接管选定流量,不是订阅登录。先完成列表导入,再决定路由或分应用设置,可以减少同时更改多个选项造成的排查困难。
- 分享链接:复制完整链接,打开 v2rayNG,点击主界面右上角「+」→「从剪贴板导入」。导入后核对节点详情,选中该节点。
- 订阅地址:打开侧边菜单「订阅设置」,点击「+」,填写备注和 URL 后保存。不要把 HTTPS 订阅地址粘贴到单节点服务器地址字段。
- 更新列表:返回配置主界面,打开右上角菜单,选择「更新订阅」。等待更新结束,再检查对应订阅分组的记录。
- 启动连接:点击连接按钮,首次使用时确认系统授权。先测试目标应用,再按实际需要调整分应用代理和路由规则。
双端方案:同一订阅分别保存与更新
桌面端:v2rayN
- 在订阅分组设置中保存地址。
- 更新后选择活动服务器。
- 为支持系统代理的应用设置代理入口。
安卓端:v2rayNG
- 在订阅设置中独立添加同一地址。
- 在配置列表执行更新订阅。
- 建立 VPN 连接后检查应用访问情况。
两端各自维护配置,更新成功后才取得各自请求时的列表;使用前还需确认提供方允许多设备使用。
订阅只提供节点配置,不一定包含客户端的路由预设、DNS 设置、系统代理开关或分应用规则。因此,两台设备使用同一订阅,也可能因为本地设置不同而表现不同。迁移设备时应分开记录节点来源与本地设置,不要认为一次订阅更新会复制所有选项。
更新失败与列表为空:按请求、内容、连接逐层检查
先判断失败发生在哪一层。请求超时表示客户端没有及时取得响应;解析失败表示拿到了内容但无法转换成支持的配置;节点能导入却无法连接,则要检查服务端参数、内核能力与网络路径。三类问题使用不同的修复方法。
复制了订阅地址,为什么剪贴板导入显示没有配置?
HTTPS 地址应添加到订阅设置,再执行更新。只有 vmess://、vless:// 等分享文本才走单节点导入入口。若提供方给的是网页地址,需要先从页面获取真正的客户端订阅 URL。
订阅更新一直超时,要切到通过代理吗?
先确认当前有可用节点,并已启动代理连接,再尝试通过代理更新。若没有可用连接,应检查直连网络、地址是否过期及提供方服务状态。不要把“通过代理”当作通用修复开关。
更新返回成功,但节点数还是零怎么办?
检查当前分组筛选条件,再查看日志是否报告解析失败。订阅接口可能返回登录页、账户到期提示或客户端不支持的格式。向提供方确认适用于 v2rayN 或 v2rayNG 的订阅格式,不必先重装客户端。
VLESS 已经导入,为什么仍然连不上?
核对地址、远端端口、用户标识、传输类型、SNI 和路径。若链接使用 REALITY,还需核对公钥、shortId 及提供方要求的相关参数,并确认所用 Xray 内核支持。保留原链接,不要擅自删掉不认识的字段。
重新更新以后,手动改过的节点为什么恢复了?
订阅更新可能按远端内容重新生成分组内记录。需要长期保留的手工修改,应另存到非订阅管理的分组,并记录修改原因;不要依赖订阅分组中的临时编辑持续存在。
HTTP 状态码也能帮助缩小范围。401 或 403 通常需要检查访问权限、订阅令牌或提供方限制;404 需要确认路径是否仍有效;429 表示请求可能受到频率限制,应停止连续刷新。具体原因以接口响应和提供方说明为准,不要仅凭状态码断言账号失效。
订阅隐私与维护:完整链接按凭据保存
分享链接内的用户标识、订阅 URL 中的令牌都可能授予访问权限。Base64 是编码,不是用于保护秘密的加密。把完整链接发布在公开聊天、工单截图或在线解码工具中,都可能让第三方取得配置;排查时只提供已脱敏的字段和错误信息。
- 复制前:从可信来源取得地址,保留大小写、查询参数和 URL 编码,不额外添加空格或中文标点。
- 更新前:确认分组、当前可用节点及更新方式。频繁失败时先看日志,不连续点击更新。
- 反馈时:遮住完整用户标识、订阅令牌和二维码。日志中若出现完整请求 URL,也需要先脱敏。
- 泄露后:在提供方账户中重置订阅令牌或连接凭据,再更新各设备保存的地址;仅删除聊天记录不能撤销已经复制的凭据。
- 迁移时:分别检查订阅、活动节点、系统代理或 VPN 连接以及路由设置,确认实际应用能够正常访问。
执行顺序:导入、更新、选中、连接、验证
单条分享链接跳过更新订阅这一步;订阅地址必须先获取列表。每次只处理一个阶段,遇到错误就记录该阶段的日志,再决定检查链接格式、网络路径还是节点参数。