01 · 分享链接与订阅内容

分享链接描述一个配置,订阅地址用来获取一组配置并持续更新。支持的订阅协议包括 VMess、Shadowsocks、SOCKS、VLESS、Trojan、Hy2、TUIC、WireGuard 和 AnyTLS。内容可以是标准链接、Base64 包装的多行链接或 v2rayN 内部分享格式。

一个普通网页地址不是订阅内容;如果下载结果是登录页或错误页,客户端会解析失败。应使用提供方给出的订阅 URL,完整保留其路径和查询参数。

02 · 添加并更新订阅

进入订阅分组设置,新增一个分组并填写容易识别的备注。在“可选地址”粘贴完整 URL,保存后执行更新订阅。更新成功后进入对应分组,选择配置设为活动项。

  1. 首次使用没有可用代理时,可先选择不通过代理更新;已有可用节点时可尝试通过代理更新。
  2. 确认启用更新开关。关闭该开关的分组会被跳过。
  3. 查看日志中的下载和解析结果。成功更新后原来的延迟、速度测试数据会清空。
  4. 活动配置属于更新分组时,客户端会重新处理该活动项;随后再测试连接。
过滤、合并与请求设置

03 · 内部链接的结构

内部格式用于保留普通分享链接不能完整表达的配置字段。ConfigType 标识配置类型,后面的载荷是 JSON 的 URL-safe Base64 编码。Base64 只改变表示方式,不保护密码。

内部链接适合在 v2rayN 之间传递;第三方客户端不一定支持。导入前保持完整前缀和载荷,不要把 URL-safe Base64 中的 -、_ 手动换成其他字符。

Internal share format复制
v2rayn://<ConfigType>/<URL-safe Base64 JSON>

04 · JSON 载荷与引用

普通配置包含类型、版本、备注、地址、端口及协议所需认证字段。IndexId 可为空;当策略组或链式代理需要引用配置时,应为被引用项提供稳定且唯一的 IndexId。

下面仅展示内部 HTTP 配置的结构,example.com 与用户名密码都是示意值。载荷编码后仍包含凭据,分享前应确认接收对象。

JSON · illustrative HTTP profile复制
{
  "IndexId": "example-http",
  "ConfigType": 10,
  "ConfigVersion": 4,
  "Remarks": "Example HTTP",
  "Address": "example.com",
  "Port": 8080,
  "Username": "example-user",
  "Password": "replace-me"
}

05 · 策略组与动态筛选

策略组可用 ProtoExtraObj.ChildItems 引用其他配置的 IndexId;SubChildItems 设为 self 时,可结合 Filter 正则筛选当前订阅分组。内部格式不支持自定义配置。

订阅中的节点会在更新时重新生成,手动绑定这些节点可能失效。需要自动跟随更新的组,应使用订阅分组与别名正则筛选;手工选择项更适合稳定的自建配置。链式代理中的顺序按实际流量方向排列。

策略组设置代理链设置

06 · 下载成功但没有节点

先看返回内容是否为支持格式,而不是网页、验证码或访问错误;再检查别名过滤是否把全部节点排除了。合并多个订阅时,内容类型应一致。提供方可能根据 User Agent 返回不同格式,未明确要求时保留默认值。

不要用重复导入来掩盖解析问题。保留原分组,先修正 URL、格式或过滤条件,再重新更新;必要时用单条分享链接确认客户端解析能力。

07 · 订阅分组字段

分组可以单独保存来源,也可以合并相同格式的内容。保存后需要执行更新,过滤和请求设置才会应用到新获取的内容。

字段行为
可选地址 / 更多地址主 URL 放可选地址;其他 URL 用逗号分隔。合并时类型应一致,更多地址非空会停用订阅转换
别名正则过滤更新后只保留匹配的别名;空结果先检查表达式
订阅转换目标类型经转换服务获取内容;多地址合并时不生效
User Agent默认 v2rayN/版本号,可能影响提供方返回格式
自定义 HTTP 标头7.25.6 新增;只填写提供方要求的请求头,认证值属于敏感信息
前置 / 落地代理别名引用唯一的现有配置名称
自定义配置的 Socks 端口订阅被解析成自定义配置时,将此端口写入配置项

08 · 备份和还原

备份对象是整个 guiConfigs 文件夹,包含客户端设置、配置数据库与自定义配置。使用“备份和还原”保存 ZIP;非 Windows 系统要明确填写 zip 扩展名,还原对话框只接受 ZIP。

还原会替换相应配置并重启客户端,操作前先备份当前状态。自动重启失败时手动启动。备份包含订阅 URL 和凭据,保存在自己控制的位置;迁移后检查本地文件路径和核心可执行文件是否在新设备存在。

参考资料官方文档

步骤与参数已在本页展开,参考链接用于标注资料来源。核对日期:2026-10-19。