Shadowrocket 使用说明

打开 Shadowrocket 后，先进入 Home。手中资料如果是一条会定期更新服务器列表的链接，按订阅处理；如果是一组协议、地址、端口和认证字段，按手动添加处理。这两种资料解决的是同一个问题：让应用知道连接到哪里、使用什么协议以及如何认证，不需要同时重复导入。

订阅链接：使用 Subscribe 类型

从 Home 点击 Add Server，进入添加页面，在 Type 中选择 Subscribe，再将完整订阅链接填入对应的 URL 字段。为条目填写便于辨认的备注后保存，回到 Home 等待订阅内容读取。订阅链接属于敏感资料，复制时留意开头、结尾以及查询参数是否完整，聊天软件附带的说明文字和换行不要一并填入。

导入完成后，查看 SERVER 分组是否出现服务器条目，再点选准备使用的一项。订阅名称只是列表的组织方式，不等于已选择了其中某台服务器。之后若服务商更新了内容，应对已有订阅执行更新，而不是不断添加相同链接。更新失败时先保留现有可用条目，确认原因后再处理。

手动填写：按 Type 核对字段

如果已有单台服务器信息，在 Add Server 中先选择正确的 Type，再填写 Host、Port 以及该协议要求的认证信息。Shadowsocks 的 Password、Method 需要与服务器端一致；其他协议显示的字段可能不同，应逐项对照你的原始资料。Host 通常填写域名或 IP 地址，不把一整段网页链接当作服务器地址。

保存前再看一次端口是否完整、密码前后是否多出空格，以及协议是否选对。页面出现某个可选字段，不表示所有服务器都必须填写；TLS、传输方式等参数也不能凭名称猜测。资料缺项时从你的服务商处获取对应信息，不通过轮流试选来替代核对。

扫码与配置文件要分清

已有二维码时，可以通过 Scan QR Code 读取连接资料，随后核对解析出来的 Type 和 Host。Import from Cloud JSON 面向相应格式的资料，并不是任意网页或任意订阅都能使用的通用入口。导入前确认资料类型，导入后仍要检查生成的条目。

服务器订阅与 Config 中的配置文件用途不同：前者主要维护连接条目，后者管理规则等设置。看到 Config 或 Subscribe 字样时，应结合正在处理的资料判断对象，不能仅凭按钮名称互换入口。此时先完成服务器导入，再进入下一步选择 Global Routing。更多词义可查阅术语表。

服务器条目保存成功后，返回 Home，点击 Global Routing 查看当前模式。这里控制请求的处理方式，而不是切换服务器协议。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)；开始前记住当前选择，排查时才能解释前后结果的差异。

配置(Config)：依据配置文件分流

选择配置(Config)时，应用按当前生效的配置文件处理请求。进入 Config 查看正在使用的文件，确认其中的 Rule 与策略符合预期。文件出现在列表中不一定表示已生效，需核对选中或使用状态。首次上手优先使用自己已有且理解用途的配置，编辑之前保留一份副本。

规则可以让特定域名使用 PROXY，让局域网网段使用 DIRECT，并在末尾通过 FINAL 指定其余请求的去向。下面是用于解释匹配顺序的 Rule 片段，不是服务器信息，也不应直接替换整份配置。只有相应请求经过应用处理时，规则才有机会参与匹配。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

该片段把 example.com 及其子域名交给 PROXY，把指定私有网段交给 DIRECT，其余请求落到 FINAL。规则通常从上到下匹配，具体条件应放在较宽泛条件之前。先保留现有规则做连接验证，不必在首次使用时同时修改 General、Hosts 或 URL Rewrite。

代理(Proxy)与直连(Direct)：用于明确对照

代理(Proxy)让应用接管的请求按代理模式处理，适合在已有服务器资料正确时，暂时排除配置分流对结果的影响；它并不保证每个服务都允许该出口访问。直连(Direct)让请求直接连接，不用它来验证代理服务器是否可用。即便顶部连接开关处于开启状态，选择 Direct 也可能得到与代理模式不同的出口结果。

