Shadowrocket 使用教程

手动添加：按 Type 填写对应字段

打开 Shadowrocket 的 Home，在 SERVER 区域找到 Add Server 并进入。先点 Type，选择服务器资料中指定的协议，再填写 Host 与 Port。Host 应填写对方提供的服务器地址，不要把整条订阅链接粘贴到这里；Port 填写对应端口，不附加说明文字。协议选定后页面会显示相应认证字段，字段是否必填由协议与服务器配置共同决定。

例如选择 Shadowsocks 时，按资料填写 Password 和 Method，不能只凭名称相似选择加密方式。使用 VMess、VLESS、Trojan 或 Hysteria2 时，还要核对对应的身份、TLS 与传输参数；不要将一个协议的参数套到另一个协议。服务商给出的资料若缺少必需字段，应先补齐资料，而不是用随机值尝试。可以填写便于辨认的备注，但备注不能替代实际地址或认证信息。

检查完后保存并返回 Home。确认 SERVER 中出现刚添加的条目，名称与预期相符，再点选该服务器。此时只是完成资料录入，尚不能据此判断服务器可用。如果你已有可识别的服务器二维码，可以从 Add Server 的 Scan QR Code 入口读取；导入后仍应打开条目检查 Type、Host、Port 等信息，不能把扫描成功等同于连接成功。

Subscribe：导入你已有的订阅

如果手中是一条订阅链接，在 Add Server 中选择 Subscribe，按页面字段填写完整链接及便于辨认的备注，然后保存。复制时保留原有查询参数，去掉聊天文字、换行和链接外层的引号。含有访问凭据的订阅链接属于私密信息，不要贴进公开留言或公开截图；需要协助时只说明错误现象，并遮挡链接中的敏感部分。

返回 Home 后，等待订阅内容加载，必要时在对应订阅项执行更新。成功时应能看到由该订阅生成的服务器条目。若只出现订阅名称却没有服务器，先检查获取是否报错，再确认链接返回的是 Shadowrocket 可识别的订阅内容，而不是登录页面或普通网页。不要为解决一次失败反复建立同名订阅，这会增加后续选错条目的概率。

订阅更新用于同步远端服务器资料，不等于导入规则配置，也不一定保留你对订阅条目的本地修改。先选择一个资料完整的服务器继续下一步；关于订阅更新失败、内容变化和重复条目的详细处理，参阅常见问题。配置文件的结构另见配置字段参考，本步骤先不修改规则。

完成添加后回到 Home，点 Global Routing，查看当前选择的姿态。三种常见选择写作配置(Config)、代理(Proxy)、直连(Direct)。先看当前勾选项，再决定是否更改；不要因为连接失败就连续切换多个姿态，否则后续很难判断是哪次改动影响了结果。

配置(Config)：根据当前配置匹配

选择配置(Config)时，请求按照当前生效配置中的规则处理。进入 Config，确认正在使用的是哪份配置，再打开对应内容查看 Rule。配置文件存在于列表中，并不必然意味着它正在生效；编辑了另一份文件，也不会自动改变当前连接的规则。对首次使用者，先确认当前文件与预期一致，不必一次性改动 General、Rule 与其他所有分段。

Rule 通常按从上到下的顺序检查，匹配到相应规则后使用指定策略。例如 DOMAIN-SUFFIX,example.com,PROXY 表示对指定域名后缀采用 PROXY，IP-CIDR,192.168.0.0/16,DIRECT 用于匹配相应地址范围。末尾的 FINAL,PROXY 为未被前文命中的请求指定处理方式。这些是语法示例，不应整段覆盖你已有且正在使用的规则。

PROXY、DIRECT、REJECT 是策略关键字，不能只按中文直觉随意替换。检查规则时还要确认对应策略或策略组确实存在，且目标选择符合预期。规则类型、DNS 解析与匹配条件之间的关系属于进一步配置内容，具体写法参阅Rule 与规则顺序说明；本教程只要求先能辨认当前文件与实际策略。

代理(Proxy)与直连(Direct)：用于对照路径

选择代理(Proxy)可以对照所选代理路径是否正常，避免先把复杂规则一起带入排查。选择直连(Direct)则用于观察直接连接的情况，它不能用来证明所选代理服务器已经可用。如果代理(Proxy)正常而配置(Config)下某个目标异常，应优先检查该目标命中的规则与策略，而不是立即重填所有服务器参数。

选好姿态后返回 Home，再看一次 Global Routing 显示值，并确认 SERVER 中当前选中的服务器。对照测试结束后，恢复自己准备长期使用的姿态；如果计划按规则使用，通常应回到配置(Config)，并保留刚确认的有效配置。下一步只打开连接开关，不再同时编辑配置文件。

