Shadowrocket 使用说明

打开 Shadowrocket 后先停留在 Home，不必立即打开顶部开关。已有资料通常分为两类：一类是包含多个服务器的订阅链接，另一类是一台服务器的协议、地址、端口及认证字段。两者的填写位置不同；不要把完整订阅链接当成 Host，也不要把单台服务器的地址直接填入订阅地址栏。

使用 Subscribe 导入已有订阅

1. 从自己的服务商处取得订阅链接，复制完整内容。复制时留意开头和末尾是否混入空格、换行或说明文字，尤其不要只复制聊天工具中被截短的可见部分。
2. 进入订阅管理入口，找到 Subscribe；若从 Add Server 进入，先选择订阅类型，再填写自己的链接。Config 中的配置文件管理与服务器订阅不是同一用途，不能仅凭链接以相同后缀结尾就认定格式相同。
3. 保存并执行更新。等请求结束后返回 Home，展开相应分组，核对 SERVER 下是否出现预期条目。只看到订阅名称、却没有任何服务器时，先检查更新结果，不要继续反复切换连接开关。

订阅更新会读取远端提供的服务器信息，不等于已经建立代理连接。订阅地址可能含有个人访问标识，不应贴到公开讨论区；排查时只描述错误现象，不公开完整地址。若更新返回网页或登录提示，应向原资料提供方确认链接用途，而不是通过修改 Host 或 Port 来尝试修复。

使用 Add Server 手动填写

1. 在 Home 的 SERVER 区域点 Add Server。先选择 Type，使表单与已有资料的协议一致，例如 Shadowsocks、VMess、VLESS 或 Trojan。不同 Type 展示的字段可能不同。
2. 依次填写 Host、Port 及当前 Type 所需的认证信息。截图中的 Password、Method 是对应表单字段；不要把它们当成所有协议都必须填写的通用项目，也不要凭经验猜测加密方式。
3. 核对后保存并返回 Home。若资料来自二维码，可使用 Scan QR Code；Import from Cloud JSON 仅适用于对应格式的资料，并不是任意订阅地址的替代入口。

例如 example.com 只能用来理解地址字段，不是可用服务器。填写完毕应再对照原资料逐项检查；协议选择正确但认证值不一致，同样可能造成超时或连接中断。看到条目已保存后，继续下一步选择 Global Routing。

返回 Home，打开 Global Routing，核对当前选中的姿态。首次操作最容易混淆的是“有服务器条目”和“所有请求都经过该服务器”这两件事：前者只是保存了连接资料，后者还取决于 Global Routing 与当前配置。先明确本次要验证什么，再选择模式，可以减少后续排错时的变量。

1. 配置(Config)：根据当前启用配置中的规则决定请求策略。需要按目标分流时使用，并先确认所需配置已经选中。导入服务器订阅不等于自动得到符合个人用途的规则文件。
2. 代理(Proxy)：用于集中验证所选代理服务器的连接情况。它适合临时区分“服务器连接问题”与“规则选择问题”，但不能保证所有应用、所有连接类型都一定成功。
3. 直连(Direct)：请求按直连姿态处理。可用于与原网络状态作对照；此时访问正常，不能作为代理服务器可用的证据。

选择后回到 Home，看 Global Routing 一行是否显示预期值。准备长期按规则使用时，进入 Config，找到并启用自己的配置文件；需要查看内容时再打开编辑页面。官方截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是配置分段，Add Rule 用来添加规则，不是添加服务器的入口。

在 Rule 中先检查已有规则，不必为了首次连接立即新增内容。规则一般自上而下匹配，较早命中的条目会影响后续判断；末尾的 FINAL 用作兜底。下面只是语法阅读示例，不是一份可直接覆盖个人配置的完整文件。PROXY 需要对应可用的代理策略，DIRECT 表示直连，策略名称应以当前配置实际定义为准。

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

首次配置不需要同时调整 DNS、URL Rewrite 和 HTTPS Decryption。保留已知配置并只核对 Global Routing，可以让下一步的结果更容易解释。若不清楚规则关键字，先查名词解释；完整的匹配与 DNS 排查放在疑难手册，本页继续完成连接闭环。

