官方手册 / 快速上手
Shadowrocket 订阅导入与规则配置
按添加、选模式、连接、验证、排错的顺序操作。首次配置先建立一条可核对的连接，再调整分流规则，不必一次改完全部设置。
截图来自 App Store 官方展示，供定位界面词使用。实际可见字段会随 Type、设备及应用界面有所不同；以当前应用显示为准，不照抄截图里的连接参数。
STEP 01 / IMPORT
Add Server：添加服务器或导入订阅
先区分手里的是订阅链接，还是单台服务器的参数。订阅链接用于获取并更新一组服务器记录；手动参数则需要逐项填写。两者不是同一种输入，不能把整条订阅地址直接填进服务器的 Host。打开 Shadowrocket，进入 Home，在 SERVER 分组找到 Add Server，或使用页面上的添加入口进入编辑页。
已有订阅链接：选择 Subscribe
在 Add Server 中点开 Type，选择 Subscribe，再将自己的完整订阅链接填入该类型对应的地址字段。可以填写便于辨认的名称，但不要把账户密码写进名称。确认粘贴内容的开头和末尾都完整，没有混入聊天说明、空格或换行，再保存并回到 Home 等待导入结果。
导入成功后，SERVER 列表应出现订阅带来的服务器记录或相应分组。请核对是否能看到预期名称；只看到订阅名称却没有服务器内容，不算完成连接准备。若应用提示获取失败，先检查地址是否仍有效、当前网络能否请求该地址，再查订阅返回内容是否适用于 Shadowrocket。不要连续重复添加同一条订阅，这会使后续选中项更难辨认。
已有服务器参数：按 Type 逐项填写
手动添加时，先按自己持有的信息选择 Type，再填写 Host、Port 以及该类型要求的认证字段。例如 Password、Method 是否出现，取决于所选类型；不要为了让编辑页看起来像截图而改变协议。Host 通常填写服务器域名或 IP 地址，不应额外加入网页路径；端口也必须与服务器端配置一致。
如果手中是用于导入的二维码，可在 Add Server 页使用 Scan QR Code，识别后仍需核对字段。Import from Cloud JSON 是另一种导入入口，只在已有与该入口相适应的内容时使用，不等同于 Subscribe。导入动作能减少手工输入，但不能证明远端服务器当前可用。
保存后回到 SERVER，点选准备测试的那一项，确认选中标记落在预期记录上。若列表里有同名项，先核对它们所属分组和服务器信息，再继续下一步。订阅链接可能包含访问凭据，排错时不要公开完整地址或二维码。需要进一步理解订阅与配置文件的区别，可阅读使用手册。
STEP 02 / ROUTING
Global Routing：选择配置、代理或直连
有服务器不代表已确定所有请求的去向。回到 Home，点击 Global Routing 查看当前模式。三个常用姿态是配置(Config)、代理(Proxy)、直连(Direct)。它们决定请求如何选择路径，而服务器列表中的选中项决定需要代理时使用哪条连接；这两处要分别核对。
配置(Config)：按当前配置处理请求
选择配置(Config)后，请求按当前配置中的规则与策略处理。使用前先进入 Config，确认已经选中准备使用的配置文件，而不只是把文件导入列表。官方截图展示的是配置编辑页，可以看到 General、Rule、Hosts 等分段；日常上手不必逐段修改，更不需要为普通连接开启 HTTPS Decryption。
订阅通常负责服务器列表，配置文件负责规则等设置，所以订阅导入成功并不意味着已经应用了某份分流规则。在 Rule 中查看规则时，要同时看匹配条件、顺序及目标策略。以下只是说明规则阅读顺序的示例，不是要求粘贴的完整配置；实际配置中的策略名称必须确实存在。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY示例先判断域名后缀，再判断 GEOIP 条件，前面没有匹配时才落到 FINAL。其中 example.com 仅用于解释语法，不是服务器地址，也不应被当成连接信息。暂时读不懂规则时，保留原配置，先用下面的模式做对照，不要在首次测试中同时增删多条规则。
代理(Proxy)与直连(Direct)：用于明确对照
代理(Proxy)用于让通常的请求按代理路径处理，可帮助判断问题是否来自规则分流；它不是速度保证，具体行为仍受相关设置和网络条件影响。直连(Direct)则用于走本地网络路径，不通过选中的远端代理服务器，适合检查基础网络是否正常。选择 Direct 后目标可以打开，并不能证明代理服务器正常。
初次排查可先选代理(Proxy)，验证已选服务器能否承担访问，再切回配置(Config)检查日常分流。每次切换后回到 Home 核对 Global Routing 显示值；测试结束应恢复自己需要的模式。关于规则顺序与策略引用的详细解释，放在使用手册中，本页先完成一条连接。
STEP 03 / CONNECT
Home：打开开关并完成连接授权
先确认服务器和模式，再打开顶部开关。回到 Home，在 SERVER 中确认当前选中项，再检查 Global Routing。顶部的 Not Connected 表示当前没有建立应用连接，并不表示服务器记录一定有误；添加信息与实际启动是两个独立动作。
打开顶部连接开关。首次启动连接时，系统可能要求允许添加 VPN 配置。阅读系统弹窗，确认这是由当前操作触发的请求后再允许；如果系统要求设备身份验证，按设备提示完成。此授权用于让 Shadowrocket 在系统层面处理相应网络流量，不会替你补齐服务器参数，也不等于远端认证已经成功。
完成授权后返回应用，观察开关与连接状态是否保持。若此前拒绝了授权，再次启动时按应用和系统提示处理，不要为了重试而先删除全部订阅。若设备由组织管理，或相关权限受到限制，应先核对设备管理要求，不能仅靠反复切换模式解决。
连接开关保持开启后，先暂缓修改其他设置，进入下一步验证。系统连接标识只能说明相应网络配置正在运行，不能单独证明每个网站都按预期路径访问。若开关随即关闭、授权没有完成或出现错误提示，记下提示原文以及发生在哪个动作之后，再前往第五步分类检查。
为了使首次测试结果容易判断，建议先保持一种本地网络环境，不要在打开开关的同时切换 Wi-Fi 与蜂窝网络。也不要同时改服务器、模式和配置文件；一旦成功，便可以明确是哪组设置可用。之后再恢复日常使用所需的配置(Config)模式，并重复一次验证。
STEP 04 / VERIFY
Connectivity Test：验证测试结果与实际访问
有效验证需要同时看测试、实际访问和当前模式。先在 Home 使用 Connectivity Test，观察准备使用的服务器是否返回测试结果。测试数字描述的是当前测试方法下的一次结果，不是下载速度，也不保证所有目标都能访问。显示超时同样需要结合测试方法与实际连接判断，不能只凭一个数字决定修改全部参数。
随后打开浏览器或目标应用，访问一个自己预期通过当前配置处理的页面，并等待一次完整加载。尽量使用新页面或刷新请求，避免只看已缓存内容。记录当前选中服务器、Global Routing 模式、所用网络和实际现象：是完全无法加载、部分内容失败，还是能打开但速度不理想。这些区别决定下一步应检查规则、服务器还是本地网络。
再回到 Shadowrocket 查看 Data 中可用的流量或活动记录。数据变化可以辅助确认应用正在处理请求，但总量增加并不等于某一目标命中了指定策略。若当前界面提供相应请求详情，应结合目标、规则与策略信息核对；不要仅以状态栏标识或一个外部地址显示结果作为唯一依据。
如果代理(Proxy)下访问正常，而配置(Config)下同一目标失败，先把注意力放在当前配置文件、规则顺序、目标策略及相关解析设置上，而不是立即重建服务器。相反，如果两种模式都失败，可以保持参数不动，先关闭连接检查本地网络，再换用自己已有的另一条服务器记录做对照。
若只是速度慢，先区分首次加载、持续传输与偶发中断，不要把这些现象都归为延迟问题。更多按现象分类的检查路径见疑难解答；这里继续处理首次使用最容易遇到的失败环节。
STEP 05 / CHECK
Settings：按失败环节检查，不同时改多项
先定位失败发生在哪一步，再选对应设置。Settings 中的选项不是首次连接必须全部调整的清单。截图中的 Test Method、On Demand、Diagnostics 各有不同用途，不能用切换一个开关来代替所有排查。开始前记下当前服务器、模式和错误原文，保留一份能回到原状的记录。
订阅没有内容：先查导入环节
如果 SERVER 没有预期记录，先回到订阅条目核对完整地址及其有效状态。检查当前本地网络能否完成获取，再确认返回内容格式是否适配。即使以前成功过，链接的访问权限或内容仍可能变化；这些情况需要向自己已有服务的提供方核实。不要把没有服务器内容的问题当成 Global Routing 选择错误。
列表有记录但不能连接：核对参数与授权
打开选中记录的编辑页，逐项对照 Type、Host、Port 与认证信息，特别留意复制时混入的空格、遗漏字符，以及与服务器要求不一致的传输选项。只修改已确认有误的字段，保存后重新选择该项并测试。若顶部开关无法保持开启，则先核对系统授权与应用提示，不急于调整规则。
测试超时或结果不一致：查看 Test Method
在 Settings 查看 Test Method，了解当前结果是由哪种测试方式产生，再用一致的方法比较自己已有的服务器。部分测试失败而实际访问成功时，应先解释测试条件，不把测试数字直接当成整条连接的结论。如果实际访问同样失败，可在保留应用设置的情况下分别验证 Wi-Fi 与蜂窝网络，每次只切换一种条件。
连接会自动变化：检查 On Demand
若手动关闭后连接又启动，或网络切换时连接状态变化，检查是否已启用 On Demand 及相应条件。它用于按条件管理连接，不会修复错误的服务器密码或失效订阅。为建立清晰的手动测试基线，可以先记录现有条件，再暂时关闭相关自动行为；测试结束后按自己的使用需求恢复。
仅部分目标失败：回到 Config 核对规则
当大多数访问正常而特定目标失败，优先比较代理(Proxy)与配置(Config)的结果，并检查当前启用的配置文件。不要为了测试单个目标就改掉所有解析与传输设置，也不要随意开启 HTTPS Decryption。需要进一步记录时可查看 Diagnostics 中提供的诊断功能；分享任何记录前，遮盖订阅地址、密码、认证字段及个人请求信息。
如果仍未定位，整理“在哪一步失败、错误原文、模式、网络环境、已做过的一项对照测试”即可继续查找，不需要公开完整配置。按现象进入疑难解答；涉及 Config、Data 或日常维护的系统性说明，阅读完整使用手册。成功后回到常用模式，再重复第四步验证，形成可复用的检查顺序。
