官方手册 · iPhone / iPad 操作示例

Shadowrocket 使用教程

从已有订阅或服务器信息开始,依次完成添加、选择 Global Routing、连接与验证。先跑通一次完整流程,再调整规则和 On Demand。

  • 添加与导入
  • Config / Proxy / Direct
  • 连接与验证

操作前提与步骤跳转

第一次设置时按顺序阅读;已有服务器条目的用户,可以直接从模式选择开始。

下面的图片为 App Store 官方截图,用于辨认界面。截图中的服务器名称或字段值不是需要照填的连接资料;请始终以自己的服务商提供的信息为准。

步骤 01 · Add Server / Subscribe

添加服务器或导入订阅

订阅导入与手动填写是两条路径,选择与你手中资料相符的一条即可。

已有订阅链接:选择 Subscribe

打开 Shadowrocket,进入 Home,在 SERVER 区域找到 Add Server,或使用页面上的添加入口。进入添加页面后,先查看 Type。若手中是一条订阅链接,将 Type 选择为 Subscribe,再把完整链接填入 URL,并在备注位置写一个自己能辨认的名称。备注只用于区分来源,不会改变服务器的连接参数。

粘贴前先检查链接是否完整:聊天工具中的换行、复制时带入的空格、漏掉的问号后内容,都可能使导入失败。订阅地址通常包含个人访问凭据,不要发送到公开评论区,也不要把它放进他人可见的截图。保存后等待导入完成,再回到 Home 查看 SERVER;出现一组服务器条目,才说明客户端已经取得并解析了订阅内容。

如果保存后没有出现条目,先看错误发生在下载链接还是解析内容。能在浏览器中打开某个网页,并不说明这个地址就是可用的订阅地址;登录页面、分享页面与订阅内容不是同一回事。此时先向你的服务商确认链接用途和适用格式,不必反复新建同一条订阅,以免后续难以判断哪个条目才是当前使用的来源。

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

手中若是地址、端口和认证信息,则在 Add Server 中选择与资料一致的 Type。以 Shadowsocks 为例,需要逐项核对 Host、Port、Password 和 Method;换成其他协议时,字段会随 Type 改变,不要为了让表单看起来相似而自行换选协议。Host 填服务器地址,Port 填端口;Password 和 Method 均应逐字对应原始资料。

涉及 TLS 的服务器可能还需要填写服务器名称等参数。不要把订阅 URL 整条放进 Host,也不要把网站的完整路径当作服务器地址。参数不齐时先补齐资料,不建议通过随意关闭验证来绕过报错。扫描现有二维码可使用 Scan QR Code;Import from Cloud JSON 对应的是配置导入用途,不能因为都包含链接就与 Subscribe 混用。

保存后返回 Home,点选要使用的服务器,确认选中标记落在预期条目上。导入完成只是把资料写入客户端,还没有建立连接。接下来先决定流量应按规则、代理还是直连处理,再打开连接开关,这样出现问题时更容易定位。

Shadowrocket Add Server 页面,显示 Type、Host、Port、Password、Method 以及 Scan QR Code 和 Import from Cloud JSON 入口
Add Server:先选择 Type,再填写该类型需要的参数。截图字段不是通用连接资料。
步骤 02 · Global Routing / Config

选择 Global Routing 姿态

先确认模式,再确认规则。服务器选对了,但处理流量的模式不对,访问结果仍可能不符合预期。

回到 Home,点开 Global Routing。首次使用重点区分三种姿态:配置(Config)/代理(Proxy)/直连(Direct)。它们控制客户端接管的流量如何处理,不负责替你补全服务器参数,也不能把不可用的服务器变成可用。测试时记住当前选择,避免切换后忘记恢复。

配置(Config):按照当前配置匹配

日常需要规则分流时,选择配置(Config),再进入 Config 确认使用的是哪份配置文件。打开配置编辑页面,可以看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。入门阶段先关注 Rule 和当前配置的选择状态,不必同时调整所有分段;尤其不要为了完成首次连接而改动与本次目标无关的 HTTPS Decryption。

Rule 中的规则按顺序匹配,前面已经命中的流量不会继续交给后面的普通规则处理。下面仅用两行说明“指定域名走代理,其余直连”的结构。example.com 是说明用域名,不是服务器地址;PROXY 是策略写法,使用前应核对当前配置中的对应策略与目标。

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

