官方手册 · 获取与配置

Shadowrocket 使用说明
订阅导入与规则分流

全平台规则代理客户端。从已有订阅开始，核对 Global Routing，再用 Config 规则分流检查请求去向。

下载 Shadowrocket 全部平台

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

首次配置：查看使用教程 →
VLESS On Demand Config

配置检查路径

从连接配置到请求去向

连接开关、服务器信息与分流规则属于不同层次。先确认配置能否建立连接，再检查哪一条规则决定了请求去向；每次只改一个变量，保留可供比较的结果。

查看设置说明

规则分流：先读匹配顺序

规则分流决定某个请求使用哪一种策略，而不是替服务器补齐连接参数。在 Home 核对 Global Routing 为 Config 后，再进入当前选中的 Config 阅读 Rule。规则通常按从上到下的顺序匹配，较具体的域名规则应放在宽泛规则之前，FINAL 用于接住前面没有命中的请求。遇到某个网站去向不符合预期，先记录域名和实际命中项，再检查规则顺序及策略名称；不要直接把所有请求改成 PROXY 来掩盖问题。右侧只是规则语法示例，不是适用于所有网络的完整配置。

Rule · 示例
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
策略含义

DIRECT 直接连接；PROXY 使用代理策略；REJECT 拒绝匹配请求。匹配成功不等于目标服务一定可用。

On Demand：检查自动触发条件

On Demand 用于根据既定条件触发连接，适合在手动连接已经验证可用后配置。先在 Settings 找到 On Demand，逐项阅读当前条件，明确哪些网络变化应该触发、哪些应该跳过。若连接关闭后又自动开启，应先检查这里，而不是反复删除服务器。排查连接不稳定时，可以暂时关闭自动触发，仅保留手动操作作为对照；确认问题来源后再恢复原来的条件。系统后台调度与网络切换都会影响触发时机，因此不能把自动触发当成连接始终可用的保证。

设置路径

Settings → On Demand

先验证手动连接，再增加自动触发条件。

排查次序

暂时关闭 On Demand → 手动连接 → 切换网络测试 → 恢复已确认的触发条件。

多协议：按已有信息选择 Type

添加服务器时，Type 必须与用户已有服务器实际提供的协议一致。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议的字段并不相同，不能只改一个协议名称就完成转换。在 Add Server 中先选择 Type，再逐项检查 Host、Port 以及对应的认证和传输参数。通过链接或二维码导入后也应复核字段，尤其留意复制时丢失的末尾参数。协议名称只描述通信方式，不代表速度或可用性；服务器是否在线、参数是否匹配和当前网络条件都需要单独确认。

协议参考
ShadowsocksVMessVLESSTrojanHysteria2WireGuard
Add Server

Type → Host → Port → 对应认证参数。字段含义见术语表。

订阅导入：区分链接与配置内容

订阅用于集中获取和更新用户已有的服务器条目。导入前先从自己的服务商处取得完整链接，确认没有多余空格、换行或截断，再在 Add Server 选择 Subscribe 并填写。保存后回到 Home 检查条目，必要时手动更新。若更新后列表为空，应区分链接无法访问、返回内容不是订阅格式以及服务器条目解析失败这几种情况。更新订阅不等于更新 Config 中的分流规则，也不表示当前选择的服务器自动变为可用。订阅链接可能含访问凭据，分享问题截图时应遮盖完整链接。

导入检查

Add Server → Subscribe

完整链接、保存结果、手动更新、服务器选择，按顺序逐项确认。

管理边界

订阅维护服务器列表；Config 管理规则与相关设置。两者应分别核对，避免更新了列表却误以为规则也已更新。

Config：确认正在使用的文件

保存一个配置文件与实际启用它是两件事。进入 Config 后，先确认当前选中的文件，再阅读 General、Rule、Hosts 等分段；修改前保留一份能够恢复的副本。远程配置更新后，应再次确认本地修改是否仍然存在，避免把同步或覆盖误判成规则失效。使用 iCloud 同步时，也要检查目标设备是否已经收到内容，并在目标设备重新核对选中项。同步配置不等于同步当前网络状态，更不能替代服务器凭据检查。建议每次调整一个设置，并记录调整前后的访问结果。

