Shadowrocket 使用教程
订阅导入与连接验证

打开 Shadowrocket 后进入 Home，在下方找到 SERVER 分组与 Add Server。先辨认手上的资料：能够更新一组服务器的完整地址属于订阅链接；包含协议、服务器地址、端口和认证参数的一组字段，则用于手动添加。两种资料不能仅凭“都是一段文本”互相替换，导入失败时应先确认类型，而不是连续重复保存。

已有订阅：选择 Subscribe

点按 Add Server，进入添加页面后点按 Type，选择 Subscribe。在对应的地址栏粘贴自己已有的完整订阅地址；如有备注字段，可填写便于辨认的名称。粘贴后检查开头、结尾是否完整，尤其留意聊天软件复制时附带的空格、换行或说明文字。地址中的参数可能用于身份验证，不应自行删减，也不要把完整地址发到公开位置。

保存并返回 Home，等待订阅内容载入，再检查 SERVER 下是否出现相应分组与服务器条目。仅保存了一个订阅名称，并不代表内容已经获取成功。如果列表仍为空，先确认当前网络能够访问订阅地址，再核对地址是否有效；需要刷新时，从该订阅条目的操作入口执行更新，不必重新建立多个同名订阅。

已有服务器信息：按 Type 填写字段

手动添加时，在 Add Server 的 Type 中选择与资料一致的协议，再填写 Host、Port 以及该协议要求的认证字段。截图展示的 Password、Method 只是对应类型下的字段示例；切换协议后字段会变化，应以自己的服务器信息为准。Host 通常只填主机名或 IP，不把整条网页地址放进去；端口与密码则逐项核对大小写及字符。

如果拿到的是二维码，可使用 Scan QR Code；Import from Cloud JSON 仅用于与该入口格式相符的已有资料。保存后回到 SERVER，核对名称、类型与地址是否对应。先保留一条能够明确识别的测试条目，再进入下一步选择 Global Routing；不要同时修改协议、订阅和规则，以免失败时无法定位原因。

完成添加后返回 Home，点按 Global Routing。首次操作应明确区分三种姿态：配置(Config)、代理(Proxy)、直连(Direct)。它们不是服务器的协议类型，也不是三份订阅；同一条服务器在不同姿态下，承接的请求范围可能不同。

• 配置(Config)：按照当前启用配置中的规则选择处理策略。某些请求可能使用 PROXY，另一些可能使用 DIRECT 或 REJECT，实际取决于规则条件与顺序。
• 代理(Proxy)：用于让受该模式处理的流量使用所选代理，适合临时判断问题是否与分流规则有关；不应将它理解为任何系统请求都必然经过同一条连接。
• 直连(Direct)：用于直接连接。即使连接开关处于开启状态，选择 Direct 也不等于正在使用所选服务器转发请求。

准备使用规则分流时，先进入底部的 Config，确认哪份配置处于启用状态，再打开它检查规则。服务器订阅与配置文件承担不同任务：订阅主要维护服务器信息，配置文件则描述通用参数、规则与相关设置。导入订阅成功，不应据此推断已经启用了符合自己需求的分流配置。

官方截图中的配置编辑页按 General、Rule、Hosts、URL Rewrite 等区块组织，Add Rule 用于添加规则。首次连接不需要逐项改动这些区块，也不需要为基础连接启用 HTTPS Decryption。已有配置可先保留原样；需要编辑时先保存副本，避免把排错操作直接变成长期配置。

检查 Rule 时，重点看具体条件是否位于宽泛条件之前，以及末尾的 FINAL 指向什么策略。PROXY 表示按代理策略处理，DIRECT 表示直接连接，REJECT 表示拒绝；如果规则引用自定义策略名称，还需确认对应策略确实存在。详细语法与匹配顺序见规则与配置参考，此处先完成模式选择，不展开整份配置重写。

如果暂时无法判断现有规则，可记录当前姿态，短暂选择 Proxy 进行连接测试；确认服务器能够工作后，再切回 Config 检验规则。这样能把“服务器本身失败”与“规则把请求送往不同策略”分开。完成选择后回到 Home，下一步才打开连接开关。

