本文适合已经拥有自己的订阅或服务器资料、准备在 iPhone 或 iPad 上导入 Shadowrocket 的用户。先区分服务器订阅与远程配置,再按 Subscribe、Add Server、扫码、剪贴板四类入口选择操作;完成后核对服务器列表、更新结果与 Global Routing,避免把“地址已保存”误认为“连接已可用”。
一、导入前先分清订阅、单条链接与配置
Shadowrocket(小火箭)是 Apple 平台上的付费客户端,购买应用与取得连接服务是两件事。本文以用户已经拥有自己的服务商与订阅为前提;本站不提供、不销售、不推荐节点或订阅。应用只通过 App Store 获取,正版身份与购买说明见正版核验页。
四种入口不是四种协议,也不保证最终生成相同内容。订阅地址通常指向可更新的服务器列表;单条分享链接描述一条连接;远程配置则可能包含规则、DNS 与策略等设置。判断应依据链接实际返回的内容和提供方说明,不能只看地址是否以 https:// 开头。
| 手中的资料 | 识别依据 | 应核对的结果 |
|---|---|---|
| 服务器订阅 | 提供方明确标注为订阅地址,返回受支持的服务器列表 | Home 中出现订阅分组及服务器条目 |
| 单条分享链接 | ss://、vmess://、vless://、trojan:// 等前缀 | 出现对应协议的一条服务器记录 |
| 手填参数 | 给出了协议、服务器地址、端口及认证资料 | Add Server 中的字段与原始资料一致 |
| 远程配置 | 提供方明确说明是 Shadowrocket 配置文件 | Config 中出现配置,另行核对是否启用 |
订阅 URL 中的查询参数经常携带访问凭据。不要把完整链接发到公开讨论区,也不要把二维码当成不含敏感信息的普通图片。下文的 https://example.com/sub?token=xxxx 是说明格式用的假值,不能用于连接或测试。
二、Subscribe 入口:先核对 Config 与 Home 的职责
查找“Config 页 Subscribe”时,首先要确认正在处理哪一种资源。Config 主要管理配置文件,Home 主要显示服务器和连接状态,Settings 管理应用设置。即使某个入口带有 Subscribe 字样,也不意味着任意服务器订阅都应该粘贴到 Config。
普通服务器订阅可以从 Home → + → Add Server → Type → Subscribe 添加,其中 Add Server 是添加页面的标题。若手中明确是远程配置,应使用 Config 的远程配置添加入口,并在导入后核对配置内容。不要为了寻找某个文字标签,把服务器列表地址反复导入配置列表。
-
确认资料
确认提供方给出的是服务器订阅地址,而不是账户管理网页、付款页面或远程配置地址。
-
打开添加页
进入
Home → +,在Add Server → Type中选择Subscribe。 -
填写地址
将完整订阅地址粘贴到
URL,在Remarks填写可辨认的名称。保留地址中的路径、问号及其后全部参数。 -
保存并更新
点击
Done返回 Home,等待列表获取完成;需要重新获取时,在 Home 下拉刷新订阅列表。 -
检查分组
展开对应订阅,确认实际出现服务器条目。只有分组名称、没有条目时,继续检查请求结果和订阅格式。
三、Add Server 手填:适合已有完整连接参数
手填适合只有服务器参数、没有可识别分享链接的情况。它创建的是服务器记录,不会凭空生成可刷新的订阅。进入 Home → + → Add Server 后,先选 Type,再填写该协议对应的字段;不同协议的认证资料不能混用。
Shadowsocks 参数核对
- Type
- Shadowsocks
- Address
- example.com,仅为假值
- Port
- 8388,仅为格式示例
- Method
- 与原始资料指定的加密方式一致
- Password
- 使用自己的认证资料,注意首尾空格
8388 不是必填的固定端口。实际端口必须采用用户已有服务的参数。
VLESS 参数核对
- Type
- VLESS
- Address
- example.com,仅为假值
- Port
- 443,仅为格式示例
- UUID
- 逐字核对自己的用户标识
- TLS 与传输
- 按原始资料核对服务器名称、传输方式及相关参数
端口 443 本身不能证明启用了 TLS,也不能替代完整的传输设置。
例如服务器地址与端口正确、但 TLS 服务器名称或 WebSocket 路径错误时,仍可能出现连接失败。不要只凭一次延迟测试判断整套参数正确。VMess、Trojan、Hysteria2、WireGuard 也各有自己的认证和传输要求,应逐项依据已有资料填写,而不是套用另一种协议的字段。
- 先核对
Type,再核对地址、端口、认证与传输参数。 - 数字端口不要夹带空格、中文标点或域名。
- 修改记录后重新测试;不要同时改动协议、DNS 和规则,否则难以定位原因。
- 需要长期跟随提供方更新时,优先使用对方提供的有效订阅,而不是手工维护大量条目。
四、扫码与剪贴板:入口不同,内容仍须核对
扫码和剪贴板是把文本送入应用的方式,不负责改变文本的含义。一个二维码既可能装着单条 ss:// 链接,也可能装着订阅 URL 或普通网页地址。导入后必须查看得到的是一条服务器、一个订阅分组,还是无法识别的内容。
按资料所在位置选择入口
资料在另一块屏幕
- 在 Home 点击扫描入口,按提示允许相机访问。
- 让二维码完整进入取景范围,避免反光或裁掉边缘。
- 识别后检查链接类型与预览字段,再确认添加。
- 若只添加了一条服务器,先检查原二维码是否本来就是单条链接。
资料在当前设备
- 复制完整链接,不要连同说明文字、引号或句末标点一起复制。
- 切回 Shadowrocket,若出现剪贴板读取或导入提示,核对来源后确认。
- 未出现提示时,可将订阅 URL 粘贴至 Add Server 的 Subscribe 表单。
- 单条分享链接应使用应用提供的链接导入提示,不要当作服务器地址字段填写。
二维码与剪贴板中可能包含同一份凭据;传递方式改变,不会增加订阅权限或自动补齐缺失参数。
iPhone 或 iPad 可能询问是否允许从其他应用粘贴。拒绝后未出现识别结果,不能直接认定链接无效;先检查是否完成了必要授权,或回到 Subscribe 表单主动粘贴。对于已经导入过的同一份资料,重复扫描和重复复制可能产生重复条目,不宜用反复导入代替故障排查。
订阅 URL 假值:
https://example.com/sub?token=xxxx
单条分享链接常见前缀:
ss://
vmess://
vless://
trojan://
前缀后面的内容可能包含编码后的认证资料、服务器信息和传输参数。不要随意删除等号、斜杠、百分号编码或查询参数,也不要仅根据链接长短判断是否完整。上面的前缀只用于辨认格式,不是可导入的完整连接资料。
五、导入完成后,分别核对列表、更新与路由
“保存成功”“更新成功”“网页可访问”是三个不同的核对结果。保存成功只表明应用接收了输入;更新成功表明订阅资源已被获取和解析;网页能否访问,还取决于服务器状态、认证、DNS 与当前路由设置。先在 Home 确认实际条目,再选择自己已有的一条服务器进行测试。
在 Home 的 Global Routing 中,Config、Proxy、Direct、Scene 是路由姿态,不是订阅协议。改变这里的选项不会修复错误的订阅 URL。以下仅比较排查时常用的三种姿态;Scene 依赖所设置的场景,不能不看场景内容就判断实际行为。
Config
推荐按照当前启用配置中的规则处理流量。先确认 Config 中启用的是预期配置,再根据规则判断目标请求的去向。
适合:已有可信配置、需要按规则日常使用
Proxy
以代理路由处理受接管的请求,可用于与 Config 的结果对照。它不是“订阅更新开关”,也不能保证所有系统流量都被接管。
适合:短时对照测试,区分规则与连接问题
Direct
以直连路由处理受接管的请求。此时网页能打开,不能据此证明所选服务器的认证和传输参数有效。
适合:建立当前网络的直连对照结果
使用 Config 时,DOMAIN-SUFFIX 匹配域名后缀,GEOIP 和 IP-CIDR 处理 IP 相关条件,FINAL 用于最后兜底。这些规则需要放在配置中,不能粘贴进订阅 URL 字段。设置自动连接也属于另一项工作:入口为 Settings → On Demand,应在手动连接核对完成后再按自己的网络场景设置。
六、订阅为空、更新失败与重复条目的处理顺序
更新失败时先保留原来的可用条目,不要立即删除全部配置。错误可能发生在地址输入、资源请求、内容解析或后续连接阶段。按阶段缩小范围,比连续更换导入方式更容易找到原因。
- 核对完整 URL。 对照原始资料检查协议头、域名、路径与
token等参数;聊天软件展示的省略文本不能当作完整地址。 - 核对返回内容。 若地址打开后是登录页或错误提示,而不是预期订阅内容,说明拿到的可能不是直接订阅资源。不要把账户密码填进服务器认证字段来补救。
- 核对资源格式。 普通网页能访问,不代表其内容能被 Subscribe 解析。向已有服务的提供方确认所给格式是否适用于 Shadowrocket。
- 核对当前网络。 区分域名无法解析、连接超时和明确的认证失败。每次只调整一项条件,并记录更新结果,避免同时修改 DNS、规则和服务器资料。
- 核对订阅来源。 同一条服务器可能同时来自手填记录和订阅分组。清理重复项前先认清归属,避免删除需要保留的整个订阅。
- 核对凭据有效性。 若原地址已被撤销或替换,应使用自己的新地址更新原订阅记录。不要继续转发或重复尝试已失效的旧地址。
换成扫码导入,能修复失效的订阅地址吗?
不能。若二维码内编码的仍是同一个失效 URL,扫描只是省去了手动输入,远端资源并未改变。先确认二维码实际内容与当前有效地址是否一致。
订阅更新后,为什么手填条目没有跟着变化?
手填记录与订阅中的记录通常属于不同来源。更新订阅不是全局替换所有服务器,也不会自动维护独立手填记录的密码、端口和传输设置。
列表有服务器且延迟正常,是否已经全部完成?
还应检查实际目标访问、当前 Global Routing 和启用配置。延迟测试反映的是对应测试方式的结果,不能替代完整的认证、TLS、DNS 与规则核对。