回到 Home，确认 SERVER 下点选的是刚才准备测试的服务器，而不是同名旧条目。再看 Global Routing 是否与上一步一致。确认后打开页面顶部连接开关。尚未连接时，页面可显示 Not Connected；开关打开后的状态变化用于判断系统连接是否建立，不用于单独判断某个目标网站能否访问。

首次连接时，系统会提示允许 Shadowrocket 添加 VPN 配置。核对提示中的应用名称与当前操作一致后，选择允许，并按设备要求完成认证。这里创建的是供系统网络扩展使用的 VPN 配置，不是要求重新填写服务器 Password。不要把服务器密码输入到不相关的系统认证位置，也不需要为了这个提示另找配置文件导入。

完成系统确认后回到 Shadowrocket，观察连接开关是否保持开启，以及页面是否从 Not Connected 转为已连接状态。如果系统提示出现后选择了取消，应用可能无法继续建立连接；再次发起连接，按提示重新授权即可。若此前在系统设置里删除过相应 VPN 配置，也可能需要重新经历这一步。

开关立即回落时，先记录是否出现权限提示或错误信息。可以在 iPhone / iPad 的系统设置中搜索 VPN，查看对应配置是否存在，以及是否有其他连接正在接管当前网络。不要在没有记录的情况下删除全部网络设置；先确认权限、当前连接与应用内选项，通常更容易定位问题。受设备管理限制的设备，还应遵守其管理策略。

连接保持开启后，让应用完成状态更新，再开始访问验证。系统出现 VPN 标识，仅说明相关系统连接处于活动状态；它不证明订阅有效期、服务器认证、远端访问或每一条分流规则都正常。先不要开启 On Demand，也不要同时切换多个服务器。保持当前条件不变，才能在下一步把测试结果与这一条连接对应起来。

如果需要暂停，回到 Home 关闭顶部连接开关即可。完成一次手动连接和断开测试后，再考虑按需连接设置。首次授权的含义及误删后的处理，也可阅读添加 VPN 配置提示说明。

导入失败：先检查链接与内容

如果失败发生在 Subscribe 保存或更新阶段，先确认设备本身能访问网络，再检查链接是否完整、凭据是否仍有效。报错发生在获取订阅时，尚不能据此判断列表中所有服务器都不可用。确认服务商提供的链接用途与内容格式，不要把规则配置地址当成服务器订阅。需要更新链接时优先编辑原有订阅，更新后再检查条目变化。

测试超时：核对参数与测试方式

如果服务器已导入但 Connectivity Test 没有响应，进入 Settings 查看 Test Method，了解当前测试采用的方式，再检查 Type、Host、Port、认证信息以及对应的 TLS、传输参数。测试方式不同，观察结果也可能不同；不要仅为得到一个响应就反复改动未知字段。设备日期与时区应正确，涉及证书验证时尤其需要检查系统时间，而不是直接放宽验证条件。

同一服务器在一个网络下失败、另一个网络下正常时，记录两边结果并检查当前网络是否有额外限制。所有参数都与原始资料一致仍无法连接时，应向自己的服务商确认服务器状态与资料有效性。向他人反馈前，遮挡 Password、身份凭据、订阅链接及其他可用于访问服务的信息。

已连接但部分请求失败：回到规则与记录

若开关保持开启却只有部分页面异常，先查看 Data 中相应请求，再核对 Global Routing 与当前 Config。确认是否命中了预期的 PROXY、DIRECT 或 REJECT，以及策略组是否选到了可用目标。涉及域名解析时，记录具体失败域名与错误，不要同时替换 DNS、规则文件和服务器。DNS 与规则字段的深入说明放在配置字段参考，先按现象定位再阅读对应章节。

Diagnostics 与 On Demand：在基础连接之后使用

Settings 中的 Diagnostics 可用于进一步查看诊断信息。诊断记录用于辅助判断，不能代替有效的服务器资料；分享记录前先检查其中是否含有私密地址或凭据。遇到持续复现的问题，保留操作顺序、错误提示和网络环境，比只描述“不能用”更有助于排查。完整的超时排查顺序见连接失败检查清单。

On Demand 适合在手动连接已经验证成功后再配置。开启前先理解触发条件，确认需要在哪些网络场景下自动建立连接；它不会修复错误的订阅或服务器参数。如果关闭连接后又自动连上，应检查 On Demand 及相关触发设置。后台连接与耗电的取舍可阅读On Demand 使用时机说明，不必在首次上手时一次完成全部设置。

完成后保留一套已经验证有效的组合：服务器、Global Routing 和当前配置。后续调整先备份，再每次只改一个字段，重复“连接、实际访问、查看记录”的检查过程。这样即使结果异常，也能回到上一套已知可用的设置，而不需要从头重新导入所有内容。