iPhone / iPad
在商店产品页先核对开发者、图标和应用 ID,再查看兼容性。系统要求以 App Store 页面标注为准。同一购买账号在另一台兼容设备上使用时,先检查已购项目。
App Store $2.99 一次性官网与官方手册
Shadowrocket 是支持规则分流的全平台客户端,可导入已有服务器或订阅,再按配置决定请求如何处理。
当前版本 v2.2.92 ·iPhone / iPad 在 App Store $2.99 一次性;Mac / Windows / 安卓 / Linux 免费
01 Platforms
先选设备,再按系统和处理器类型确认入口。iPhone / iPad 在 App Store $2.99 一次性付费;Mac / Windows / 安卓 / Linux 版免费,安装包在本站下载页提供。
在商店产品页先核对开发者、图标和应用 ID,再查看兼容性。系统要求以 App Store 页面标注为准。同一购买账号在另一台兼容设备上使用时,先检查已购项目。
App Store $2.99 一次性打开「关于本机」,查看显示的是 Apple 芯片还是 Intel 处理器,再选对应的 DMG。设备名称和外观不能用来判断芯片类型;换了电脑,需要重新核对。
免费 · Apple 芯片 / Intel下载页提供 64 位安装程序。下载前可在系统设置的设备规格中核对系统类型。若系统弹出提示,先回到下载页核对文件来源,再阅读对应的放行说明。
免费 · 64 位按设备架构选用 arm64 安装包。如果应用内浏览器没有开始下载,用系统浏览器重新打开本站下载页。若系统要求授权,先核对来源,再查看下载页关于安装权限的说明。
免费 · arm64根据发行版的包管理方式选 deb 或 rpm,也可查看 AppImage 入口。先核对发行版和处理器架构;如果选择 AppImage,下载页另有授予文件执行权限的说明。
免费 · deb / rpm / AppImage02 Capabilities
服务器条目决定连接的目标,Global Routing 决定请求如何处理。先分清这两层,再按下列界面入口检查。协议参数的含义和适用条件见技术参考。
Routing
在 Home 的 Global Routing 选择 Config,应用会按当前配置中的规则处理请求;Proxy 和 Direct 则把处理方式分别设为代理或直连。需要给某类域名单独指定走向时,先在 Config 核对匹配条件和规则顺序,再看末尾的 FINAL。若请求未按预期分流,先确认实际访问的域名和命中的规则,不要只根据地址栏里的页面名称判断。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
Connection
在 Settings 查看 On Demand,并根据当前界面提供的条件配置自动连接。调整之后,先保持服务器条目和分流模式不变,再切换一次网络,观察是否按预期触发。若设备比预期更频繁地重连,先区分是网络变化触发,还是服务器连通性不稳定,再决定是否缩小触发范围。只有偶尔使用时,也可以保留手动连接,避免把自动触发和规则排查混在一起。
On Demand
Protocols
Shadowrocket 支持 Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等协议。手动添加时,先在 Add Server 的 Type 选定协议,再按服务商提供的信息填写 Host、Port 和该协议所需的字段。名称相似的字段不一定能互换:密钥、标识符、密码应分别放在对应位置。遇到握手失败,先核对配置原值与传输设置,而不是随机更换 Type。
VLESS
WireGuard
Subscription
已有订阅链接时,在添加界面的 Type 选择 Subscribe,粘贴由服务商提供的完整链接,保存后回到 Home 确认 SERVER 分组是否出现。更新后若条目变化,重新确认当前选中的服务器,避免仍在测试已被移除的条目。导入失败时,先检查链接是否被截断、是否混入空格,再确认服务端是否仍返回可用内容。订阅地址可能含访问凭据,不应公开分享。
Subscribe
SERVER
Configuration
到 Config 查看当前启用的配置文件。编辑时,先区分 Rule 与 Hosts 等分段,不要把域名匹配规则写进地址映射段。改动前保留可用副本,一次只调整一条规则,测试命中结果后再继续。换机时,如果已启用 iCloud 同步,也要核对新设备显示的文件和启用状态;文件出现在列表中,并不代表 Global Routing 正在使用它。
Config
Rule
Diagnostics
先在 Home 对选定条目运行 Connectivity Test,再用一个常见目标确认应用访问是否符合预期。测试成功仅表明该次测试通过,不能证明每个应用都命中了同一规则。需要继续定位时,结合 Settings 中的 Diagnostics 检查请求;Data 的流量统计适合观察用量变化,但不能代替规则命中记录。分享诊断结果前,先移除账号、地址中的凭据和私人访问记录。
Connectivity Test
Data
如果普通访问和单个应用的结果不一致,先检查 Global Routing 的当前选项,再回到 Config 核对影响该目标的规则。只有在连接稳定、配置文件正确而某个目标仍不符合预期时,才值得单独调整该目标的规则。
查看代理模式说明03 Quick start
以下步骤以 iPhone 和 iPad 的界面为例。先准备自己的服务器信息或订阅链接,完成一次手动连接;确认基础配置可用之后,再设置自动连接。
打开 Home,从 Add Server 进入添加界面。手动添加单个服务器时,先选与服务端一致的 Type,再填入 Host、Port 及协议需要的字段;已有订阅链接时使用 Subscribe。保存后回到 SERVER,检查条目是否出现,并明确选中这次要测试的条目。
如果保存正常但列表为空,先检查链接是否完整、分组是否已展开。条目能显示,只说明客户端读取到了配置,还需要用下一步和连接测试确认它能工作。
按规则处理请求时选 Config,并确认当前启用的配置文件;临时排查时,可对同一目标分别用 Proxy 与 Direct 对比。用同一个服务器、同一网络和同一目标测试,才能判断结果变化来自模式切换,而非其他条件改变。
如果 Proxy 能访问而 Config 不符合预期,先看规则是否匹配,以及更靠前的规则是否先命中;如果两种方式都失败,再检查服务器地址、端口和协议参数。测试结束后切回原本要使用的模式。
在 Home 打开连接开关。首次使用时,按系统提示确认添加必要的 VPN 配置,再返回应用看连接状态。先运行 Connectivity Test,再实际访问一个熟悉的目标,观察是否符合所选模式或规则。
若连接开关打开但目标无法访问,记录当前模式、选中条目和失败现象。先确认系统网络本身可用,再逐项测试;不要同时更换服务器、网络和规则。连接验证完成之后,才开启 On Demand 或调整自动触发条件。
故障排查时,先记下问题发生在导入、保存、连接还是实际访问阶段。这四个阶段需要核对的信息不同,明确失败位置后再改设置,通常比清空配置重新开始更容易找到原因。
查看完整教程04 Verification
商店内核对产品身份,本站下载页核对安装包入口。两类平台的更新与重装方式也不同。
从App Store 产品页核对三处信息:产品图标与左侧官方图标一致,开发者显示为 Shadow Launch Technology Limited,产品页地址末尾为 id932747118。图标的白底和蓝紫描边可帮助辨认,但图标或名称相似并不能代替另两项核对。
从搜索结果进入时,先打开产品详情页再检查,而不是根据缩略图判断。如果产品页仍可显示,往下查看兼容性,再决定是否在当前设备上安装。iPhone / iPad 的系统要求以 App Store 页面标注为准。
App Store 按账号所属的国家或地区展示可用应用。切换系统语言、修改设备的地区格式和改变当前网络,都不等于更改商店账号所属地区。中国大陆商店搜不到时,先在设备设置中打开当前账号的「媒体与购买项目」,查看账号的国家或地区,再结合产品页提示判断。
网页能打开产品介绍,并不表示当前账号所在商店可以购买。若已确认产品 ID 正确,而商店提示所在地区不可用,应以当前商店显示为准;名称相近的搜索结果不是同一个产品条目。
Shadowrocket 是闭源商业应用。iPhone / iPad 在 App Store $2.99 一次性付费,美区以外以所属商店显示为准;Mac / Windows / 安卓 / Linux 版免费。iPhone 与 iPad 共用同一 App Store 购买记录:用原购买账号登录商店,在已购项目中查找 Shadowrocket,再下载到兼容设备。
若没看到下载入口,先核对「媒体与购买项目」使用的是否为原购买账号,并查看当前商店及设备兼容性。恢复应用与恢复配置不同:旧机仍可使用时,先检查自己的同步设置,并保存必要的服务器资料和配置文件。商店版更新也在 App Store 中查看。
客户端买断 ≠ 线路套餐。App Store 的购买记录对应应用,不会生成服务器账号或订阅链接。本站不提供、不销售、不推荐节点或订阅。已经有服务商的用户,按其给出的配置原值填写即可;只是重装应用时,不需要为了重新导入而另办线路服务。
如果应用能打开,但旧订阅无法刷新,先检查该订阅本身是否可用。连接失败与购买记录是两类问题:前者从服务器和配置排查,后者从 App Store 账号与已购项目核对。
Mac、Windows、安卓和 Linux 的安装包通过本站 /dl/shadowrocket/ 路径提供。需要更新或重装时,回到全平台下载页,按当前设备选取安装包。尤其是从 Intel Mac 换到 Apple 芯片机型,或从一种 Linux 发行版迁移到另一种时,应重新选择对应文件,避免沿用旧设备的安装包。
更新前记下当前使用的配置文件和连接方式;更新后先验证一条已知可用的连接,再恢复其他设置。这样即使结果发生变化,也能先检查应用、配置和服务器中的哪一环发生了改变。
05 Reading
按问题查阅:填写协议参数、找回商店购买记录,或判断后台连接是否频繁重建。
协议科普
地址、端口、密码和 SNI 分别由哪项信息决定?文章按填写顺序解释字段,并说明证书名称不符与其他握手失败现象有什么不同。
查看字段说明获取与购买
先确认购买所用账号,再检查已购项目。文章区分下载应用和恢复应用配置,也说明列表未显示时应先检查什么。
查看恢复步骤故障排查
从网络切换、重连和连接测试三方面检查。调整时一次只改一个条件,再对比常驻连接与按需连接的表现。
查看排查方法