Shadowrocket 官方手册 / 使用教程

Shadowrocket
导入、连接与验证

以 iPhone / iPad 界面为例,按五个步骤完成首次连接。先确认服务器能连接,再确认规则如何处理请求。

已有可用服务器条目时,可以从第二步继续。尚未完成安装,请先阅读下载与首次打开说明,不要把系统安装提示与应用内连接错误混为一类问题。

STEP 01 / IMPORT

添加服务器或导入订阅

先分清手中的信息是什么,再选择入口。单个服务器通常包含协议类型、服务器地址、端口以及密码或身份字段;订阅链接则用于获取一组服务器条目;配置文件还可能包含规则、策略和其他设置。这三者用途不同,不能仅凭链接外观判断。请以你已有服务信息的说明为准,避免把配置文件地址填进服务器地址栏,或把网页介绍地址当成订阅地址。

使用 Add Server 手动填写

打开 Shadowrocket,进入 Home,点击右上角添加入口进入 Add Server。先选择与已有服务器一致的协议类型,再逐项填写地址、端口和认证信息。协议类型决定后续出现哪些字段,因此应先选类型再填内容;不要因为某个字段暂时看不懂,就换成名称相近的协议尝试保存。不同协议的参数不能相互替代。

填写时重点核对服务器地址中是否误带空格、端口是否完整、密码或身份字段是否保留原有大小写。若服务信息还提供传输方式、TLS、服务器名称或路径,应按原始说明对应填写,不能只保留地址和密码。保存后返回 Home,在 SERVER 列表确认新条目已经出现。此时只是完成保存,还没有证明服务器能够连接。

使用 Subscribe 导入已有订阅

已有订阅链接时,进入 Config 页,找到 Subscribe 对应的订阅操作入口,按提示粘贴完整链接并确认获取。链接经常含有查询参数,复制时应保留整段内容,不要只复制域名,也不要把聊天消息中的说明文字一起粘贴。若系统请求读取剪贴板,请仅在确认剪贴板中是本次需要导入的信息时允许。

获取完成后回到 Home,检查 SERVER 列表是否出现订阅对应的服务器条目。如果只是 Config 中多出一个配置文件,而 Home 中仍没有可选服务器,应先核对导入内容的类型,不能将“文件已下载”视作“服务器已导入”。不同界面布局中的入口位置可能略有差异,关键是确认操作对象究竟是服务器订阅还是配置文件。

扫码与导入后的检查

手中已有服务器二维码时,可以在 Home 的扫码入口使用 Scan QR Code。首次使用按系统提示给予相机权限,识别后先检查解析出的协议与地址,再确认添加。二维码和订阅链接都可能包含认证信息,不应发布到公开讨论区,也不应把完整内容放入排查截图。导入后先选一个明确的条目继续下一步,不必反复导入同一份订阅;重复条目会增加后续判断的难度。

这一阶段的完成标准是:Home 中存在预期服务器,能够查看其类型和必要参数。订阅链接无法识别、更新后条目为空等情况,留到第五步按获取链路排查;入口差异可另查四种导入入口说明。

STEP 02 / ROUTING

选择 Global Routing 姿态

有了服务器条目,下一步决定请求如何处理。回到 Home,打开 Global Routing,检查当前选项。这里的三种姿态写作配置(Config) / 代理(Proxy) / 直连(Direct)。它们控制请求的处理方式,不是三种连接质量,也不会修改服务器本身的协议或认证参数。

配置(Config):按当前配置处理

选择配置(Config)时,请求交给当前启用的配置规则判断。请到 Config 检查实际选中的文件,而不只是确认文件列表中有某份配置。下载到本地与设为当前配置是两件事;编辑另一份未启用的文件,也不会改变正在使用的规则。首次使用应选择自己理解用途的已有配置,先保留原始内容,避免同时修改大量规则后无法判断问题来源。

规则通常从上到下匹配,命中后采用对应策略。PROXY 表示交由相应代理策略处理,DIRECT 表示直连,REJECT 表示拒绝;末尾的 FINAL 用于承接前面未命中的请求。策略的实际指向还要结合当前配置检查,因此“选择了 Config”并不等于“所有请求都经过当前服务器”。

