Shadowrocket(小火箭)的导入入口需要按内容类型选择:服务器订阅通过 Home 的 Add Server → Type → Subscribe 添加,Config 页的 Subscribe 用于远程配置文件;单条服务器参数可以手填,也可以通过二维码或剪贴板读取。本文以用户已有自己的服务商与订阅为前提,说明输入、保存、更新和连接验证的顺序,避免把“导入成功”误当成“连接已可用”。
一、先辨认链接:服务器订阅不等于配置文件
导入前先确认拿到的是订阅地址、单条服务器分享链接,还是配置文件地址。三者都可能表现为一段文本,但保存的位置和更新后的作用不同。仅凭地址以 https:// 开头,不能判断它应该放进 Home 还是 Config;应以已有服务提供的用途说明和实际返回内容为准。
| 内容类型 | 辨认方法 | 导入位置 |
|---|---|---|
| 服务器订阅 | 远程返回一组服务器信息,常带访问凭据 | Home → Add Server → Type → Subscribe |
| 单条分享链接 | 常见前缀为 ss://、vmess://、vless:// 或 trojan:// | Home 的扫码或剪贴板导入入口 |
| 远程配置文件 | 包含配置分节、规则及相关设置,而不只是服务器列表 | Config → 右上角「+」→ 下载配置,随后管理 Subscribe |
| 独立连接参数 | 分别给出协议、地址、端口及认证信息 | Home → Add Server → 对应 Type |
本文用 https://example.com/sub?token=xxxx 表示明显无效的订阅示例,只用于解释结构,不能用于实际连接。真实地址中的 token 往往属于访问凭据;不要把完整链接贴到公开截图、评论或诊断记录中。二维码也可能包含相同凭据,需要同样保管。
二、Subscribe:分别保存服务器订阅与 Config 配置
添加服务器订阅时,从 Home 开始,而不是把地址直接放进 Config。订阅导入会建立可更新的服务器来源;远程内容变化后,需要再次更新,Home 中的列表才会反映变化。首次操作前可以记录已有分组和当前选择,便于核对是否添加了重复来源。
-
打开添加页
进入 Home,点右上角「+」打开 Add Server。先确认手中链接被标注为服务器订阅,再继续选择类型。
-
选择订阅
在 Type 中选择 Subscribe,把自己的完整订阅地址粘贴到 URL;不要删除问号后的参数,也不要把说明文字一起粘贴进去。
-
命名并保存
填写便于辨认的 Remarks,核对 URL 的首尾没有空格或换行,再点 Done。名称只用于识别,不会改变远程订阅内容。
-
更新并核对
回到 Home,下拉触发更新,查看对应订阅是否出现服务器条目;再检查其中一个条目的 Type、Address 和 Port 是否符合已有服务说明。
Config 页的 Subscribe 应怎样使用
如果拿到的是适用于 Shadowrocket 的远程配置文件地址,进入 Config,点右上角「+」,填入地址并下载。文件出现后,先查看内容再决定是否启用;在配置文件的操作菜单中,通过 Subscribe 管理其远程更新关系。这里的订阅对象是配置文件,不应当把它理解成 Home 中的服务器订阅入口。
三、Add Server 手填:按协议核对独立参数
手填适合已有独立连接参数的情况。进入 Home →「+」→ Add Server,在 Type 选择实际协议,再逐项填写。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的认证与传输字段并不相同,不要为了让表单能保存而把参数填进名称相似的字段。
- Address 与 Port:填写服务提供的主机地址和端口。Address 通常只放域名或 IP,不应把
https://、路径或订阅 token 一起填入;Port 也不能仅因启用了 TLS 就自行改为443。 - Shadowsocks:核对 Method 与 Password,二者必须与服务器设置一致。密码错误与加密方法错误都可能表现为连接不可用。
- VMess / VLESS:核对 UUID、传输方式,以及服务明确要求的 Host、Path 和 TLS 参数。Host、SNI 与 Address 可能用途不同,不要默认互相复制。
- Trojan / Hysteria2:核对认证信息与 TLS 相关参数;如服务给出 SNI,应按原值填写。不要通过关闭证书验证来替代参数核对。
- WireGuard:按配置分别核对密钥、接口地址、Peer 与 Endpoint 等字段,不把普通订阅 URL 当成密钥或 Endpoint。
点 Done 保存后,回到 Home 选择该条目。手填记录通常不是可自动更新的订阅来源;当已有服务更改密码、端口或传输设置时,需要同步修改这条记录。即使手填条目和订阅条目名称相同,也不能据此认定它们共享更新关系。
四、扫码与剪贴板:先解析,再确认保存结果
二维码与剪贴板是输入方式,不是新的协议。它们可能携带单条服务器分享链接,也可能携带订阅地址。导入后仍需确认保存成了哪一种对象;二维码识别成功,只说明读取了内容,不代表服务器认证已经通过。
按内容所在位置选择读取方式
二维码在另一块屏幕
- 在 Home 点扫码图标,首次使用按系统提示允许相机访问。
- 对准完整二维码,避免反光、裁切和过度缩放。
- 识别后检查协议类型与地址,再确认保存。
- 若是普通网页地址,应先确认用途,不把网页当成服务器条目。
链接已在当前设备
- 只复制完整链接,不包含前后的说明文字或引号。
- 返回 Shadowrocket;出现剪贴板导入提示时,核对内容再确认。
- 如系统询问是否允许粘贴,按本次导入需要授权。
- 没有识别提示时,订阅 URL 可回到 Add Server → Type → Subscribe 手动粘贴。
结论:扫码和剪贴板只负责传递原始内容,保存后都要回到 Home 核对条目;多次重复导入可能产生重复记录。
对于 ss:// 等分享链接,编码部分通常包含必要参数,不能只复制可读的末尾名称。也不要自行把一种协议的前缀改成另一种;改前缀不会转换认证方式和传输格式。识别失败时,优先从原始来源重新复制完整内容,而不是在编码文本中试改字符。
五、导入后验证:先检查服务器,再选择 Global Routing
保存条目之后,先在 Home 选中一个服务器,再使用 Connectivity Test 观察结果。测试有响应只能说明相应探测条件下可达,不能单独证明所有网页、UDP 流量或 DNS 查询都正常。首次打开连接开关时,按系统提示允许添加 VPN 配置;随后用同一个目标网页进行复查,避免频繁更换测试对象导致结论混乱。
Config
推荐使用当前启用配置中的规则与策略。规则可能指向 DIRECT、代理策略或其他已定义策略,并不意味着“未命中就一定直连”;兜底结果需要检查 FINAL。
适合:已有经过核对的配置,需要按目标分流的日常使用
Proxy
用代理姿态进行临时验证,可以帮助区分服务器连接问题与配置规则问题。测试完成后恢复原先模式,并继续核对 DNS 和目标访问结果。
适合:服务器已选中,需要临时排除规则影响的检查
Direct
使用直连姿态观察本地网络访问情况。Direct 下网页能打开,不能证明刚导入的代理服务器可用,因为该测试并未验证相同的代理路径。
适合:确认本地 Wi-Fi 或蜂窝网络是否具有基本连通性
Global Routing 中的 Scene 用于按已配置场景决定路由行为,不是导入协议,也不是订阅格式。初次排查不要同时修改 Scene、DNS 和服务器参数。若已设置 Settings → On Demand,测试时还要注意自动连接行为;确需暂停时记录原设置,完成后再恢复。
Config 中需要核对的规则顺序
[Rule]
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
这段内容仅用于说明语法,不应直接替换现有配置。DOMAIN-SUFFIX 按域名后缀匹配,IP-CIDR 按地址网段匹配,GEOIP 按 IP 地理归属匹配,FINAL 提供最终兜底策略。规则按顺序判断;示例中的 PROXY 必须能在实际配置中解析为有效策略。导入服务器列表不会自动保证这些规则和策略引用正确。
六、订阅更新与常见导入问题
订阅 URL、订阅内容和服务器连接是三个独立检查点。更新失败时先确认地址是否仍有效、网络是否能访问订阅端点;更新成功但无法连接时,再检查选中的服务器与路由配置。不要在一次排查中反复删除全部记录,否则会失去可比较的基准。
订阅更新超时,应该先改哪里?
先确认本地网络能正常访问网页,再到 Home 对对应订阅重新更新。若订阅地址确实需要代理访问,并且已有可用连接,可在 Settings → Subscribe 核对 Update via Proxy 后重试;当所有服务器都不可用时,仅开启该选项不能建立可用代理路径。
提示更新完成,为什么没有服务器?
回到订阅编辑页检查 URL 是否复制完整,尤其是 ? 后的参数。确认返回内容不是登录页面、错误页面或配置文件;若实际拿到的是配置文件,应按 Config 流程处理,而不是继续重复添加服务器订阅。
粘贴了链接,为什么没有导入提示?
重新从原始来源复制纯文本链接,确认没有引号、空格或聊天软件截断。订阅 URL 可以通过 Home → Add Server → Type → Subscribe 直接粘贴;单条分享链接应检查前缀与编码部分是否完整,并留意系统是否允许此次粘贴。
更新后手动修改的内容又变回去了?
订阅条目以远程内容为更新来源,下一次更新可能重新写入参数。需要长期保留的独立测试项,应以手填记录单独保存并明确命名;不要把远程订阅中的临时修改当作稳定配置。
导入完成,开关打开还是无法访问?
先在 Home 确认当前选中的服务器,再运行 Connectivity Test;随后核对 Global Routing,使用 Proxy 做临时对照,最后检查 Config 中 DNS、策略引用与 FINAL。一次只改一项,并记录改变前后的现象。
七、保存前后的最小核对清单
完成一次导入,应能明确说出内容来自哪里、保存在哪个页面、如何更新,以及实际连接使用哪条记录。把这四点记录下来,比仅凭名称判断更可靠。涉及服务期限、连接数量或认证变更时,按自己已有服务的说明核对;本文仅说明配置操作。
- 导入前:确认服务器订阅、远程配置文件或单条参数的类别,保留当前可用配置。
- 保存后:在 Home 核对 Type、Address、Port;在 Config 核对下载文件是否已被实际启用。
- 更新后:确认对应来源没有报错,检查当前选择是否因远程列表变化而需要重新指定。
- 连接后:核对 Global Routing,使用固定目标测试,并把订阅更新问题与服务器访问问题分别记录。
- 分享记录时:遮盖 token、密码、UUID、密钥及二维码,只保留排查所需的字段名称和错误现象。