日常需要规则分流时，完成基础验证后切回配置(Config)，并再次核对当前文件。三种模式不是“强度”等级，也不改变服务商侧的账号权限。更详细的规则类型、FINAL 顺序与配置段落说明放在配置字段参考，本页只完成首次使用所需的选择。

回到 Home，先确认 SERVER 中已经选中准备使用的服务器，再确认 Global Routing 与上一步一致。不要一边切换模式一边快速点开关；先固定服务器和模式，才能判断接下来的连接结果对应哪组设置。

点击 Home 顶部的连接开关。尚未连接时可看到 Not Connected。首次建立连接，系统会请求允许 Shadowrocket 添加 VPN 配置；阅读弹窗中显示的应用名称和说明，确认是本次主动操作后允许，并按设备提示完成密码或生物识别验证。

这里的 VPN 配置授权是让系统允许应用处理相应网络流量，仅涉及本机权限，不代表服务器已通过认证。允许后返回 Shadowrocket，观察顶部状态是否改变、开关是否保持开启。若先前取消了弹窗，可再次主动连接，按系统实际提示处理授权。

如果开关刚打开就退回关闭，先检查授权是否完成，以及系统是否有其他正在接管连接的 VPN 配置。暂时停止冲突的连接后再试，不要直接清空所有系统设置。对于工作或学校管理的设备，相关限制可能由管理策略决定，应按设备允许的方式处理。

状态保持开启只说明本机连接流程已建立，不等于每个远端网站都能正常访问。此时继续下一步验证，不急于开启 On Demand。等手动连接、断开与重新连接都符合预期后，再根据需要设置自动连接行为。

导入后为空：先查资料读取

返回订阅条目，核对链接是否完整，确认复制的是订阅内容入口而不是服务商的账户网页。再检查已有服务是否处于可用状态，以及当前网络能否读取该链接。链接从你的服务商处获取，涉及服务端解析或账号权限的问题，应依据原始资料核对，不把含凭据的链接贴到公开讨论区。

如果手动添加的条目没有出现在 SERVER，回到 Add Server 检查是否已保存，以及必填字段是否通过检查。订阅读取失败与服务器连接失败是两个环节：前者还没有取得条目，后者是已有条目无法完成测试或实际请求，处理顺序不同。

测试超时：区分测试方式与实际访问

进入 Settings，查看 Test Method，了解当前测试使用的方式。不同方式衡量的环节不同，结果不宜直接横向比较；先保持一种方法，再对同一条目重复测试。若实际访问正常而某种测试持续失败，可进一步检查测试目标和该方法适用的网络条件。

实际请求也失败时，再核对 Type、Host、Port、Password 或该协议对应的认证字段，以及服务商要求的 TLS 和传输参数。切换 Wi-Fi 与蜂窝网络做一次对照，可以帮助判断是否与当前接入网络有关，但切换前后应保持服务器和 Global Routing 不变。

部分应用失败：检查模式与命中规则

先确认没有误选直连(Direct)，再检查配置(Config)当前使用的文件。特定域名被 REJECT、较宽泛规则提前命中、或 FINAL 指向了不符合预期的策略，都可能造成局部失败。不要看到访问异常就修改全部 DNS 与协议参数，应先用连接记录确认失败请求实际走向哪里。

若需要修改配置，先保存副本，再改动与问题有关的一条规则，重新发起请求验证。涉及域名解析、IP 规则与协议细节时，继续查阅配置字段参考；按具体错误现象查找处理路径时，前往常见问题。

自动连接异常：最后再检查 On Demand

Settings 中的 On Demand 用于按条件触发连接，不是服务器可用性的修复开关。基础连接尚未确认时，先使用手动开关验证。若系统在断开后又自动连接，检查已有 On Demand 设置及设备的 VPN 管理状态，再决定是否调整；调整后分别测试进入应用、切换网络与手动断开的行为。

进一步排查可查看 Diagnostics。分享诊断内容前，检查其中是否包含服务器地址、认证信息、订阅链接或访问记录，并移除敏感部分。保留问题发生时的模式、网络类型与错误现象，通常比只提供一句“连接不了”更有助于缩小范围。