官方手册 · 首次连接步骤
Shadowrocket 订阅导入与连接教程
按“导入信息 → 选择 Global Routing → 打开连接 → 验证结果 → 定位失败点”的顺序操作。先让一条已有服务器记录完成验证，再整理其他订阅与规则，不要在首次设置时同时修改多个选项。
- 操作界面 Home / Config
- 适用设备 iPhone / iPad
- 前提 已有连接信息
本页提供一次上手所需的操作路径；订阅更新、多订阅整理、字段解释与备份方法，请继续阅读订阅与服务器管理手册。
[Before You Start]操作前，应已从 App Store 安装 Shadowrocket，并已有自己的订阅链接或服务器信息。本站不提供、不销售、不推荐节点或订阅。客户端一次性买断 ≠ 线路套餐；购买应用不会自动生成可用服务器。
尚未安装时，先阅读App Store 正版购买与安装说明。iPhone 与 iPad 的系统要求、兼容性及购买适用范围，以 App Store 页面标注为准。以下步骤以应用内英文界面词定位，不依赖按钮的固定屏幕位置。
[Subscribe]步骤 01 · 准备连接记录
添加服务器或导入已有订阅
先判断手上的内容属于订阅地址、单条分享链接，还是逐项服务器参数。三者使用不同入口，不要只根据链接看起来像网址就选择 Subscribe。
已有订阅地址：选择 Subscribe
打开 Shadowrocket，进入 Home，点右上角的加号进入 Add Server。在 Type 中选择 Subscribe，把自己的完整订阅地址填入 URL，并填写便于辨认的备注后保存。订阅通常返回一组服务器记录，保存或更新后应回到 Home 查看是否生成了对应的分组与条目，而不是停留在编辑页就认为导入完成。
复制地址时，从第一个字符检查到最后一个字符。查询参数可能包含身份凭据，不能随意删去问号后的内容，也不要把聊天文字、中文引号、换行或末尾标点一起复制进去。下面只用于辨认订阅地址的结构，不能用于实际连接；操作时请使用自己已有的完整地址。
https://example.com/sub?token=xxxx若保存后没有出现服务器，先检查 URL 是否完整，再查看应用返回的提示。不要为了得到列表而连续创建相同订阅，也不要把 Subscribe 改成某个单节点协议来尝试解析。空列表与单台服务器连接失败发生在不同阶段，应分别处理。
已有服务器参数：在 Add Server 逐项填写
如果拿到的是地址、端口、密码及协议说明，在 Add Server 的 Type 中选择与资料一致的协议，再填写界面展示的相关字段。Address 应是服务器主机名或地址，不要擅自添加网页路径；Port 应与原资料一致。密码、加密方式、UUID、TLS、SNI 等字段是否需要填写，取决于选中的协议及服务器要求，不应从其他条目复制猜测。
填写完成后保存，返回 Home 检查新条目是否存在。协议相同不代表参数相同；特别是 Trojan 的密码与 SNI、Shadowsocks 的加密方式与密码，不能互相替代。遇到资料中没有说明的必需字段，应核对已有服务器资料，而不是关闭验证选项来绕过提示。
已有分享链接或二维码：导入后复查
以 ss://、vmess://、vless:// 或 trojan:// 开头的内容通常是单条分享链接，不等同于可持续更新的订阅。使用剪贴板导入时，按应用出现的导入提示操作；持有二维码时，可通过 Scan QR Code 读取，并按系统提示允许所需的相机访问。不要把二维码发到公开页面请求代为识别。
无论采用哪种方式，最终都要回到 Home，点选本次准备使用的服务器行，并根据选中标记确认选择结果。先选定一条记录，再进入下一步；订阅组里有多条记录，并不表示它们会同时参与本次连接。更完整的导入与整理方法见Subscribe 管理说明。
[Global Routing]步骤 02 · 决定流量处理方式
选择配置、代理或直连
有了服务器记录后，还要指定如何使用它。Global Routing 与服务器选择是两件事：前者决定处理方式，后者决定需要代理时使用哪条服务器记录。
在 Home 点开 Global Routing，按当前任务选择三种姿态之一：配置(Config)、代理(Proxy)、直连(Direct)。选好后返回 Home，核对显示的模式，再继续打开连接开关。不要只记住某次选过的选项；后续排查时也应重新确认当前模式。
配置(Config)：按当前配置文件处理
已有规则配置、希望不同目标采用不同策略时，选择配置(Config)。随后进入 Config，确认准备使用的配置文件确实处于启用状态。仅在 Config 中看到一个文件名，或者刚把文件导入列表，都不能替代对当前启用项的检查。订阅负责提供服务器记录，配置文件负责组织规则；导入订阅不会自动证明规则已经就绪。
在 Config 模式下，目标可能按规则使用 PROXY，也可能使用 DIRECT 或其他指定策略。规则顺序与最终兜底规则都会影响结果。因此，看到某个网站走直连，不应立即判断服务器失效；应先确认该目标本来应该匹配哪条策略。首次上手只需确认当前配置，不必立即编辑整份规则。
代理(Proxy)：用于确认所选代理路径
希望先检查所选服务器能否承载通常的访问流量时，可暂时选择代理(Proxy)。这能减少规则匹配带来的变量，但仍受系统网络行为及相关设置影响，不能理解为对设备所有通信作绝对保证。完成验证后，如果日常使用目标是规则分流，应切回配置(Config)，并再次核对目标服务是否按预期工作。
直连(Direct)：不通过所选代理服务器
直连(Direct)用于直接访问，不应用它证明代理服务器可用。如果 Home 已选中服务器，但 Global Routing 仍是 Direct，目标访问可能根本没有经过该服务器。需要比较基础网络与代理路径时，可以记录切换前后的结果；每次只改模式这一项，避免同时更换服务器导致无法比较。
本步完成的标准是：能说清当前选的是哪种姿态，以及选择它的原因。涉及 DOMAIN-SUFFIX、IP-CIDR 与 FINAL 的匹配细节，请转到节点管理与配置说明继续阅读，首次连接阶段先保留已经确认的设置。
[Connect]步骤 03 · 建立系统连接
打开开关并允许 VPN 配置
返回 Home，再检查一次所选服务器与 Global Routing，然后打开顶部连接开关。首次授权仅允许应用在设备上添加 VPN 配置；连接使用的是你已有的订阅或服务器信息。
第一次启用时，系统可能提示 Shadowrocket 请求添加 VPN 配置。确认提示对应正在进行的操作后，按系统指引允许，并完成设备要求的验证。这里授权的是应用在设备上建立相应网络配置的能力，不代表系统已经检查了服务器密码，也不代表远端服务一定可以连接。
如果之前取消了提示，先返回 Home 再尝试打开开关，并留意是否重新出现授权界面。不要为了继续操作而删除设备中用途不明的配置；设备若受组织管理，应先确认管理策略是否允许该操作。遇到明确的系统限制提示时，反复改服务器参数不能解决授权问题。
完成系统确认后回到 Shadowrocket，观察连接开关是否保持开启。连接建立过程中先等待当前操作结束，不要连续快速开关。若开关立即关闭，记录此时出现的错误文字，再到第五步区分系统授权、当前网络与配置问题。准确提示比“打不开”这样的概括更有助于定位。
iPhone 与 iPad 都按这一顺序核对。不同屏幕尺寸下列表和详情的呈现位置可能不同，应以 Home、Global Routing、Config 等界面词定位，而不是照搬固定坐标。不要因为状态栏没有在某个固定位置显示 VPN 字样，就单独据此判断失败。
此时暂不启用额外的自动连接行为，也不同时调整 On Demand。先验证手动连接与断开能按预期工作，之后再考虑自动化设置。关闭 Home 的连接开关后也应重新检查应用状态，尤其是在曾经设置过 On Demand 的设备上，避免把自动重新连接误认为手动开关失效。
[Checkpoint]开关保持开启，仅说明本地连接状态已进入下一阶段。服务器是否可用、目标是否经过预期策略，还需要通过下一步的测试与实际访问确认。
[Connectivity Test]步骤 04 · 检查实际结果
先测试，再验证目标访问
把本地开关、服务器测试和实际访问分开观察。任何一个单独结果，都不足以证明全部配置正确。
在 Home 使用 Connectivity Test，对已有服务器记录执行测试，留意本次准备使用的那条记录返回什么结果。测试结果用于观察当前网络下的可达性与响应情况，不是服务质量承诺，也不能代替登录、网页加载或其他实际业务验证。不要单纯按照某一次测试数值选择并频繁切换服务器。
接着打开浏览器或需要使用的应用，访问自己有权使用的目标服务。选择一个结果容易辨认的页面，确认它是否能完成实际内容加载，而不是只显示先前缓存的标题。若目标本身需要登录，还要把账号权限问题与网络连接问题分开；出现登录拒绝，不等于代理连接一定失败。
使用配置(Config)时，核对当前配置是否让该目标走预期策略。如需进一步确认，可结合应用内可用的连接记录，查看目标与处理策略是否对应；日志展示以当前界面为准，不必寻找某个固定颜色或固定图标。目标命中了 DIRECT 时，即使页面正常打开，也不能据此证明所选代理服务器已经承载该次访问。
若 Proxy 下能访问、Config 下不能，优先回到 Config 检查当前启用文件与规则，而不是马上重新导入订阅。若 Connectivity Test 有结果，但目标访问仍失败，则继续检查目标服务状态、协议所需字段及 DNS 等因素。两种结果并不矛盾，因为测试请求与实际访问的目标及过程可能不同。
完成后做一次简单记录：使用的是哪种基础网络、选中了哪条服务器、Global Routing 是什么、Connectivity Test 返回什么、目标访问出现什么现象。记录只需写便于自己辨认的名称，不要附带密码或完整订阅链接。随后手动断开，再确认基础网络是否恢复到预期状态，这样可以建立清晰的前后对照。
当所选服务器、路由模式与目标访问结果能够相互对应，本次首次连接验证才算完成。以后更换订阅、服务器或配置文件时，也可以重复这组检查，而不必重新修改所有设置。
[Diagnostics]步骤 05 · 按阶段缩小范围
常见失败点与自查顺序
先找到失败发生在哪一步，再改对应设置。一次只变更一个因素，每次修改后回到相同目标重新验证，保留可比较的结果。
订阅保存后为空或解析失败
回到订阅编辑处检查 URL，确认它不是服务商网站的登录页、说明页或单条分享链接。检查复制时是否缺少查询参数，以及地址是否已被替换或失效。若应用给出返回内容相关的提示，保留提示文字并核对自己已有订阅的状态。不要公开粘贴地址让他人测试，其中的 token 可能直接代表访问权限。
更新失败不必立即删除现有分组。先确认原有记录是否还在，再判断是更新请求失败，还是更新后内容确实发生变化。避免在没有备份的情况下反复删除和重新添加，导致原始信息与调整记录都丢失。
服务器已出现，但测试失败
先关闭连接，确认 Wi-Fi 或蜂窝网络本身能完成普通访问；遇到需要网页登录确认的网络，应先完成网络接入。随后回到 Add Server 对照原始资料检查协议、地址、端口以及认证字段。手动填写时尤其注意尾部空格、大小写和容易混淆的字符，不要只比较备注名称。
如果协议需要 TLS 或 SNI，按已有资料核对相应设置。服务器地址与用于校验的名称可能承担不同作用，不能因为字符串不同就擅自改成相同值。不要通过关闭证书校验来掩盖问题，应先确认参数、设备时间与服务器端状态。
开关无法保持开启
先回看系统 VPN 配置是否已经允许，以及应用是否显示了明确错误。确认当前确实选中了一条服务器，并检查是否还有其他正在使用的网络配置影响本次操作。先结束已知的冲突连接再重试，不要删除不清楚用途的设备设置，也不要把重新购买应用当作排查步骤。
连接后只有部分目标失败
先检查 Global Routing。若是 Direct，当前并未使用预期的代理路径；若是 Config，检查目标是否命中不同策略，再用 Proxy 作一次受控对照。若只有某个应用失败，浏览器正常，继续检查该应用的账号状态、缓存与目标服务可用性，不要据此判断整组订阅都不可用。
DNS、规则顺序与协议字段需要进一步分析时，转到订阅与服务器管理手册。本教程阶段不建议同时修改 DNS、规则、服务器与自动连接选项，否则即使恢复访问，也难以确认是哪项修改产生作用。
整理结果后再继续调整
完成一次检查后，把结果归到导入、路由、系统授权或目标访问中的一个阶段。若要向自己的服务商核对信息，只说明失败时间、网络类型、协议类型和经过处理的错误提示；移除完整订阅 URL、密码、UUID、分享链接与二维码，也留意截图中可能出现的个人信息。
后续重新操作可从第一步导入检查开始，若服务器记录已正确保存，则直接从Global Routing 选择继续。保持每一步都有可核对的结果，比反复重建所有配置更容易找到真正的失败点。