Shadowrocket 官方手册 · 教程
Shadowrocket 使用教程订阅导入与连接检查
先把已有资源导入，再选择流量处理方式。按下列五步完成首次连接，并用一次实际访问确认结果；不需要先修改全部高级设置。
Add Server：添加服务器与 Subscribe 导入
打开 Shadowrocket，先停留在 Home。首次配置时，顶部连接开关可以保持关闭。找到 Add Server 进入添加页面，接下来按手中资料的类型选择一种方式：完整订阅链接用 Subscribe，单个服务器的字段资料则按对应协议手动填写。不要把订阅地址拆成服务器地址和密码，也不要把单个分享链接当作订阅地址填入。
已有订阅链接
在 Add Server 的 Type 中选择 Subscribe，把完整订阅链接粘贴到对应的 URL 输入项。粘贴后检查开头与结尾，确认没有带入引号、空格或聊天消息中的说明文字；链接中的查询参数应保持原样。给这条订阅填写一个自己能辨认的名称，再保存并返回 Home。不同版本的入口位置可能略有区别，以实际显示的 Subscribe 和 URL 字段为准。
导入后先等待订阅内容读取完成，再查看列表是否出现服务器条目。只有订阅名称出现、下面没有可选服务器时，不能算完成导入；应先检查链接是否有效，以及当前网络能否读取该链接。订阅更新只是重新获取列表，不会自动证明其中每个条目都可连接。首次操作先选一个已有条目完成后续验证，暂时不要同时导入多条订阅，以免难以分辨问题来自哪一组。
已有单个服务器信息
返回 Add Server，先选对 Type，再依据资料填写其余项目。例如选择 Shadowsocks 后，逐项核对 Host、Port、Password 与 Method。Host 填服务器域名或 IP，不要额外加网页路径；Port 填数字端口；Method 必须与服务器配置一致，不能按名称相似程度猜选。其他协议显示的字段不同，应按服务商提供的信息完整填写。
如果已有二维码，可使用 Scan QR Code，按系统提示授予相机权限。只有明确拿到兼容 JSON 配置时才使用 Import from Cloud JSON，它与普通订阅链接不是同一入口。无论采用哪种导入方式，保存后都要返回 Home，在 SERVER 分组中确认条目并选中一个服务器。需要了解分享链接、订阅更新和重复条目整理时，转到节点管理手册继续阅读，不必在首次连接前完成全部整理。
Global Routing：配置、代理与直连
已有服务器条目后，回到 Home 打开 Global Routing。这里决定请求按什么方式处理，而不是决定使用哪条订阅。三种姿态分别写作配置(Config)、代理(Proxy)、直连(Direct)。先明确当前需要规则分流，还是只想检查服务器连接，再作选择；列表中选中服务器，并不意味着所有请求一定都会经过它。
日常使用选择配置(Config)
配置(Config)会依据当前配置文件中的规则决定策略，适合需要区分不同请求的日常使用。选择后进入底部 Config 页面，确认当前使用的是自己准备启用的文件；打开文件时可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。首次配置重点检查 Rule，不需要为了完成连接而修改每一个分段，也不需要启用 HTTPS Decryption。
规则中的 PROXY 表示按代理策略处理，DIRECT 表示直接连接，REJECT 表示拒绝请求。规则从上向下检查，较早命中的条目会影响结果；因此即使连接已经建立，某个目标仍可能走 DIRECT，这不一定是异常。编辑器中的 Add Rule 用于新增规则，但此时建议保留已有可用配置，完成连接验证后再修改。规则关键字的完整含义可查术语手册。
诊断时使用代理(Proxy)与直连(Direct)
代理(Proxy)用于把请求按代理方式处理，便于暂时减少规则匹配对结果的干扰；它仍依赖已选中的服务器、有效凭据和可用网络，并不会修复错误的服务器字段。直连(Direct)用于直接访问，可作为基础网络对照，不会因为列表里存在服务器就自动转为代理。首次检查可先确认基础网络，再使用 Proxy 测试已有服务器，最后回到 Config 验证规则分流。
Home：打开开关并完成授权
现在返回 Home，再次检查两项内容：SERVER 中选中的是准备测试的服务器，Global Routing 显示的是刚才决定的姿态。确认后，打开页面顶部 Not Connected 旁的开关。第一次连接可能出现系统添加 VPN 配置的提示，这是应用使用系统网络连接能力所需的授权，应先阅读提示，再按系统要求确认或完成设备验证。
如果刚才取消了授权，先回到应用重试，不要通过反复编辑服务器地址来解决权限问题。授权完成后，返回 Home 等待状态变化，避免连续快速拨动开关。若开关立即回到关闭状态，或页面仍显示 Not Connected，说明这一阶段尚未完成，应先检查授权、系统网络设置以及是否有其他网络连接配置正在影响本次操作。
系统连接建立与远端服务器可用是两件事。开关保持开启，代表应用已进入连接工作状态；它本身不能保证密码正确、服务器可达或目标网站可用。因此看到连接状态变化后，下一步不是继续增加设置，而是执行 Connectivity Test 并尝试实际访问。先把“能否打开连接”和“打开后能否完成请求”分开记录，排错会更直接。
首次验证期间建议保持当前 Wi-Fi 或移动网络不变，并让应用留在前台直到状态稳定。若需要换服务器，先明确选中的新条目，再重新检查测试结果；若同时更换网络、服务器和 Global Routing，成功或失败都难以归因。日后需要自动连接时再研究 On Demand，首次操作先以手动开关建立一个可重复的基准。
Connectivity Test：测试与实际访问
连接开关开启后，在 Home 点击 Connectivity Test。测试用于获得当前连接条件下的参考结果，不能替代实际业务验证。等待本次测试结束后，再打开浏览器，刷新原本需要访问的页面；尽量使用一次新的请求，而不是只看已经缓存的页面内容。若目标是某个应用，还需要在该应用内重试相应操作。
检查时分别记录三件事：Home 的连接状态、Connectivity Test 是否完成、实际页面是否正常。三者并不总是一致。比如测试完成而某个页面失败，可能与目标域名的规则、目标服务本身或 DNS 有关；测试失败但实际页面可打开，也可能是测试方法或测试目标不适合当前网络。不要只凭一个测试数值判断整份订阅失效，更不要把结果理解为服务质量排名。
用一次对照缩小问题范围
如果配置(Config)下打不开页面，保留同一个服务器与同一个目标，临时切到代理(Proxy)再试。Proxy 可用而 Config 不可用时，应优先检查启用的配置文件、命中的规则和 DNS 设置，而不是马上更换所有服务器信息。如果 Proxy 也失败，再测试基础网络与已有服务器字段。直连(Direct)可帮助判断目标是否本来就能直接访问，但直连成功不能证明代理链路正常。
确认代理连接可用后，切回日常使用的 Config，再访问一个预期走 PROXY 的目标和一个预期走 DIRECT 的目标。可在 Data 查看当前版本提供的请求或流量信息，结合规则判断；流量数字变化本身仍不足以说明某个目标命中了哪条规则。完整的规则示例、顺序检查与订阅管理放在节点管理手册，需要时再展开，不要在首次验证中一次加入大量新规则。
Settings：常见失败点与复测顺序
遇到问题先判断停在哪一步，再进入 Settings。这里可以看到 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等项目，但这些入口不是首次连接必须全部调整的清单。保持未涉及的选项不变，每次只改一个条件，重新连接后复测，才能确认改动是否有效。
导入失败或列表为空
如果还没出现可选服务器，先回到订阅输入项检查 URL 是否完整，尤其是链接尾部参数，以及复制时是否带入换行或额外字符。确认当前网络可以读取订阅，随后再执行更新。反复添加同一条链接通常只会增加重复分组，并不会修复失效地址。若服务商确认链接已变更或访问条件已调整，应使用其提供的最新资料；不要自行猜测地址中的字符。
开关已开，但请求失败
先核对选中条目，再检查 Type、Host、Port 和认证信息。手动填写时，协议类型与 Method 不一致、密码前后出现空格，都可能造成连接失败。完成字段检查后，可在同一网络下换一个自己已有的服务器做对照；如果所有条目都失败，再回到基础网络和系统授权检查。不要为了排错同时改动 TCP、UDP 等多个设置，这会增加新的变量。
测试与页面结果不一致
进入 Settings 查看 Test Method，确认当前使用的测试方法与所理解的结果一致。网络条件可能允许某种测试，却无法完成实际页面所需的请求，也可能出现相反情况。若只有个别域名失败，先回到 Config 检查相关规则与 DNS，再用 Proxy 对照。需要进一步记录时使用 Diagnostics，记录发生问题的时间、所选模式、错误文字与可重复步骤，而不是只保留一张开关截图。
连接自动变化或切网后异常
若手动关闭后又重新连接，检查 On Demand 是否启用，以及系统是否保存了相应的按需连接设置。首次排错可暂时停用自己已启用的自动连接条件，再按步骤三手动连接。若问题只在 Wi-Fi 与移动网络切换后出现，分别在两种网络上单独测试，记录差异；不要把网络切换后的短暂结果直接归因于订阅内容。
向服务商核实已有线路时，只提交必要的错误现象，并遮住订阅 URL 中的访问参数、Password、二维码和个人信息。删除应用或批量清空列表并不是优先排错动作，可能让原配置无法恢复。先保留能用的文件与条目，再处理异常项；订阅备份、分组与更新策略可继续阅读节点管理手册，不熟悉的英文项目则到术语手册查阅。
