官方手册 · 首次配置

Shadowrocket 使用教程

quick-start

已有配置导入 → 选择分流模式 → 连接与验证。按五步完成首次使用,再根据失败位置逐项检查。

添加服务器与订阅导入

01 / import

先判断手里的资料属于哪一种。订阅链接通常是一个用于获取服务器列表的地址;单条服务器分享内容只描述一个连接;手动参数则包含协议、地址、端口及认证信息。三者的用途不同,不要把订阅地址填进 Host,也不要把用于查看说明的网页地址直接当作订阅链接。无法确定时,先向自己的服务商确认资料类型。

已有订阅链接:选择 Subscribe

打开 Home(主页),点击右上角添加入口或 SERVER(服务器分组)中的 Add Server(添加服务器)。进入后点击 Type(类型),选择 Subscribe(订阅),把自己的完整订阅链接填写到 URL 地址字段。为这条订阅设置一个便于辨认的备注,然后保存。返回 Home,等待列表获取完成,再检查该订阅下是否出现服务器条目。

粘贴前后分别检查一次链接边界,尤其是开头和结尾。聊天内容中的说明文字、换行和多余空格可能一起被复制;地址中的查询参数也可能被截断。不要自行删除看起来复杂的参数,它们可能用于识别你的订阅。订阅地址应按账户凭据保管,不要贴到公开留言、截图或在线转换页面。

保存订阅并不等于订阅已成功更新。若只有分组名称而没有服务器,先进入该订阅的操作入口尝试更新,再检查链接是否仍有效、当前网络能否取得内容。此时不必调整 Global Routing;导入尚未完成,后续模式切换不能补齐空列表。也不要连续创建多条相同订阅,以免之后无法判断正在使用哪一份。

已有服务器参数:按 Type 填写

如果拿到的是逐项参数,在 Add Server 里先选择正确的 Type,再填写 Host(服务器地址)和 Port(端口)。截图展示的是含 Password(密码)与 Method(加密方法)的字段组合;不同协议会显示不同字段,不能照着截图给所有协议填写同一套内容。Host 一般填写服务商给出的域名或 IP 地址,而不是整条网页链接。

认证信息、加密方法、传输方式和 TLS 相关参数都要与服务器端一致。协议名相近不表示字段可以互换,也不要凭经验猜测缺失项。填写后保存,返回 Home,在 SERVER 中确认新条目存在。若已有二维码,可使用 Scan QR Code(扫描二维码);Import from Cloud JSON(从云端 JSON 导入)只用于对应格式的资料,不是通用订阅入口。

本步完成的标准是:列表中已有可选择的服务器,且来源与备注能被辨认。先选择一个资料确认完整的条目,再进入下一步。需要理解具体协议字段时,查看协议详解,不必在首次连接时修改所有高级选项。

Shadowrocket Add Server 添加服务器页,展示 Type、Host、Port、Password、Method 以及扫描导入入口
Add Server:先选 Type,再填写对应字段。截图中的字段不代表所有协议。

Global Routing 三种姿态

02 / routing

服务器条目准备好后,回到 Home,点击 Global Routing(全局路由)查看当前处理方式。这个选项决定连接采用哪一类策略,并不负责下载订阅,也不会修复错误的服务器密码。首次使用应先理解三种姿态,再决定是否需要编辑配置文件。

  • 配置(Config):依据当前配置文件中的规则决定连接如何处理。需要按域名或地址区分代理与直连时使用,但前提是已启用符合预期的配置文件。
  • 代理(Proxy):将可接管的连接交给代理策略处理,适合短时判断服务器连接是否可用。它并不意味着每个应用的所有网络行为都必然经过同一条路径。
  • 直连(Direct):连接采用直连方式,不使用代理服务器转发。需要临时对照本地网络访问结果时可以选择;选中它之后,不应再用代理访问效果判断服务器是否正常。

Config 模式与 Config 页面分别看什么

