Shadowrocket 自定义规则写法与优先级：从上到下匹配与 FINAL 兜底
从 DOMAIN-SUFFIX、IP-CIDR 的条件写法开始，核对规则顺序，再区分 PROXY、DIRECT、REJECT 的用途。适合排查请求为何没有采用预期策略，以及 FINAL 放在哪里才便于理解和维护。
阅读规则说明 →
官方手册
App Store 正版核对
Shadowrocket 使用说明
面向 iPhone / iPad 的 Shadowrocket 官方手册。从 App Store 核对一次性买断的客户端，再导入已有信息，按规则分流检查连接。
Shadowsocks
Trojan
Hysteria2
Global Routing
设备与商店入口
先核对设备，再查看购买入口
Shadowrocket 只在 Apple 平台发行，唯一获取入口是 App Store。先确认设备兼容性、当前商店账户与应用身份，再进行购买和首次配置。
iPhone
从 App Store 查看 Shadowrocket，核对开发者与应用 ID 后购买。首次打开先熟悉 Home、Global Routing 和 Add Server；连接前准备好自己的订阅或服务器信息，系统要求以 App Store 页面标注为准。
查看 iPhone 获取说明 →iPad
已在同一 Apple ID 下购买时，先到 App Store 的已购项目查找。iPhone 与 iPad 的通用购买条件、兼容设备和系统要求以 App Store 页面标注为准；应用恢复后，还需单独检查配置与连接信息。
查看 iPad 获取说明 →搜索结果与商店页面要分开核对
应用名称相近，并不等于应用身份相同。进入产品详情页后，应同时检查官方图标、开发者 Shadow Launch Technology Limited，以及链接中的应用 ID 932747118。下面的商店按钮直接打开这一产品页；打开页面不代表已经完成购买，付款前仍需阅读当前店面显示的价格和兼容性。
如果搜索不到，先查看 App Store 当前用于购买的账户及其国家或地区，不要只根据设备语言判断商店归属。产品链接中的店面路径也不等于当前账户的购买地区。应用是否可见、能否购买及付款提示，应以当前账户实际显示的商店页面为准。
首次连接时出现的 VPN 配置授权，是系统为客户端建立网络连接配置的确认步骤。应在确认当前操作来自 Shadowrocket 后阅读并处理系统提示。完成授权只表示系统允许建立配置，不表示服务器参数、订阅状态或规则已经正确；后续仍需按教程进行检查。
配置与连接
按任务理解核心能力
先区分连接信息、Global Routing 与配置文件。服务器决定连接目标，路由姿态决定处理方式，规则决定具体请求采用的策略。
Rule：按顺序匹配请求
规则分流用于为不同请求选择处理策略。在 Home 将 Global Routing 设为 Config 后，再到 Config 核对正在使用的配置。规则通常从上到下匹配，条件命中后采用对应策略；具体条件宜放在宽泛条件前，FINAL 放在末尾作为兜底。PROXY、DIRECT 与 REJECT 是策略关键字，不是服务器地址。修改前先保留副本，每次只改一处，再检查实际请求命中的规则。下面使用 example.com 的片段只说明语法，不是完整可用配置。
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECTOn Demand：按条件建立连接
On Demand 用于在指定网络条件下触发连接，不用于替代服务器配置。先在 Settings 找到 On Demand，明确哪些 Wi-Fi、蜂窝网络或域名条件需要触发，再逐项检查条件是否重叠。首次设置宜只启用一个明确条件，切换网络后观察连接状态，确认符合预期再增加其他条件。手动关闭连接后若又自动连接，应先检查 On Demand，而不是立即删除配置。自动连接与 Rule 分流处于不同环节：前者决定何时连接，后者决定连接后如何处理请求。
Settings → On Demand
Wi-Fi / Cellular / Domain
连接触发条件 ≠ Rule 匹配条件多协议：先匹配 Type，再填参数
Shadowrocket 支持 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议。使用用户已有服务器信息时，先在 Add Server 确认 Type，再按对应类型填写 Host、Port 及认证参数。不同协议的字段并不通用，TLS、传输方式和证书相关选项也应与服务端一致。不要通过反复更换 Type 猜测协议；应对照已有配置信息逐项核对。某个条目能够保存，只代表输入已被接受，不代表远端连接成功，仍需结合测试和实际访问验证。
Add Server
Type → Host → Port
Trojan / Hysteria2 / WireGuardSubscribe：导入已有订阅信息
Subscribe 适合维护用户自己已有的订阅条目。导入前应确认地址完整，保留链接中的必要参数，避免复制时混入空格、换行或说明文字。导入后先检查是否生成预期的服务器条目，再选择其中一个进行连接测试。订阅更新负责刷新远端列表，不会自动修复远端失效、认证错误或所有本地规则问题。删除或覆盖前应确认哪些条目来自订阅、哪些是手动添加。订阅地址可能包含访问凭据，排查时不要把完整地址放入截图或公开记录。
Add Server → Type → Subscribe
导入已有地址 → 更新条目 → 选择服务器
订阅列表 ≠ 规则配置文件Config：核对正在生效的配置
配置文件用于组织 General、Rule、Hosts 等设置，服务器列表与配置文件应分开理解。在 Config 导入或编辑后，还要确认当前选用的是哪一份配置，并检查 Global Routing 是否为 Config。仅把文件保存在列表中，不等于其中规则已经参与处理。修改 DNS 或规则前保留可恢复的副本，记录修改项与预期结果。需要使用 iCloud 同步时，应分别检查系统的 iCloud 设置、应用内相关选项与另一台设备的实际内容，不要将同步视为完整备份或连接成功的证明。
[General]
bypass-system = true
dns-server = system
[Rule]
FINAL,DIRECT诊断工具：先定位，再修改
连接失败时，先确认设备本身能够正常联网，再查看所选服务器、Connectivity Test 和当前测试方式。测试结果只反映相应方法下的可达性，不能单独代表所有请求的访问结果。继续核对协议参数、TLS 设置、系统时间与 Global Routing，必要时查看 Settings 中的 Diagnostics。Data 的流量统计适合观察使用情况，不等于服务端计费记录，也不能单凭流量变化判断规则正确。每次只调整一个变量，并保留失败现象与测试条件，方便比较前后差异。
Connectivity Test
Settings → Diagnostics
网络 → 参数 → Global Routing → 实际请求Global Routing：先确认当前姿态
Config 按当前配置中的规则处理请求；Proxy 用于让请求走代理处理；Direct 用于直接连接。日常需要规则分流时，应先检查 Config 和正在使用的配置文件。临时切换姿态可以帮助缩小排查范围，但切换后的结果必须与原来的测试条件对照，不能把一次访问成功理解为所有规则都已正确。
开始检查前，记录当前服务器、路由姿态与配置名称。若 Proxy 下能够访问，而 Config 下出现差异，应优先核对规则命中、策略指向与 DNS 相关设置；若连接本身就失败，则先核对服务器参数和基础网络。排查结束后恢复原定姿态，避免临时设置继续影响后续使用。
对照 Config、Proxy、Direct 的用途 →
正版与购买事实
核对应用身份，区分购买内容
Shadowrocket 是闭源商业应用。应用身份、价格、兼容性与购买条件以 App Store 产品页为核对依据，操作入口以当前应用内显示为准。
正版核验三要素
官方图标、开发者名称和应用 ID 应同时对应。不要只看搜索结果中的名称，也不要仅凭图标颜色作判断；打开详情页后再核对开发者，最后检查产品链接中的数字 ID。
开发者 Shadow Launch Technology Limited
应用 ID 932747118
获取渠道 App Store
商店可见性：先查当前购买账户
App Store 的搜索结果与应用可见性可能随账户所属国家或地区不同而变化。设备显示中文，不等于购买账户属于某个特定店面；浏览器打开的产品页面，也不一定与设备当前用于购买的账户店面相同。遇到搜不到或页面提示不可用时，应先阅读商店提示，核对当前购买账户和国家或地区，再查看正版指南中的对应章节。
不要将搜索不到直接判断为应用已无法使用，也不要将浏览器能看到页面等同于设备可以购买。应分别确认详情页是否可见、购买按钮是否可用、设备是否符合兼容性要求。若页面显示的身份信息与本页三要素不同，应停止当前购买步骤，回到正确产品页重新核对。
一次性买断：购买的是客户端
美区参考价格为 2.99 美元，一次性付费；其他店面按当地货币显示，实际价格与购买条件以 App Store 页面为准。购买记录归属于完成付款的 Apple ID，后续换机时应先核对这一账户。不要把参考价格当作所有地区的固定价格，也不要仅根据另一台设备上的显示推断当前账户的购买状态。
已有订阅的有效期、服务器认证和服务端状态，需要与应用购买分开检查。应用能够正常打开，不代表远端服务仍然有效；远端条目连接失败，也不意味着需要重新购买客户端。先判断问题属于商店购买、应用配置还是远端连接，再进入相应排查步骤，可以避免在无关位置反复修改。
换机与恢复：应用和配置分别确认
更换设备或重新安装后，先登录原购买账户，在 App Store 的已购项目中查找 Shadowrocket。若出现价格按钮而非预期的重新获取入口，先检查用于媒体与购买项目的账户是否正确，不要直接再次付款。购买记录、地区可用性和设备兼容性都可能影响页面显示，具体以系统提示和商店记录为准。
重新获取应用与恢复配置是两件事。应用恢复后，逐项确认服务器列表、所选配置、Global Routing 和 On Demand；若使用 iCloud 相关功能，也要核对同步内容是否实际出现。切勿因看到应用图标就认定原来的所有设置已经恢复。涉及家人共享时，应查看产品页和家庭设置中的实际适用条件，不将同一账户恢复与家庭成员使用混为一谈。
应用更新：先保留设置，再检查变化
Shadowrocket 的获取与更新均通过 App Store 进行。可在系统商店设置中检查自动更新选项，并在应用详情页查看更新记录。手册不固定展示具体版本号或更新日期；当界面入口与文字略有差异时，以当前应用内可见选项为准，先确认功能所属页面，再按相同的操作目的查找。
进行重要配置调整前，保留当前可用的配置副本，并记录所选服务器和路由姿态。更新或换机后的首次使用，宜先用已知条件完成一次连接验证，再逐步恢复自动连接和其他设置。这样即使出现差异，也能区分是导入信息、规则选择还是网络环境变化，而不是一次修改多个环节后失去比较依据。
使用前常见问题
先判断当前卡在哪个环节，再进入对应说明。下面的答案可直接展开阅读。
已经购买，为什么还不能直接连接？
购买只完成客户端获取。连接还需要用户已有的订阅或服务器信息，并正确选择服务器、Global Routing 与配置。先确认 Home 是否有可用条目，再核对参数和系统 VPN 配置授权；不要把付款完成当成连接配置完成。
导入订阅后，还需要选择 Config 吗？
订阅条目和规则配置承担不同任务。订阅通常维护服务器信息，Config 中的配置决定规则如何处理请求。若需要规则分流，应确认 Global Routing 为 Config，并检查当前选用的配置；不能仅凭订阅更新成功就判断规则已生效。
Connectivity Test 有结果，为什么实际访问仍有问题？
测试与实际请求可能使用不同的目标和处理条件。测试结果应结合测试方式理解，还要检查请求命中的规则、DNS、TLS 及所选服务器。先在相同网络条件下复现问题，一次只修改一个设置，再比较结果，避免把测试可达性当作所有请求都能成功。
手动关闭后又连接，应先检查哪里？
先查看 On Demand 是否启用，以及当前 Wi-Fi、蜂窝网络或域名条件是否仍然满足。自动连接与手动开关可能共同影响当前状态。记录触发场景，调整一个条件后重新观察，不要立即删除服务器或整个配置文件。
博客预览
规则与连接的专题说明
基础步骤完成后，可按当前问题继续阅读。先记录现象和当前设置，再使用专题中的检查顺序，不把不同问题的调整方法同时叠加。
Shadowrocket Global Routing 怎么选：Config、Proxy、Direct 三种姿态的区别
对照三种姿态如何处理流量，理解规则分流为何需要核对 Config。说明临时切换姿态的检查用途，以及排查完成后应恢复哪些设置，避免把临时测试状态当作日常配置。
阅读路由说明 →Shadowrocket 节点超时与连接失败排查顺序：延迟测试、协议参数、系统时间
先确认基础网络和测试条件，再检查协议参数、TLS 与系统时间。按固定顺序缩小范围，区分测试失败、连接失败和实际请求失败，减少在多个设置之间来回修改。
阅读排查清单 →