代理(Proxy):先判断服务器路径

选择代理(Proxy)适合进行一次范围明确的连接验证:在同一网络下,选定一个服务器,再测试一个确定的目标。如果 Proxy 可以访问,而 Config 不可以,排查重点应转向配置文件、规则和策略指向,而不是立即重新填写服务器。测试结束后,根据日常用途切回需要的姿态,避免把临时验证状态长期保留下来。

直连(Direct):区分本地网络结果

选择直连(Direct)时,普通请求不交给所选代理服务器。它可以帮助比较基础网络与代理路径,但不能据此判断远端服务器是否正常。若你期待目标请求经过代理,当前却选择了 Direct,即使连接开关处于开启状态,得到的也可能仍是直连结果。记录选项后再继续,后续每次验证都应保持这个条件明确。

不确定从哪里开始时,可先用 Proxy 判断已有服务器是否能承载目标请求,再用 Config 验证规则。这里不需要编写完整配置;各设置项用途见Global Routing 设置说明,协议参数含义见协议参考。

STEP 03 / CONNECT

选择服务器并打开连接开关

返回 Home,在 SERVER 列表中明确选中准备使用的服务器。不要把“刚刚导入的条目”自动理解为“当前已选条目”,应根据列表中的选中标记再次确认。若服务器较多,先固定一个条目完成验证,暂时不切换其他服务器,这样才能把连接结果与具体参数对应起来。

连接前可使用 Connectivity Test 观察测试结果。测试返回时间值,说明该次测试条件下得到响应,不代表所有网站、所有应用与所有请求都一定成功;出现超时,也应结合测试方法和实际访问继续判断。测试结果用于缩小排查范围,不能替代下一步的页面访问验证。请避免只比较显示数值的大小,却没有检查服务器是否能完成实际请求。

确认服务器与 Global Routing 后,打开 Home 的连接开关。首次连接时,系统会提示是否允许添加 VPN 配置,核对正在操作的应用后选择允许,并按系统要求完成设备密码或其他身份验证。这个授权用于建立系统网络连接配置,与服务器的密码字段不是同一项信息,不要将设备密码填入 Add Server。

授权完成后返回 Home,检查开关是否保持开启,再观察系统连接状态。若开关马上回到关闭状态,先看是否有配置错误、权限提示或其他连接占用,不要连续快速开关。可以先关闭其他正在运行的 VPN 连接,再回到 Shadowrocket 重试;每次只保留一个明确的测试状态,避免系统连接相互切换造成误判。

连接开关保持开启,表示客户端已进入连接状态,不等于远端认证成功,也不等于目标请求已经按预期分流。此时先不要修改 DNS、规则和协议参数,保持当前条件进入下一步,用实际请求验证。若确实需要更换服务器,记录更换前的条目和现象,再重新执行同样的检查过程。

STEP 04 / VERIFY

验证实际访问与规则结果

验证分成三个层次:开关是否开启、目标是否能访问、目标是否走了预期策略。只看系统 VPN 标记,最多能确认系统连接处于某种活动状态;只看一个页面能打开,也可能是该目标原本可以直连。应把具体访问结果与当前 Global Routing、所选服务器和请求记录一起判断。

重新发起一个确定的请求

在浏览器打开你有权访问、且知道正常表现的目标页面,重新加载并等待结果。尽量使用新发起的请求,不要只观察已经加载好的页面或应用缓存内容。首次验证保持同一网络、同一服务器和同一目标,记录页面是正常返回、长时间等待,还是出现明确错误。不同结果指向的排查方向并不一样。

用 Data 核对请求去向

回到 Shadowrocket,查看 Data 中与本次访问对应的请求记录或连接信息,按请求发生时间和目标域名定位。关注实际采用的策略、可见的规则匹配结果及服务器指向,而不是只看是否有数据量变化。设备后台也可能产生请求,因此总流量增长不能单独证明刚才测试的目标已经经过代理。

