配置阅读路径
先确定 Global Routing 的工作方式，再检查 Config 中的规则。处于 Config 时，请求按规则排列顺序检查，首条命中决定使用的策略；PROXY、DIRECT 与 REJECT 表示不同处理结果，并不是三种协议。下方示例用于解释语法，不是可直接套用到所有网络的配置。
服务器协议、认证信息和传输参数需要相互对应。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 与 WireGuard 的字段要求并不相同，添加时应按已有信息选择 Type，而不是通过轮换协议猜测连接方式。订阅从你的服务商处获取，导入成功后仍需完成连接验证。
在 Home 打开 Global Routing，按目的选择 Config、Proxy 或 Direct。Config 依据当前配置的规则分流；Proxy 以代理方式处理流量，适合核对所选服务器是否可用；Direct 直接连接目标，不用于验证代理服务器。日常需要规则分流时，应确认选中 Config，并检查当前启用的配置文件。切换后重新发起请求，再结合 Logs 判断实际走向；原有长连接可能继续保持此前路径，不能只根据页面是否已打开判断切换结果。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECTOn Demand 用于按系统条件触发连接，不等同于 Global Routing，也不会替代配置文件中的规则。先在 Settings 查看相关选项，再根据当前网络使用需求设置。首次使用应先完成手动连接和访问验证，避免把服务器参数错误误判为自动连接失效。启用后，主动断开与系统再次触发连接可能表现不同，排查时可以暂时关闭该功能，记录手动连接结果，再恢复原设置。具体可选条件及授权状态以设备上显示的界面为准。
# On Demand：决定何时建立连接
# Global Routing：决定流量处理方式
# Config 中的 Rule：决定请求策略
[Rule]
DOMAIN,api.example.org,DIRECT
FINAL,PROXY订阅从你的服务商处获取。使用 Subscribe 导入前，确认复制了完整地址，并保留原有查询参数；地址中的认证信息属于敏感资料，不应放进公开截图。导入后先核对列表是否出现预期条目，再选择一项进行连接测试。订阅更新负责刷新来源中的服务器信息，不代表当前 Config 的规则会同时改变。遇到更新失败时，分别核对地址有效性、当前网络是否能访问来源，以及服务商提供的内容是否适用于客户端，不要连续重复添加同一份订阅。
# Subscribe 管理服务器信息来源
# Rule 决定请求使用哪种策略
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECTConfig 用于查看与管理配置文件。阅读时先分清 General、Rule、Host 与 URL Rewrite 的职责，不要把规则写进服务器认证字段。修改前保留可用副本，每次只调整一类内容，保存后确认当前选中的仍是目标配置。需要换机时，可结合配置导出与 iCloud 同步准备恢复，但应逐项核对服务器、规则和本地设置是否齐全，不能把同步理解为所有状态都已恢复。示例仅展示结构，实际使用前还需按已有网络环境填写有效参数。
[General]
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
[Host]
example.org = 192.0.2.10Rule 按书写顺序检查请求，命中后使用该行策略，不再继续寻找更靠后的相似规则。DOMAIN 对应完整域名，DOMAIN-SUFFIX 适合覆盖域名及其子域名，IP-CIDR 用于地址范围，FINAL 处理此前都未命中的请求。较具体的例外通常放在范围更大的规则之前。排查时先找到实际命中的规则，再判断策略是否符合预期；只看配置里存在某一行，不能证明请求一定会走到这一行。修改后重新请求目标，并核对日志中的匹配结果。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXYHost 用于记录域名与地址的对应关系，适合在明确掌握目标地址时设置映射。它处理的是名称解析，不是选择代理策略，因此不能用一条映射替代 Rule 中的 DIRECT 或 PROXY。修改前核对地址是否仍然有效，尤其注意网络切换后原有内网地址可能不可达。遇到某个域名异常时，应同时检查 Host 映射、DNS 结果与命中规则，逐项排除。这里的保留地址仅用于文档示例，不应当作真实服务地址使用，也不应覆盖尚未确认的域名。
[Host]
example.org = 192.0.2.10
[Rule]
DOMAIN,example.org,DIRECT
FINAL,PROXYURL Rewrite 根据表达式匹配请求地址并执行对应处理，作用与规则分流不同。编写时先确认协议、域名与路径范围，再决定重定向目标和状态码。表达式过宽可能影响同一域名下原本正常的请求，因此应从单个测试路径开始，保留回退副本。涉及加密请求时还需考虑请求是否可见以及相关安全设置，不能仅凭写入一行就认定会生效。下面使用示例域名说明重定向格式，验证时应选用自己有权管理的测试目标。
[URL Rewrite]
^http://example\.com/ https://example.com/ 302Proxy Group 把策略选择组织为可引用的分组，让 Rule 只负责判断请求所属范围。使用前确认分组名称与规则中的引用完全一致，并且组内存在可用选项。手动选择类分组适合明确指定出口，其他分组类型则应按实际需求核对行为与检测条件，不应混淆为协议种类。出现匹配正常却连接失败时，要继续检查分组当前选择的服务器。下方为手动分组语法示例，其中引用的 PROXY 仍依赖已有服务器配置，不会自动产生连接服务。
[Proxy Group]
Reading = select,PROXY,DIRECT
[Rule]
DOMAIN-SUFFIX,example.com,Reading
FINAL,DIRECTScan QR Code 用于读取已有配置的二维码，识别结果仍需要检查。扫码前确认内容来自自己的配置资料；读取后核对 Type、Host、Port 与认证字段，再保存并测试。相机访问由系统权限管理，无法扫描时先检查授权与二维码清晰度，不要直接修改协议参数。二维码可能包含完整连接凭据，应与订阅地址同样保管，避免公开传播。成功添加仅表示客户端已读取信息，不表示目标服务器可达；后续仍需选择服务器、开启连接并验证实际请求。
# 导入后核对服务器字段
# 再使用明确的规则验证请求路径
[Rule]
DOMAIN,example.com,PROXY
FINAL,DIRECTLogs 适合核对请求目标、匹配规则与连接结果，Data 则帮助观察一段时间内的流量使用情况，两者用途不同。诊断时先记录发生问题的时间，再只发起一次目标请求，沿着域名解析、规则命中、策略选择与连接结果检查。Connectivity Test 可作为连通性线索，但不能代替具体应用的访问验证。准备分享诊断资料时，应遮盖订阅地址、认证字段和私人访问记录，只保留与问题相关的片段。一次测试结果只能反映当时条件，不宜据此推断长期状态。
# 对照 Logs 中的目标与命中策略
[Rule]
DOMAIN,api.example.org,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT需要逐行解释？阅读规则与配置字段参考 →。首次导入已有信息，可先按入门指南完成一轮连接与验证，再调整规则。
设备与获取
Shadowrocket 只通过 App Store 获取。购买前查看产品名称、开发者和应用 ID，系统要求与购买适用范围以 App Store 页面标注为准。已购买的用户应先查看自己的已购项目，再判断是否需要重新操作购买；商店当前登录的购买账户与设备同步配置所用账户也应分别核对。
核对商店信息后购买安装，添加已有服务器或订阅，再按系统提示允许添加 VPN 配置。先完成手动连接，确认目标请求正常后，再设置 On Demand。
查看 iPhone 获取说明 →使用购买时的同一 Apple ID 查看已购项目，按商店显示获取应用。安装后仍需核对本机服务器、当前 Config 与系统授权，不能只凭另一台设备连接正常判断。
查看 iPad 获取说明 →Mac / Apple TV 也可在同一 App Store 获取，兼容性、系统要求与购买适用范围以 App Store 页面标注为准。
购买确认发生在 App Store；添加 VPN 配置发生在设备系统中，二者服务于不同步骤。安装完成不代表已经建立连接，允许系统配置也不代表服务器信息一定正确。首次打开后，应先检查已有配置是否齐全，再选择服务器并开启连接。若系统弹出配置授权提示，应在理解用途后确认，并按设备提示完成验证；如果暂时取消，可回到客户端重新发起相关操作。
两台设备之间也要分别验证。相同的订阅可以提供一致的服务器信息，但当前网络、Config 选择与本地权限可能不同。建议先在一台设备完成最小可用配置，记录所用协议和模式，再在另一台设备逐项检查。切换 Wi-Fi 与蜂窝网络后如出现差异，应保留相同测试目标，只改变网络条件，便于判断问题来自网络可达性还是本机设置。
第一次使用可从入门指南开始：准备已有订阅或服务器信息，选择对应的导入方式，检查 Global Routing，开启连接，最后通过具体请求与 Logs 验证。已有配置但个别目标走向不符时，再进入配置字段参考，核对规则顺序、策略和域名映射。把安装、连接与分流拆开检查，可以避免同时改动多个设置后失去判断依据，也便于保留一份可恢复的配置。
正版与购买事实
Shadowrocket中文文档是 Shadowrocket 的官网与官方手册。产品为闭源商业应用，购买、安装和应用更新通过 App Store 管理；本手册说明客户端操作，不提供、不销售、不推荐节点或订阅。购买前应先核对商品信息，连接前应确认自己已持有有效配置。
在 App Store 搜索 Shadowrocket 后，先进入产品详情页，不要只依据搜索列表中的名称判断。查看开发者是否为 Shadow Launch Technology Limited，再与本站使用的官方图标对照，最后确认产品页地址中的应用 ID 为 932747118。名称相似不代表商品相同，核对信息应以详情页为准。本站提供的获取说明与商店链接都围绕这一产品页展开。
图标是辨认线索之一，但不能代替其他两项核对。若搜索结果与预期不同，可从正版下载页进入指定产品页，再检查当前店面所显示的购买信息。阅读评价或功能介绍之前，先确认自己打开的是正确商品；准备购买时，再核对显示的金额与系统兼容性。涉及商店信息变动的内容，以 App Store 页面标注为准，不能根据旧截图推定当前状态。
同一产品在不同店面的可见性与货币显示可能不同。搜索未出现时，应先确认拼写，并检查当前 App Store 账户所在店面及产品页提示。页面无法购买、设备不满足兼容性要求、付款未完成，分别对应不同处理步骤；不要把它们都归为应用安装失败。价格、系统要求与购买适用范围均以 App Store 页面标注为准，手册不替代商店的最终确认信息。
需要区分设备登录状态与商店购买状态。查看历史购买时，应确认当前使用的是当初完成购买的账户，并检查交易是否确已完成。如果页面显示重新获取入口，可按系统提示继续；如果仍显示价格，应先检查购买记录与账户信息，避免把账户差异误判为购买失效。保留商店中的交易记录有助于核对，公开提问时则不应附带账户、账单或支付资料。
客户端买断 ≠ 线路套餐。美区标价参考为 2.99 美元，各店面按当地货币显示，最终金额以 App Store 页面标注为准。一次性买断对应客户端的购买，不会自动向 Home 添加可用服务器，也不会生成订阅地址。已有订阅从你的服务商处获取；已有服务器则按其协议、地址、端口和认证资料填写。导入前应确认资料完整，导入后仍要验证连接。
订阅更新失败与应用购买是否成功是两件事。购买记录由 App Store 管理，订阅内容及其有效性由你的服务商提供。排查时先确认发生问题的环节：不能获取应用，检查商店；列表没有预期条目，检查导入；已经有条目但无法连接，检查服务器参数与网络；只有部分请求异常，再看规则和解析。按环节定位，比反复重装更容易保留证据，也减少配置丢失的风险。
同一 Apple ID 的已购项目可用于查找已购买的 Shadowrocket，iPhone 与 iPad 的购买适用范围以 App Store 页面标注为准。换机或重新安装时，先恢复应用，再处理服务器与配置文件。家人共享是否适用也应查看商店页说明和账户设置，不应把一个设备上已安装应用理解为另一台设备已具备相同购买状态。恢复过程中遇到商店提示，应先完成对应的账户核对。
配置方面，可提前检查 iCloud 同步是否开启，并准备必要的配置导出副本。同步与导出的作用范围需要分别确认，尤其要核对当前 Config、手动修改的规则以及服务器信息是否完整。恢复后先查看列表，再检查所选服务器、Global Routing 和系统授权；完成一次实际请求验证后，再启用自动连接条件。备份可能包含认证资料，应放在自己可控的位置，分享排查材料前先去除敏感内容。
应用更新通过 App Store 管理，可按设备的商店设置使用自动更新或手动检查。界面与选项以实际安装的应用显示为准。更新前保留重要配置，更新后先检查现有连接和常用目标，不必仅因界面位置变化就重建全部配置。订阅刷新、Config 编辑与应用更新属于不同变更，应分别记录，便于在出现问题时回顾最近改动，而不是同时替换所有内容。
日常维护可以保留一份已验证可用的配置副本。需要调整分流时，先写明目标域名和预期策略，再修改对应规则，保存后重新发起请求。若结果与预期不同，先查看首条命中位置，确认是否被更早的宽范围规则覆盖，再检查策略所引用的服务器或分组。验证通过后再继续下一个修改；验证失败则回退本次改动。这个顺序同样适用于 Host 映射和 URL Rewrite 的小范围测试。
专题阅读
以下三篇文章分别对应购买前辨认、首次连接和换机恢复。可按当前任务选择，不必一次修改所有设置。文章中的操作以已有配置为前提，涉及价格、兼容性与购买范围时，仍需回到 App Store 产品页确认。
从搜索结果进入商品详情，逐项确认 Shadow Launch Technology Limited、官方图标与应用 ID 932747118。说明名称相似时应先查看哪些信息，以及购买确认前需要核对的商店事实。
阅读核对说明 →按首次使用顺序解释 Subscribe 导入、VPN 配置授权、服务器选择与连接开关。区分“已经添加”“已经连接”和“请求验证正常”，并说明何时再设置 On Demand，便于逐步检查。
阅读入门问答 →分别检查应用购买恢复与配置迁移，梳理 iCloud 同步、导出副本和恢复后验证的顺序。换机后先核对列表、当前 Config 与授权状态，再恢复日常使用中的自动连接设置。
阅读迁移步骤 →