已有服务商与订阅时,先确认拿到的是节点订阅、单条节点链接,还是远程配置,再选择导入入口。本文以 iPhone / iPad 的 Home、Config、Settings 界面为操作基准,说明四种录入方式、保存后的检查方法和失败时的排查顺序;Mac、Windows、安卓、Linux 用户可按同名功能核对,按钮位置以对应平台实际界面为准。
先辨认链接类型
Shadowrocket(小火箭)的“添加订阅”常被用来泛指添加连接信息,但节点订阅和规则配置并不是同一种内容。Home 管理连接条目及节点订阅,Config 管理配置文件;Settings 则用于应用设置。把节点订阅贴进远程配置入口,即使地址能访问,也不代表能够生成可用配置。
订阅链接从你的服务商处获取。客户端买断 ≠ 线路套餐,安装客户端不会自动生成订阅或连接凭据。本文仅说明用户已有资料的录入方法,所有示例均为格式演示,不是可用连接。
| 手中资料 | 识别依据 | 录入方向 |
|---|---|---|
| 节点订阅地址 | 通常为 HTTPS 地址,返回一个或多个连接条目 | Home → + → Type → Subscribe |
| 远程配置地址 | 内容包含 [General]、[Rule] 等配置段 | Config 的远程配置入口;Subscribe 用于相应远程配置的订阅更新 |
| 单条节点链接 | 常见前缀有 ss://、vmess://、vless://、trojan://、hysteria2:// | 剪贴板识别或扫描对应二维码 |
| 分项连接参数 | 协议、服务器地址、端口及认证信息分别列出 | Home → + → Add Server 表单 |
仅凭地址以 https:// 开头,无法判断它是哪类订阅;文件扩展名也不是可靠依据。应核对服务商对该地址的用途说明。若打开后出现账户登录页或错误提示,那不是客户端所需的连接数据。
方法一:Subscribe
先分清两个使用场景:Config 页的 Subscribe 面向远程配置的订阅关系与更新,并不等于向 Home 添加节点列表。若目的是让 Home 出现服务商提供的节点,应在 Add Server 中把 Type 设为 Subscribe;若拿到的是完整规则配置,再使用 Config 的远程配置功能。
-
复制地址
从你的服务商处获取节点订阅地址,完整复制,包括问号后面的查询参数。不要附带“订阅地址:”等说明文字,也不要遗漏末尾字符。
-
选择类型
打开 Home → 右上角 +,进入 Add Server,将 Type 设为 Subscribe。不要保留默认协议后直接把整条订阅地址填入服务器地址字段。
-
粘贴保存
将地址粘贴到 URL,填写便于识别的名称后保存。名称只是本地识别信息,不会改变订阅返回的节点内容。
-
检查更新
返回 Home,确认订阅分组及条目已出现。若保存后没有条目,执行该订阅的更新操作,检查返回错误,而不是连续重复添加相同地址。
在 Config 添加远程配置时,应使用确认过的配置文件地址,再按该远程项提供的 Subscribe 功能管理更新。节点订阅的刷新与配置文件的刷新是两件事;更新其中一项,不表示另一项也已更新。
例如 https://example.com/sub?token=xxxx 只是明显假值,用于说明 URL 结构。实际地址中的 token 往往具有账户访问权限,不要上传完整截图或粘贴到公开讨论区。需要排查时,保留错误提示即可,遮盖地址路径、查询参数及账户标识。
方法二:手填参数
Add Server 手填适合服务商只给出分项参数,或需要检查单条连接字段的情况。它创建的是一个连接条目,不会自动建立节点订阅关系;服务端地址或密码变更后,通常需要自行修改该条目。
-
打开表单
进入 Home → + → Add Server,先在 Type 选择与服务端一致的协议,再填写后续字段。切换 Type 后,应重新核对已填内容。
-
填写地址
服务器地址填域名或 IP,端口单独填写。例如资料写明端口为 443,就填 443;不要把 https://、路径或“:443”一并塞入地址字段。
-
核对认证
Shadowsocks 核对加密方法与密码;VMess、VLESS 核对 UUID 及相应传输参数;Trojan、Hysteria2 核对密码及 TLS 相关参数。字段是否显示取决于所选 Type。
-
保存测试
保存后返回 Home,选中该条目再做连通性检查。若失败,逐项对照原始资料,尤其注意密码前后空格、域名拼写和端口数字。
同样使用 443 端口,不代表不同协议可以互换。TLS 的 Server Name、传输层的 Host 与服务器地址也可能不同,必须按服务端资料填写。不要为了消除报错就随意关闭证书验证,这会改变连接的安全属性,却不一定解决参数错误。
- 端口只填数字;443 是常见示例,并非所有服务的默认答案。
- UUID、密码和密钥不是同一类字段,不应相互替代。
- WireGuard 使用密钥、地址与对端参数,不能套用密码型协议的填写方法。
- 如果资料缺少必要字段,应向原服务商核实,而不是根据其他条目的值推测。
方法三:扫描二维码
二维码只是一种数据载体,可能装着单条节点链接、订阅 URL,也可能只是普通网页。扫描不会自动把网页转换成订阅。导入前应查看识别结果,确认内容类型和来源与预期相符。
-
准备原图
在另一台设备展示完整二维码,或将原图保存到当前设备。避免截掉边缘、强反光和过度压缩,图片应能清楚分辨黑白模块。
-
打开扫描
从 Home 的扫描入口进入;使用相机时授予相机权限,使用相册识别时选择原图。系统权限被拒绝后,需到设备的应用权限设置中调整。
-
核对结果
检查识别的是节点还是订阅。若只是账户网页地址,应返回服务商页面寻找明确标注的连接二维码,不要把登录页当成连接数据。
-
确认保存
确认后回到 Home 检查条目数量和名称。若导入的是单条节点,应按独立条目检查,不要预期它日后随远程订阅自动变化。
二维码中可能直接包含完整认证信息,其敏感程度与原始链接相同。截图求助时只遮住可见文字并不充分,二维码本身也需要遮盖。若识别持续失败,优先索取原始文本,通过剪贴板导入,避免反复转存低清图片。
方法四:剪贴板导入
剪贴板识别适合资料已经在当前设备上的情况。复制内容应是一条完整链接或客户端能够识别的连接数据,不应是包裹链接的整段聊天记录。系统出现粘贴授权提示时,只有允许读取后,应用才能识别剪贴板内容。
-
只复制链接
选择完整连接文本,去掉前后的引号、项目符号与解释文字。不要手动改写链接中的百分号编码、加号或等号。
-
返回应用
打开 Shadowrocket,使用出现的剪贴板识别提示;若没有提示,检查添加菜单是否提供从剪贴板导入,并确认系统允许粘贴。
-
确认类型
检查解析出的 Type、地址和端口。若复制的是 HTTPS 节点订阅地址但未被自动识别,改用 Home → + → Type → Subscribe → URL 手动粘贴。
-
清理副本
保存并核对 Home 条目后,可复制一段普通文字覆盖剪贴板,减少凭据被后续粘贴到其他位置的机会。
按资料位置选择录入方式
资料在当前设备
- 有完整节点链接:使用剪贴板识别。
- 有节点订阅 URL:优先建立 Subscribe 条目。
- 只有截图:使用扫描入口的相册识别功能。
资料在另一设备
- 有二维码:使用当前设备相机扫描。
- 只有分项参数:通过 Add Server 手填。
- 需要持续更新:获取节点订阅地址,而非只导入单个节点。
录入方式只影响数据如何进入应用,不改变服务端协议、账户权限或线路状态。
导入后的分流检查
“条目已出现”只说明数据已经保存,不等于流量已经通过该条目。先在 Home 选择要使用的节点,再检查连接开关与 Global Routing。首次建立系统网络连接时,按设备提示确认网络配置权限。
Config
推荐在已准备好并选中合适配置的前提下,按规则匹配结果决定策略。并非所有未命中请求都自动直连,最终行为取决于 FINAL 等实际规则。
适合:已有明确规则配置,需要按域名或地址分流。
Proxy
将交由客户端处理的流量按 Proxy 姿态转发,用于对照检查节点连通性。系统与配置中的特殊排除项仍需单独考虑。
适合:短时对照测试,区分节点故障与规则命中问题。
Direct
按 Direct 姿态直连。切到此项后能够打开网页,不足以证明刚导入的节点有效,因为请求可能没有经过该节点。
适合:对照本地网络是否能够直接访问目标。
规则文件与订阅需要分别验证。例如下面的片段表达规则匹配关系,不是节点订阅,也不能提供服务器连接参数。规则自上而下匹配,FINAL 放在末尾作为兜底;PROXY、DIRECT、REJECT 是策略关键字。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
延迟测试有结果也不等于网页请求一定成功。DNS、TLS、目标站点状态和规则命中都可能影响访问。验证时只改一个变量:先固定节点与目标,再对照姿态或配置,避免同时换节点、改 DNS、换规则而无法定位原因。
失败时按层排查
把失败分成“没有识别”“无法更新”“已导入但无法连接”三类,比重新安装更容易定位。保留原始错误文字,先检查输入和返回内容,再检查网络与账户状态;不要用重复创建同一订阅掩盖更新失败。
| 现象 | 先检查 | 下一步 |
|---|---|---|
| 剪贴板没有识别结果 | 粘贴权限、文本是否完整、是否误复制说明文字 | 节点订阅改为在 Subscribe 的 URL 中手动粘贴 |
| 扫描后出现网页 | 二维码是否指向账户页或帮助页 | 从你的服务商处获取对应的连接资料 |
| 更新返回 401 或 403 | 授权信息、链接有效性及服务端访问限制 | 向服务商核对,不要自行删除 token 参数 |
| 更新返回 404 | 地址路径、复制完整性、旧地址是否失效 | 重新复制当前有效地址,避免手工拼接路径 |
| 更新超时 | 当前网络能否访问订阅服务器、域名解析是否正常 | 换一个可用网络重试,并记录错误发生阶段 |
| 导入成功但无法连接 | 选中条目、Global Routing、账户状态、端口及认证字段 | 固定一个节点逐项检查,区分连接失败与规则问题 |
- 节点订阅更新可能增删或重建条目,更新前应记录自己的手动修改,不要假设本地编辑一定保留。
- 自动更新只影响获取远程内容的时机,不能修复已失效的订阅地址。
- On Demand 管理按条件建立连接的行为,不负责获取订阅;首次排查时先验证手动连接,再配置自动连接条件。
- 仍需帮助时,提供设备平台、操作入口、错误文字和失败阶段,不提供密码、UUID、密钥或完整订阅地址。