官方手册 · 首次设置

Shadowrocket 使用教程

从导入已有资料到验证实际访问,按五步完成首次连接。每一步先确认结果,再继续下一步。

01 导入资料

用 Add Server 或 Subscribe 导入

打开 Shadowrocket,在 Home 的 SERVER 区域找到 Add Server。先分清手里的资料:订阅地址用于获取一组服务器,手填参数用于添加单台服务器,二维码则要看它实际包含的是哪一种资料。三种方式选其一即可,首次操作不必把同一份资料重复导入。

如果已有订阅地址,打开 Add Server,在 Type 中选择 Subscribe,将完整地址粘贴到 URL 后保存。不要漏掉地址末尾的查询参数,也不要把订阅地址当作单台服务器的 Host。返回 Home 后,展开对应的订阅分组,确认里面出现了可选条目。保存动作完成但分组仍为空时,先核对链接是否完整,再确认订阅是否能正常更新。

如果已有单台服务器的参数,先选正确的 Type,再填写该协议要求的字段。以截图里的 Shadowsocks 为例,需分别核对 Host、Port、Password 和 Method。把地址和端口分开填,密码前后不要混入空格,并以已有资料中的 Method 为准。换成其他协议后字段可能不同,不要照着截图补填该协议没有要求的内容。

如果拿到的是自己的二维码,可从 Add Server 选择 Scan QR Code。识别后先核对导入结果,再返回 Home。二维码和订阅地址都可能含有凭据,请勿截屏公开。最后在 SERVER 下点选一条要验证的服务器,记下分组和条目名称,避免下一步对照时认错同名条目。更多字段说明见节点管理手册的 Add Server 章节。

Add Server 官方界面,显示 Type、Host、Port、Password、Method 与 Scan QR Code 入口
Add Server:截图展示 Shadowsocks 的字段,实际表单由 Type 决定。
02 路由方式

选择 Global Routing 姿态

条目已经选中后,回到 Home,点开 Global Routing。选中服务器解决的是“要用哪条线路”,路由姿态解决的是“这次请求要不要用代理”。两处设置各自生效:列表里选中了条目,不代表每个请求都会经它转发。

  • 配置(Config):按当前配置文件匹配请求。适合已经知道哪些地址应走代理、哪些应直连的情况。若目的地址没有命中前面的规则,应继续检查末尾的 FINAL,判断未匹配请求的处理方式。
  • 代理(Proxy):让客户端接管的请求使用代理路径。首次诊断时可短暂使用它验证已选线路,帮助区分“线路本身不通”和“配置把请求送往另一条路径”。验证结束后再恢复平时使用的姿态。
  • 直连(Direct):让请求不经代理服务器,用于观察当前网络直接访问的结果。它不是关闭 Home 的连接开关,不能用来代替断开连接。

如果选择 配置(Config),到 Config 核对实际启用的是哪个文件;需要确认规则时,打开该文件查看 Rule。截图展示的是配置文件编辑页,不是 Global Routing 选择菜单。不要仅凭文件名字判断规则效果,也不必为了首次连接去改动 URL Rewrite 或 HTTPS Decryption。

例如,若某个域名后缀在 Rule 中指向 PROXY,可以用一个实际属于该后缀的已知页面来验证。若只想先验证服务器是否能转发,先用 代理(Proxy),连通后再回到 配置(Config) 检查分流。确定这次测试要用的姿态后,返回 Home 查看显示值是否已更新。

Config 文件编辑官方界面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config 文件编辑页:从 Rule 查看规则;切换路由姿态要返回 Home。
03 建立连接

打开 Home 的连接开关

在 Home 先确认两项:SERVER 中选中的条目没有变化,Global Routing 显示的是刚才选定的姿态。然后打开顶部 Not Connected 旁的开关。首次使用时,系统可能提示添加 VPN 配置。确认弹窗是本次由 Shadowrocket 发起的请求,再按系统提示确认;如需设备验证,在系统界面内完成即可。

