官方手册 / 首次连接
Shadowrocket 使用说明
本教程以 iPhone / iPad 界面为例。从手头已有的服务器或订阅开始,依次完成导入、路由选择、连接和验证。若已经导入成功,可直接跳到 Global Routing。
添加服务器或导入 Subscribe
先辨认手头的资料。若已有协议、主机名、端口及对应凭据,选择手动添加;若已有服务商给出的订阅地址,选择 Subscribe。订阅地址和服务器主机名用途不同,不要把整条订阅链接填进 Host,也不要把单个服务器地址当成订阅。两种方式任选其一即可开始,无需为同一个条目重复导入。
手动填写 Add Server
打开 Home,在 SERVER 区域找到 Add Server。进到表单后先点 Type,按已知资料选择协议。协议决定后续显示哪些字段。以 Shadowsocks 为例,Host 填服务器主机名或 IP,Port 填端口号,Password 填对应密码,Method 与服务端设置保持一致。别把示意图里的字段组合当成其他协议的通用表单;切换 Type 后,按实际出现的字段和服务商给出的资料填写。
保存前比对一遍,重点检查 Host 有没有带上网址路径、端口有没有错抄、密码首尾是否粘入空格。若已有用于分享单台服务器的二维码,可在 Add Server 中使用 Scan QR Code,扫描后先核对识别出来的 Type 和关键字段,再保存。扫描成功只说明内容被识别,不代表服务器可用。
用 Subscribe 导入已有链接
从 Home 进入 Add Server,在 Type 中选择 Subscribe,将服务商给出的完整链接粘贴到订阅地址输入处,保留查询参数,不截断尾部。保存后回到 Home,找到对应的订阅分组,确认更新后确实出现可选条目。如果只出现分组名称但没有服务器,先排查订阅获取或解析,不要继续改变路由模式。看到条目后,选定本次要用的服务器,记住名称,后续测试时核对的就是这一个条目。
选择 Global Routing
回到 Home,点 Global Routing,确认当前路由模式。选中服务器是确定可用的代理出口;选择路由模式则是确定请求如何处理。这两件事不能互相替代:列表里选中了服务器,并不表示每个请求都会经由它。
- 配置(Config):按当前生效的配置文件匹配规则。需要按目标分流时用这个模式;请求可能走 PROXY,也可能走 DIRECT,具体取决于先命中的规则。
- 代理(Proxy):不按配置文件中的分流规则逐条选择策略。希望先判断所选服务器能否承担代理请求时,可以临时用它做对照。
- 直连(Direct):请求不经所选服务器转发。适合对比同一个目标在当前网络下能否直接访问;这不等同于关闭 Home 的连接开关。
选择配置(Config)后,切到 Config 查看当前使用的配置文件,并在编辑页找到 Rule。不要把该编辑页与 Home 里的 Global Routing 混为一处:前者决定匹配条件与策略,后者决定是否采用这些规则。规则按顺序检查,首条命中即停止。以下片段仅用于说明顺序,不必替换已有配置:
[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
在这个示例中,docs.example.com 先命中第一条,走 DIRECT;另一个子域如 www.example.com 才会命中第二条。两条互换时,更宽泛的后缀规则就会先接住 docs.example.com。此前规则都没命中的请求由 FINAL 兜底。只做首次连接时,先保留原配置,不必动 General、Hosts 或 URL Rewrite。需要修改匹配条件时,先备份,再参考规则手册。
打开 Home 连接开关
确定路由模式后回到 Home,在 SERVER 下确认选中的是刚才准备使用的服务器。如果订阅中存在名称相近的条目,先打开详情核对,不要仅凭名称猜测。随后打开 Home 顶部 Not Connected 旁的开关。首次运行时,iOS 或 iPadOS 可能提示添加 VPN 配置;在确认提示是由刚才的 Shadowrocket 操作触发后,允许添加并按系统提示完成验证。
处理完系统提示后回到 Home,等待状态稳定,再确认开关保持开启。如果刚开启就弹回,不要连续点击或同时更换服务器。先检查系统提示是否已完成、设备是否已有其他 VPN 连接,或设备管理策略是否限制建立连接。受管理设备应先向管理员确认限制,不要为了测试移除管理配置。
开关保持开启表示本地连接已建立,不表示远端服务器、目标站点和每条分流规则都正常。第一次测试时固定当前网络、所选服务器和路由模式。这样即使后续访问失败,也能区分是本地连接阶段出了问题,还是请求进入连接后没有按预期完成。
用 Connectivity Test 和实际访问验证
先回到 Home,点 Connectivity Test,查看当前所选服务器对应的结果。若同时出现多个条目的结果,按名称找到刚才选中的那一行。测试正常只说明该条目在当前测试条件下获得了响应,不能替代浏览器或目标应用的实际访问;测试失败也需要结合测试方式判断,不能直接认定所有访问都会失败。
再打开一个自己有权限访问、平时结果明确的页面。手动重新加载,确认不是直接看到了浏览器缓存;必要时另开一个页面复查。若使用配置(Config),可以各选一个预期走 DIRECT 和 PROXY 的目标,记录目标的实际主机名。不要只记页面上显示的站名:网页重定向后可能已经进入另一个主机名,而页面中的图片、脚本或接口也可能来自不同域名。
如果能看到请求记录,按时间与主机名找出这次访问对应的请求,对照记录中显示的策略和 Config 中的规则;没有可用记录时,回到 Rule 按原顺序手动核对。先查看目标能否命中更靠前的精确规则或后缀规则,再看是否落到 FINAL。仅凭页面能打开,不能证明它走了预期策略。
需要对照时,在相同网络下访问同一目标,一次只改 Global Routing,测完恢复原模式。如果代理(Proxy)下可访问而配置(Config)下失败,优先检查规则和当前配置文件;如果两者都失败,继续查服务器参数和当前网络。不要用多个不同站点的结果直接比较,也不用为了验证一次连接就永久切换模式。
在 Settings 排查常见失败
先认清故障发生在哪一层:列表里没有可选条目,是导入问题;顶部开关不能保持开启,先看系统连接;开关稳定但测试或访问失败,再去区分出口、测试条件和规则。按这三层顺序排查,可避免把正在使用的配置一并改乱。
订阅更新后没有条目
确认 Type 是 Subscribe,并从自己的服务商提供的原始记录重新复制完整地址。如果地址包含查询参数,从问号开始的内容也要保留。地址无误但分组仍为空时,向服务商确认链接是否仍有效、返回格式是否适用于 Shadowrocket。不要把完整地址粘贴进公开的解析工具,也不要先删掉还能使用的分组。
连上后测试超时,或只有个别目标失败
进入 Settings,查看 Test Method,确认两次对照使用相同的测试方式。若当前服务器一再超时,先检查设备本身能否联网,再对比已知可用的网络,并回到 Add Server 的相关字段核对 Type、Host、Port 和协议要求的参数。如果只有个别目标失败,先按验证步骤重做同一目标的模式对照,再查域名是否命中 REJECT 或落入与预期不同的策略。
切换网络后连接状态出现变化
在 Settings 查看 On Demand 是否启用。启用时,网络变化可能触发重新连接或断开;测试时先记下当前条件,避免把按需行为误判成服务器故障。仍无法定位时,打开 Diagnostics,记录故障发生的时间、接入网络、模式和界面中的错误提示。需要转交排查信息时,先遮盖服务器凭据、订阅地址及不宜公开的访问记录。每改一项便回到 Home 重测,修复后恢复临时改变的设置。