先判断拿到的是服务器订阅 URL、单条服务器分享链接,还是远程配置文件,再选择导入入口。本文面向已经拥有自己的服务商与订阅的用户,说明 Subscribe、Add Server、扫码和剪贴板的用途,并把 Config 中的远程配置与 Home 中的服务器列表分开核对;导入完成后,还需选中服务器并测试连接。
一、先分清服务器订阅与远程配置
Shadowrocket(小火箭)中的“订阅”首先表示一种远程更新关系,不代表所有订阅内容都应放进同一个页面。Home 主要管理服务器与连接;Config 管理配置文件及规则;Settings 管理应用设置。导入后列表没有变化时,先检查所在页面,通常比反复粘贴更有效。
服务器订阅通常是一个 HTTPS URL,返回可识别的服务器列表。远程配置也可以使用 HTTPS URL,但内容可能包含 [General]、[Rule] 等配置段。两者外观相似,不能仅凭链接以 https:// 开头就判断用途;应以已有订阅的用途说明和返回内容为准。
| 已有内容 | 对应处理 | 导入后核对 |
|---|---|---|
| 服务器订阅 URL | Home → + → Type → Subscribe | Home 中的订阅分组与服务器条目 |
| 服务器参数 | Home → + → Add Server 编辑页,选择实际 Type | 服务器地址、Port、认证参数 |
| 服务器分享二维码 | Home 的扫描入口 | 识别后的类型与目标地址 |
| 剪贴板中的分享链接 | 复制完整文本后返回应用,确认识别结果 | 导入的是单条服务器还是订阅 |
| 远程配置 URL | Config 中的远程配置添加与订阅管理 | 配置是否下载,以及是否被选中使用 |
二、Subscribe:服务器订阅与 Config 分开处理
如果目标是批量添加服务器,应从 Home 进入添加页,把 Type 设为 Subscribe,而不是把服务器订阅直接当作规则文件使用。示例 https://example.com/sub?token=xxxx 仅用于说明 URL 结构,不是可用订阅。实际操作时应完整复制用户自己已有的地址,包括问号后的查询参数。
-
核对内容
确认来源说明标注的是服务器订阅,并保留完整 URL。不要复制网页标题、说明文字或链接外层的引号。
-
选择类型
打开 Home → 右上角 +,进入 Add Server 编辑页,在 Type 中选择 Subscribe。
-
填写地址
把自己的订阅 URL 粘贴到对应地址栏,并填写便于辨认的备注。保存前检查是否混入换行、空格或中文标点。
-
保存更新
保存后返回 Home,检查订阅分组及其条目;需要重新获取内容时执行该订阅的更新操作,等更新结束后再核对列表。
如果看到的是 Config 页的 Subscribe 或远程配置订阅管理,应先确认对象是配置文件。配置文件中的 DOMAIN-SUFFIX、IP-CIDR、GEOIP 和 FINAL 属于规则体系,不能与服务器地址、密码等参数混为一谈。远程配置下载成功,也不等于 Home 已经出现可连接的服务器。
三、Add Server:手填适用于完整参数
Add Server 是添加服务器的编辑入口,Subscribe 则是其中一种 Type。手填单条服务器时,要选择实际协议类型,例如 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard,而不是因为拿到了一个地址就统一选择 Subscribe。
手填的前提是参数完整。只有域名和 Port 通常不足以建立连接;不同协议还可能需要密码、UUID、密钥、TLS 或传输层参数。字段之间存在对应关系,不能根据另一条服务器的设置补齐未知值。
- 地址与 Port:地址栏填写服务器域名或 IP,Port 填写对方给出的端口号。即使使用 TLS,端口也不一定是
443,应逐项照原始参数填写。 - 认证字段:区分密码、UUID 与密钥,不要把订阅 URL 中的 token 填进服务器密码栏。
- TLS 与名称:如果原始参数包含 SNI 或服务器名称,应按原值填写;证书验证失败时先检查名称和设备时间。
- 传输参数:Path、Host 等值可能区分大小写,路径中的斜杠也属于参数。缺失时应向既有配置来源核对。
- 保存结果:保存后回到 Home,确认出现的是预期服务器,而不是仅保存了一个尚未获取内容的订阅分组。
如果已经拿到完整的 ss://、vmess://、vless:// 或 trojan:// 分享链接,优先让应用识别整条链接,再核对解析结果。手动拆解编码内容容易遗漏参数;能识别出条目也只表示解析完成,连接是否可用仍需单独测试。
四、扫码与剪贴板:改变输入方式,不改变内容类型
扫码适合另一块屏幕上展示二维码的场景。打开 Home 的扫描入口,首次使用时允许相机权限,把完整二维码放入取景范围。二维码被识别后,先看结果是服务器分享链接、订阅 URL,还是普通网页地址,再确认导入。
剪贴板适合在同一台 iPhone 或 iPad 上收到文本链接的场景。复制完整内容后返回 Shadowrocket;出现剪贴板识别或导入提示时,核对条目再确认。系统询问是否允许粘贴时,应根据本次操作授权。没有自动提示时,可在相应添加页手动粘贴,不能据此认定链接已经失效。
输入方案:另一块屏幕与当前设备
另一块屏幕
- 使用 Home 扫描入口读取完整二维码。
- 避免反光、遮挡和二维码边缘被裁切。
- 识别为网页时,先确认它是否只是说明页面。
当前设备
- 复制完整分享文本,返回应用核对识别结果。
- 复制 URL 时保留
?、&与后续参数。 - 自动识别未出现时,在对应添加页手动粘贴。
扫码和剪贴板只是输入通道;最终进入服务器列表还是配置管理,取决于内容本身。
订阅地址与二维码可能携带访问凭据。排错截图应遮住完整 token、密码和分享二维码;如需描述现象,保留错误文字、操作入口及发生阶段即可。不要为检查内容把真实订阅提交给不明转换页面。
五、订阅与手填的设置取舍
已有服务器订阅且需要持续更新列表时,保留 Subscribe 关系更便于维护;只有单条参数或需要核对某一字段时,手填更直接。下面比较的是 Shadowrocket 内的添加设置,不涉及服务质量判断。
Subscribe 设置
推荐对已有服务器订阅的用户,保存订阅 URL 后可以再次获取远程列表。更新结果由远程内容决定,更新前应留意手动改动的条目是否需要保留。
适合:已有完整订阅 URL,需要维护一组服务器。
单条服务器设置
选择实际协议并填写参数,便于逐项检查地址、Port 和认证字段。它不会因为另一个订阅发生变化而自动获得新的参数。
适合:只有完整单条参数,或需要隔离检查某一服务器。
扫码导入一次服务器,并不会自动建立订阅更新关系;剪贴板导入也同样如此。判断能否更新,应看保存的是订阅 URL 还是独立服务器条目,而不是看最初通过哪一种输入方式添加。
六、导入失败:按发生阶段检查
把“无法导入”“更新失败”“无法连接”分开记录。前者通常发生在内容识别阶段,中间一项发生在获取或解析远程内容时,最后一项则发生在已经存在服务器条目之后。三者检查方向不同,反复更换导入入口不一定能解决问题。
| 观察到的现象 | 先查哪一项 | 下一步 |
|---|---|---|
| 提示无法识别文本 | 是否复制了完整链接及正确协议前缀 | 去掉外层说明文字,保留链接内部字符后重新粘贴。 |
| 订阅更新返回 401 或 403 | URL 凭据是否完整、订阅权限是否有效 | 向用户已有的配置来源核对,不先修改服务器协议参数。 |
| 订阅更新返回 404 | 路径是否过期或复制错误 | 核对完整路径,不能只检查域名是否能打开。 |
| 更新显示超时 | 当前网络能否访问订阅地址 | 分别在 Wi-Fi 与蜂窝网络检查,并记录是否只有一种网络失败。 |
| 请求成功但没有服务器 | 返回内容是否为登录网页、错误页面或配置文件 | 确认订阅格式与导入入口,不以 HTTP 成功替代格式检查。 |
| 服务器已出现但无法连接 | 是否选中服务器,参数与路由设置是否匹配 | 转入连接诊断,不再重复导入同一条目。 |
导入后的最小验证
- 返回 Home,点选要使用的服务器,确认左侧出现选中标记。
- 检查 Global Routing。Config 按当前配置规则处理,Proxy 使用代理路径,Direct 使用直连路径;Scene 涉及场景设置,测试时要同时核对其实际选择。
- 打开 Home 连接开关;首次连接时按系统提示允许添加 VPN 配置。
- 运行 Connectivity Test,记录测试结果。测试成功只能说明相应测试目标在当时可达,不能代表所有请求都正常。
- 若连接会自动恢复,再到 Settings → On Demand 核对按需连接设置,避免把自动重连误判为导入异常。
到这一步,订阅获取、内容解析与连接测试已经分别核对。继续排查时应保留错误提示和操作顺序,先改一个变量再重试,例如只更换当前网络,或只核对一个参数,避免同时改动订阅、规则和连接设置后无法判断原因。规则语法可继续查阅规则手册。