Shadowrocket(小火箭)的导入入口取决于手中资料的类型:节点订阅、单条协议链接、二维码与远程配置文件不是同一种内容。本文以用户已有自己的服务商与订阅为前提,说明 Subscribe 与 Config 的区别、Add Server 的填写顺序、扫码和剪贴板的检查方法,并给出导入后验证与失败排查步骤。
先区分订阅链接、协议链接与配置文件
导入之前,先确认收到的是“返回一组连接信息的地址”,还是“描述一个连接的链接”。订阅地址通常以 https:// 开头,应用请求该地址后才取得内容;单条协议链接则常以 ss://、vmess:// 或 trojan:// 等协议标识开头。仅凭地址后缀无法判断格式:没有 .conf 后缀的地址,也可能返回配置文件。
| 资料类型 | 识别方式 | 处理方向 |
|---|---|---|
| 节点订阅 | 通常是带有身份参数的 HTTPS 地址,返回多个连接条目。 | 使用 Home 中的订阅添加入口,Type 选择 Subscribe。 |
| 单条连接 | 以协议标识开头,包含服务器、端口和认证信息。 | 使用扫码、剪贴板导入,或在 Add Server 手动填写。 |
| 远程配置 | 正文可能包含 [General]、[Rule] 等段落。 | 在 Config 管理远程配置,下载后再确认启用状态。 |
| 网页地址 | 打开后显示登录页面、说明页或 HTML 内容。 | 不能直接当作订阅;向已有服务方确认实际导入地址。 |
本文涉及 Home、Config、Settings 三个区域:Home 管理连接与选择状态,Config 管理配置文件,Settings 管理应用行为。不同平台的按钮位置可能随窗口布局变化;以下以移动端常见英文界面词定位,桌面端应按相同功能查找,不必机械照搬屏幕坐标。
Subscribe:节点订阅与 Config 入口分别处理
查找“Config 页 Subscribe”时,应先确认订阅对象。Config 中与 Subscribe 或远程地址相关的操作用于配置文件管理,不能据此把所有节点订阅都填进 Config。节点订阅的常见路径是 Home → 右上角“+”(Add Server)→ Type → Subscribe。两者都可能使用 HTTPS 地址,但导入后的结果不同:前者是配置文件,后者是一组可选择的连接条目。
-
核对地址
从自己的服务管理页面复制完整订阅地址。确认没有选中前后的说明文字、空格或换行,并保留问号之后的全部参数。
-
打开入口
进入 Home,点右上角“+”打开 Add Server,在 Type 中选择 Subscribe。不要保持在普通单节点协议类型后直接粘贴整条订阅地址。
-
填写链接
将完整地址填入 URL,设置便于自己辨认的备注,再保存。不要把 token 单独拆成密码,也不要把 HTTPS 地址填写到服务器主机名字段。
-
更新列表
返回 Home,检查订阅分组是否出现。若未自动取回内容,使用该订阅的更新操作;在支持下拉更新的列表中可下拉触发,再观察错误提示和条目数量。
-
检查结果
展开分组,确认至少一个连接的协议、服务器与端口符合已有资料。保存了一个订阅名称,不等于已经成功取得连接列表。
如果拿到的是远程 .conf,应进入 Config,通过添加远程 URL 的入口取得文件,再确认当前启用的是哪份配置。文件中可能包含分流与 DNS 行为,不能因为文件下载成功就推断其中所有设置都适合当前网络。订阅更新与配置文件更新也应分开检查,前者更新连接资料,后者更新配置内容。
Add Server:按协议手动填写单个连接
当已有资料是服务器地址、端口、密码或 UUID 等独立字段时,使用 Home → “+” → Add Server 更便于逐项核对。先选 Type,再填字段,因为不同协议需要的认证和传输参数并不相同。不要先填一遍再随意切换协议,避免旧字段残留或必填项变化后未被注意。
- Shadowsocks:核对服务器、端口、加密方法与密码。加密方法必须与服务端一致,不能仅因名称相近就替换。
- VMess / VLESS:核对 UUID,以及服务端要求的传输方式、路径、Host 和 TLS 参数。VLESS 与 VMess 的字段不能互相照抄。
- Trojan:核对密码与 TLS 相关设置,尤其是服务器名称。用 IP 连接时,也不能据此把证书所需名称改成该 IP。
- Hysteria2:核对认证、端口、TLS 与服务端给出的相关传输参数;网络是否允许 UDP 也是后续排查的一部分。
- WireGuard:按完整资料核对密钥、接口地址、Peer 与 Allowed IPs,不能按普通密码型连接处理。
例如,服务端资料写端口 8443,就填写 8443;不要因为启用了 TLS 就改成 443。服务器字段通常填写主机名或 IP,而不是 https:// 开头的网页地址;路径则应放在相应传输设置中。保存前逐项比对,通常比保存后反复切换开关更容易发现错误。
按已有资料选择添加方式
只有单条连接资料
- 通过 Add Server 选择准确的 Type。
- 逐项填写服务器、端口和认证字段。
- 服务端变更参数后,手动同步本地设置。
已有可更新订阅
- 通过 Subscribe 保存原始订阅 URL。
- 更新后检查分组中的连接是否变化。
- 需要保留本地修改时,先做好独立备份。
两种方式解决的是资料组织与维护方式不同,不代表连接速度或服务质量有固定差异。
扫码添加:先确认二维码承载的内容
二维码只是文字的编码载体,可能装着一条协议链接、一个订阅 URL,也可能只是普通网页。进入 Home,使用顶部扫码图标打开扫描入口;首次调用相机时按系统提示授权。识别后先查看解析出的类型与字段,再保存,不要把“能够识别二维码”当作“连接参数一定有效”。
- 在另一块屏幕显示用户已有的二维码,保持图形完整,避免反光、遮挡与过度缩放。
- 打开 Shadowrocket 的扫码入口,对准二维码。若当前界面提供从相册读取图片的选项,也可选择原图,避免反复压缩的聊天缩略图。
- 核对识别结果。单条协议链接应对应一个连接;订阅 URL 应按订阅处理;普通登录网页不能直接变为连接。
- 保存后回到 Home,检查新条目或分组,再做连通性测试。
如果相机没有画面,先检查系统对 Shadowrocket 的相机权限;如果能拍到二维码但始终不识别,先确认图片是否完整、文字内容是否为应用支持的格式。二维码截图本身可能包含密码或 token,反馈问题时不应把原图直接发到公开讨论区。
剪贴板导入:保留完整链接与原始编码
对于已经在当前设备上的文本,剪贴板通常比重新扫码更直接。先只复制链接本身,再回到 Home,按应用识别到链接后的导入提示操作;需要时从添加入口查找剪贴板导入操作。系统询问是否允许粘贴时,只有允许后应用才能读取对应内容。若没有出现识别提示,可将 HTTPS 订阅地址手动粘贴到 Type 为 Subscribe 的 URL 字段。
订阅地址结构示意:
https://example.com/sub?token=xxxx
常见单条链接前缀:
ss://
vmess://
vless://
trojan://
以上前缀用于识别内容类别,不是完整可用的连接。链接中可能存在百分号编码、Base64 文本和 # 后的备注,手动“整理”这些字符可能改变含义。不要把聊天软件显示的省略号当成原文,也不要把包含“点击导入”等说明的整段消息一并复制。
- 复制后没有反应:确认复制的是实际链接文字,而不是网页标题;检查系统是否拒绝了粘贴权限。
- 仅导入一个条目:查看原文是否为单条协议链接。单个连接不会因为通过剪贴板导入而自动成为订阅。
- 提示格式错误:移除链接外层的引号与说明,保留链接内部编码;仍失败时向已有服务方确认输出格式。
- 批量粘贴漏项:先用一条完整链接验证识别,再处理多行内容,避免用空格把多条链接连成一条。
导入后验证:连接选择与 Global Routing 分开检查
导入只负责保存资料,不等于已经建立连接。先在 Home 选择刚导入的连接,进行延迟或连通性测试,再打开连接开关;首次建立系统 VPN 配置时,按系统提示确认授权。延迟测试有结果,只能说明相应测试方式成功,不能保证 DNS、TLS、UDP 或所有目标网站都正常。
然后检查 Home → Global Routing。Proxy、Direct、Config、Scene 是不同的路由姿态,不能把它们当作四种协议。为确认问题发生在哪一层,可暂时对比路由行为,但测试完应恢复原有设置。
Config
推荐按当前配置的规则决定去向。是否直连取决于命中的规则与末尾策略,并非“没有命中就必然直连”。
适合:已核对配置、需要按规则分流的使用场景。
Proxy
将路由模式设为代理,用于对照判断是否是规则选择导致目标流量未按预期经过代理。
适合:短时验证已选连接与分流规则之间的差异。
Direct
采用直连路径。切到此模式后可以访问某个网站,不能证明新导入的代理连接有效。
适合:对照本地网络本身的可达性。
Scene
按已配置的场景条件决定路由行为,需结合场景内容判断实际采用的设置。
适合:已经建立并核对场景条件的网络切换需求。
如果 Proxy 下能访问而 Config 下不能,接着检查当前配置中的 DOMAIN-SUFFIX、IP-CIDR、GEOIP 与 FINAL。规则通常从上到下匹配,命中后采用对应策略,末尾的 FINAL 决定前面未命中的流量。不要通过反复重新导入订阅来修正规则问题。
- 确认 Config 中实际启用的文件,而不只是列表里最后下载的文件。
- 检查连接记录中的目标、匹配规则与最终策略,区分“未走代理”和“代理连接失败”。
- 若手动断开后又自动连接,检查 Settings → On Demand 的触发条件;On Demand 控制按需连接,不负责导入订阅。
导入失败排查:先看结果,再查网络与格式
保留错误提示的原文,并记录失败发生在“保存地址”“获取内容”“解析内容”还是“连接测试”。这四个阶段对应的问题不同。订阅地址能在浏览器打开,也只代表浏览器取得了响应;返回的内容如果是登录页面,Shadowrocket 仍然无法按订阅解析。
| 看到的现象 | 优先核对 | 下一步 |
|---|---|---|
| 请求超时 | 当前网络能否访问订阅主机,DNS 是否正常。 | 切换 Wi-Fi 与移动网络做对照,避免同时改动连接参数。 |
| HTTP 401 / 403 | token、访问权限、服务端限制。 | 回到已有服务管理页面核对地址与授权;不能只凭状态码认定到期。 |
| HTTP 404 | 路径是否完整,地址是否已变更。 | 重新复制实际订阅地址,不手动猜测路径。 |
| 证书相关错误 | 系统日期、时间与服务器名称。 | 先校准系统时间,再确认远端证书状态,不通过关闭验证掩盖原因。 |
| 更新成功但没有条目 | 返回空列表、格式不匹配或入口用错。 | 确认返回的是节点订阅而非配置文件或网页。 |
| 有条目但连接失败 | 协议、端口、认证、TLS 与服务状态。 | 逐项核对单个连接,不必先删除整个订阅分组。 |
订阅更新可能替换由订阅管理的条目,本地改名或参数修改能否保留取决于具体管理方式。需要保留独立设置时,先备份再更新。排查截图应遮住服务器敏感信息、密码、UUID 与 token,仅保留入口、错误文本及必要的协议类型,便于定位而不暴露完整凭据。