本文速览

本文适用于已经持有服务商资料、准备在 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,而不是拆成多条手动记录。这样服务商调整服务器地址、端口或条目数量后,可以继续通过同一订阅更新。订阅更新是重新获取资料,不是检测线路速度,也不是延长服务有效期。

  1. 确认资料

    从自己服务商的账户页复制适用于 Shadowrocket 的服务器订阅 URL,检查没有同时复制说明文字、换行或首尾空格。

  2. 选择类型

    进入 Home → 右上角“+”打开 Add Server,将 Type 设为 Subscribe。不要把订阅 URL 填入普通协议的 Server 字段。

  3. 保存订阅

    在 URL 字段粘贴完整地址,可在 Remarks 填写便于辨认的名称,再完成保存。名称只用于本地识别,不会改变订阅返回内容。

  4. 获取条目

    回到 Home,使用订阅的更新操作;支持下拉更新的列表也可下拉刷新。等待请求结束,检查目标订阅分组中是否出现服务器条目。

  5. 检查配置

    如果服务商另提供配置 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、认证或传输设置。不要通过关闭证书验证来替代对域名和证书的检查。

四、扫码与剪贴板:导入的是编码内容

扫码和剪贴板是两种输入方式,不是两种额外协议。二维码可能装着一条分享链接,也可能只装着网页地址;剪贴板同样可能混入网页标题、说明文字或多个不完整片段。识别成功以后,仍要检查最终生成的是单条服务器、订阅分组,还是配置资料。

扫码导入

  1. 在 Home 找到扫码图标并打开扫描入口,首次使用时按系统提示授予相机权限。
  2. 对准自己服务商提供的二维码,保持内容完整。二维码在另一台设备上显示时,避免反光或裁掉四角。
  3. 如果二维码保存在本机相册,使用扫描页提供的相册入口;该入口不可用时,可改为复制同一资料的文本链接。
  4. 识别后查看 Type、Server、Port 等结果,再保存。仅识别到普通网页 URL 时,不要把它当作已经导入的服务器。

从剪贴板导入

  1. 先完整复制单条分享链接,例如以 ss://、vmess://、vless:// 或 trojan:// 开头的资料。
  2. 回到 Home,打开“+”添加菜单中的 Import from Clipboard;若应用弹出读取剪贴板确认,按本次导入需要允许。
  3. 检查识别出的条目再保存。若当前界面没有该菜单,可在 Add Server 对应字段粘贴资料,或使用服务商提供的二维码。
  4. 对于 https:// 订阅 URL,优先回到 Type → Subscribe → URL 粘贴,明确告诉应用这是订阅,避免将普通网址误作单条分享链接。

五、导入后检查 Global Routing 与连接

Home 中出现服务器只表示资料已保存。接下来选择一条自己已有的服务器,打开连接开关;首次建立 VPN 配置时,按系统提示授权。随后核对 Home → Global Routing。不同姿态会改变请求的处理方式,不能只看开关是否打开。

Config

推荐

依据当前选中的配置规则处理请求。命中规则后使用该规则指定的策略;未命中的请求按后续规则及 FINAL 等兜底设置处理,并非固定直连。

适合:已经检查配置内容、需要按规则分流的日常使用。

Proxy

将接管的请求交给代理处理,可用于判断问题是否与分流规则有关。仍需服务器认证正确、传输可达,并受应用与系统可接管范围限制。

适合:临时对照测试,区分规则问题与服务器连接问题。

Direct

将接管的请求按直连方式处理。选择了服务器但停留在 Direct 时,不能据此验证该服务器是否能转发请求。

适合:核对当前网络的直连表现,或临时明确使用直连。

Global Routing 中的 Scene 用于按已配置的场景条件应用相应设置,不是协议类型。没有检查场景条件与对应行为前,不要把 Scene 当作固定的 Proxy 或 Config。首次验证建议先使用一种明确的姿态完成测试,再配置自动切换。

六、订阅失败与导入异常的处理顺序

先区分失败发生在哪一层:没有下载到订阅内容、下载后无法解析,还是已经有条目却连接失败。反复删除再添加会丢失排查线索。保留错误提示,在不暴露 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。客户端买断 ≠ 线路套餐,导入时仍需使用自己已有的服务商资料。