Shadowrocket 使用教程：
订阅导入与连接验证
按添加、分流、连接、验证、排错的顺序操作。先完成一次可复现的连接，再调整规则和自动连接设置。
已有服务器记录可从第二步继续；已经显示连接但无法访问，可直接检查第四步和第五步。
Add Server：添加服务器或导入订阅
先区分手中的资料是一条订阅链接，还是一组服务器参数。订阅用于批量导入和后续更新服务器记录；手动添加则逐项填写单个服务器的信息。两条路径任选其一即可，不必把同一份资料重复录入。订阅地址通常包含访问凭据，应只在自己的设备和可信输入位置使用，排错时也不要公开完整地址。
手动添加：按 Type 填写对应字段
打开 Shadowrocket 的 Home，在 SERVER 区域进入 Add Server；也可以使用页面上的添加入口。进入后先点 Type，选择与已有资料一致的协议类型。接着填写 Host 和 Port，再按该类型要求填写 Password、Method 或其他认证与传输字段。官方截图中的字段只对应当时选中的 Type，不表示所有协议都使用相同参数。
Host 通常填写服务器域名或 IP 地址，Port 填写资料给出的端口。不要把带路径的订阅链接整体放进 Host，也不要将密码填入 Method。若资料包含 TLS、服务器名称或传输路径等设置，应逐项按原资料填写；不清楚的字段先核对来源，不用猜测值补齐。完成后使用页面右上角的保存操作，返回 Home 查看 SERVER 中是否出现该记录。
订阅导入：选择 Subscribe 后保存
如果持有的是自己的订阅链接，在 Add Server 的 Type 中选择 Subscribe，将完整地址填入对应的 URL 字段，并添加便于辨认的备注。粘贴后检查开头、结尾是否多了空格、换行或聊天内容；地址中的大小写、参数和符号应保持原样。保存并等待读取完成，返回 Home 检查是否出现订阅分组及其中的服务器记录。
Subscribe 地址与 Config 配置文件地址用途不同。前者主要提供服务器记录，后者承载规则及配置内容，不能仅因为两者都是链接就互换入口。若导入后列表为空，先确认资料的格式和用途，再检查订阅是否有效；不要立刻改动 Global Routing，因为分流姿态不会把错误格式转换成服务器列表。
页面底部的 Scan QR Code 用于扫描兼容的二维码，Import from Cloud JSON 用于对应的云端 JSON 导入流程，并非任意订阅的通用入口。使用前确认手中资料确实匹配该方式。导入完成后，在 Home 的 SERVER 中点选本次要使用的记录，检查选中标记，再进入下一步。
本步完成标准：SERVER 中有可辨认的记录，所需字段已保存，且已选中一项。协议字段含义可继续查阅术语手册。
Global Routing：选择配置、代理或直连
服务器记录决定“通过哪个连接出口”，Global Routing 决定“流量采用哪种处理方式”。完成导入后，回到 Home，点开 Global Routing，按使用目的选择配置(Config)、代理(Proxy)或直连(Direct)。更改姿态不会替代服务器资料，也不能修复已经失效的认证信息。
配置(Config)：按当前规则处理
配置(Config)适用于需要规则分流的日常使用。选择后，到 Config 确认实际启用的配置文件，打开查看 Rule 内容。仅在编辑页看到某份文件，不一定表示它已成为当前配置；保存修改后，还需核对列表里的当前选择状态。服务器订阅导入成功，也不意味着已经同步取得适合自己需求的规则文件。
规则自上而下检查，首条命中即采用对应策略。因此，范围更明确的条件通常应放在宽泛条件前面，FINAL 放在末尾处理其余请求。下面仅演示“指定域名走 PROXY，其余走 DIRECT”的逻辑，不是必须导入的完整配置。域名为教学示例，实际使用应按自己的目标调整，并先保留原配置。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT上述示例会让 example.com 及其子域名匹配 PROXY，其他未命中的流量由 FINAL,DIRECT 处理。PROXY、DIRECT、REJECT 是策略关键字，不是需要自行填写的服务器名称。排查时应同时核对规则顺序、当前文件和当前姿态，不能只确认某一行“存在”就认定它一定生效。
代理(Proxy)与直连(Direct)：用于明确目的的对照
代理(Proxy)将一般流量交由所选代理处理，适合临时判断问题是否与规则选择有关；它不保证服务器一定可用。直连(Direct)让一般流量直接连接目标，可作为基础网络的对照，但不能用来证明所选服务器连通。两者的实际处理仍需留意应用设置中的例外行为。
首次操作不必同时修改 General、Hosts、URL Rewrite 或 HTTPS Decryption。先确认当前配置的基本分流符合预期，再继续连接。测试中如果临时改成代理(Proxy)或直连(Direct)，记录原来的姿态，完成对照后恢复，避免下一次使用时误以为规则失效。规则关键字的详细范围见术语手册，系统化排查见故障排查。
本步完成标准：知道当前 Global Routing 的选择；使用配置(Config)时，能确认当前文件及其兜底策略。
Home：打开 Not Connected 对应开关
完成服务器选择和 Global Routing 设置后，返回 Home。先检查 SERVER 中选中的记录是否就是本次准备使用的一项，再看 Global Routing 显示的姿态。此时顶部可能仍为 Not Connected，这表示连接尚未启动，并不说明导入失败。
首次连接时允许添加 VPN 配置
打开顶部连接开关。首次使用时，系统会询问是否允许添加 VPN 配置；确认正在操作的是 Shadowrocket 后允许，并按系统要求完成设备密码或生物识别验证。这项授权用于让系统建立本地 VPN 通道，将需要处理的流量交给应用；它不是服务器账号，也不会替你补充缺失的订阅或认证信息。
若此前取消了授权，返回应用再次尝试连接，按实际出现的系统提示处理。设备受管理或存在系统限制时，是否允许添加配置取决于设备管理策略，应先确认设备允许此操作。不要为了继续教程而删除不明用途的管理配置；无法判断时先停止变更。
等待状态变化，再开始访问测试
授权完成后回到 Home，观察顶部状态及开关是否稳定。系统状态区域也可能显示 VPN 标识，具体显示位置会随设备而异。连接状态保持开启，代表系统通道已建立，但不代表选中的服务器、DNS 和所有目标网站都已经通过验证，因此下一步仍需实际访问。
若开关很快退回关闭，先记下错误提示以及发生阶段：是授权前、授权后，还是尝试连接后。设备上若有其他 VPN 连接正在使用，先停止另一个连接再单独测试，减少相互切换造成的干扰。不要反复快速点按开关，也不要一边连接一边修改多个参数。
本轮先保持 On Demand 的现有设置，优先完成一次手动连接闭环。如果连接会在手动关闭后自动重新建立，再到第五步核查 On Demand 条件。确认开关稳定后，继续执行 Connectivity Test 和浏览器访问，而不是仅凭一个 VPN 标识结束检查。
本步完成标准：已完成必要的系统授权，Home 连接状态稳定，且能明确当前使用的服务器与姿态。
Connectivity Test：测试后再做实际访问
连接保持开启后，在 Home 点 Connectivity Test，等待本轮测试结束。测试结果可帮助判断记录是否能通过当前测试方式得到响应；它不等于完整的网站访问，也不直接证明某条规则已经命中。先观察本次选中的记录，再看其他记录，避免把列表中另一项的结果当作当前连接结论。
先看测试条件，再解释结果
Connectivity Test 的结果与 Settings 中的 Test Method、当前网络及服务器对测试方式的支持有关。出现超时不一定意味着所有实际请求都无法通过；测试成功也不保证全部应用的流量、UDP 或所有目标都可用。比较两次结果时，应尽量保持同一网络、同一记录和同一测试方式，不把不同条件下的数值直接当作优劣结论。
用两类访问检查预期路径
接着打开浏览器，访问自己有权使用、且预期走 PROXY 的目标，再访问预期走 DIRECT 的目标。配置(Config)下应根据当前规则选择测试对象，而不是随机打开一个页面。若使用的是前文教学规则，只有匹配 example.com 的请求才会走 PROXY；其他目标直连成功，并不能反证代理服务器可用。
在应用的 Data 或相关请求记录中，如能查看到本次请求的处理信息，可结合目标域名、时间和策略进行核对。界面提供的信息以当前应用实际显示为准；不能仅凭页面打开快慢推断走了哪条路径。部分页面会继续请求其他域名，应观察失败的具体请求，而不是只看最初输入的地址。
如果需要做一次简单对照，可临时把 Global Routing 从配置(Config)改为代理(Proxy)，保持同一服务器，重新加载同一个目标。代理(Proxy)可访问而配置(Config)失败时，优先检查规则、当前文件和 DNS；两者都失败，则先回头核对服务器资料和基础网络。测试结束后恢复原来的姿态。
本步完成标准：不仅连接开关开启，还能在已知条件下复现访问结果，并判断是否符合当前姿态和规则预期。
Settings 与常见失败点：按发生阶段排查
先判断失败发生在导入、建立连接，还是连接后的访问阶段。三个阶段的检查入口不同：订阅读取失败先查地址，开关无法保持先查授权，只有部分目标失败再查规则与 DNS。下面完成基础定位即可；涉及多项设置或持续异常时，转到故障排查大全继续，不必在首次上手时遍历所有高级参数。
导入失败或 SERVER 没有记录
重新核对订阅地址是否完整、是否仍有效，以及它是否确实用于服务器订阅。若出现网络或证书错误，先检查当前网络能否正常访问订阅所在地址，并确认设备时间准确。不要把完整地址贴入公开搜索或截图；需要咨询自己的服务提供方时，仅提供必要的错误信息，遮住凭据。
手动添加后无法使用，则回到 Add Server 核对 Type、Host、Port 和认证字段。密码看似相同也可能夹带首尾空格；端口、加密方式或 TLS 相关参数不一致，同样可能导致连接失败。修正后保存，再回 Home 重新选中记录测试，避免仍然使用旧记录。
开关打不开、自动断开或重新连上
先确认系统 VPN 配置授权是否完成，再检查是否有其他 VPN 连接同时工作。若手动关闭后又自动建立连接，到 Settings 查看 On Demand 的启用状态与触发条件；它控制何时自动连接，和 Config 中“连接后如何分流”不是同一层设置。调整前记下原状态，排查结束后按使用需求恢复。
在 Wi-Fi 与蜂窝网络间切换后才出现的问题，应分别在两种网络下重测，不要直接归因于应用本身。保留当前配置和记录，只改变网络这一项，观察相同目标是否出现一致结果。这样才能区分基础网络差异和服务器参数错误。
已连接但无法访问，或只有部分目标失败
先用已知可用的普通目标确认基础网络，再检查当前服务器和 Global Routing。代理(Proxy)正常而配置(Config)异常时，优先核对实际启用的配置、规则顺序和 FINAL。仅少数域名失败时，再看 DNS 解析与相关请求；不要一开始就同时改 DNS、TCP、UDP 和全部传输设置。
Settings 中的 Test Method 用于理解连通性测试条件，Diagnostics 可在定位问题时提供诊断线索；Proxy、TCP、UDP 等项目涉及更具体的行为，首次上手保持已有值即可。准备分享诊断信息前，先检查其中是否包含订阅地址、服务器信息或访问记录，只保留排错所需部分。
如果订阅更新后原先选中的记录消失，回到 SERVER 重新确认当前选择；如果修改配置后才异常，先恢复此前保留的配置，再用相同目标复测。按“恢复基线、只改一项、重新验证”的顺序操作，通常比不断叠加设置更容易找到原因。
到这里，首次使用流程已完成。界面词含义查术语手册；持续超时、DNS、耗电或更新后异常等情况，按故障排查中的对应症状继续检查。
