本文适用于已经从自己的服务商处获取订阅或连接参数的用户。先区分节点订阅、远程配置和单条分享链接，再选择 Subscribe、Add Server、扫码或剪贴板入口；最后通过更新结果、连接测试和 Global Routing 检查导入是否真正可用。下面以 iPhone / iPad 的 Home、Config、Settings 界面为操作参照，其他平台按对应入口核对。
先辨认内容：订阅地址不等于配置文件
Shadowrocket（小火箭）的导入入口处理的对象并不相同。节点订阅用于批量获取和更新服务器记录；远程配置通常包含分流规则及全局参数；单条分享链接则描述某一个服务器。即使三者都表现为一段文字，也不能直接互换入口。
订阅链接从你的服务商处获取。不要把账号登录页面、购买记录页面或网页上的说明文字当作订阅地址。HTTP 或 HTTPS 只说明地址使用的传输方式，并不能说明返回内容一定能被识别；需要同时确认服务商提供的内容类型。
| 拿到的内容 | 应选择的入口 | 导入后的对象 |
|---|---|---|
| 服务商提供的节点订阅 URL | Home → + → Type → Subscribe | 订阅分组及其服务器记录 |
| 远程配置 URL | Config 的添加入口；Subscribe 管理远程配置订阅 | 可在 Config 中选择使用的配置 |
| 服务器地址、端口及认证参数 | Home → + → Add Server 编辑界面 | 一条手动服务器记录 |
| 单条协议分享链接或二维码 | 扫码入口或剪贴板导入入口 | 由链接解析出的服务器记录 |
链接以 https://example.com/sub?token=xxxx 为例时，整行才是地址，包含问号后的参数。这个地址只是格式示意，不能用于连接。真实订阅中的 token 属于访问凭据，不应出现在公开截图、聊天记录或故障反馈中。
Subscribe：分清 Home 与 Config 的订阅对象
批量添加服务器时，使用 Home 的添加入口，在 Type 中选择 Subscribe，再填写服务商给出的订阅 URL。保存后检查订阅分组是否生成，以及分组内是否出现服务器记录。只出现分组名称而没有记录，通常表示订阅尚未成功获取或返回内容未能解析，不能据此认定导入完成。
Config 页的 Subscribe 面向远程配置订阅，与 Home 中用于导入服务器的 Subscribe 不是同一类对象。处理远程配置时，在 Config 的添加入口填写配置 URL，下载后再选择对应配置；Subscribe 用于查看或管理这类配置订阅。不要把任意节点订阅 URL 填到 Config 后，期待它自动生成完整的规则配置。
-
确认地址
从你的服务商处获取节点订阅 URL，确认它不是登录页；复制时保留
?、&、=以及后面的参数。 -
选择类型
进入 Home → +，在 Add Server 编辑界面的 Type 中选择 Subscribe，而不是沿用上一次手动添加时的协议类型。
-
填写地址
将完整地址粘贴到 URL，填写便于辨认的备注后保存。名称只影响显示，不会修改地址或认证信息。
-
检查记录
返回 Home，等待首次获取完成；必要时下拉刷新，检查该订阅下是否出现服务器，并核对记录数量是否符合服务商说明。
-
保留订阅
后续继续更新已有订阅分组，不要每次都重复添加同一个 URL。更新可能替换服务器字段，单条记录上的临时修改不一定会保留。
配置与服务器分开验收。节点订阅成功不代表 Config 中已经具备所需规则；远程配置下载成功也不代表 Home 中已经存在可用服务器。配置可能包含 [General]、[Rule] 等段，是否包含连接信息要看实际内容，不能仅凭 .conf 后缀判断。
Add Server：按协议手动填写连接参数
只有服务器参数、没有订阅 URL 时，进入 Home → + 打开 Add Server，先选 Type，再逐项填写地址、端口及认证信息。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的字段要求不同，不能因为它们都能建立代理连接，就把同一组字段机械复制到不同 Type。
例如，VLESS 常使用 UUID 作为用户标识，Trojan 使用 Password；启用 TLS 时还要核对服务商给出的服务器名称、证书及传输设置。地址可以是域名，端口必须是服务商指定的整数。示例中的 443 只是一个端口值，并非所有协议的固定默认值。
连接字段核对
- Type
- 与服务商标注的协议一致
- Address
- server.example.com，仅作示意
- Port
- 443，仅作端口示意
- 认证
- 按协议填写 UUID 或 Password 等字段
Address 通常不填写网页路径；不要将整条 HTTPS 订阅 URL 当作服务器域名。
传输字段核对
- TLS
- 按服务商要求启用或关闭
- 服务器名称
- 与服务商给出的 TLS 名称一致
- 传输方式
- 与服务端配置保持一致
- 附加参数
- 按要求核对 Path、Host 等字段
界面只填写当前协议需要的字段；不要通过关闭证书验证来代替参数核对。
手动记录保存后只保存当前参数，不会自动追踪服务商后续变更。若服务器域名、端口或认证信息发生变化，需要重新编辑；已有订阅能提供同一记录时，优先更新订阅，避免长期维护两份内容不一致的记录。
扫码：二维码携带什么，就按什么内容解析
扫码入口位于 Home 顶部的扫描图标。首次使用需要允许相机访问；若无法打开相机，到系统设置中检查 Shadowrocket 的相机权限。扫描时保持二维码完整进入取景范围，不要遮挡边缘或只截取中间图案。
二维码只是文字载体，并不天然代表订阅。它可能携带单条 ss://、vmess://、vless:// 或 trojan:// 分享链接，也可能携带 HTTPS 地址。识别后仍要核对导入提示，判断得到的是一条服务器记录，还是需要作为订阅处理的 URL。
- 没有识别结果：先检查清晰度、反光和裁切范围；提高屏幕亮度后重新扫描，或让服务商提供原始文字链接。
- 识别出普通网页：说明二维码内容可能是说明页或账号页面，不应直接作为节点订阅保存。
- 记录出现但字段缺失：检查二维码是否完整、链接是否被截断，以及当前协议参数能否被正确解析。
- 二维码显示在同一台设备上：使用扫描界面提供的相册入口（若有），或复制原始链接走剪贴板导入，不必重复拍摄屏幕。
服务商更换二维码后，原来手动导入的记录不会因此自动更新。需要持续同步服务器列表时，应使用服务商提供的订阅 URL，而不是把一次扫码当作长期更新机制。
剪贴板：复制完整链接，而不是整段说明
复制协议分享链接后返回 Home，查看是否出现剪贴板导入提示；也可使用添加菜单中提供的剪贴板导入项。系统询问是否允许粘贴时，需要允许本次读取。若没有提示，先确认剪贴板中仍是链接文本，再重新进入对应导入入口。
分享链接常以协议前缀开始，例如 ss://、vmess://、vless://、trojan://。其中的编码内容、百分号转义及查询参数都属于链接的一部分，不要自行解码、删除或用中文标点替换。仅复制一个服务器域名并不构成完整分享链接。
如果复制的是 HTTPS 订阅地址，直接走 Home → + → Type → Subscribe 更便于确认对象类型。批量复制多条分享链接时，每行只放一条，去掉项目符号、引号和解释文字；导入后逐条核对名称与参数。剪贴板读取失败属于导入阶段的问题，与代理连接是否成功无关。
导入后的检查：先更新，再测试连接与分流
导入成功只表示内容已保存或解析，不保证远端服务可达。回到 Home 选中一条记录，先做 Connectivity Test，再开启连接。首次连接时按系统提示允许添加 VPN 配置。测试显示响应，也只能说明相应测试路径可用，仍需用实际目标验证连接。
- 核对选中项：确认选中的服务器来自刚导入的分组，而不是之前保存的旧记录。
- 核对 Global Routing：Proxy 按代理姿态处理流量；Direct 直接连接；Config 根据所选配置分流；Scene 按已定义的场景设置工作。不要把 Direct 下能访问网页当作代理已验证通过。
- 核对 Config：使用 Config 姿态时，确认选中了预期配置。规则按顺序匹配，例如
DOMAIN-SUFFIX,example.com,DIRECT会把对应域名交给 DIRECT，FINAL用于兜底。 - 核对自动连接：Settings → On Demand 管理按条件触发的连接行为，不负责下载订阅，也不会修复错误的服务器参数。手动排查期间先确认当前连接状态。
更新订阅与使用服务器连接目标是两次不同的网络请求。前者可能因为订阅地址过期而失败，后者也可能因为单台服务器不可达而失败。排查时保留错误文字、发生在哪一步和当前网络类型，避免只记录“导入失败”或“不能用”这类无法定位的描述。
常见报错：按失败阶段处理
订阅更新超时，先检查哪里？
先确认当前 Wi-Fi 或蜂窝网络能正常联网，再在 Home 刷新该订阅。若订阅地址需要通过已有可用代理访问，可先连接可用记录，再到 Settings → Subscribe 检查 Update via Proxy。没有可用代理时，开启该项本身不会创建连接，应向服务商确认地址的访问条件。
提示无法解析，链接明明能打开？
检查返回内容是不是登录页、错误页或服务到期提示。HTTP 200 也可能返回 HTML，而不是订阅数据。确认整条 URL 未丢失 token，并向服务商核对适用于 Shadowrocket 的订阅格式；不要把网页另存为配置再导入。
出现 401 或 403，要重新添加吗？
这类状态通常与认证或访问限制有关。先核对 URL 参数是否完整，再确认订阅是否有效、访问条件是否改变。重复添加同一 URL 不会修复认证问题。若已更换订阅凭据，应编辑原订阅地址并更新，避免新旧分组混淆。
列表有服务器，为什么网页仍打不开？
先确认 Home 已选中正确记录并开启连接，再做 Connectivity Test。检查 Global Routing 是否停在 Direct，使用 Config 时查看是否命中 DIRECT 或 REJECT。若所有记录都失败，继续核对网络和认证信息；若只有一条失败，单独检查该记录的端口、TLS 与传输参数。
反馈前隐藏凭据。订阅 URL、二维码、UUID 和 Password 都可能包含敏感信息。只提供错误文字、入口路径和已做的检查；需要核对完整参数时，通过你的服务商提供的私密支持渠道处理，不要公开粘贴原始订阅。
获取 Shadowrocket 与快速上手
iPhone / iPad 版在 App Store $2.99 一次性买断，系统要求以 App Store 页面标注为准；Mac（Apple 芯片 / Intel）、Windows、安卓、Linux 版免费。前往下载页选择平台，再按快速上手教程完成连接检查。
客户端买断 ≠ 线路套餐。本文以用户已有自己的服务商与订阅为前提，订阅链接从你的服务商处获取。