使用 Config 时,若记录显示 DIRECT,而预期是 PROXY,应回到当前启用的配置检查规则。先确认目标域名是否与规则一致,再看前面是否有更早命中的条目,最后检查策略指向。一个页面可能请求多个域名,首页文档、图片与接口未必命中同一条规则;只改页面地址对应的规则,不一定能改变所有子请求。

通过单一变量比较缩小范围

如果 Config 下访问失败,可保持同一服务器不变,临时切换 Proxy 后重复请求。Proxy 成功、Config 失败时,优先检查规则和当前配置;两者都失败时,再考虑服务器参数、网络连通或目标本身。比较完成后恢复预期姿态,并再做一次访问验证。不要同时切换网络、服务器与配置,否则即使恢复正常,也无法知道是哪项变化产生作用。

完成标准是:实际目标访问符合预期,请求记录中的策略也与预期一致。若需要向他人描述问题,只记录必要的目标现象、姿态和错误文字,隐藏服务器认证字段与订阅链接。涉及规则顺序的进一步解释,可阅读自定义规则与 FINAL 兜底说明。

STEP 05 / TROUBLESHOOT

按失败位置逐项排查

出现问题时,先判断停在哪一步:订阅未导入、服务器测试失败、开关无法保持,还是开关正常但目标访问失败。不同阶段不要混用处理办法。尤其不要一遇到超时就删除全部配置或重装应用,这会丢失原有对照条件,也不能修复失效的服务器信息。

基础网络与订阅获取

先暂时关闭连接,确认设备当前 Wi-Fi 或蜂窝网络本身可用;需要登录的网络应先完成登录。基础网络正常后,再检查订阅链接是否完整、是否仍有效,以及订阅获取是否返回错误。导入后的条目为空,应核对服务信息是否变更或返回内容是否仍是支持的格式。刷新失败时,先保留原有可用条目,不要通过连续重复添加制造更多副本。

订阅更新是在获取新的服务器列表,Connectivity Test 是在测试条目的连通情况,两者并不是同一个动作。更新成功但服务器仍超时,应继续检查服务器;更新失败但旧条目仍能连接,也不能据此判定所有连接已经失效。更新入口和失败原因另见订阅手动更新与自动更新说明。

服务器超时或认证失败

回到 Add Server 对应的编辑界面,按已有服务信息逐项核对协议、地址、端口和认证字段,再检查 TLS、服务器名称、传输方式与路径。不要自行省略看似可选但服务端实际要求的字段。若系统时间明显不准确,先恢复正确时间再测试,时间偏差可能影响证书或认证判断。必要时在你有权使用的另一种网络下测试同一服务器,区分本地网络差异。

测试持续失败时,应向你已有服务的提供方确认服务器状态及参数是否发生变化;提供现象与错误文字即可,不要公开完整链接或认证内容。更换密码、切换协议等操作应有明确依据,不能靠反复随机修改寻找可用组合。完整排查顺序可查节点超时与连接失败检查清单。

开关正常但访问不符合预期

先检查 Global Routing 是否误选 Direct,再确认 Config 当前启用的文件。若 Proxy 正常而 Config 异常,沿着“目标请求 → 首条命中规则 → 策略指向”的顺序检查。若只有某个目标异常,核对该目标的域名解析与请求记录,不要立刻修改全部 DNS 设置;修改前记录原值,每次只改一项,再重复同一个请求。

如果页面文档能打开、图片或接口失败,应分别查看失败资源对应的域名,而不是把整个页面视为单一连接。若系统授权尚未完成,应先处理授权;若开关稳定但远端无响应,应检查服务器和请求路径。把故障准确落在某一层,比同时更改多个设置更容易恢复,也更容易保留可复现的结果。

结束测试并保留可用状态

连接恢复后,确认当前服务器、Global Routing 和启用配置均是准备长期使用的组合,撤回仅为定位问题而添加的临时修改。不需要连接时,可回到 Home 关闭开关;再次使用时,重新确认服务器选择并打开即可。常见入口和权限问题可继续查阅FAQ,协议字段的详细含义请转到协议参考,不必在首次连接时一次调整所有高级设置。