这段示例的关键是顺序:域名规则在前,FINAL 兜底在后。若把 FINAL 提前放置,后续规则就可能得不到预期匹配机会。已有可用配置时不必照抄示例;要新增规则,可以从 Rule 分段进入 Add Rule,并在保存后确认编辑的是当前实际使用的配置,而不是另一个同名文件。

代理(Proxy)与直连(Direct):用于明确处理路径

代理(Proxy)让客户端接管的流量采用代理路径,适合在短时间内检查所选服务器能否完成实际访问。直连(Direct)则采用直连路径,不能用它来判断代理服务器是否工作。两者都不应被理解成“自动修好网络”的开关;网站是否可达还取决于基础网络、服务器状态和目标服务。

如果 Proxy 下可以访问,而 Config 下同一目标失败,下一步应查规则命中与策略目标,而不是重新导入订阅。关于规则范围和更复杂的模式选择,可以继续阅读代理模式说明;首次上手先保留一份能辨认、能恢复的配置即可。

Shadowrocket Config 配置编辑页面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config 配置编辑页:Global Routing 选择 Config 后,还要确认当前配置文件及 Rule 内容。
步骤 03 · Home

打开开关并建立连接

连接之前再看一次服务器选择和模式;首次连接还需要完成系统授权。

完成前两步后回到 Home,检查 SERVER 中的选中条目,再看 Global Routing 是否为刚才决定的姿态。若列表里有多个相似名称,先点开条目核对地址或备注,不要只凭排列位置判断。列表更新后位置可能变化,名称相似也不表示参数相同。

打开 Home 顶部连接开关。首次使用时,iPhone 或 iPad 会显示添加 VPN 配置的系统提示。阅读提示并确认后,按设备要求完成密码或生物识别认证,再返回 Shadowrocket 查看状态。这里授予的是在设备上建立网络隧道所需的权限,不会附带连接服务,也不等于已经验证所选服务器可达。

如果此前拒绝了系统提示,开关可能无法保持开启。先重新触发连接流程并留意系统弹窗,不要连续快速点按开关。若系统已经存在其他 VPN 连接,先关闭其他连接再重试,避免两套连接同时争用网络路径。受管理的设备可能有组织配置限制,此类限制需要由设备管理方确认,反复修改节点参数通常无效。

当开关能够保持开启、页面不再显示 Not Connected 时,可以开始下一步验证。系统显示 VPN 状态只能说明隧道已经建立,并不能单独证明所有网站都采用代理路径。Config 下某些目标按规则直连本来就是正常结果,因此不要把“浏览器能打开页面”直接当作所有规则都正确的证据。

若开关刚开启就立即回落,先记录是否出现授权提示或错误文字,再检查系统权限与当前配置;若开关保持开启但网页打不开,则保留当前状态进入验证与排错,不要同时删除服务器、替换配置和改 DNS。把问题分成“隧道能否建立”与“连接后能否传输”,能够减少重复操作。

iPad 的基本流程与 iPhone 一致。分屏或横屏使用时,先确认焦点在 Shadowrocket,系统授权完成后返回 Home 查看最终状态;不要因为应用切到了后台就认定授权失败。需要结束本次测试时,再回到顶部关闭连接开关。

Shadowrocket Home 页面,顶部显示 Not Connected 开关,下方为 Global Routing、Connectivity Test、SERVER 和 Add Server
Home:检查 SERVER 与 Global Routing 后再打开顶部开关。Connectivity Test 用于下一步验证。
步骤 04 · Connectivity Test

验证连接与分流结果

把服务器测试、隧道状态和实际访问分开看,才能知道成功的是哪一层。

先在 Home 点 Connectivity Test,等待结果返回。测试可用于发现明显不可达的服务器,但某种测试通过并不能保证每个网站都能访问,某种测试失败也需要结合测试方法解释。不要只按结果中的数值大小决定配置是否正确;这里首先要确认的是测试能否完成,以及结果是否稳定重复出现。

随后打开浏览器,访问一个你原本就需要验证的网站。首次验证建议固定一个目标,记录能否加载、是否只有部分资源失败,以及等待后出现什么错误。页面缓存可能掩盖路径变化,切换模式后可以重新加载页面;若应用保留已有连接,应关闭该次访问后重新发起请求,而不是仅观察一个已经打开的页面。

在配置(Config)下,验证还要包含规则方向。需要走代理的域名,应命中对应代理策略;应直连的目标,则应保持直连。如果页面能打开但路径不符合预期,回到 Config 检查 Rule 的顺序与目标策略。一个页面可能同时请求多个域名,只给主域名写规则,不一定涵盖页面加载的其他资源。