Global Routing 中的 Config 是处理模式;底部 Config(配置文件)页面用于管理和编辑配置内容。两者名称相同但层次不同。准备使用规则分流时,进入 Config,确认当前选中的文件,再打开它查看 Rule(规则)部分。截图中的 General(通用设置)、Hosts(主机映射)、URL Rewrite(地址重写)和 HTTPS Decryption(HTTPS 解密)属于其他配置部分,首次连接不需要逐项开启。

Rule 通常按从上到下的顺序匹配,首条命中后使用相应策略。DOMAIN-SUFFIX 用于域名后缀匹配,IP-CIDR 用于地址网段匹配,FINAL 是前面的规则均未匹配时的兜底。DIRECT 表示直连,PROXY 表示代理策略。检查规则时不仅要看有没有目标域名,还要看它上方是否有更宽泛的规则先命中。

本教程不要求新建整套规则。已有可信配置时,确认选中状态和规则内容即可;仅有服务器参数、还不能判断配置是否正确时,可以先用代理(Proxy)完成一次连通性对照,验证后再切回配置(Config)。不要同时替换服务器、修改规则和调整 DNS,否则即使访问结果改变,也难以判断是哪项修改起作用。规则关键字的简明定义可查术语表。

Shadowrocket Config 配置文件编辑页,展示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config:在 Rule 中核对分流规则;Global Routing 的选择仍在 Home 完成。

Home 打开连接

03 / connect

完成模式选择后回到 Home,在 SERVER 分组中点选准备使用的服务器。确认选择标记落在预期条目上,再核对 Global Routing 当前显示的值。订阅里有多个条目时,导入成功并不表示应用一定选中了你刚添加的那一个;连接前的这次确认可以避免用错旧条目。

打开页面顶部 Not Connected(未连接)旁的开关。首次使用时,系统可能弹出添加 VPN 配置的授权提示。确认请求来自 Shadowrocket 后选择允许,并按系统要求完成密码或设备身份验证。这一步是让系统建立本地网络接管配置,与填写服务器账户不是同一件事;系统密码不应输入到服务器的 Password 字段。

返回应用后,等待顶部状态变化。若先前拒绝了授权,开关可能无法保持开启;此时重新发起连接,按系统提示检查 VPN 配置权限,不要通过重复导入订阅处理授权问题。若设备受组织管理且限制了 VPN 配置,应先确认设备管理规则,而不是反复尝试更改服务器字段。

开关开启和系统显示 VPN 状态,只能说明本地网络接管已经启动,不能单独证明远端服务器能访问,也不能证明每条规则都按预期命中。即使密码错误或目标服务不可达,本地状态也可能与实际访问结果不同。保持当前服务器和模式不变,进入下一步验证,先建立一组可复现的结果。

需要停止时,回到 Home 关闭顶部开关,并确认状态回到未连接。首次排查期间不必开启 On Demand(按需连接);如果它原本已启用,后续应留意网络条件是否会再次触发连接。让连接开关、所选服务器和模式保持明确,比反复切换多个条目更容易定位问题。

Shadowrocket Home 主页,展示 Not Connected 开关、Global Routing、Connectivity Test 和 SERVER 添加入口
Home:确认服务器和 Global Routing 后,再打开顶部连接开关。

连接测试与生效验证

04 / check

先在 Home 使用 Connectivity Test(连通性测试),观察当前条目是否返回结果。该测试的含义与 Settings 中的 Test Method(测试方法)有关:不同方法检查的目标和网络层面不同。因此,有响应不等于网页一定能完整打开;没有响应也不能立刻证明服务器的所有功能都不可用。先记录结果,再结合真实访问判断。

把“能连接”和“规则正确”分开验证

打开浏览器,访问一个你原本就需要使用、地址明确的目标页面,观察是否能完成加载。再访问一个预期直连的页面,确认普通网络访问仍然正常。测试时尽量使用新的页面请求,避免仅凭缓存页面判断。若只有某个应用异常,先确认浏览器的访问结果,不要立即把局部问题归结为整个连接不可用。