此时已保存服务器资料，也已明确 Global Routing。返回 Home，在 SERVER 分组中找到本次准备使用的条目并选中。若同一订阅包含多个条目，先固定其中一个做完整测试，避免测试前后切换了服务器，却把结果变化误认为某个设置产生的效果。

1. 核对 Home 显示的服务器选择与 Global Routing。若服务器列表为空，返回第一步处理导入，不要用连接开关代替订阅更新。
2. 打开顶部 Not Connected 对应的连接开关。首次建立连接时，系统可能请求添加 VPN 配置；阅读提示并确认来自 Shadowrocket 后允许，再按系统要求完成设备认证。
3. 回到应用，等待 Home 状态变化。若系统权限窗口仍停留在前台，先完成或取消该操作，不要在不同页面连续重复点击开关。

允许 VPN 配置的含义是让应用通过系统网络机制处理相关流量，不会提供服务器连接资料，也不会补全缺失的服务器密码。若之前拒绝过权限，重新打开开关并按系统提示处理；若设备受组织管理，系统限制可能需要管理员确认，单纯重装应用未必改变限制。

连接状态改变后，先留在 Home 观察，不要立即开启 On Demand。手动连接能够稳定复现后，再考虑自动连接条件。其他 VPN 配置或具有相似网络接管功能的工具可能与当前连接相互影响，测试时应确认没有另一项连接正在切换，避免状态反复变化。

Home 显示已连接，只说明当前连接流程进入了相应状态，并不能证明每个目标均可访问。接下来必须验证服务器、目标访问和规则选择三个层面；如果开关立即恢复关闭，直接跳到第五步检查权限与连接环境。

进入 Settings 前，先用一句话描述现象：“订阅更新失败”“开关立即关闭”“测试超时”或“只有某个目标打不开”。这些现象属于不同阶段，处理路径也不同。Settings 中的 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 是不同设置项，并不存在一个适合所有故障的统一组合。

1. 导入失败：核对链接是否完整、当前网络是否能完成订阅请求，以及资料是否仍有效。若手动填写，重新检查 Type、Host、Port 和认证字段。服务器列表已经出现时，不要因为后续访问失败就反复删除整个订阅。
2. 开关打不开或立即关闭：先看系统 VPN 配置权限是否完成，是否有其他连接同时启动，再检查设备管理限制。若手动关闭后又自动连接，进入 Settings 的 On Demand 核对条件；排查期间暂时停用自动触发，再手动复测。
3. Connectivity Test 超时：在 Settings 核对 Test Method，明确当前测试方法，再与真实网页访问对照。可以换用自己已有的另一个服务器作比较，但测试时保持同一网络和相同方法，避免同时更换全部条件。
4. 已连接却访问失败：先比较代理(Proxy)与配置(Config)，然后检查 Data 中相关目标的策略记录。若域名访问异常而其他连接有结果，再进入 DNS 方向；不要一开始就随机更换多个解析设置。
5. 部分应用或连接类型异常：先确认问题是否只出现在特定目标、特定网络或特定操作。TCP 与 UDP 的表现可能不同，应依据已有服务器能力和实际请求判断，不要把某个选项开启当成通用修复办法。

需要进一步定位时再使用 Diagnostics。保留能说明失败时间与步骤的片段即可；分享截图或记录前应遮盖订阅地址中的访问标识、认证信息及不需要公开的访问目标。诊断信息用于解释现象，不应用来公开自己的完整配置。

若问题只在切换 Wi-Fi 与移动网络后出现，先回到手动连接条件，在两个网络分别重复第四步；若只在应用更新后出现，保留当前资料并逐项核对设置，不要未经备份就删除全部配置。处理后再次执行“选择条目 → 连接 → 测试 → 实际访问”的完整链路，确认修复不是偶然结果。

仍无法定位时，前往疑难手册按症状继续排查。记录设备系统、当前网络、Global Routing、最先失败的步骤和已经尝试过的单项修改，比只描述“连不上”更有助于缩小范围。