本文适用于已经持有服务商资料、准备在 Shadowrocket(小火箭)中完成首次导入的用户。先区分服务器订阅、单条分享链接和远程配置,再按 Subscribe、Add Server、扫码或剪贴板选择入口;最后检查订阅更新、Global Routing 与连接结果,避免把“成功保存”误认为“已经可用”。以下操作以 iPhone / iPad 界面词为参照,其他平台按对应入口核对。
一、导入前先识别资料类型
订阅地址与网站地址可能都以 https:// 开头,但用途并不相同。服务器订阅返回可解析的服务器条目;远程配置包含配置段落、规则或策略;服务商账户页面则返回网页。把账户页面粘贴到 Subscribe,通常不会得到可使用的服务器列表。先查看服务商对链接用途的说明,不要仅凭网址外观判断。
Home 主要用于服务器列表、选择与连接,Config 用于配置文件,Settings 用于应用设置。Config 页的 Subscribe 与 Home → “+” → Type → Subscribe 应按资料类型区分:前者处理配置订阅入口,后者添加服务器订阅。导入服务器列表不等于同时安装规则文件,也不代表 Global Routing 已经切换为 Config。
服务器资料
- 订阅地址
https://example.com/sub?token=xxxx,仅为假值示例。- 单条分享
ss://、vmess://、vless://、trojan://等协议链接。- 主要入口
- Home → “+” → Type → Subscribe;单条资料也可扫码或从剪贴板导入。
- 导入结果
- Home 中出现订阅分组或单独的服务器条目。
链接前缀只说明格式;能否解析仍取决于完整内容和当前应用支持情况。
配置资料
- 远程配置
- 服务商明确提供的 Shadowrocket 配置文件地址。
- 主要入口
- Config 中的远程配置添加或 Subscribe 入口,按页面字段填写 URL。
- 配置内容
- 可能包含
[General]、[Rule]等段落;应先检查实际文件。 - 应用方式
- 下载后在 Config 选择目标配置,再核对 Global Routing。
文件后缀不是可靠判断依据;远程地址也可能通过不带后缀的接口返回配置。
二、Subscribe:导入订阅并确认更新结果
手中是一条服务器订阅 URL 时,优先添加为 Subscribe,而不是拆成多条手动记录。这样服务商调整服务器地址、端口或条目数量后,可以继续通过同一订阅更新。订阅更新是重新获取资料,不是检测线路速度,也不是延长服务有效期。
-
确认资料
从自己服务商的账户页复制适用于 Shadowrocket 的服务器订阅 URL,检查没有同时复制说明文字、换行或首尾空格。
-
选择类型
进入 Home → 右上角“+”打开 Add Server,将 Type 设为 Subscribe。不要把订阅 URL 填入普通协议的 Server 字段。
-
保存订阅
在 URL 字段粘贴完整地址,可在 Remarks 填写便于辨认的名称,再完成保存。名称只用于本地识别,不会改变订阅返回内容。
-
获取条目
回到 Home,使用订阅的更新操作;支持下拉更新的列表也可下拉刷新。等待请求结束,检查目标订阅分组中是否出现服务器条目。
-
检查配置
如果服务商另提供配置 URL,再到 Config → Subscribe 或远程配置添加入口导入该配置。确认配置可读取后选择使用,不要用服务器订阅 URL 替代配置 URL。
更新后条目减少,不一定是导入失败:服务商可能删除或调整了返回内容。先对照账户中的有效期和订阅说明,再查看是否存在错误提示。手动修改订阅生成的服务器条目,后续更新时可能被远程内容覆盖;需要长期保留的本地调整应单独记录,不能依赖一次编辑一直有效。
三、Add Server:按协议手动填写字段
当资料是 Server、Port、Password 等分开的字段,而不是可复制的订阅或分享链接时,使用 Home → “+” → Add Server。先确定 Type,再逐项填写。相同的服务器域名和端口并不能确定协议,错误的 Type 即使能保存,也无法据此建立正确连接。
| 协议或字段 | 应核对的资料 | 常见错误 |
|---|---|---|
| Server / Port | 分别填写主机名或 IP 与端口。若资料写端口 443,就填 443,而不是根据协议自行选择。 | 把 https://、路径或端口一并粘进 Server。 |
| Shadowsocks | 核对 Method、Password;如资料要求插件,还需按原资料填写相关设置。 | 只填写 Password,忽略 Method 不一致。 |
| VMess / VLESS | 核对 UUID、传输方式以及 TLS 相关字段;不同协议的附加参数不能混用。 | 只复制 UUID,遗漏 WebSocket Path 或 Host。 |
| Trojan / Hysteria2 | 核对认证信息、TLS Server Name;Hysteria2 还需留意 UDP 可达性与服务端要求。 | 把连接 IP 当作必然正确的 TLS Server Name。 |
| WireGuard | 按已有配置核对 Private Key、对端 Public Key、Endpoint 与地址等必要信息。 | 将一条普通订阅 URL 当作 WireGuard 配置内容。 |
例如,服务商明确给出 Server 为 example.com、Port 为 443、TLS Server Name 为另一个域名时,应分别保留各字段的原值。443 只是端口号,不代表可以省略 TLS、认证或传输设置。不要通过关闭证书验证来替代对域名和证书的检查。
- 保存前逐项核对大小写、空格与标点,尤其是 Password、UUID、路径和密钥。
- 手动条目通常不会随服务商订阅更新;服务商更换地址或凭据后,需要自行修改。
- 资料不完整时向原服务商确认缺失字段,不用猜测默认值补齐。
四、扫码与剪贴板:导入的是编码内容
扫码和剪贴板是两种输入方式,不是两种额外协议。二维码可能装着一条分享链接,也可能只装着网页地址;剪贴板同样可能混入网页标题、说明文字或多个不完整片段。识别成功以后,仍要检查最终生成的是单条服务器、订阅分组,还是配置资料。
扫码导入
- 在 Home 找到扫码图标并打开扫描入口,首次使用时按系统提示授予相机权限。
- 对准自己服务商提供的二维码,保持内容完整。二维码在另一台设备上显示时,避免反光或裁掉四角。
- 如果二维码保存在本机相册,使用扫描页提供的相册入口;该入口不可用时,可改为复制同一资料的文本链接。
- 识别后查看 Type、Server、Port 等结果,再保存。仅识别到普通网页 URL 时,不要把它当作已经导入的服务器。
从剪贴板导入
- 先完整复制单条分享链接,例如以
ss://、vmess://、vless://或trojan://开头的资料。 - 回到 Home,打开“+”添加菜单中的 Import from Clipboard;若应用弹出读取剪贴板确认,按本次导入需要允许。
- 检查识别出的条目再保存。若当前界面没有该菜单,可在 Add Server 对应字段粘贴资料,或使用服务商提供的二维码。
- 对于
https://订阅 URL,优先回到 Type → Subscribe → URL 粘贴,明确告诉应用这是订阅,避免将普通网址误作单条分享链接。
五、导入后检查 Global Routing 与连接
Home 中出现服务器只表示资料已保存。接下来选择一条自己已有的服务器,打开连接开关;首次建立 VPN 配置时,按系统提示授权。随后核对 Home → Global Routing。不同姿态会改变请求的处理方式,不能只看开关是否打开。
Config
推荐依据当前选中的配置规则处理请求。命中规则后使用该规则指定的策略;未命中的请求按后续规则及 FINAL 等兜底设置处理,并非固定直连。
适合:已经检查配置内容、需要按规则分流的日常使用。
Proxy
将接管的请求交给代理处理,可用于判断问题是否与分流规则有关。仍需服务器认证正确、传输可达,并受应用与系统可接管范围限制。
适合:临时对照测试,区分规则问题与服务器连接问题。
Direct
将接管的请求按直连方式处理。选择了服务器但停留在 Direct 时,不能据此验证该服务器是否能转发请求。
适合:核对当前网络的直连表现,或临时明确使用直连。
Global Routing 中的 Scene 用于按已配置的场景条件应用相应设置,不是协议类型。没有检查场景条件与对应行为前,不要把 Scene 当作固定的 Proxy 或 Config。首次验证建议先使用一种明确的姿态完成测试,再配置自动切换。
- 在 Home 运行 Connectivity Test,记录失败的是全部条目还是某一条;测试结果与目标网站实际访问是两种证据,应分别核对。
- 选择 Config 时,确认 Config 中确实选中了目标配置,并查看规则顺序。
DOMAIN-SUFFIX匹配域名后缀,IP-CIDR匹配地址段,GEOIP按地址归属数据库匹配,FINAL负责兜底。 - 首次排查先手动连接。Settings → On Demand 用于按条件触发连接,不负责导入订阅,也不能修复认证信息错误。
六、订阅失败与导入异常的处理顺序
先区分失败发生在哪一层:没有下载到订阅内容、下载后无法解析,还是已经有条目却连接失败。反复删除再添加会丢失排查线索。保留错误提示,在不暴露 token 和认证信息的前提下,检查 URL、网络与返回内容。
订阅更新一直超时,应该先改什么?
先确认当前网络能访问订阅地址。若已有一条可用连接,可连接后再更新;订阅地址确实需要代理访问时,到 Settings → Subscribe 检查 Update via Proxy。新装应用且没有可用服务器时,这个选项不能凭空建立代理通道。
提示解析失败,但地址能在浏览器打开?
检查打开后是订阅内容还是账户登录页、错误页面。HTTP 200 只表示请求得到响应,不保证内容格式正确。确认复制的是服务商标明适用于 Shadowrocket 的订阅,而不是控制台地址;不要将完整返回内容发到公开渠道。
二维码扫到了,Home 却没有新条目?
查看识别结果是否只是网页、配置 URL 或不完整链接,再回到对应入口操作。相册中的小图可能因压缩损失信息,可从原资料重新获取清晰二维码,或改用完整文本链接导入。
订阅有条目,网页还是打不开?
先在 Home 选择条目并运行 Connectivity Test,再检查 Global Routing 是否为预期姿态。仅一条失败时核对该条目的认证和传输字段;全部失败时检查当前网络、服务有效期以及服务器地址是否已变更。
更新后改过的名称或参数恢复了?
订阅更新会根据远程内容刷新生成的条目,本地修改可能被覆盖。需要保留的独立资料可另建手动条目,并注明用途;下次更新仍应检查原订阅是否发生变化,不要用旧参数替代服务商的新资料。
完成首次导入后,保留一份不含敏感凭据的操作记录:资料类型、使用的入口、Global Routing 姿态和错误提示即可。后续出现问题时,先更新资料并复现同一测试,再考虑修改配置;一次只改一个设置,才能判断是哪一步影响了结果。
获取 Shadowrocket 与继续配置
iPhone / iPad 版在 App Store $2.99 一次性付费;Mac(Apple 芯片 / Intel)、Windows、安卓、Linux 版免费。iPhone / iPad 的系统要求以 App Store 页面标注为准,开发者为 Shadow Launch Technology Limited。客户端买断 ≠ 线路套餐,导入时仍需使用自己已有的服务商资料。