Config 分段
GeneralRuleHostsURL Rewrite
iCloud

先确认文件同步，再确认当前选中项。修改前留存副本，出现异常时回到上一份可用配置。

诊断工具：把故障缩小到一层

Connectivity Test、Diagnostics 与 Data 分别提供连通性检查、诊断线索和流量观察入口。先关闭连接验证基础网络，再开启连接测试同一目标，比较两次结果。单次测试超时不能证明所有请求都失败，测试目标、DNS 解析和服务器状态都可能影响结果。Data 中的流量变化可以辅助判断是否产生请求，但不能单独说明请求已经成功。记录问题时写明网络类型、Global Routing、当前 Config 和可复现步骤；对外分享前遮盖服务器认证信息、订阅链接与个人访问记录。

检查工具
Connectivity TestDiagnosticsData
症状索引

开关异常、节点超时、DNS 问题与更新后异常，应沿不同路径检查。参阅排查手册。

GLOBAL ROUTING

三种模式分别检查什么

界面中的 Config / Proxy / Direct 分别对应配置、代理、直连。模式选择决定如何处理请求，不会修改服务器本身的认证参数。

Config：按当前配置分流

日常需要按域名、IP 或其他条件区分请求时，先选择 Config，再确认 Config 页实际选中的文件。某个请求出现意外去向时，检查该请求命中的第一条规则，以及规则引用的策略是否存在。相同服务器在不同规则文件下可能得到不同结果，因此排查时应固定服务器，只比较规则变化。若规则示例引用 PROXY，也要确认应用中对应策略能够找到可用的服务器。不要把尚未理解的完整配置直接覆盖到当前文件。

按设备获取

Shadowrocket 全平台入口

iPhone / iPad 在 App Store $2.99 一次性付费；Mac、Windows、安卓、Linux 版免费。安装包通过本站 /dl/shadowrocket/ 获取，首页入口统一带到下载指南，再按设备选择。

iPhone iPad

iPhone / iPad

App Store $2.99 一次性；Mac、Windows、安卓、Linux 版免费。

使用自己的购买账号核对商品页，再完成获取。两种设备共用同一购买记录；系统要求以 App Store 页面标注为准。首次使用前准备好自己的订阅或服务器信息，安装完成不会自动生成连接配置。

查看商店与购买说明

Mac

免费 · Apple 芯片 / Intel

先在“关于本机”查看芯片信息，下载页分别提供 Apple 芯片与 Intel 安装选项。首次打开遇到“无法验证开发者”时，先核对下载来源，再按下载指南进入“隐私与安全性”处理，不要反复更换不明来源文件。

查看 Mac 安装选项

Windows

免费

下载页提供 Windows 64 位安装包。首次运行若出现 SmartScreen 提示，先核对文件来自本站，再查看“更多信息”中的“仍要运行”。安装提示的处理方法与连接故障排查不同，连接参数应在应用正常打开后另行检查。

查看 Windows 下载说明

安卓

免费

使用下载页提供的 arm64 安装选项。系统询问安装权限时，仅为正在使用的下载应用按需允许“安装未知应用”，完成后可恢复原设置。若在微信内无法继续下载，改用系统浏览器打开本站下载页，再按页面提示操作。

查看安卓安装说明

Linux

免费 · deb / rpm / AppImage

依据发行版的软件包管理方式选择 deb 或 rpm；使用 AppImage 时，需要先赋予文件执行权限。下载指南提供对应安装步骤。出现依赖或启动提示时保留完整错误信息，先解决应用启动问题，再导入已有配置。

查看 Linux 安装选项

查看全部平台 →

首次配置

添加配置、选择模式、验证连接

下面以 iPhone / iPad 界面为例。先完成一次可复现的手动连接，再配置自动触发与更细的分流条件。

步骤 01 · Add Server

导入已有服务器或订阅

在 Home 进入 Add Server，按已有信息选择协议，或用 Subscribe 导入完整订阅链接。保存后检查 SERVER 列表，确认条目确实出现，再选中准备使用的服务器。二维码导入也要核对协议与关键字段，不应只凭条目名称判断配置正确。

