官方手册 · iPhone / iPad
Shadowrocket 使用说明
先导入已有连接信息，再选择 Global Routing，最后打开开关并验证实际访问。本页按首次配置顺序说明操作；已经完成的步骤可以通过目录跳过。iPhone 与 iPad 均按界面英文词定位，具体布局以当前应用显示为准。
准备好资料后，先区分两种输入：订阅链接用于获取一组连接条目，单个服务器信息用于手动添加一条连接。两者不需要重复录入。订阅也不等于规则配置文件；前者提供服务器资料，后者决定请求如何分流。首次操作先完成一条可核对的连接，再处理复杂规则。
Home → Add Server
步骤一：添加服务器或导入 Subscribe
按已有资料选择一种导入方式。保存后，先确认 Home 中的 SERVER 条目，再进入模式选择。
有单个服务器信息：填写 Add Server
打开 Home，在 SERVER 分组附近点击 Add Server。进入编辑页后，先点 Type 选择资料中指定的协议。选定 Type 后，页面字段会随协议变化；截图中的 Host、Port、Password、Method 是一种字段组合，不表示所有协议都必须填写相同内容。
把已有服务器地址填入 Host，把端口填入 Port，再按资料填写认证与加密字段。Host 通常填写域名或 IP 地址，不要自行加上网页路径；Password 保留原有大小写与符号，复制后检查首尾空格。Method 必须与服务器资料一致，不能为了让页面保存成功而随意换一个值。若资料包含其他认证或传输参数，也应逐项对应当前页面，缺失时先向自己的服务商核对。
如果已有资料以二维码形式提供，可以使用 Scan QR Code。扫码后仍要检查 Type、Host 与 Port 是否对应原资料，再保存。Import from Cloud JSON 是另一种特定格式的导入入口，不应把普通订阅链接随意填到这里。遇到无法识别的内容，先确认资料格式，而不是反复切换协议尝试。
有自己的订阅链接：选择 Subscribe
同样从 Add Server 进入，打开 Type 并选择 Subscribe，在 URL 字段粘贴自己的完整订阅链接。订阅地址可能包含查询参数，它们也属于地址的一部分；复制时不要删掉参数、换行后半段或末尾字符。填写便于辨认的备注后保存，返回 Home 查看订阅是否成功获取并展开出服务器条目。
如果保存后只出现订阅分组，却没有可选择的服务器，先检查是否需要在该分组执行更新，以及是否显示获取错误。订阅更新需要当前网络能够访问订阅地址，也需要该地址仍然有效。不要把订阅链接当成普通网页链接公开发送；它可能携带访问凭据。具体的失效、认证与返回格式问题可查看疑难解答。
保存完成后，在 Home 的 SERVER 中选中本次要使用的服务器，确认当前选中标记。添加成功只表示资料已经写入客户端，还不能证明服务器可连接。下一步先确定请求采用哪种处理方式；稍后再用测试与实际访问核对结果。
Global Routing · Config / Proxy / Direct
步骤二：选择 Global Routing 姿态
配置(Config)、代理(Proxy)、直连(Direct)分别决定请求按规则、代理路径或直接连接路径处理。
回到 Home，点击 Global Routing 查看选项。这里改变的是请求处理方式，不是导入来源，也不会替你修正服务器认证资料。首次配置时，应先知道当前选择代表什么，再打开连接开关；不要仅因为某个页面暂时打不开，就同时更改模式、服务器与 DNS。
配置(Config)：按当前规则分流
选择配置(Config)时，请求依据当前配置文件中的规则处理。进入 Config 页，确认实际启用的是哪份配置，而不只是看到列表里存在某个文件。打开对应文件后检查 Rule 内容及其引用的策略。配置编辑页中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 各有用途，首次连接不需要逐段修改。
规则通常按排列顺序判断，命中后使用相应策略。下面片段仅解释域名后缀与兜底规则的写法，不是为你的网络准备的完整配置，也不应直接替换当前文件。example.com 是示例域名；实际目标是否走代理，应由你的规则与使用需求决定。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT第一行规则匹配 example.com 及其子域名，采用 PROXY；没有被前面规则命中的请求落到 FINAL，采用 DIRECT。这也解释了为什么开关已打开，但部分请求仍然直接连接。若需要修改规则，可通过 Add Rule 或编辑现有条目完成；应先保留原配置，再逐条验证，详细流程见疑难手册。
代理(Proxy)与直连(Direct)：用于区分路径
代理(Proxy)适合临时检查所选代理路径是否可用，但实际处理仍可能受其他相关设置影响。直连(Direct)用于直接连接路径，不用于验证远端代理服务器。若 Config 下某个目标失败而 Proxy 下可以访问，应优先检查目标命中了哪条规则；若代理路径本身失败，则返回服务器参数与测试步骤，不要先堆叠新的分流规则。
选择后返回 Home，确认 Global Routing 显示的是预期姿态。日常需要规则分流时，验证完成应恢复配置(Config)，并再次确认启用的配置文件。此时服务器与模式都已明确，可以进入连接授权步骤。
Home · Not Connected
步骤三：打开开关并完成系统授权
先确认选中服务器和 Global Routing，再打开 Home 顶部连接开关。
在 Home 检查三处：SERVER 中已有可选条目、预期服务器处于选中状态、Global Routing 显示预期姿态。截图顶部的 Not Connected 表示当时尚未建立客户端连接。点击旁边的开关开始连接，不需要进入 Add Server 再保存一次资料。
首次建立连接时，系统可能请求允许 Shadowrocket 添加 VPN 配置。这是应用使用系统网络扩展所需的授权环节。核对弹窗中的应用名称，按系统提示允许，并使用设备当前要求的验证方式完成确认。若主动取消授权，连接开关不会因此变成有效连接；需要返回应用重新操作并完成授权。
授权后回到 Home，查看顶部状态与开关是否保持开启。客户端显示已连接，只说明本地连接功能已启动，不代表每个远端服务器、DNS 请求或目标网页都已经验证通过。规则仍会决定请求采用代理还是 DIRECT；因此，连接状态和实际可用性应分别检查。
如果开关刚打开就关闭，先观察是否存在系统提示或应用错误。不要连续快速点击开关，也不要立即删除全部配置。先确认授权确已完成，并检查设备是否正在使用其他 VPN 配置或存在设备管理限制；受管理设备的限制应由相应管理方确认。保留现有资料，按下方失败点流程定位具体环节。
iPad 上可用空间与布局可能不同，但仍按 Home、SERVER、Global Routing 这些词定位。切换到另一台设备后，需要分别检查该设备的连接授权与当前配置；应用已安装或已购记录存在，不等于服务器资料和选中状态已经同步完成。
连接保持后再切换到浏览器进行验证。测试期间先保持当前网络环境不变，避免同时从 Wi-Fi 切换到蜂窝网络；否则难以判断结果来自配置调整还是接入网络变化。完成一次测试后，再分别检查其他网络环境。
Connectivity Test → 实际访问 → 请求路径
步骤四：验证连接与规则是否生效
验证要分成两件事：所选服务器能否响应测试，以及需要访问的目标是否按预期路径工作。打开 Home 中的 Connectivity Test，查看所选服务器对应的结果。根据当前测试方式，结果反映的是相应检测环节；它不是所有网页可访问、全部协议正常或实际传输速度的保证。
测试出现结果后，在浏览器重新打开原先需要访问的页面。尽量选择一个你能够明确复现问题的目标，不要同时打开许多页面。记录是否能完成域名解析、是否开始加载、是否在某一步停住。刷新一次并等待合理时间即可，反复连续刷新会增加连接数量，却不能帮助判断根因。
若需要判断规则分流，查看应用内可用的连接记录或日志，核对目标域名、匹配规则与采用策略。Config 下目标使用 DIRECT，可能正是规则的预期结果；不能仅凭系统显示 VPN 状态，就认定所有流量都经过代理。Data 中的流量变化可以作为辅助观察，但统计增加本身不能证明某一条规则命中。
按结果决定下一步
- 测试与实际访问都成功：保留当前服务器和配置。若此前临时使用 Proxy，恢复 Config 后对同一目标再验证一次。
- 测试失败，但部分页面可访问：先核对测试方式及页面实际路径。页面可能采用 DIRECT，测试目标也可能与实际目标不同。
- 测试成功，但页面打不开：检查该页面的 DNS、规则策略和连接记录，不要直接认定服务器参数全部正确。
- 切换网络后结果改变：分别记录两种网络的表现，再检查接入网络限制与解析差异，不要把所有失败归为订阅问题。
需要进行对照时，每次只改一项。例如只把 Config 临时切到 Proxy，其余设置不动，再访问同一页面；结果改变后才有依据检查规则。测试完成应恢复原来的日常姿态。涉及持续超时、解析失败或性能问题时，转到疑难解答选择对应症状，不必在入门阶段修改所有高级设置。
Settings · Test Method / On Demand / Diagnostics
步骤五：按失败环节检查 Settings
先定位导入、测试、授权或实际访问中的失败点。保留原配置，每次只修改一个相关设置。
导入后没有服务器：先检查资料来源
返回 Add Server，确认订阅使用 Subscribe，而不是把链接填入普通服务器的 Host。检查链接是否完整、订阅是否仍有效、更新时是否出现认证或格式错误。如果是手动添加，重新对照 Type、Host、Port 与认证字段。能够保存不代表参数已经符合服务器要求，缺失资料应向自己的服务商核对，不能从截图推测填写值。
Connectivity Test 超时：先区分测试与连接
进入 Settings 查看 Test Method，确认当前测试采用什么方式。不同方式检查的环节不同，测试结果不应直接当作应用浏览速度。先核对所选服务器与端口，再检查当前网络是否能够到达服务器。使用自己的另一个已有条目做对照时，只切换服务器，保持模式与网络不变，才能判断问题是否集中在单个条目。
连接未保持或自动变化：核对 On Demand
如果连接会随网络条件变化而启动或停止，检查 On Demand 是否开启以及已有条件如何设置。按需连接用于条件触发，不是提升速度的开关。初次排错时可记录其原状态，暂时关闭后手动连接，以区分自动触发与手动操作；确认原因后再恢复需要的条件。Today Widget 属于快捷操作相关设置，不应作为服务器可用性的判断依据。
测试正常但网页失败：查看诊断线索
通过 Diagnostics 及当前应用提供的日志查看失败环节，重点区分 DNS 解析、远端连接与规则策略。若仅某个域名失败，先检查该目标的记录，不要立即修改所有 DNS 设置。Settings 中的 Proxy、TCP、UDP 涉及不同连接行为，首次排错不应凭名称一次性调整；修改前确认用途，并保留可恢复的原值。
遇到更新后异常、耗电变化或 iPad 特定表现，先记录当前网络、Global Routing、所选服务器及可复现步骤。不要把重装作为第一步；先保存必要资料并检查配置与授权，避免丢失原有排查线索。更新与系统要求以 App Store 页面标注为准，不按截图外观推断应用版本。
完成以上流程后，应能明确说出问题发生在哪里：导入没有生成条目、服务器测试未通过、系统授权未完成，或规则下的实际请求失败。带着这个结论阅读疑难解答，需要逐层检查时再进入故障排查疑难手册。日常使用前，最后确认 Home 的连接状态、当前选中服务器与 Config 文件均符合预期。
