官方手册 · 快速上手
Shadowrocket 导入与连接教程
按“资料 → 模式 → 连接 → 验证”的顺序操作。首次设置先完成手动连接，再调整规则和自动连接条件。
开始前：应用与连接资料分别准备本教程以用户已从 App Store 装好 Shadowrocket，并已有自己的订阅链接或服务器信息为前提。本站不提供、不销售、不推荐节点或订阅。客户端一次性买断 ≠ 线路套餐。
尚未安装时，先阅读App Store 正版下载说明。核对开发者 Shadow Launch Technology Limited 与应用 ID
932747118；系统要求以 App Store 页面标注为准。
以下主要说明 iPhone 与 iPad 上的操作。配图为 App Store 官方截图，用于辨认页面；实际字段与排列以设备上的应用为准。阅读时不要照抄截图中的连接资料。
步骤 01 · 连接资料
Add Server：添加服务器或导入订阅
打开 Shadowrocket 后进入 Home。下方的 SERVER 分组用于显示服务器条目，Add Server 是添加入口。先判断手中的资料属于哪一种：一整条订阅地址、一条单独的服务器分享链接，还是包含地址、端口与认证字段的参数表。三种资料的添加方式不同，不要把订阅地址填写到 Host，也不要把单条服务器链接当作订阅反复更新。
已有订阅：选择 Subscribe
从自己的服务商处取得完整订阅链接后，在 Home 点 Add Server，打开 Type 并选择 Subscribe，再把地址粘贴到 URL 字段。检查开头、结尾及查询参数是否完整，尤其留意复制时附带的空格、换行或聊天软件标点。完成后使用页面的保存操作，返回 Home 等待订阅内容载入。
成功导入后，Home 应出现相应分组及服务器条目。展开分组并点选一个自己准备使用的条目，确认它处于选中状态。保存订阅地址只代表客户端记住了地址；如果没有载入条目，还需要检查更新结果，不能直接进入连接步骤。订阅更新用于重新取得远端列表，不等于连接开关，也不保证原先的服务器仍然有效。
手动填写：先核对 Type 与协议字段
如果已有服务器参数，在 Add Server 中先选择正确的 Type，再依次填写 Host、Port 与该协议要求的认证信息。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 等协议需要的字段并不相同；Type 改变后，页面上的字段也可能变化。先选协议可以避免把字段填到错误的位置。
以配图所示的字段为例，Host 是服务器地址，Port 是端口，Password 与 Method 应按自己的资料逐项核对。其他协议出现的 UUID、TLS、Server Name 或传输参数，也应保持与资料一致。不要凭印象补一个加密方式或省略认证字段。保存后回到 Home，找到新条目并选中；如果需要修改，重新打开该条目的编辑页面，而不是连续创建多个近似名称的副本。
已有二维码时，可在合适的添加页面使用 Scan QR Code，并按需授予相机权限。Import from Cloud JSON 是另一种资料入口，仅在已有对应格式文件时使用。二维码、单条分享链接、订阅地址与 JSON 文件不能因为都包含连接信息就互相替代。
本步完成标志：Home 已显示服务器条目，并且已明确选中其中一个。接下来先选择 Global Routing，再打开连接开关。
步骤 02 · 请求路径
Global Routing：选择配置、代理或直连
返回 Home，点 Global Routing 查看当前模式。本教程使用三种写法：配置(Config)、代理(Proxy)、直连(Direct)。这里决定请求采用哪一类路径；SERVER 中选中的条目则决定需要代理时使用哪台服务器。两者分工不同，选中服务器并不表示每一个请求都会经过它。
- 配置(Config)：依据当前配置中的规则决定请求使用 PROXY、DIRECT、REJECT 或配置内的其他策略。准备日常按规则使用时，先确认配置内容和策略引用。
- 代理(Proxy)：将一般请求交由所选代理路径处理，适合首次检查服务器是否具备基本连接能力。它不是“修复连接”的按钮，错误的服务器参数仍然会导致失败。
- 直连(Direct)：让一般请求直接访问，适合作为对照。若目标在该模式下能打开，不能据此认定代理服务器已经可用。
Config：确认配置文件与 Rule
准备使用配置(Config)时，进入 Config，确认当前选中或启用的是预期的配置文件，再查看 Rule。配图展示配置文件编辑页面，其中 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是不同内容分段；Add Rule 用于新增规则。打开过一个文件不一定等于已将它设为当前配置，应返回文件列表再次确认选择状态。
规则会按配置规定的顺序参与匹配。下面只展示语法，不是可直接替代完整配置文件的内容：第一行表达域名后缀匹配，第二行是最终匹配。PROXY、DIRECT、REJECT 是策略关键字，不是服务器地址，也不是订阅内容。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT第一次连接时不要同时改动多条规则。可以先用代理(Proxy)完成基础验证，再切回配置(Config)检查分流结果。若 Proxy 可用而 Config 下某个目标失败，排查重点应转到规则命中和策略，而不是立即重填服务器。复杂规则的调整顺序见规则分流与故障排查。
本步完成标志：能说清当前选中的是哪一种模式，以及需要代理时会使用哪个服务器。保留这个状态，进入下一步连接。
步骤 03 · 系统连接
Home：打开开关并确认 VPN 配置
回到 Home，先检查两处：SERVER 分组中的所选服务器是否正确，Global Routing 是否保留了上一步计划使用的模式。确认后打开顶部开关。未连接时可看到 Not Connected；打开开关后需要观察后续状态，不要把“点过开关”当成已经成功。
首次连接可能出现系统添加 VPN 配置提示。这是系统允许应用建立相关网络连接的授权流程，与在 Config 中添加规则文件不是同一件事。核对提示来自刚刚主动操作的 Shadowrocket 后，按系统要求确认，必要时完成设备认证。返回应用，等待状态变化，再进行实际访问测试。
如果上次选择了拒绝，可以再次打开连接开关，观察是否重新出现授权提示。仍不能建立配置时，到系统设置中的 VPN 管理位置检查相关记录与设备限制。受组织管理的设备可能有额外策略，应按设备管理要求处理，不要反复删除与当前问题无关的配置。
系统显示 VPN 状态，说明隧道已建立或处于活动状态；它并不能单独证明服务器认证、域名解析及目标访问都正常。相反，某些规则会使部分请求直接访问，因而也不能只凭某个页面能打开，就认定全部流量经过了代理。
本次练习先保持手动连接，暂不启用 On Demand。如果连接后立即断开，先记下提示和发生时间，进入后文排查；如果开关保持开启，则进入 Connectivity Test 与实际访问验证。两种情况都不需要重新购买客户端。
步骤 04 · 结果验证
Connectivity Test：测试与实际访问分开判断
在 Home 使用 Connectivity Test，等待测试结束。测试结果反映的是所选测试方法和测试目标下的响应情况，不等同于所有网站、所有应用都能正常工作。某个条目没有返回结果时，先记录现象；不要只凭一次测试就删除整份订阅。
随后打开自己有权访问、且预期应当可用的目标页面。先测试普通网页，再测试实际需要使用的功能。页面能显示但图片、登录或其他请求失败时，应分别看待这些请求；同一个页面可能调用不同域名，Config 中的规则也可能为它们选择不同策略。
- 看连接层：返回 Home，确认开关仍开启，连接状态没有反复变化。
- 看服务器路径：保持服务器不变，用代理(Proxy)检查基本访问，再与计划使用的配置(Config)比较。
- 看规则结果：若只有 Config 下出现差异，检查相关域名规则、最终匹配规则与所引用策略。
比较时一次只改一个条件。例如固定服务器，只切换 Global Routing；或固定模式，只切换自己已有的另一条服务器。每次操作后重新发起请求，必要时重新打开目标页面，避免旧连接和缓存影响判断。若同时更新订阅、换服务器、改 DNS 和改规则，就很难判断是哪一步改变了结果。
验证结束后，恢复准备日常使用的模式。Data 中的上传、下载读数可以辅助确认有流量活动，但读数增长本身不代表目标访问成功，也不适合作为全部请求均已代理的证据。能稳定复现“连接保持、目标可访问、规则行为符合预期”，才算完成本轮上手。
步骤 05 · 按阶段排查
Settings：先定位失败点，再修改设置
出现问题时，先关闭连接，确认设备在当前 Wi-Fi 或蜂窝网络下能够完成基本访问。需要登录的 Wi-Fi 应先完成网络认证。基础网络尚未可用时，反复更新订阅或修改规则通常不能解决问题；先恢复基础访问，再按失败发生的位置继续检查。
订阅没有条目：检查地址与更新结果
确认使用的是完整订阅地址，而不是服务页面地址或单条分享链接。检查是否到期、参数是否被截断，以及当前网络能否取得订阅内容。能够保存地址但没有条目，说明添加动作与内容载入需要分别检查。若错误与账户状态或远端内容有关，应向自己已有的服务商核对，不要把私人订阅地址贴到公开讨论区。
开关无法保持：检查配置授权与认证资料
先区分“系统未允许 VPN 配置”和“服务器无法连接”。前者回到连接授权步骤检查；后者重新核对 Type、Host、Port 与认证字段。地址可解析并不代表端口可达，端口可达也不代表密码或其他认证参数正确。遇到明确错误时先记录原文，再与自己的资料逐项对照，不要通过随机修改字段尝试碰运气。
测试与浏览不一致：核对 Test Method 与规则
进入 Settings 查看 Test Method，先理解当前测试方式。不同测试方法观察的对象不同，不能把测试结果当作实际业务请求的完整替代。如果代理(Proxy)可以访问而配置(Config)失败，回到 Config 检查 Rule；如果两者都失败，再检查服务器资料、基础网络以及目标本身的状态。
Settings 中还能看到 Diagnostics，以及 Proxy、TCP、UDP 等相关设置。它们不是一组需要全部打开的“连接增强”选项。初次排查应保留原设置，只在已有证据指向某项时修改，并记下原值。TCP 请求正常也不能直接证明 UDP 请求正常，应按实际失败的功能区分。
需要进一步分析时，可使用 Diagnostics 收集相关信息。记录失败时间、当前网络、Global Routing、所选服务器及错误现象即可帮助缩小范围。分享日志或截图前，遮盖订阅地址、密码、UUID、访问令牌及其他私人资料；诊断内容也可能包含访问域名，不宜整份公开。
本页只覆盖首次上手的排查顺序。更细的情形请阅读Shadowrocket 无法连接与规则排查；购买恢复和商店地区问题请转到App Store 指南，不要在连接设置里处理账号购买问题。
步骤 06 · 可选设置
On Demand：手动连接稳定后再启用
On Demand 用于按条件触发连接，不负责修复错误的服务器信息或失效的订阅。完成前面的手动连接与访问验证后，再进入 Settings 查看 On Demand。先确定自己的目的，例如在某个网络条件下连接，或在特定条件下保持断开，再阅读当前页面提供的条件和动作。
首次设置只新增一个容易验证的条件。保存后分别测试条件匹配和不匹配的情况，并返回 Home 观察连接状态。涉及 Wi-Fi 名称时，按实际网络名称填写；涉及域名条件时，按应用所提供的规则形式输入，不要把完整网页地址与域名混用。多个条件同时存在时，还要检查它们的顺序和动作是否冲突。
如果手动关闭后连接又自动出现，先查看 On Demand 是否仍在生效，而不是立即认为开关失灵。排查其他连接问题时，可以先暂停 On Demand，让测试回到明确的手动状态；确认基础连接恢复后，再逐项恢复自动条件。
至此，基本使用流程已经闭环：已有资料能够载入，所选模式明确，系统允许连接，目标访问经过验证。以后出现异常，优先回到发生变化的那一层，而不是从头重做全部设置。订阅内容变动先查更新，模式变动先查规则，换网络后失败先查基础网络。