步骤 02 · Global Routing

确认模式与 Config

需要规则分流时选择 Config，并核对 Config 页当前选中的文件；临时使用 Proxy 做对照时记住原始状态。服务器列表负责连接目标，Config 负责规则，两项都要确认。首次配置不宜同时加入多份陌生规则，否则很难判断是哪一项变化影响结果。

步骤 03 · Connectivity Test

打开连接并比较结果

按系统提示允许添加 VPN 配置，再打开连接开关。先访问一个明确的测试目标，再使用 Connectivity Test 辅助检查。开关显示已连接仅说明连接状态发生变化，不代表所有目标均能访问。失败时记录模式、服务器和错误信息，再沿排查手册逐项缩小范围。

查看完整教程 →

正版核验与获取事实

核对商品信息，再处理购买与恢复

Shadowrocket（小火箭）是闭源商业应用。本站是官网与官方手册；获取、配置和排查属于不同环节，应分别确认。

开发者 Shadow Launch Technology Limited 应用 ID 932747118 2 档获取 · App Store 与本站安装包

开发者、图标、应用 ID

iPhone / iPad 获取前，核对商品名称 Shadowrocket、开发者 Shadow Launch Technology Limited 与应用 ID 932747118，并比较页面上的官方图标。仅凭搜索结果中的同名文字不足以确认商品。可以从下载指南进入指定产品页，再逐项查看商品信息；遇到名称近似的其他条目，不要把其价格或功能说明套用到 Shadowrocket。

官方图标采用白底蓝紫描边图案，页头使用的也是该图标。判断时应以完整商品信息为准，而不是只凭颜色、搜索排序或某一张介绍图片。

商店可见性与账号地区

中国大陆 App Store 当前不提供此应用，搜索不到时先查看自己的 Apple ID 商店地区，而不是更换关键词反复搜索。商店地区影响商品可见性、当地货币标价与支付选项；需要调整地区时，应先阅读账号中的地区变更条件，处理已有余额、订阅等限制，再按 Apple 的账号设置流程操作。

iPhone / iPad 系统要求以 App Store 页面标注为准。若页面提示设备不兼容，应先核对系统与商品页要求，不能把账号地区问题和系统兼容问题当成同一种故障。

两档价格与购买记录

iPhone / iPad 在 App Store $2.99 一次性付费，各店面按当地货币显示；Mac、Windows、安卓、Linux 版免费。iPhone 与 iPad 可使用同一购买账号的记录重新获取，换机或重装时先进入已购项目检查，不要在未核对账号前重复购买。

重新下载应用与恢复本地配置不是一回事。此前保存的订阅、服务器字段及 Config 文件，应从自己保留的配置或可用同步内容恢复，并在新设备上重新确认当前选中项。

客户端买断 ≠ 线路套餐

客户端费用对应应用获取，不包含服务器访问权限。导入教程始终以用户已经拥有自己的订阅或服务器信息为前提。本站不提供、不销售、不推荐节点或订阅，仅说明已有信息如何填写、更新和排查；安装完成后列表为空，并不表示应用获取失败。

服务器到期、认证信息变化或订阅链接失效，应向原有服务商核对。此类问题不能通过重新购买客户端解决，也不应通过反复覆盖 Config 来尝试修复。

更新应用后，保留可比较的配置

iPhone / iPad 通过 App Store 管理应用更新；其他平台在本站下载指南获取新的对应安装包，Mac 仍需区分 Apple 芯片与 Intel。安装包只走本站 /dl/shadowrocket/ 路径。更新前保留已有服务器信息与可用 Config，更新后先使用原有配置验证，再逐项调整设置。如果出现新问题，记录应用中的实际提示、设备系统、网络类型和操作顺序；不要同时更换服务器、订阅、规则与 DNS，以免失去前后对照。

查看正版核验与已购恢复说明 →

日志选读

安装格式与 App Store 操作说明

按当前遇到的问题阅读：Linux 包格式、商店商品核对，以及桌面端首次打开提示。安装完成后，再回到使用教程导入已有配置。

查看全部文章 →