回到 Home,等待开关进入开启状态。如果开关刚打开又退回关闭,先看有没有权限提示或错误信息,不要连续点按。如果此前取消了系统提示,可留意再次打开时是否出现同样的请求;若设备由组织管理且限制 VPN 配置,先确认设备的管理要求,不要删除已有配置来试错。

如果设备同时在使用另一个 VPN 配置,测试前先确认它是否占用了当前连接。只调整自己可管理、也允许临时断开的连接。设备刚加入需要登录的无线网络时,可先关闭 Shadowrocket 并完成网络登录,再返回 Home 开启连接。这样能避免把网络本身未就绪误判成服务器不可用。

开关保持开启,说明客户端连接已启动;它不代表浏览器的目标页面已经可访问,也不能说明请求一定走了代理。比如 配置(Config) 可能把目标分到 DIRECT。因此这一步只确认开关状态,暂时保持选中的服务器和路由姿态不变,下一步用同一组条件验证实际请求。

Home 官方界面,显示 Not Connected 开关、Global Routing、Connectivity Test 和 SERVER 分组
Home:先核对 SERVER 和 Global Routing,再操作顶部开关。
04 验证结果

用 Connectivity Test 和实际访问验证

保持当前网络、服务器条目和路由姿态不变,在 Home 点 Connectivity Test。它回答的是“在当前测试方式下,条目能否完成探测”。出现延迟数值,说明这次探测有响应,但不代表所有域名都能解析,也不代表目标应用里的请求走了代理。若出现超时,先核对测试的是哪一项,不要拿另一条记录的结果替代。

接着打开浏览器,访问一个本来就知道可用的页面。如果验证的是 配置(Config),可再选一个明确应直连的页面作对照。尽量使用重新加载的页面或发起新的请求,不要只看已打开的标签页;页面仍能阅读有时只是内容来自缓存。无需为了验证去访问陌生网站,也不要提交账号资料来测试连通性。

回到 Shadowrocket 后,按刚才访问的时间和目标域名查找新记录;若当前界面显示处理策略,再核对是 PROXY 还是 DIRECT。页面能打开且策略符合预期,才足以确认这次路由设置达到了目的。如果只需要证明设备当前能访问某个页面,则不用把流量计数变化当作额外的通过条件。

要对照两种姿态时,只改 Global Routing,保留同一服务器和同一测试页面。若 代理(Proxy) 下正常、配置(Config) 下失败,优先检查 Rule;两个姿态都失败,再检查服务器参数、设备网络及目标页面状态。问题可复现时,记下失败出现在哪一步,接着按下节排查。

05 常见失败

用 Settings、Diagnostics 和 Data 排查

先找出最早出现异常的步骤。如果连条目都没有出现,优先回到导入步骤核对地址是否完整、Type 是否选对,以及订阅分组能否正常加载。切换路由不会修复导入失败。如果条目存在但开关无法保持开启,则先检查系统提示和设备权限;这时修改规则也不能解决连接没有启动的问题。

如果开关稳定开启,只有 Connectivity Test 的结果异常,打开 Settings 查看 Test Method。不同测试方式不宜直接比较,复测时先沿用同一方式。如果只有个别页面打不开,可在 Settings 找到 Diagnostics,结合访问记录区分域名解析失败与解析之后的连接失败。前者先查 DNS,后者再按 Global Routing、命中规则和服务器参数的顺序核对。具体解析现象见 DNS 解析失败排查。

Data 用于观察流量统计。测试前后可对照统计值是否变化,但设备后台也可能产生流量,计数增加不能单独证明某个页面走了 PROXY。定位单次请求时,应优先核对时间、域名与策略。如果切换无线网络或锁屏后状态与预期不符,再到 Settings 检查 On Demand 是否影响设备的自动连接行为;它不决定单个域名的规则命中结果。

每轮只改一项,然后用同一个页面复测。若调整无效,先恢复该项再检查下一项,避免多处改动叠加。记录故障时,保留连接状态、路由姿态和可脱敏的错误文字即可,不要带上订阅地址、密码、二维码或完整连接记录。需要整理多组订阅、更新条目或备份服务器资料时,继续查阅节点管理手册。

Settings 官方界面,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:核对 Test Method,并按故障现象查看 Diagnostics 或 On Demand。