Shadowrocket（小火箭）首次使用要先准备自己的连接资料，再选择路由方式并允许系统添加 VPN 配置。本文以 iPhone / iPad 的操作流程为主，说明 Home、Config、Settings 的分工，以及如何区分连接开关、服务器选择和连通性测试。适合已经安装应用、已有自己的服务商与订阅，但尚未完成第一次连接的用户。
首次打开前需要准备什么？
需要准备用户自己的服务器资料或订阅，以及可正常联网的设备。安装客户端不会自动生成可用服务器；VPN 配置权限也不是服务器账户。本站不提供、不销售、不推荐节点或订阅，连接资料应由用户向自己的服务商核对。
应先确认安装渠道与设备平台。iPhone / iPad 的 App Store 产品页开发者为 Shadow Launch Technology Limited，应用 ID 为 932747118，系统要求以 App Store 页面标注为准。Mac 提供 Apple 芯片与 Intel 两种版本；各平台获取入口统一见客户端下载页。下文的系统权限路径以 iPhone / iPad 为例，其他平台的授权窗口以本机系统显示为准。
- 已有订阅：确认链接完整、账户有效，并注意链接通常含个人访问凭据。
- 手动添加：准备协议类型、服务器地址、端口及认证信息；TLS 等附加参数也应与服务端一致。
- 已有规则配置：确认文件来源与用途，区分服务器订阅和用于分流的配置文件。
第一次连接与 VPN 配置权限怎么处理？
首次连接应在选好服务器后打开 Home 的连接开关，并在系统弹窗中允许添加 VPN 配置。这个授权让应用建立系统网络隧道；它不验证订阅是否有效，也不保证远端服务器可达。拒绝后，应重新发起连接并处理系统提示，而不是反复导入同一份订阅。
-
检查基础网络
先保持 Home 连接开关关闭，用浏览器确认当前 Wi-Fi 或蜂窝网络可以访问原本可达的网站。若网络有登录认证页，应先完成认证。
-
添加连接资料
进入 Home → 右上角“+” → Type。已有订阅时选择 Subscribe，填入自己的链接并保存；手动添加时选择实际协议，再填写对应参数。
-
选择服务器
回到 Home，在 SERVER 列表选择准备使用的条目。订阅导入后若没有服务器，应先检查导入或更新结果，不要把空列表理解为权限问题。
-
核对路由方式
进入 Home → Global Routing。已有经过核对的规则配置时使用 Config；临时排查时可用 Proxy 对照，避免一开始同时修改多个设置。
-
允许系统配置
打开 Home 的连接开关，在系统添加 VPN 配置提示中选择允许，并按系统要求完成身份验证。返回应用检查状态，再访问目标网站确认实际结果。
已允许过配置的设备不一定每次都弹窗，这是正常的权限复用。若曾在系统中删除 VPN 配置，之后可能需要再次授权。iPhone / iPad 可在系统“设置 → 通用 → VPN 与设备管理”中核对相关配置；不同系统版本的分组名称可能有所变化。
Home 的 Not Connected 与 SERVER 分别控制什么？
Not Connected 表示当前未建立应用的 VPN 连接，SERVER 列表则用于管理和选择服务器。前者是连接状态与开关，后者是连接所用的远端资料；列表里出现条目不等于已经连接，选中条目也不等于它一定可用。
| Home 区块 | 作用 | 首次使用检查 |
|---|---|---|
| Not Connected | 显示未连接状态，旁边开关用于发起连接。 | 开启后是否出现系统授权提示，状态是否发生变化。 |
| Global Routing | 决定连接建立后的流量处理方式。 | 核对当前选择的是 Proxy、Direct、Config 还是 Scene。 |
| Connectivity Test | 对服务器执行连通性测试。 | 观察测试结果；不要将延迟数字等同于目标网站可访问。 |
| SERVER | 展示服务器条目，供选择及编辑。 | 确认选中条目、协议及端口与自己的资料一致。 |
服务器条目的协议必须与服务端一致，不能靠更换 Type 随意互换。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的认证和传输要求不同。以端口为例，资料写明 443 时应填写该值，但“使用 443”本身并不能证明该条目采用 TLS，也不能代替密码、密钥或证书相关设置。
订阅更新与选择服务器也应分开处理。更新用于重新读取服务商提供的列表，选择用于决定当前使用哪个条目。服务商调整名称或删除条目后，应重新确认当前选择；不要把订阅链接、含认证信息的编辑页或完整配置公开发出。
Global Routing 的四种方式应该怎么选？
应按是否已有可用规则以及当前排查目标来选择。Global Routing 决定流量采用哪种处理方式，而不是更换协议或增加服务器。以下推荐以“已经核对并启用正确配置”为前提；没有规则配置时，不能仅因为选了 Config 就假定会按预期分流。
Config
推荐按当前配置中的规则与策略处理请求。不同请求可以命中 DIRECT、代理策略或 REJECT，实际结果由规则决定。
适合：已经在 Config 核对当前配置、需要按规则日常使用的情况。
Proxy
将接管范围内的请求交给所选代理处理，用于对照是否为规则分流造成访问差异；不代表设备上的每种系统流量都必然经过该代理。
适合：短时验证所选服务器，或与 Config 的访问结果进行对照。
Direct
使用直接连接方式处理请求，不通过所选远端代理转发。此时即使应用连接开关处于开启状态，也不能据此判断网站在走代理。
适合：检查基础网络或对照直连访问结果。
Scene
按已配置的场景条件应用相应路由安排。使用前需要核对场景条件与对应设置，具体选项以应用内显示为准。
适合：已经明确设置不同网络环境处理方式的用户。
Config 模式下应同时检查配置是否选对以及规则先后顺序。DOMAIN-SUFFIX 按域名后缀匹配，GEOIP 按 IP 地理归属匹配，IP-CIDR 按 IP 网段匹配，FINAL 为未命中前序条件的请求指定后续策略。先命中的规则会影响结果，因此“服务器测试可用，但某个域名失败”也可能是规则问题。
Connectivity Test 有结果就表示能正常上网吗？
不能，测试结果只反映所选测试方法与当时网络条件下的结果。TCP 建连和实际代理请求验证的范围不同；一个延迟值既不是下载速度，也不保证 DNS、TLS 和目标网站访问全都成功。应把它作为定位线索，再用实际请求复核。
检查方案：先测试服务器，再测试实际请求
服务器测试
- 在 Home → Connectivity Test 发起测试，记录当前测试方式。
- 观察所选条目是否返回结果或超时，不预设合格延迟阈值。
- 若多个条目同时失败，先核对当前网络及订阅资料。
实际访问
- 开启连接，并确认 Global Routing 的当前选择。
- 访问自己需要使用的网站，区分全站失败与单个域名失败。
- 分别在 Wi-Fi 和蜂窝网络对照，保持服务器与路由设置不变。
结论：一次只改变一个条件，才能区分本地网络、服务器参数、规则分流与目标站点问题。
测试失败时不要立即删除全部配置。若基础网络本身不通，任何服务器测试都可能失败；若仅一个条目失败，应先核对该条目的地址、端口和服务有效性。需要向自己的服务商反馈时，提供报错文字、发生的网络环境及是否能够复现，比仅描述“连接不上”更有帮助。
Home、Config、Settings 与 On Demand 怎么分工？
Home 负责日常连接和服务器选择，Config 负责配置文件及规则，Settings 负责应用设置。首次使用应先完成一次手动连接，再考虑自动连接条件；不要同时改规则、切服务器和开启自动连接，否则难以判断哪项设置造成变化。
- Home：确认服务器、Global Routing 和连接状态，进行 Connectivity Test。
- Config：确认当前使用的配置文件，检查规则顺序及策略引用。服务器订阅与规则配置作用不同，导入前应确认资料类型。
- Settings → On Demand：按设置的条件触发 VPN 连接。它处理何时连接，不替代服务器认证，也不保证失效的服务器恢复可用。
On Demand 不宜作为第一次连接失败的补救措施。应先在关闭自动触发的条件下手动验证；连接与访问均正常后，再进入 Settings → On Demand 阅读并设置需要的条件。如果手动断开后又自动连接，先回到这里检查触发设置，而不是反复删除系统 VPN 配置。
首次设置中常见的几种问题怎么排查？
应先按现象分组，再做最少量修改。以下处理顺序分别对应系统权限、资料导入、路由方式和自动连接，避免将所有问题都归结为同一个开关。
刚才点了不允许，还能重新授权吗？
可以重新发起连接。回到 Home 再次打开连接开关，按系统提示处理添加 VPN 配置授权；若没有出现预期提示，到系统“设置 → 通用 → VPN 与设备管理”核对现有配置与设备限制。受管理设备应联系管理方确认权限。
订阅保存了，SERVER 为什么还是空的？
先核对 Home 中保存的条目是否确实使用 Subscribe 类型，再检查自己的订阅链接是否完整、账户是否有效。确认网络可达后，在 Home 下拉刷新订阅并观察更新结果；不要把服务商的网页登录地址当成订阅地址。
开关已经打开，为什么网站还是打不开？
先检查 Home → Global Routing 是否处于 Direct，再做 Connectivity Test。若 Proxy 能访问而 Config 不能，回到 Config 核对当前文件及目标域名对应规则；若两种方式都失败，则继续检查服务器参数、基础网络和目标网站状态。
关掉开关后为什么又自动连接？
先进入 Settings → On Demand 检查是否设置了自动触发条件。临时关闭相关条件后再手动断开观察；还需区分是否存在其他系统 VPN 自动连接设置，避免只改 Home 开关却保留触发条件。
完成首次设置的判断标准是能重复完成连接，并按预期访问所需资源，而不是某个按钮变色或某次测试返回数字。保留一份已验证的配置，后续一次只修改一项；遇到问题时可先恢复已验证的设置，再逐项定位。