本文适合已经持有服务商订阅链接、节点参数或二维码的用户。先区分可刷新的订阅、单个节点分享链接与规则配置,再按 Subscribe、Add Server、扫码、剪贴板四种入口完成导入,最后核对条目、测试连接并保留更新来源。操作以 iPhone / iPad 的界面词为参照,其他平台按对应功能核对,不假定按钮位置完全相同。
导入前:识别链接里装的是什么
Shadowrocket(小火箭)的导入入口不等于服务来源。本文以用户已有自己的服务商与订阅为前提;本站不提供、不销售、不推荐节点或订阅。导入只把现有连接资料写入客户端,不会生成服务器账号,也不会延长原有服务的有效期。
首先确认收到的是“订阅地址”“单节点分享链接”还是“配置文件地址”。订阅地址通常使用 HTTPS,获取后可能返回多个节点;单节点分享链接一般带协议前缀;配置文件则可能包含 DNS、规则和策略等内容。地址看起来都是一行文字,并不代表它们能放进同一个输入框。
https://example.com/sub?token=xxxx:仅用于辨认结构的假值,不能导入使用。不能仅凭 HTTPS 前缀判断返回格式。ss://、vmess://、vless://、trojan://:常见节点分享前缀,导入后仍需核对参数。- 含
[Rule]、DOMAIN-SUFFIX、FINAL的文本:通常涉及规则配置,不能当作服务器地址填写。
Subscribe:区分订阅节点与 Config 配置
按“Config 页 Subscribe”查找入口时,需要先确认订阅对象。Config 用于配置文件管理;其中的 Subscribe 涉及配置订阅,不应把任何节点订阅地址都当作规则配置载入。若服务商明确交付的是节点订阅,常用路径是 Home → 右上角“+”→ Add Server → Type → Subscribe。两者都可能读取远程地址,但保存的内容与后续影响不同。
节点订阅保留了远程来源,后续刷新可以获取服务商调整后的节点集合。手动添加的单节点则不因此自动获得订阅关系。首次导入前保留当前可用条目;不要为了排查一次失败就清空 Home,也不要在不了解内容时用远程配置覆盖现有规则。
-
确认资料类型
在服务商原有说明中核对链接用途。写明用于节点订阅的地址走 Home;完整配置文件才在 Config 中按配置订阅方式处理。
-
选择 Subscribe
打开 Home →“+”→ Add Server → Type → Subscribe,将类型切换为 Subscribe 后,再填写地址,避免把整条 URL 放进普通节点的 Address。
-
粘贴完整地址
把原始订阅 URL 放入 URL 字段,保留问号后的查询参数;为条目填写便于辨认的名称。检查开头、末尾没有空格或换行。
-
保存并核对
保存后回到 Home,等待获取完成并检查所属订阅下是否出现节点;需要重新获取时,对该订阅执行更新,避免反复新增同一地址。
Add Server 手填:按协议逐项核对
只有服务器地址、端口和凭据,没有可用分享链接时,使用 Home →“+”→ Add Server。先在 Type 中选择真实协议,再按字段填写。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 与 WireGuard 的认证和传输参数不同,不能用一个类型的字段勉强承载另一个类型的资料。
例如,Port 应填写服务商分配的端口,而不是因启用了 TLS 就自行改成 443;服务器 Address 与 TLS 的 Server Name 也不一定相同。对于使用 WebSocket 的连接,Path 需要保留起始斜杠;Host、Path 与 TLS 相关名称分别有用途,不能全部替换成服务器 IP。若资料缺失,应向已有服务商核对,而不是逐项猜测。
连接与认证
- Type
- 与服务商声明的协议一致,例如 Shadowsocks 或 VLESS。
- Address
- 填写服务器域名或 IP,不附带网页路径。
- Port
- 填写分配的整数端口;443 只是可能值,不是通用答案。
- 认证字段
- 按协议填写 Password、UUID 等实际字段,区分大小写。
字段名称与必填项随 Type 改变,保存成功不代表认证已经通过。
传输与 TLS
- 传输方式
- 与服务器端配置保持一致,不能只看协议名称。
- Host
- 仅在相应传输需要时,填写服务商给出的请求主机名。
- Path
- 使用 WebSocket 时保留路径原文,包括起始斜杠。
- Server Name
- 按 TLS 配置填写,不能默认等同于连接 IP。
不要用关闭证书验证代替核对域名、证书与系统时间。
保存后先核对条目详情,再进行连接测试。手填条目通常需要自行维护:服务商改动端口、密码或传输设置后,旧参数不会因为重启应用而自动修正。记录资料来源时保留自己的私密备份,不把密码写进公开备注。
扫码:二维码可能承载不同内容
二维码只是文字的载体,不是一种额外协议。它可能包含单节点分享链接、订阅地址,也可能只是服务商的说明网页。打开 Home 的扫描入口并授予所需相机权限,将完整二维码放入识别区域;识别完成后检查结果,而不是看到扫描成功就立即连接。
按二维码所在位置选择读取方式
二维码在另一块屏幕
- 在电脑或另一台设备上打开自己已有的二维码。
- 从 Home 打开扫描入口,使码图四周边界完整可见。
- 识别后核对协议、服务器与端口,再保存结果。
二维码在当前设备
- 若扫描界面提供相册入口,选择保存在本机的清晰原图。
- 若当前界面没有图片读取入口,改取服务商提供的文字链接。
- 用剪贴板导入文字,不把图片直接粘贴到 URL 字段。
识别结果若是普通网页,应回到原有服务商页面确认用途;不要把任意网页当作订阅。
无法识别时先排除反光、模糊、遮挡和裁剪,尤其要保留二维码周围的空白边界。识别成功但导入失败,则应检查内部文字格式是否受支持;放大图片不能修复缺失的认证参数。包含完整凭据的二维码与订阅 URL 一样需要保密。
剪贴板:复制原文后再导入
剪贴板适合处理当前设备上的文本链接。先在可信来源复制完整一行,切换回 Shadowrocket,使用应用提供的剪贴板导入提示或对应导入操作;系统询问粘贴权限时,按本次操作需要允许。没有出现提示时,不必反复重启应用,可以按资料类型手动进入 Subscribe 的 URL 字段,或使用单节点链接的导入入口。
- 复制链接本身:不要连同“点击导入”等说明文字、中文引号或 Markdown 的括号一起复制。网页的显示文字与实际链接目标可能不同。
- 保留查询参数:订阅地址中
?后的 token 常参与认证,不能只保留域名和路径;不要把&后的参数截断。 - 区分文本转义:如果复制结果含字面量
&,可能复制到了网页源文本;优先重新复制原始链接,而不是盲目手工替换整段内容。 - 逐项核对结果:多行节点文本可能生成多个条目。先检查数量与协议,再决定是否保留,避免把同一组内容重复导入。
遇到“无法识别”时,先把内容放到本机可信的文本编辑位置检查开头和结尾。不要上传到在线解码页面。对本身经过编码的分享链接,也不需要先自行解码再填入普通节点字段;客户端应接收完整且受支持的原始分享格式。
导入后:验证连接与保留更新来源
导入完成、延迟有返回、网页能访问是三个不同检查点。导入完成只说明资料被解析并保存;测试结果也只反映所用测试方法下的可达性。实际访问还会受到认证、DNS、TLS、路由规则与目标站点状态影响。先在 Home 选择一个明确的条目,再测试连接,避免同时换节点、改规则和刷新订阅而失去对照。
- 检查路由姿态:在 Home → Global Routing 核对 Proxy、Direct、Config 或 Scene。Config 按当前配置规则处理;Direct 不适合作为代理节点是否可用的验证依据;Scene 需核对当前场景实际采用的策略。
- 分开测试和常用设置:需要隔离规则影响时,可短时用 Proxy 做对照;测试后恢复自己的既定姿态。不要因一次成功就删除原配置。
- 检查自动连接:在 Settings → On Demand 核对是否存在自动连接条件。On Demand 控制连接触发,不负责修复订阅格式或账号认证。
- 维护订阅来源:可刷新的订阅与手填条目分开管理。刷新前留意自己对订阅条目的本地修改,远程更新可能改变节点集合与参数。
粘贴了订阅,怎么一个节点都没有?
先回到订阅条目核对 URL 是否完整,再确认返回的是节点订阅而非登录网页或完整规则配置。若提示认证失败,向已有服务商核对地址有效性;不要连续新增相同条目。
扫码成功了,为什么还是连不上?
打开新条目详情,对照原始资料检查 Type、Address、Port、认证与 TLS 参数。若全部一致,再检查当前网络是否允许该传输,以及系统时间是否自动设置。
订阅获取超时,要先改哪些设置?
先确认当前网络能访问订阅域名,再检查 URL 拼写与有效期。若确需通过代理获取,必须先有一个已验证可用的连接;尚无可用连接时,单纯开启相关选项不能建立通路。
重新导入后出现了两组一样的节点?
先比较两组的订阅来源与名称。保留正确来源,确认能够刷新后再删除重复组;后续在已有订阅上执行更新,不把“新增订阅”当作每次刷新的步骤。