- 官方手册 · 上手教程
- 添加 → 模式 → 连接 → 验证
Shadowrocket 使用教程
用自己已有的订阅或服务器信息，完成首次连接。先跑通一条明确的操作路径，再调整规则与自动连接。
建议顺序阅读并逐步核对。截图为 App Store 官方素材；实际界面以设备上安装的应用为准，字段会随所选 Type 改变。
Add Server：添加服务器或导入订阅
订阅链接与单个服务器信息是两种输入方式，按手头材料选择其中一种即可。
打开 Shadowrocket，进入 Home，找到 Add Server 或添加入口。先判断已有内容属于哪一类：订阅链接用于获取一组服务器条目，单个服务器信息则需要手动填写协议与连接字段。不要把订阅链接整段粘到 Host，也不要把服务器的域名误当成订阅地址。
已有订阅链接：选择 Subscribe
进入 Add Server 后，点开 Type，选择 Subscribe，在对应的 URL 字段粘贴自己已有的完整订阅链接，并按需要填写便于辨认的备注。粘贴后检查首尾空格、换行以及链接是否被聊天工具截断。链接中的路径和参数属于同一整体，不要为了缩短地址而自行删改。
保存后返回 Home，等待内容获取完成；如需更新，使用该订阅对应的更新操作。成功的核对点是列表出现可选择的服务器条目，而不只是多出一条订阅名称。更新后仍为空时，先停在本步骤检查链接和订阅状态，不必反复打开连接开关。订阅本身的有效期、返回内容与访问权限，应向自己已有服务的信息来源核对。
已有单个服务器信息：逐项填写字段
手动添加时，先在 Type 选择与已有信息一致的协议，再填 Host、Port 及所需认证字段。例如，选择 Shadowsocks 后会看到 Password、Method 等字段；其他协议显示的字段可能不同，不能套用同一组参数。Host 通常填写主机名或 IP 地址，Port 填端口，是否需要其他参数以已有服务器说明为准。
若已有可导入的二维码，可以使用 Scan QR Code；Import from Cloud JSON 只适合与该入口格式相符的内容，不是任意链接的通用导入方式。导入后仍应打开条目检查协议、地址、端口与认证信息。保存并返回 Home 后，在 SERVER 分组选择本次要使用的条目，再进入下一步。
Global Routing：选择运行姿态
添加条目只完成了输入信息；请求如何处理，还取决于模式和当前配置。
回到 Home，点开 Global Routing。三种姿态分别是配置(Config)/代理(Proxy)/直连(Direct)。选择之前先明确这次操作的目的：按规则日常使用、核对所选服务器，还是暂时检查直连网络。不要仅因为列表里有服务器，就默认所有请求都会经过它。
配置(Config)：依当前规则处理
选择 Config 后，请求按当前配置中的规则处理。进入底部 Config 页面，确认实际启用的配置文件；需要查看规则时，打开对应文件的编辑页，找到 Rule。这里与 Home 的 Global Routing 是两个相关但不同的位置：前者管理配置内容，后者决定是否按这些内容运行。
规则通常按从上到下的顺序匹配，命中后采用对应策略。DIRECT 表示直连，PROXY 表示代理策略，REJECT 表示拒绝请求；FINAL 处理前面的规则均未命中的情况。因此，Config 下出现直连请求并不一定是故障，应先看它命中了哪条规则。首次上手不必同时编辑 General、Hosts、URL Rewrite 或 HTTPS Decryption，这些内容不是完成基础连接的必经步骤。
代理(Proxy)与直连(Direct)：用于明确路径
Proxy 使用代理路径，适合在排查时暂时减少规则带来的变量，但仍需要有效的服务器信息；切到此姿态不会修复地址、认证或服务器状态。Direct 使用直连路径，适合核对当前网络本身是否能够访问目标，不能用于证明所选代理服务器正常。
如果已有配置明确要求使用 Config，就先按其说明选择；如果需要判断问题是否来自规则，可暂时用 Proxy 做一次同目标对照，再恢复原模式。修改规则前保留原配置，本页不要求新建复杂规则。有关 DOMAIN-SUFFIX、GEOIP 与 FINAL 的进一步说明，可阅读规则分流与故障排查常见问题。
Home：打开开关并完成 VPN 授权
先确认服务器与 Global Routing，再操作顶部开关。
返回 Home，确认 SERVER 下已选中本次要使用的服务器，再检查 Global Routing 显示的是预期姿态。若上一步只是导入了内容，却没有选择条目，应先完成选择；若订阅列表仍为空，则返回步骤一，不要把顶部开关当作订阅更新入口。
打开页面顶部的连接开关。首次连接时，系统可能弹出添加 VPN 配置的授权提示，这是应用建立系统网络连接所需的权限步骤。确认提示来自当前操作后，按系统要求允许并完成设备认证，再回到 Shadowrocket。不要把这个系统提示与服务器的 Password 混淆：设备认证和服务器认证属于两个不同环节。
回到 Home 后，观察顶部是否仍为 Not Connected，以及连接开关和状态是否保持在已连接状态。如果刚打开便回落，先记录应用或系统显示的具体提示，再检查 VPN 配置授权与已有参数。反复快速切换开关会让问题发生顺序难以判断，建议完成一次操作、等状态稳定后再继续。
iPad 的页面空间与系统提示布局可能与截图不同，操作顺序仍然是选择条目、确认模式、打开连接、完成授权。系统显示 VPN 状态只能说明相关连接已建立，不能单独证明远端服务器可用，也不能说明每一个应用请求都经过代理。保持当前设置不变，接着做下一步验证。
Connectivity Test：测试后再验证使用场景
把连接状态、测试结果与实际访问分开检查，才能判断卡在哪一层。
在 Home 找到 Connectivity Test 并执行测试，先看是否能得到测试结果。测试失败是继续检查的线索，不等于所有请求必然失败；测试成功也只说明当前测试条件下有响应，不能代替实际使用验证。测试所用的方法或目标与日常应用可能不同，因此不要只凭某一次结果决定是否重建全部配置。
接着打开自己需要使用的应用或页面，发起一次新的请求，例如重新加载页面或重新执行刚才失败的操作。仅看已经缓存好的内容，无法确认这次网络请求是否成功。若问题只出现在某一个目标，记录具体操作与时间；若所有目标都失败，再回头检查整体连接与服务器信息。
使用 Config 时，还要结合当前配置判断请求应当走哪条路径。若应用内可用的请求记录显示命中了 DIRECT，先确认这是否正是规则要求；若命中了 REJECT，则应检查是否存在误拦。需要对照时，暂时切到 Proxy，重新发起同一个请求，再恢复原模式。Config 与 Proxy 的结果不同，是检查规则的依据，不是直接删除所有规则的理由。
- 状态成立：Home 显示连接已建立，开关没有自行回落。
- 测试可解释：记下 Connectivity Test 的结果，以及使用的测试方法。
- 实际请求成立：目标页面或应用能完成一次新的网络操作。
- 路径符合预期：Global Routing 与规则决定的去向和使用目的相符。
上述核对完成后，再把当前选择作为日常使用的起点。若只有部分项目成立，不要笼统记录为“连不上”，而应写成“开关回落”“测试失败但页面可用”或“Proxy 正常、Config 异常”。这些描述能直接对应下一步的排查路径，也能减少无关设置的改动。
Settings：按顺序排错，单项修改
先处理最早失败的一步；每次只改一个变量，并保留可回退的配置。
导入为空或保存后没有可选条目
回到订阅设置检查 Type 是否为 Subscribe，URL 是否完整，以及更新是否完成。如果返回的是说明网页、登录页面或错误内容，客户端不能把它当成有效服务器列表。核对已有订阅的状态后再更新，不要通过更改 Global Routing 来解决解析失败；模式只处理请求路径，不会补齐订阅内容。
开关回落或连接后不能访问
先分清系统授权与服务器通信。开关无法保持时，检查 VPN 配置是否获准、是否出现系统限制或明确错误；开关能保持但访问失败时，再核对所选条目。逐项比对 Type、Host、Port 和认证字段，特别注意复制时的空格、Method 不一致及遗漏的协议参数。不要凭经验替换加密方法或端口，字段应与自己的服务器信息一致。
测试结果与页面访问不一致
进入 Settings，查看 Test Method，确认这次测试采用的方式。不同测试方式覆盖的条件不完全相同，不宜直接横向比较结果。再回到 Home，检查 Global Routing 与当前配置；若仅 Config 异常，优先检查 Rule、FINAL 及相关解析设置。DNS 设置涉及的细节较多，建议先阅读Shadowrocket DNS 设置与连接问题说明，不要同时改动多个 DNS 选项来试错。
基础连接正常后，再考虑 On Demand
On Demand 用于按设定条件触发连接，并不能修复错误的服务器参数。首次排查时先使用手动开关，避免自动连接触发后误以为应用没有保存关闭状态。基础连接验证通过后，再进入 Settings 的 On Demand 按需要设置，并实际测试触发条件。Proxy、TCP、UDP 等设置也应在有明确需求时调整，而不是把所有选项同时开启。
仍无法定位时，可以在 Diagnostics 查看可用的诊断信息，记录失败发生在哪一步、当时的模式以及具体错误。分享记录前删除订阅链接、认证信息与其他敏感内容。更完整的购买、系统要求与已购恢复说明见App Store 安装指南；连接与规则的延伸问题见常见问题。