接着回到 Shadowrocket,打开 Data(数据记录)查看本次请求对应的连接信息;在可查看的请求详情中核对目标、规则及处理策略。使用配置(Config)时,预期直连的请求应对应 DIRECT,预期代理的请求应进入相应代理策略。目标页面能打开,只说明有一条可用路径,不能代替规则命中检查。

若需要对照,可在保持同一服务器的情况下,短时比较配置(Config)与代理(Proxy)。代理(Proxy)可用而配置(Config)异常,通常应优先检查当前配置和匹配顺序;两者都失败,则继续检查服务器参数、本地网络与远端状态。测试结束后恢复准备日常使用的模式,不要把排查期间的临时选择当作最终配置。

当服务器可用、实际目标访问正常、规则处理也符合预期时,首次配置就完成了。此时可保留当前有效配置,再逐步研究按需连接或更细的分流规则。不要为了寻找某个“最佳参数”一次调整大量高级选项;后续修改前保留可恢复的配置副本,并妥善保管其中的连接凭据。

按失败位置逐项排查

05 / diagnose

先把问题归到导入、连接、访问或规则四个环节,再处理对应条件。保存不成功、SERVER 列表为空、开关无法开启、页面无法加载并不是同一种故障。保留当前报错文字,不要一开始就删除全部配置或重置所有设置;那样会丢失有效的对照信息,也可能让原本可用的条目一并消失。

导入失败或列表为空

回到订阅设置核对完整 URL,检查是否误用了普通网页地址,以及复制时是否丢失参数。确认当前网络可以访问订阅地址,并向自己的服务商确认订阅状态。返回的是登录页、错误说明或不受支持的内容时,重复更新不会把它变成有效配置。可保留订阅备注并记录错误提示,不要把包含凭据的链接公开发送。

测试失败或连接后不能访问

手动添加的条目先核对 Type、Host、Port 和认证字段,再检查 TLS、传输方式等附加参数是否完整。若本地网络本身无法正常访问普通页面,先处理 Wi-Fi 或蜂窝网络。随后可在保持同一条目和同一模式的情况下更换网络做对照。连接测试成功但网页失败时,还要检查域名解析和目标服务状态,不能只看一次测试数值。

部分页面异常或模式切换后结果不同

先确认 Global Routing 没有停留在直连(Direct),再核对 Config 中实际启用的配置文件。配置(Config)下某个目标异常而代理(Proxy)下正常时,重点查看对应请求命中了哪条 Rule。具体域名规则应放在可能提前命中的宽泛规则之前,FINAL 通常作为末尾兜底。先找出实际命中项,再决定是否调整,不要直接删除整组规则。

Settings 中只检查与现象有关的项目

进入 Settings(设置)后,可查看 Test Method 来理解 Connectivity Test 的测试口径;检查 On Demand 是否按当前网络条件触发了连接;需要更多线索时再使用 Diagnostics(诊断)。截图中的 Proxy、TCP、UDP 是不同设置分组,不是遇到问题就必须全部修改的开关。排查前记录原值,调整后立即复测,不符合预期时恢复。

如果问题仍存在,整理发生时间、网络类型、所选协议、当前模式和具体报错,再与自己的服务商核对服务器侧状态。分享截图或诊断文本前,应遮去订阅 URL、密码、认证标识和其他个人信息。更多现象可到常见问题按类别查找;协议参数含义与选型差异请转到协议详解,首次上手不必在这里展开整套技术设置。

Shadowrocket Settings 设置页,展示 Test Method、On Demand、Diagnostics 及 Proxy、TCP、UDP 设置分组
Settings:根据失败现象检查相关项目,修改前保留原值。

其他设备与获取入口

get

上面的界面步骤以 iPhone / iPad 为例。Shadowrocket 同时提供 Mac(Apple 芯片与 Intel)、Windows、安卓和 Linux 版本。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。安装包由本站下载页提供,地址位于本站 /dl/shadowrocket/ 路径。

当前版本 读取中 · iPhone / iPad $2.99 一次性,其他平台免费

需要重新核对 iPhone / iPad 应用时,请查看下载页的正版核验:开发者为 Shadow Launch Technology Limited,应用 ID 为 932747118,图标以官方商店展示为准。