本文面向已经持有自己服务商订阅或连接参数的用户。先区分 Home 中的服务器订阅与 Config 中的配置订阅，再按链接、参数、二维码或剪贴板选择入口；完成后检查列表、更新结果与 Global Routing。扫码和剪贴板只是传递内容的方式，不会把单条连接自动变成可更新的订阅。
导入前：核对应用与已有资料
Shadowrocket（小火箭）是 Apple 平台的闭源商业应用，以 iPhone、iPad 使用为主，唯一获取入口是 App Store。购买前核对产品名 Shadowrocket、开发者 Shadow Launch Technology Limited，以及产品页地址中的应用 ID 932747118。系统要求以 App Store 页面标注为准。
客户端采用一次性买断；客户端买断 ≠ 线路套餐。本文以用户已有自己的服务商与订阅为前提，本站不提供、不销售、不推荐节点或订阅。应用购买成功后，仍需导入自己有权使用的连接资料。
- 订阅 URL：通常是 HTTPS 地址，访问后返回客户端可识别的服务器列表，而不是账户管理网页。
- 单条分享链接：常见前缀包括
ss://、vmess://、vless://、trojan://，一般描述一条连接。 - 手动参数：至少确认 Type、Address、Port 及相应认证字段；TLS、SNI、传输方式等也要与服务端一致。
- 配置文件 URL：用于载入规则、DNS 与策略等配置，不应仅凭地址以 HTTPS 开头就当作服务器订阅。
Subscribe：先分清 Home 与 Config 的用途
最容易混淆的地方是 Subscribe 一词对应的对象。批量导入服务器列表，使用 Home → + → Add Server → Type → Subscribe；Config 页的 Subscribe 则用于订阅远程配置。两者都可能接收 URL，但返回内容与保存位置不同。
如果拿到的是服务器订阅，不要因为 Config 页也出现 Subscribe 就直接填入。反过来，包含 [General]、[Rule] 等段落的完整配置也不应当作普通服务器列表导入。先查看资料说明；若不清楚返回类型，向原有服务商确认，不靠反复更换入口猜测。
-
进入添加页
打开 Home，点击右上角「+」进入 Add Server。这里管理连接条目，不是在 Config 中选择规则文件。
-
选择类型
点击 Type，选择 Subscribe。把自己已有的完整订阅地址粘贴到 URL，保留查询参数、大小写和百分号编码。
-
命名并保存
填写便于辨认的名称，点击右上角 Done。返回 Home，检查订阅分组及展开后的服务器列表。
-
执行更新
在 Home 下拉刷新，等待本次请求完成。若分组存在但内容为空，先检查请求与解析结果，不要立即重复添加同一 URL。
Config 页 Subscribe 应在什么时候使用？
当资料明确说明它是 Shadowrocket 远程配置时，再进入 Config，打开用于添加远程配置的菜单并选择 Subscribe，填写该配置的 URL。保存后在 Config 列表检查并选用对应配置。不同界面布局中添加菜单的位置可能不同，应按 Subscribe 标签辨认，而不是寻找 Home 中的 Type 表单。
- Config 列表新增文件、Home 没有新增服务器，不一定是失败：可能导入的本来就是只含规则的配置。
- 远程配置可能包含 DNS、规则和策略引用，应用前应检查来源与内容，避免覆盖已经调整好的设置。
- 更新服务器订阅与更新远程配置是两项操作；完成其中一项，不代表另一项也已经更新。
Add Server 手填：只有参数时逐项建立连接
只有 Address、Port、Password 等参数而没有订阅 URL 时，在 Home → + → Add Server 中选择实际协议，再逐项填写。手动添加的是独立服务器条目，服务端参数变化后通常需要自行修改，不具备订阅列表的自动同步关系。
地址与认证
- Type
- 按已有资料选择 Trojan 等实际协议。
- Address
- 服务器域名或 IP，不附带 https:// 或网页路径。
- Port
- 填写服务端端口；例如资料明确给出 443 时才填 443。
- Password
- 按原文填写，避免首尾空格和换行。
443 只是常见端口示例，不能替代服务端实际参数。
协议附加项
- SNI
- 按服务端要求填写 TLS 握手使用的域名。
- UUID
- VMess、VLESS 等协议的身份字段，不能当成通用 Password。
- Method
- Shadowsocks 的加密方法，必须与服务端一致。
- Transport
- 若指定 WebSocket 等方式，同时核对 Path 与 Host。
表单字段随 Type 变化，不要跨协议照抄整套参数。
以 Trojan 为例，Address 能解析、Port 能建立连接，并不代表认证与 TLS 校验都已成功。若资料指定 SNI，应按指定值填写；不要把订阅 URL 的域名误当作服务器 Address，也不要通过放宽证书校验来掩盖 SNI 或证书不匹配。
- 先保存一条完整连接，在 Home 中确认名称与 Type。
- 选中该条目，再打开连接开关；首次使用按系统提示允许添加 VPN 配置。
- 若连接失败，依次核对 Address、Port、认证字段和 TLS／传输参数，每次只更改一项，便于定位原因。
扫码添加：二维码中的内容决定导入结果
二维码是文本载体，不是一种独立协议。在 Home 点击扫码入口，对准自己已有的连接二维码，并按系统提示允许相机访问。识别后先检查解析出的类型和名称，再确认保存。若扫码页提供从照片读取的入口，也可读取设备中已有的二维码图片。
- 二维码包含
trojan://等单条分享链接：通常得到一条服务器记录，不会自动形成可更新分组。 - 二维码包含订阅 URL：确认进入订阅添加流程；如果只识别出普通文本地址，可复制后到 Home → + → Type → Subscribe 填写。
- 二维码包含账户网页、付款页面或其他普通网页：不能据此得到服务器参数，应回到原有资料中查找实际连接信息。
- 扫描结果缺字段或无法识别：检查二维码是否完整、反光或被裁切，再尝试原始文本；不要自行补猜 Password、UUID 或 SNI。
扫描到自己的分享链接也需要核对内容，尤其是从照片转存或经过聊天软件压缩的二维码。建议保留原有条目，先确认新条目能正常使用，再决定是否清理重复记录。
剪贴板导入：完整复制，不把 URL 填错字段
剪贴板适合处理已经拿到的分享文本。复制时从协议前缀开始保留到链接结尾，不带说明文字、引号、项目符号或代码围栏。回到 Home 后，如出现导入提示，允许读取并确认；若没有提示，打开 Home 的添加入口，查看当前界面提供的剪贴板导入操作。
-
复制原文
复制完整的单条分享链接。多条链接若没有被批量识别，先复制一条验证，避免将整段说明一起导入。
-
允许读取
切回 Shadowrocket，在系统询问是否允许粘贴时选择允许。拒绝读取后没有导入提示，不等于链接格式错误。
-
核对结果
确认新增条目的协议、Address 与 Port。若复制的是 HTTPS 订阅 URL 而未被自动识别，改用 Home → + → Type → Subscribe → URL。
不要手工解码或改写链接中的 %2F、%3D 等字符，也不要把 & 后面的参数截掉。分享链接的片段标记 # 后面常用于名称，但不同格式仍有各自解析规则，最稳妥的做法是保留原文。
导入后验证：列表、选中项与 Global Routing 分开检查
导入成功只能说明数据已经保存，不能直接证明服务器可达或分流符合预期。先在 Home 展开订阅分组、确认至少有一条记录，再选中目标服务器并执行 Connectivity Test。测试结果只用于观察当时的连接情况，不代表所有网站和应用都能正常访问。
Global Routing → Config
推荐依据当前选用配置的规则决定策略。命中 DIRECT 的请求直接连接，命中代理策略的请求使用对应出口；是否走代理取决于规则，而非仅取决于 Home 选中了哪条服务器。
适合:已经检查配置内容、需要按规则分流的日常使用
Global Routing → Proxy
将由客户端接管的流量按 Proxy 姿态处理，可用于暂时减少规则匹配带来的变量。不应据此推断设备中的每一种流量都必然经过同一路径。
适合:短时对照测试服务器连接与规则分流问题
Global Routing → Direct
将由客户端接管的流量按 Direct 姿态处理。即使已导入且选中服务器，也不能据此判断当前访问正在使用该服务器。
适合:对照直连表现，排除目标网站本身的访问问题
排查过程中还应检查 Settings → On Demand。On Demand 管理按条件触发连接，不负责导入订阅或补全参数；如果切换网络后连接自动变化，先核对相关条件，再判断是否需要重新导入。
- Home 有服务器、Config 没有新文件：对普通服务器订阅而言可以是正常结果。
- Config 有文件、规则未生效：检查是否选用了该配置，以及 Global Routing 是否为 Config。
- 使用 Scene 时：先核对对应场景设置；做单项排查时记录原设置，再临时切换明确的姿态测试，结束后恢复。
常见问题：列表不显示与订阅更新失败
保存了订阅，Home 还是空的？
先确认是否误加到了 Config；再检查 Home 中是否已有可展开的订阅分组，并下拉刷新。若只有分组没有服务器，核对 URL 是否完整、token 是否有效，以及返回的是否为可识别的订阅内容。账户登录网页不能替代订阅响应。
订阅更新一直超时，要重装吗？
先确认当前网络能访问订阅地址。若已有可用代理连接，可打开连接后到 Settings → Subscribe 检查 Update via Proxy，再重试更新；没有可用代理时，仅打开此项不能解决问题。不要先删除最后一份可用列表。
更新后服务器名字变了，是导错了吗？
订阅更新会按远端返回内容刷新，名称变化不一定表示导错。核对分组对应的订阅 URL，并重新检查所选条目；如果原先选中的记录已被移除，应选择现有记录再测试。手动添加的独立条目不一定随订阅更新。
扫码能导入，为什么不能更新？
打开条目检查它是单条服务器还是 Subscribe。二维码若只包含单条分享链接，导入后没有订阅来源可供刷新；需要更新列表时，应使用自己原有的订阅 URL 另建 Subscribe，而不是重复扫描同一个单条二维码。
列表有记录，打开连接后网页仍打不开？
先在 Home 执行 Connectivity Test，再检查 Global Routing 与当前选用配置。若服务器测试正常而只有部分域名异常，继续核对规则和 DNS；若服务器测试也失败，先查连接参数、服务有效状态与当前网络，不要把所有问题都归为订阅导入失败。
完成排查后，保留一个来源明确的订阅分组即可，避免为同一个 URL 建立多个名称不同的副本。需要进一步检查规则、DNS 或连接状态时，可继续阅读排查手册；需要确认术语含义时，可查看术语手册。