Shadowrocket（小火箭）的导入入口不能只按按钮名称选择，还要先判断手中的内容是服务器订阅、单条服务器分享信息，还是远程配置文件。本文面向已经持有自己的服务商与订阅的用户，说明四种入口如何选择、保存后到哪里核对，以及更新失败时怎样区分链接、响应格式和连接设置问题。本站不提供、不销售、不推荐节点或订阅。
一、先判断内容：订阅链接不等于配置文件
服务器订阅用于取得一组服务器信息，通常包含地址、端口与认证参数；远程配置文件用于载入规则、DNS 和策略等设置。二者都可能通过 HTTPS 地址提供，但不能因为地址以 https:// 开头，就认定可以放入同一个入口。应先确认原提供方标明的用途与 Shadowrocket 适用格式。
Home 是检查服务器与连接状态的主要位置；Config 管理配置文件。服务器列表里出现了条目，不代表 Config 中的规则已经更换；Config 下载成功，也不代表已经获得可用的服务器。把这两个结果分开验收，可以避免“导入成功却没有节点”和“有节点却没有按规则分流”这两类混淆。
| 手中的内容 | 优先入口 | 导入后的核对位置 |
|---|---|---|
| 服务器订阅 URL | Home → + → Type → Subscribe | Home 中的订阅分组与服务器列表 |
| 远程配置文件 URL | Config → + → Download from URL；按需设置 Subscribe | Config 中的文件、内容与选中状态 |
| 单条服务器参数 | Home → + → Add Server 编辑页 | Home 中新增的服务器 |
| 二维码或剪贴板文本 | Home 扫码入口或剪贴板识别提示 | 先确认识别类型，再检查对应列表 |
二、Subscribe：分清 Config 订阅与服务器订阅
Config 中的 Subscribe 围绕远程配置文件的订阅与更新工作，不应把任意服务器订阅链接都填到这里。首次添加远程配置时，在 Config 的添加入口使用 Download from URL，填入完整配置地址；下载完成后，打开内容检查，再选择是否使用。需要持续更新远程配置时，再检查该文件的 Subscribe 设置与来源。
如果原提供方给的是服务器订阅，路径应是 Home → 右上角 + → Type → Subscribe。这里的 Subscribe 是 Add Server 编辑页中的类型选择，与 Config 的远程配置用途不同。填写 URL 并保存后，应回到 Home 检查是否形成订阅分组、是否取回服务器条目，而不是到 Config 寻找新增规则。
-
确认用途
先阅读原提供方对链接的说明，确定它返回服务器列表还是完整配置；不要凭 URL 后缀判断。
-
选择入口
服务器订阅进入 Home → + → Type → Subscribe；远程配置进入 Config → + → Download from URL。
-
粘贴地址
完整粘贴 URL，保留查询参数与大小写，确认没有前后空格、换行或聊天软件附加的标点。
-
保存核对
保存后检查目标列表。服务器订阅在 Home 核对条目；配置文件在 Config 核对内容与当前选中项。
-
单独更新
首次排查只更新这一条订阅，保留错误提示；避免同时新增多个同源条目，使结果难以对应。
更新前保留本地修改远程配置更新可能替换从远端取得的内容；服务器订阅更新也可能重建所属列表。重要规则与手工修改应先备份，不要假定每次更新都会保留本地编辑。
三、Add Server：手动填写参数与添加订阅
Home 右上角的 + 打开 Add Server 编辑页。Type 决定后续表单的含义：选择 Subscribe 时填写订阅信息；选择 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard 等类型时，则是在录入对应协议的服务器参数。应以实际持有的配置为准，不要为了让表单通过而随意切换协议。
手动录入适合只有单条服务器信息、需要核对一个字段，或者原始分享文本无法识别的情况。它不是订阅更新的替代品：只录入一台服务器后，原提供方未来调整列表，不会自动变成本地这条记录的订阅更新。
- 地址与端口：服务器地址不应混入网页路径。若原参数指定端口为
443，就填写443；端口只是连接目标的一部分，不能据此判断一定使用哪种协议或一定启用 TLS。 - 认证信息：按协议填写密码、UUID 或密钥等字段。不能把订阅 URL 的 token 直接当作服务器密码，除非原提供方明确给出了相同参数。
- TLS 与传输：涉及 TLS、SNI、Host、Path 等字段时，逐项照原参数录入。服务器地址、TLS 服务名与传输 Host 可能不同，不要统一替换成同一个值。
- 备注：使用能区分来源和用途的名称。名称用于管理，不会修正错误的协议、认证或端口。
保存后先在 Home 确认条目存在，再进行连接验证。编辑页能够保存，只能说明本地记录已经建立，不能证明远端认证成功；延迟测试有结果，也不能单独证明所有目标网站和规则都正常。
四、扫码与剪贴板：先看识别内容，再确认导入
扫码与剪贴板主要改变信息进入 Shadowrocket 的方式，并不改变内容本身的类别。二维码可能装着单条服务器分享文本，也可能只是一个 HTTPS 地址；剪贴板同样可能是订阅地址、单条分享信息，甚至只是服务商的网页地址。因此，识别后的类型确认比“扫码成功”更重要。
按已有内容选择输入方式
二维码
- 在 Home 使用顶部扫码入口，首次调用时允许相机访问。
- 将完整二维码放入取景范围，避免反光、裁边与过度缩放。
- 核对识别结果是服务器信息还是 URL，再继续保存。
- 同一设备上的二维码，优先使用原来源同时提供的文本；不要依赖一定存在相册识别入口。
剪贴板
- 只复制完整链接或分享文本，不要连同说明段落一起复制。
- 返回 Shadowrocket；出现剪贴板导入提示时，核对内容再确认。
- 系统询问粘贴权限时，按当前操作意图允许。
- 没有识别提示时，直接进入对应编辑页，在 URL 或参数字段中手动粘贴。
扫码和剪贴板只是输入方式；最终仍要回到 Home 或 Config 检查实际保存的对象。
若扫码后只新增了一个服务器，原二维码很可能编码的是单条分享信息，而不是整个订阅。重复扫描不会自动把它变成订阅分组。若剪贴板毫无提示，也不必反复复制：先用手动粘贴确认文本完整，再检查格式与系统粘贴权限。
订阅地址按凭据保管二维码、剪贴板和 URL 查询参数都可能包含访问凭据。提交排障信息时遮盖完整 token、密码与密钥；不要把原始订阅链接放在公开截图或公开文本中。
五、链接写法与导入失败检查
订阅 URL 没有统一的固定路径。它可能通过查询参数携带访问凭据，也可能把标识放进路径；有无 .conf 后缀同样不能作为唯一判断标准。下面两个地址仅用于说明 URL 结构，是不可用于导入的假值。
https://example.com/sub?token=xxxx
https://example.com/sub/xxxx?format=shadowrocket不要自行添加示例中的 format=shadowrocket 参数：只有原接口支持该参数时它才有意义。复制时还要注意 & 是否被错误保留为网页转义文本、参数是否被聊天软件截断，以及末尾是否多出中文句号。含有百分号编码的值应整体保留，不要随意解码再粘贴。
| 观察到的现象 | 优先检查 | 下一步操作 |
|---|---|---|
| 无法保存或没有识别结果 | 复制内容是否包含说明文字、空格或截断 | 仅粘贴完整 URL；单条分享文本应使用其对应入口 |
| 请求超时 | 当前网络是否能访问订阅地址 | 保留原配置，换一个可用网络后只重试该订阅 |
| 返回 HTTP 401 或 403 | token 是否有效、访问是否受限 | 通过已有服务商的账户页面核对授权；不要公开完整地址 |
| 返回 HTTP 404 | 路径是否复制完整、原地址是否变化 | 从原来源重新复制，保留全部参数 |
| 请求成功但提示解析失败 | 响应是否为登录页、错误页或不兼容格式 | 核对 Shadowrocket 适用格式，确认没有把账户页面当成订阅 |
| 更新后列表为空 | 远端是否返回空内容，是否存在筛选条件 | 检查该订阅的筛选设置与原来源状态，先不要删除其他可用记录 |
浏览器能打开一个地址，不等于 Shadowrocket 能从中解析出服务器。浏览器显示的可能是账户登录页、访问验证页或一段错误说明；HTTP 请求成功与内容格式正确是两项独立检查。排障时记录错误文字和发生阶段即可，不需要向他人发送含完整凭据的原始响应。
六、导入后验证：更新、连接与规则分开检查
完成导入后，按“列表是否正确、服务器能否连接、规则是否生效”的顺序验证。先在 Home 选择刚导入的服务器，开启连接并按系统提示允许添加 VPN 配置；再使用自己有权访问的目标进行测试。若服务器根本无法建立连接，应先核对协议与认证，不要同时改写规则。
Global Routing → Config
推荐按当前选中的配置文件处理流量。实际去向取决于规则、策略与所选服务器，而不是只由订阅名称决定。
适合：已有明确规则、需要验证日常分流的情况。
Global Routing → Proxy
以代理姿态处理流量，不按 Config 中的常规分流规则选择去向。可用于缩小规则相关问题的排查范围，不能保证远端服务可用。
适合：短时区分服务器连接问题与规则匹配问题。
Global Routing → Direct
以直连姿态处理流量。此时网站能够访问，不能用来证明刚导入的服务器工作正常。
适合：观察当前网络的直连表现，作为排障对照。
Global Routing 中的 Scene 用于场景相关选择，不是第五种导入入口；Settings → On Demand 管理按需连接行为，也不负责取得服务器。为避免排查中连接自动变化，先查看现有 On Demand 设置，不要在尚未确认连接可用时同时改动自动连接条件。
- 核对订阅：在 Home 对目标订阅执行更新，确认新增、移除或名称变化符合原来源内容；一次更新不需要重新导入相同 URL。
- 核对配置：在 Config 确认当前使用的文件。存在多个文件时，下载完成不等于已经选中该文件。
- 核对规则：
DOMAIN-SUFFIX匹配指定域名及其子域名；IP-CIDR匹配地址段；GEOIP使用 IP 地理归属匹配；FINAL负责此前未命中的最终策略。不要用订阅更新代替规则检查。 - 核对重复：同一 URL 通过扫码和剪贴板各导入一次，可能形成重复记录。确认来源后保留需要的订阅，再清理多余条目；不同订阅出现相同服务器名称，不一定是同一个连接参数。
Shadowrocket 是闭源商业应用，以 iPhone、iPad 为主要使用设备，唯一获取入口是 App Store。系统要求与其他兼容性信息以 App Store 页面标注为准。客户端一次性买断不等于线路套餐；购买客户端与使用自己已有的订阅是两个独立环节。