回到 Home，在 SERVER 分组点按准备使用的服务器，确认选中标识落在正确条目上。如果刚更新过订阅，应重新核对当前选择，因为列表名称、顺序或可用条目可能已经变化。随后查看 Global Routing 是否保持为上一步选定的姿态，避免在 Direct 下误以为正在测试代理连接。

点按顶部 Not Connected 旁的连接开关。首次连接时，系统可能弹出添加 VPN 配置的确认窗口；核对提示后允许，并按设备要求完成密码或生物识别验证。该步骤是在系统中登记网络连接配置，不是导入订阅，也不会代替服务器认证。若当时取消了授权，返回 Home 再次尝试连接，并留意是否仍有系统提示等待处理。

授权完成后回到 Shadowrocket，观察顶部连接状态与开关是否保持开启。iPad 与 iPhone 的布局宽度和系统状态标识可能不同，但判断顺序相同：服务器已选中、Global Routing 已确认、系统授权已完成、应用状态已变化。不要只凭状态栏是否出现 VPN 字样判断失败；不同设备与显示位置可能影响标识的可见性。

如果开关立即回到关闭状态，先处理系统授权或连接启动问题，不要急着修改所有规则。如果开关能够保持开启，进入下一步验证实际请求。连接状态说明网络配置已启动，却不能单独证明服务器认证、目标网站访问、DNS 与分流结果全部正常。

导入失败或 SERVER 列表为空

首先返回 Add Server 核对 Type。订阅链接应使用 Subscribe，单台服务器资料应按对应协议填写。确认完整地址没有被截断，当前网络可以获取内容，并检查已有服务是否仍在有效期内。订阅地址可访问但仍没有条目时，应确认返回内容是否确实为兼容的订阅数据；登录页面、提示文字或错误页面不能因为“能够打开”就被视为有效订阅。

开关无法保持开启

检查是否完成了系统 VPN 配置授权，以及当前是否还有其他 VPN 连接占用。先停止正在使用的其他 VPN 连接，再回到 Home 重试；受管理设备若限制添加 VPN 配置，应向设备管理人员确认策略。不要一开始就删除现有配置，删除前先确保自己仍持有订阅和服务器资料，以免丢失必要信息。

开关已开启，但测试或访问失败

先核对所选服务器的 Host、Port、协议与认证字段；使用订阅时可更新一次，再重新确认当前选中项。在 Settings 查看 Test Method，理解当前测试方法后再解释 Connectivity Test 的结果。如果一种测试失败而实际页面可用，应优先核对测试目标与方法，不把单个测试结果直接等同于整体连接失败。

如果 Proxy 下可访问、Config 下失败，重点回查当前配置的 Rule、FINAL 与策略引用。如果两种姿态均失败，保持服务器和模式不变，尝试另一条自己可用的网络，以区分网络环境与服务器问题。只有某个目标失败时，也应考虑目标服务本身的状态；反复刷新订阅并不能处理每一种访问故障。

检查 On Demand 与 Diagnostics

On Demand 用于按条件触发连接。首次排错可先记录其原有设置，再暂时关闭，使用手动开关复现问题；否则自动重连可能让“刚关闭又开启”的现象干扰判断。待手动连接稳定后，再恢复并逐项验证触发条件。Settings 中的 Proxy、TCP、UDP 等选项也应按实际需求调整，不因看到字段就全部改动。

需要进一步定位时，使用 Diagnostics 查看诊断信息，记录问题出现在哪一步、使用何种网络、所选 Global Routing 姿态，以及测试和网页访问各自的结果。分享记录或截图前，隐藏完整订阅地址、密码、认证参数及可识别个人的信息；只保留复现问题所需的字段与错误描述。

仍未解决时，前往常见问题与故障排查按症状继续检查；需要理解配置段落、规则优先级与策略含义时，阅读规则与配置参考。日常维护先更新自己已有的订阅，应用更新则通过 App Store 进行，二者不是同一个操作。