本文速览

已有自己的订阅或服务器信息时,先判断拿到的是订阅 URL、单节点 URI,还是远程配置文件,再选择 Subscribe、Add Server、扫码或剪贴板入口。本文说明 Shadowrocket(小火箭)中这些入口的使用边界,并给出导入后的核对顺序;保存成功只表示内容已写入,不等于服务器已经可用。

先区分订阅、单节点与配置文件

订阅通常是一个可更新的 URL,应用请求该地址后读取服务器列表。单节点 URI 则把一台服务器的协议和连接参数编码在一段文本中,通常只添加一个条目。两者都可能通过二维码或剪贴板传递,因此“扫码”和“复制”只是输入方式,不是内容类型。

Config 管理配置文件,Home 显示服务器及订阅分组,Settings 管理应用设置。远程配置文件也可能使用 HTTPS 地址,但其内容是规则、DNS 与策略等设置,不能因为它看起来像网址,就把它当作服务器订阅导入。

订阅 URL

示意地址
https://example.com/sub?token=xxxx
导入类型
Subscribe
保存对象
可通过原地址更新的服务器分组
敏感内容
路径、查询参数及访问令牌

以上为假值示例,不是可用订阅;实际填写用户已有的完整地址。

单节点 URI

常见前缀
ss://、vmess://、vless://、trojan://
保存对象
某一台服务器的连接参数
导入方式
扫码、剪贴板,或按参数手填
更新方式
普通独立条目不会自动变成可更新订阅

协议前缀有助于识别内容,但不代表该 URI 的字段一定完整或正确。

拿到链接时,先看提供信息中对内容类型的说明。若只拿到一个网页入口,应取得其中明确标注的订阅地址或服务器参数,而不是把登录页、订单页、说明页直接粘贴到 Subscribe。不要通过公开的在线转换工具试探含令牌的私人链接。

Subscribe:添加可更新的服务器列表

服务器订阅可从 Home 右上角的“+”进入 Add Server,在 Type 中选择 Subscribe。搜索“Config 页 Subscribe”的用户需要特别区分:Config 中的远程配置操作与 Home 中的服务器订阅并非同一种对象。若当前界面出现 Subscribe,先核对其所在页面和目标内容,不要把远程配置地址与服务器订阅地址互换。

  1. 确认内容

    准备自己的订阅 URL,确认文本包含完整协议头、路径和查询参数,不带引号、换行或聊天消息中的说明文字。

  2. 打开入口

    进入 Home → 右上角“+” → Add Server → Type → Subscribe,确认正在添加服务器订阅,而非 Config 中的远程规则配置。

  3. 粘贴地址

    将完整地址填入 URL。名称或备注仅用于辨认分组,可以使用自己的用途标记,不要把整个订阅地址当作公开备注。

  4. 保存并更新

    保存后返回 Home,查看是否出现订阅分组及服务器条目。若尚未取得列表,对该订阅执行更新,再观察返回结果。

  5. 检查结果

    展开分组,核对名称、协议和条目数量是否与已有信息相符。若分组为空,先排查请求或格式问题,不要连续重复添加相同地址。

初次保存后的列表获取与后续更新都依赖订阅地址可访问且返回兼容内容。已有分组时,应更新原分组,而不是每次重新导入。重复添加会让相似名称同时出现,增加选择错误条目的可能性。

Add Server:按字段手动添加单台服务器

只有服务器地址、端口、密码或 UUID 等字段时,使用 Home → “+” → Add Server 手填。Type 应选择实际协议,而不是因为手里有一个域名就选择 Subscribe。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的字段结构不同,不能直接套用同一张参数表。

字段类别核对内容常见错误
Type与已有服务说明中的协议一致把 VLESS 参数填入 VMess 条目
Address服务器域名或 IP 地址把完整网页 URL 连同路径填入地址栏
Port服务实际监听端口,数值范围为 1–65535看到 TLS 就擅自改为 443
身份凭据按协议填写密码、UUID 或密钥复制时带入空格,或把备注当作密码
TLS 与传输逐项核对 TLS、SNI、传输类型及路径等适用字段认为域名相同就可忽略 SNI 或路径差异

端口 443 只是常见服务端口之一,不是通用答案。TLS 是否启用、服务器名称如何填写、是否使用 WebSocket 等传输,都应以已有配置为准。WireGuard 还涉及密钥、地址与 Peer 等专用参数,不宜从普通代理的密码字段反推。

扫码与剪贴板:按内容选择处理方式

扫码入口可在 Home 的扫描图标进入,使用相机时按系统提示授予权限。二维码可能包含单节点 URI、订阅 URL,也可能只是普通网页地址。扫描后先查看识别结果与确认界面,再决定是否保存;不要把“识别到二维码”等同于“已添加服务器”。

二维码与剪贴板的导入检查

二维码在另一块屏幕上
  • 在 Home 打开扫描入口,让二维码完整进入取景区域。
  • 检查识别内容是订阅 URL 还是单节点 URI。
  • 确认保存后回到 Home 查看新增分组或条目。
  • 若显示普通网页地址,先取得真正的配置内容。
