Shadowrocket 导入与连接教程
从 Add Server 到实际请求验证，依次完成五步。适用于 iPhone 与 iPad；先建立一条可核对的连接，再调整规则与自动连接设置。
按顺序操作即可。四张配图均为 App Store 官方截图，用于辨认页面与字段；实际界面请以设备上显示的英文项目为准，截图中的内容不是需要照抄的连接资料。
添加服务器或导入已有订阅
先把自己的连接资料保存到应用，再选择实际使用的服务器。
打开 Shadowrocket，进入 Home，找到 SERVER 分组附近的 Add Server 入口；部分界面也可通过右上角的添加按钮进入。打开后，先看 Type，而不是直接填写 Host。Type 决定后续字段的含义，同一组地址和密码不能随意套用到另一种协议。开始输入前，确认自己拿到的是订阅链接、单台服务器参数，还是单条服务器分享链接，这三类资料的导入方式不同。
已有订阅链接：在 Type 选择 Subscribe
- 复制自己已有的完整订阅链接，返回 Add Server，在 Type 中选择 Subscribe。
- 将链接粘贴到该类型的 URL 输入项；如有备注项，可填写便于区分用途的名称。不要把整条订阅链接拆成 Host 和 Port，也不要删掉链接里的查询参数。
- 检查粘贴内容是否混入说明文字、空格或换行，再使用页面右上角的保存入口，等待订阅内容载入。
- 回到 Home，确认订阅分组及其服务器条目已出现，并选择其中一个目标条目。只出现分组名称、没有服务器时，不能视为已完成导入。
Subscribe 的作用是读取链接返回的服务器信息，不是获取连接服务。链接可能包含个人访问凭据，不应发到公开聊天、截图或排错记录中。若返回内容是登录页面、提示页面，或与应用支持格式不符，保存链接也不会得到可选服务器；这时应核对原始资料，而不是反复添加同一个分组。
已有服务器信息：按对应 Type 手动填写
仍从 Add Server 进入，在 Type 选择资料明确标注的类型。Host 填服务器域名或地址，Port 填端口；Password、Method 或其他认证字段按该类型显示的项目逐项填写。官方配图展示的是包含 Password 与 Method 的字段组合，不意味着所有 Type 都使用同一套字段。遇到 UUID、TLS、Server Name 或传输选项时，应与自己的原始信息逐项对应，不能凭名称相似自行推断。
手动输入完成后保存，返回 Home 查看新条目，再点选它。如果已有自己的二维码，可使用 Scan QR Code，识别后核对 Type、地址和认证资料。Import from Cloud JSON 是读取兼容 JSON 资料的另一入口，不应当作任意订阅链接的通用输入框。剪贴板或分享链接的完整格式、订阅更新与分组整理，请继续阅读订阅与服务器管理手册。
选择 Global Routing 与当前 Config
服务器决定连接交给谁，Global Routing 决定请求如何处理。
服务器保存后回到 Home，点开 Global Routing。入门时先区分三种姿态：配置(Config)/代理(Proxy)/直连(Direct)。这里的选择会改变请求处理路径，不是对服务器进行测速，也不会替换刚才填写的认证信息。为便于排查，先记录当前选项，再按自己的用途选择；不要在尚未验证服务器时同时更换多份配置。
| 姿态与界面词 | 处理方式 | 入门检查重点 |
|---|---|---|
| 配置(Config) | 依照当前配置中的规则决定请求走向。 | 确认配置已选用，规则指向的策略或服务器有效。 |
| 代理(Proxy) | 将可由应用代理的流量交给当前所选服务器。 | 可辅助隔离分流规则的影响，不代表所有请求必然成功。 |
| 直连(Direct) | 直接连接目标服务。 | 适合对照本地网络状态，不用于验证代理服务器是否可用。 |
使用 Config 前，确认正在使用哪份配置
如果已有经过自己确认的配置文件，进入 Config，检查当前选用的文件。需要查看规则时，打开该文件的编辑入口，辨认 General、Rule、Hosts 等分段；Rule 中的 Add Rule 用于添加规则。配图显示的是配置文件编辑页，而不是 Home 上的 Global Routing 选择页，两者职责不同：前者保存配置内容，后者决定是否按配置执行。
首次连接不必急着添加规则。先查看现有规则是否指向已经存在的目标，避免把规则中的策略名称误当成服务器地址。下面是用于辨认语法的真实规则片段，不是适用于所有网络环境的完整配置；example.com 是说明用域名，不是连接地址。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY在这样的规则语义中，DOMAIN-SUFFIX 用于匹配域名后缀，DIRECT 表示直接连接，PROXY 表示交给代理处理，FINAL 用于兜底。实际处理还取决于完整配置及规则顺序，所以不能只看最后一行就断定所有请求的路径。若尚不理解现有配置，先保留原文件，不要删除 General 或批量覆盖 Rule。
需要暂时区分“服务器本身有问题”还是“分流结果不符合预期”时，可记录原选项后切到 Proxy 进行一次对照，完成后恢复原模式。详细的模式边界见代理模式说明；涉及配置文件的保存、整理与备份，则阅读订阅手册。本页继续沿用已确认的模式，不展开整套规则编辑。
打开连接开关并完成系统授权
先确认服务器和模式，再处理首次出现的 VPN 配置提示。
现在回到 Home，依次核对三处：SERVER 中是否选中了刚才保存的目标，Global Routing 是否为准备使用的模式，顶部开关是否仍处于未连接状态。官方截图中的 Not Connected 表示未连接，并非导入失败；即使列表里已有服务器，应用也不会仅因保存条目就自动完成连接。
- 确认当前资料和模式后，打开 Home 顶部的连接开关。
- 首次建立连接时，系统可能提示添加 VPN 配置。核对提示所指向的应用确为 Shadowrocket，并在理解该请求后确认。
- 如系统要求设备密码或身份验证，按设备上的提示完成，不要把设备密码填入 Add Server 的 Password 字段。
- 返回 Shadowrocket，观察顶部状态是否从 Not Connected 转为连接状态，再继续下一步验证。
这里的系统授权用于让应用通过系统网络机制处理流量，不会补全错误的服务器参数，也不会为订阅增加可用内容。若拒绝了授权，先回到应用重新尝试连接并阅读提示；设备受管理或系统存在限制时，应先核对设备设置，不要连续点击开关来绕过提示。
连接建立后，系统的 VPN 标识可作为隧道已启用的辅助信息，但不是目标服务可访问的保证。服务器认证失败、DNS 解析异常或目标自身故障，仍可能发生在开关开启之后。相反，如果当前使用 Direct，打开开关也不能据此推断流量正在经过所选代理服务器，必须结合 Global Routing 判断。
首次验证期间，建议保留当前网络，不要立即从 Wi-Fi 切换到蜂窝网络，也先不要设置 On Demand。这样能减少变量：出现失败时，可以明确问题发生在导入、授权还是连接之后。需要停止时关闭 Home 顶部开关；计划修改 Type、端口等关键字段时，先断开、保存，再重新连接。
验证连接与请求是否符合预期
分开检查服务器可达、目标服务可用、路由结果正确这三件事。
回到 Home 使用 Connectivity Test，观察当前服务器是否有测试结果。它用于帮助判断相应测试方式下的可达性，不等同于完整业务测试；即使某项测试有响应，实际请求还可能受到认证、DNS、传输设置或目标服务状态的影响。反过来，某种测试方式没有响应，也不能直接证明所有请求都无法通过。
先打开一个明确的目标，再判断路径
在浏览器或需要使用的应用里，打开自己有权访问、且预期应通过当前配置处理的目标服务。不要只看已打开很久的页面，因为缓存内容可能在断开后仍然显示。尝试发起新的加载或刷新，并记录是否出现域名解析错误、连接超时、证书提示或目标返回的错误页面。这些现象对应不同阶段，比一句“连不上”更有助于后续判断。
若使用 Config，应先确认目标域名预期命中哪条规则。一个按规则直接连接的页面能打开，只能说明该次直连请求成功，不能证明所选代理服务器已经可用。若 Proxy 下能完成同一请求而 Config 下失败，则重点回看当前配置、匹配顺序和策略目标；若两者都失败，则再检查服务器资料与本地网络。对照结束后恢复原模式，避免遗留临时设置。
一次只改变一个条件
第一次测试建议固定同一个服务器、同一个目标和同一种本地网络。如果需要比较 Wi-Fi 与蜂窝网络，先记录原测试结果，再切换网络重试；如果需要更换自己已有的另一台服务器，则保持目标和模式不变。同时更换服务器、DNS 与规则，会让成功或失败都难以归因，后续也无法判断应保留哪个修改。
当目标请求正常、模式与预期一致，且重新打开连接后仍能复现同样结果，可以结束本轮入门操作。此时再考虑订阅更新、分组整理或 On Demand。Connectivity Test 的方法差异、DNS 与特定请求错误的深入解释放在常见问题与故障排查，不需要为了完成首次连接逐项改动所有设置。
按失败阶段检查，不同时重设全部选项
保留已有信息，从最接近故障发生的位置开始。
如果前四步没有得到预期结果，先停止反复删除与重新导入。记录失败发生在哪一步、当时的 Global Routing、所用本地网络及错误提示。随后进入 Settings，辨认 Test Method、On Demand 和 Diagnostics 等项目。它们用于测试、自动连接或诊断，不是把任何服务器变成可用连接的通用开关。
保存 Subscribe 后没有服务器
先确认本地网络本身能够正常访问，再检查订阅链接是否完整、是否已经失效，以及返回内容是否为兼容的订阅数据。有些链接包含查询参数，复制时丢掉后半段会改变返回结果。若此前已有同一订阅分组，优先在原分组执行更新，避免重复导入造成列表混淆。订阅内容的有效性应按自己的现有服务信息核对；更新入口和多订阅整理详见订阅手册。
无法启用连接，或启用后立即断开
回到第三步确认系统 VPN 配置授权已完成，再确认 SERVER 中确实选中了目标服务器。如果开关短暂开启后又关闭，检查应用或系统给出的具体提示，并核对 Type、Host、Port 及认证字段。不要只因密码看似正确就忽略协议类型；需要 TLS 或特定传输字段的资料，也不能仅填地址与端口后就保存。
测试有响应，但页面仍无法加载
先辨认测试方法。Settings 的 Test Method 会影响测试的含义，结果不应当作完整访问能力的承诺。再按第四步用同一目标做 Config 与 Proxy 对照，检查当前规则是否把请求交给有效目标。若只有域名请求失败，应结合具体错误检查 DNS；不要在没有记录的情况下同时替换多个解析地址，也不要因为页面出现证书提示就随意开启 HTTPS Decryption。
切换网络、回到前台后状态不符合预期
先手动关闭连接，再在当前网络重新打开并复测，确认基本连接是否稳定。如果已经配置 On Demand，检查其触发条件是否符合当前网络环境。On Demand 用于按条件触发连接，不负责修复失效订阅或错误认证；首次连接尚未成功时，先保持手动连接，待基本验证完成后再单独设置。
需要继续定位时，保留最小必要记录
可按当前界面提供的 Diagnostics 入口查看诊断信息，围绕失败时刻和目标请求记录现象。诊断内容可能包含目标域名、服务器地址或个人资料，分享前应检查并隐藏订阅链接、密码及认证信息。保留修改前的配置，每次只改一个因素，再用同一目标复测；若修改后没有改善，恢复原值，避免把临时尝试长期叠加。
完成入门后，日常使用只需确认订阅内容有效、SERVER 选择正确、Global Routing 符合用途，并在需要时打开连接。更细的错误分类请进入常见问题；需要管理多份订阅、服务器与备份时再进入系统化订阅手册，无需在首次连接阶段把所有高级选项都设置一遍。