为了缩小范围,可以保持同一个服务器和测试网站不变,临时把 Global Routing 从 Config 切到 Proxy,再重新发起访问。若 Proxy 可用而 Config 不可用,优先查看规则、DNS 与策略引用;若两种姿态都失败,优先查看服务器参数和基础网络。比较结束后恢复原来的模式,避免临时测试设置变成日常设置。

最后做一次基础对照:关闭 Shadowrocket 连接,确认普通网络本身能否访问日常使用的网站。若关闭后同样失败,先处理 Wi-Fi 登录、蜂窝数据权限或网络本身的问题。完成对照后,再按原设置连接一次。每次只改变一个变量,比连续更换多个设置更容易确认是哪一步真正影响结果。

步骤 05 · Settings / Diagnostics

按失败位置检查设置

先找到失败环节,再修改对应参数。入门阶段不需要逐项尝试 Settings 中的所有开关。

导入失败:检查链接与内容

如果停在第一步,先检查订阅链接是否完整、是否仍有效,以及当前基础网络能否访问该地址。已经导入过的订阅,更新失败与现有条目失效并不是同一件事;先保留现有条目,记录报错,再向你的服务商确认链接状态。需要重新导入时,先辨认旧订阅名称,避免把重复条目误认为新增了不同服务器。

手动添加后始终无法通过测试,则回到 Add Server,按 Type、Host、Port、认证参数的顺序检查。密码中的大小写、Method 的选项,以及 TLS 相关名称都可能影响连接。优先与原始资料逐项比对,不要根据别人的截图推测参数,更不要把不同服务器的字段拼在一起。

测试失败:先看 Test Method

进入 Settings 查看 Test Method,确认当前测试方式,再理解 Home 中的 Connectivity Test 结果。不同方式检查的环节可能不同,不能把某一种测试的失败直接解释为整个服务器永久不可用。先固定测试方式,比较同一服务器在同一网络下的表现,再结合实际访问判断;不要在每次测试前同时换模式、换网络和换测试方法。

开关反复变化:检查授权与 On Demand

开关无法保持时,先确认步骤三的系统授权已完成,并关闭其他正在运行的 VPN 连接。若连接在切换 Wi-Fi、锁屏或重新打开应用后自动改变,进入 Settings 查看 On Demand。按需连接条件可能触发重新连接;临时排查时先记下原设置,再暂停相关条件,使用手动开关复测,确认原因后恢复需要的设置。

不要直接删除设备上的全部网络配置,尤其是包含工作或学校管理设置的设备。若系统禁止添加 VPN 配置,应先确认管理限制;若没有这类限制但错误持续出现,记录系统提示和触发步骤,再继续深入排查。

已连接但访问失败:保留可复现条件

连接保持开启但页面打不开时,先比较 Config 与 Proxy,再区分是所有目标失败还是单个目标失败。如果 IP 连接和域名访问表现不同,才进一步检查 DNS;不要把来历不明的 DNS 地址反复填入配置。页面能加载文字却缺少图片,也可能是资源域名未命中预期规则,而不是整个代理失效。

Settings 中的 Diagnostics 可作为收集错误信息的入口。复现问题后记录发生步骤、网络类型、所选姿态和错误文字;对外提供诊断材料前,先检查是否包含订阅链接、服务器地址、密码或其他个人信息。Proxy、TCP、UDP 等项目涉及更细的连接行为,首次上手不建议为了试错而一次改动多项。

走完以上检查仍不能确定原因,可进入故障排查大全,按开关、超时、订阅、DNS 等症状继续阅读。购买、恢复和常见操作疑问放在问答页。保留一组可以重复描述的现象,比笼统地说“连接不了”更有助于找到下一步。

Shadowrocket Settings 页面,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:先查看 Test Method、On Demand 与 Diagnostics。修改前记录原值,复测时一次只改一项。

其他设备的获取入口

上面的操作以 iPhone / iPad 为例。iPhone / iPad 版在 App Store $2.99 一次性付费;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。其他设备的安装包由本站下载页提供,安装包路径统一位于本站 /dl/shadowrocket/。

系统感知按钮会按当前设备展示获取选项;Mac 不自动猜测芯片,请先在“关于本机”查看。首次安装遇到系统拦截时,先阅读下载页的安装放行说明,再按对应系统操作。

当前版本 · iPhone / iPad $2.99 一次性,Mac、Windows、安卓、Linux 免费