文本在当前设备上
  • 只复制完整链接,不连同标题、项目符号或解释段落一起复制。
  • 返回 Shadowrocket,若出现剪贴板导入提示,先核对识别内容。
  • 系统询问粘贴权限时,按本次导入需要允许读取。
  • 若未出现识别提示,订阅 URL 可直接粘贴到 Subscribe 的 URL 字段。

扫码和剪贴板改变的是输入方式;是否形成可更新分组,仍取决于导入的是订阅还是独立服务器。

二维码保存在当前设备时,若扫描界面提供从照片读取的入口,可选择原始图片;否则优先使用内容提供方同时给出的文本链接。裁切、缩放和图片压缩都可能导致识别失败,不应通过重新编码私人链接的公开网页来解决。

剪贴板没有提示不一定是格式错误,也可能与系统粘贴权限或当前界面有关。先确认复制的是完整原文。对于单节点 URI,不要把它硬塞进 Subscribe 的 URL 字段;应使用可识别 URI 的导入入口,或按已知完整参数手填。

如何选择 Subscribe 与独立服务器条目

选择标准是是否需要通过原地址维护服务器列表,而不是哪种入口步骤更少。用户已有可用订阅时,保留订阅关系便于后续更新;只有固定单台服务器参数时,独立条目更直接。下面比较的是 Shadowrocket 内部的两种保存方式。

Subscribe 订阅分组

推荐

保存订阅来源,通过更新重新读取列表。更新可能改变服务器名称、数量或参数,因此应把订阅视为由原来源维护的集合。

适合:已有订阅 URL,且需要持续接收列表变化。

Add Server 独立条目

保存一台服务器的参数,便于逐项核对。普通独立条目不依赖订阅地址更新,参数变化时需要重新导入或手动修改。

适合:已有完整单台服务器参数,或需要独立核对一个连接。

若同一台服务器同时出现在订阅分组和独立列表中,它们是两个保存对象。修改其中一个,不应假定另一个会同步变化。清理重复条目前,先确定当前选中的是哪一个,并保留原始信息以便恢复。

导入后:先核对列表,再检查连接

完整检查可分为保存、获取、连接三层。保存失败应检查输入;订阅获取失败应检查 URL 与响应;列表已经存在但网页打不开,则应检查服务器参数、路由模式与 DNS。不要在第三层出现问题时反复删除第一层的订阅记录。

4 种
本文入口:Subscribe、Add Server、扫码、剪贴板
4 项
Global Routing:Proxy、Direct、Config、Scene
1–65535
手填 Port 的有效数值范围,实际值由服务配置决定
  1. 确认 Home 列表。订阅分组不为空,目标服务器能够选中,协议与预期一致;延迟测试有结果也不代表所有网站均可访问。
  2. 确认 Global Routing。Proxy 用于代理路径,Direct 用于直连路径,Config 按当前配置处理,Scene 按已设场景处理。选择应与测试目标一致,不能只看连接开关。
  3. 确认系统授权。首次启用连接时按系统提示添加 VPN 配置。授权完成后,再观察连接状态与请求表现。
  4. 确认 Config。使用 Config 模式时检查实际启用的配置。DOMAIN-SUFFIX、GEOIP、IP-CIDR 等规则决定匹配条件,FINAL 处理此前未命中的请求;导入服务器订阅不等于已经配置好这些规则。
  5. 暂缓自动触发。Settings → On Demand 用于按需连接条件,不能修复错误凭据或失效链接。先完成一次手动连接验证,再调整自动触发设置。

常见导入问题与处理顺序

保存订阅后只有分组,没有服务器怎么办?

先对原分组执行更新,再检查错误信息。确认 URL 没有缺少 token、没有多余空格,且不是登录页面。若请求返回的是网页、空内容或不兼容格式,保存地址本身仍可能成功,但无法生成有效列表。不要靠重复添加同一地址修复响应内容。

出现 HTTP 401、403 或 404,分别检查什么?

401 通常表示认证未通过,403 表示请求被拒绝,404 表示请求的资源未找到;这些状态码只能帮助定位,不能单独证明具体原因。检查完整链接是否变化、令牌是否仍有效,以及当前网络是否能访问该订阅来源。求助时提供状态码,不公开完整 URL。

二维码能扫出来,为什么没有导入多个服务器?

先看识别到的内容。单节点 URI 通常只对应一个条目;只有指向服务器列表的订阅地址,才可能生成订阅分组。若二维码承载的是说明网页,则需要从自己的原始资料中取得实际订阅或参数,不能通过扫码动作把网页转换成订阅。

应该把 Config 中的远程文件地址粘贴到 Subscribe 吗?

不应只凭地址外观决定。远程配置包含路由、DNS 等设置,服务器订阅主要提供服务器列表,二者可能同为 HTTPS 地址。先核对内容用途:配置文件在 Config 管理,服务器订阅从 Home 的 Subscribe 类型添加。导入配置前还应了解它将如何处理请求。