官方手册 · 全平台
Shadowrocket 帮助中心
下载、设置与规则参考
全平台规则代理客户端 ,用于已有服务器接入与规则分流 。iPhone / iPad 在 App Store $2.99 一次性买断;Mac / Windows / 安卓 / Linux 版免费。
当前版本 读取中 · iPhone / iPad App Store $2.99 一次性;Mac、Windows、安卓、Linux 版免费
首次使用:查看导入与连接步骤 →
先区分服务器、订阅与配置文件:服务器保存连接参数;Subscribe 用于更新一组服务器;Config 决定请求怎样匹配规则。导入其中一项,并不意味着另外两项已经完成。下列功能按使用任务组织,选择瓷砖可查看操作要点;示例只说明规则语法,不包含可连接的服务资料。
规则分流
On Demand
多协议
Subscribe 订阅导入
Config 配置文件
诊断工具与 Data
Global Routing 姿态
设备与 iCloud
先匹配条件,再执行策略 规则分流用于让不同请求采用不同处理方式。在 Config 中核对 Rule,并在 Home 将 Global Routing 设为 Config,规则才参与常规分流。DOMAIN-SUFFIX 匹配域名后缀,IP-CIDR 匹配地址段,FINAL 处理此前未命中的请求。检查时先看规则顺序,再看目标策略是否存在;把宽泛规则放在前面,可能遮住后面的细分规则。修改前保留原文件,每次只调整一项,并用实际请求记录核对命中结果。
查看规则关键字 →
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT
连接稳定后再设置 On Demand On Demand 用于按已设置的条件触发连接,不负责生成服务器资料,也不能修复失效的服务。先在 Home 手动连接并完成访问验证,再进入 Settings 检查 On Demand 的条件。调整后分别测试 Wi-Fi 与蜂窝网络切换,观察是否符合预期。若关闭连接后又自动开启,先检查此项及系统中的相关连接设置,而不是重复删除配置。排查期间可暂时关闭自动触发,待手动连接正常后再恢复,避免把触发问题误认为规则问题。
查看 On Demand 设置说明 →
# 操作检查顺序
Home
Settings → On Demand
Home → Connectivity Test
Type 必须与已有服务一致 Shadowrocket 支持 Shadowsocks、VMess、VLESS、Trojan、WireGuard 等协议。添加时在 Add Server 选择对应 Type,再按照已有服务器信息填写字段;不同协议的认证方式和传输参数不能互相套用。Host 与 Port 正确并不代表其余参数齐全,还需要核对密码或标识、TLS 与传输相关选项。资料不完整时应向自己的服务商确认。扫码可以减少输入错误,但导入后仍应检查协议类型与地址,不能仅凭备注判断服务器是否可用。
查看协议术语 →
# 字段核对,不是连接配置
Type
Host
Port
# 按所选协议继续核对认证参数
导入已有 Subscribe 资料 订阅用于集中更新服务器列表,前提是用户已有自己的订阅链接。在 Home 进入 Add Server,选择 Subscribe,填写已有地址并保存,再检查返回的服务器条目。若结果为空,先确认链接是否完整、是否已失效,以及返回内容是否为支持的格式,不要反复添加同一链接。更新前保留必要的分组备注,删除前分清是在删除单条服务器还是整份订阅。订阅地址可能包含访问凭据,截图、反馈问题或迁移设备时应避免公开完整地址。
查看多订阅管理 →
# Home → Add Server
Type: Subscribe
# 保存后检查
# 分组名称 / 服务器列表 / 更新结果
导入与启用是两次检查 Config 保存规则及相关设置,与服务器列表的职责不同。获得配置文件后,先备份当前文件,再核对 General、Rule、Hosts 等分段及引用的外部资源。导入完成还要确认当前选中的文件,并在 Global Routing 使用 Config。若切换后只有部分网站异常,应优先对照新旧文件的 DNS 设置、规则顺序和策略名称,而不是立刻重装客户端。示例中的 FINAL,DIRECT 表示未匹配请求采用直连,只适合说明语法,不能代替按需求编写的完整配置。
查看配置与 Settings 参考 →
[Rule]
DOMAIN,example.com,PROXY
FINAL,DIRECT
把连接状态与请求结果分开看 Connectivity Test 可用于初步观察连通性,Data 用于查看流量记录,Settings 中的 Diagnostics 和 Log 帮助定位问题。测试有返回并不等于目标网站的每项请求都正常,连接开关已打开也不等于所有流量都会经过代理。排查时记录所用网络、服务器、Global Routing 姿态和出错操作,再对照日志中的域名、策略及错误信息。反馈前隐藏地址中的凭据与个人信息;完成排查后按需要调整日志设置,避免积累与当前问题无关的记录。
查看诊断设置 →
# 按层次检查
Home → Connectivity Test
Data
Settings → Diagnostics
Settings → Log
Config / Proxy / Direct Global Routing 的三种姿态分别是配置 Config、代理 Proxy、直连 Direct。Config 按当前配置的规则处理请求;Proxy 用于让请求采用代理路径;Direct 用于直连检查。日常需要规则分流时选择 Config,并确认对应文件已启用。故障排查可以临时切换姿态以缩小范围,但切换本身不会修正错误的服务器参数。若 Proxy 可用而 Config 异常,应回到规则和 DNS 检查;完成对照后恢复原来的姿态,避免把临时测试设置当成最终配置。
查看模式选择步骤 →
Global Routing
├─ Config
├─ Proxy
└─ Direct
先备份,再同步与迁移 在支持 iCloud 同步的设备上,先确认系统账户、iCloud Drive 与应用相关权限,再检查 Shadowrocket 的同步设置。同步与手动导出是不同的备份路径,迁移前应保留一份能辨认用途的 Config 文件,并妥善保存已有服务资料。新设备导入后重新核对当前文件、服务器选择、Global Routing 和 On Demand;系统连接权限也需要在新设备上确认。不要因为文件已出现就直接覆盖旧设备内容,先验证连接与规则,再决定是否清理原来的备份。
查看备份与换机迁移 →
# 迁移后逐项检查
Config
Home → Global Routing
Settings → On Demand
Home → Connectivity Test
Shadowrocket / 932747118
正版核验 · 2 档获取
商店信息与本站安装包
iPhone / iPad 核对开发者、官方图标与应用 ID;Mac、Windows、安卓、Linux 从本站下载页选择安装包。先确认应用身份与设备类型,再进入导入流程。
查看正版核验步骤 →
核对开发者、图标与应用 ID
打开 Shadowrocket 的 App Store 产品页,开发者应为 Shadow Launch Technology Limited ,应用 ID 为 932747118 。同时对照本站页头所用的官方图标:白底、蓝紫描边图案。搜索结果中的名称和图标只是辨认起点,应继续进入产品页核对开发者与应用 ID,不要把名称相近的条目当成同一应用。系统要求以 App Store 页面标注为准。
Shadowrocket 是闭源商业应用。本手册以实际界面词与具体操作说明功能,不使用评分或下载量替代身份核对。电脑与安卓用户应从本站全平台下载页进入,安装包通过本站 /dl/shadowrocket/ 路径提供;选择设备与安装格式后,再按照系统提示完成安装。
价格与购买范围
iPhone / iPad 在 App Store $2.99 一次性买断,Mac / Windows / 安卓 / Linux 版免费。 App Store 各店面按当地货币显示,实际付款金额以产品页及确认付款页面为准。iPhone 与 iPad 可使用同一购买账户的已购记录获取应用;这项购买对应客户端使用,不是按月购买连接服务,也不会自动生成服务器。
客户端买断 ≠ 线路套餐。 本站不提供、不销售、不推荐任何节点或订阅。添加服务器、扫码和 Subscribe 操作,均以用户已经拥有自己的订阅或服务器信息为前提。若只有客户端而没有这些资料,应先向自己的服务商确认已有信息,而不是在 Config 中反复切换文件。
商店可见性与账户地区
App Store 的搜索结果与 Apple ID 所属商店地区有关。中国大陆商店没有此应用时,先检查当前商店账户地区,再核对产品页是否可访问。地区变更应通过系统中的账户设置按提示进行,并先了解余额、现有订阅与付款方式对变更的影响;更改设备的语言或显示地区,不等于已经更改商店账户地区。
购买前确认使用的是准备长期保留的个人账户,并保留自己的购买记录。商店搜索不到与客户端连接失败是两类问题:前者先查商店与账户信息,后者才检查服务器、网络和规则。将两个阶段分开处理,可以避免在尚未安装应用时误改网络配置。
重装、换机与后续更新
在 iPhone / iPad 重装或换机时,使用原购买账户查看已购项目并重新下载;如果显示需要再次购买,先核对账户和购买记录,不要立即重复付款。重新取得应用与恢复配置是两件事,原设备中的服务器选择、Config 文件和自动连接条件仍需要备份与复核。
iPhone / iPad 后续更新通过 App Store 管理;Mac、Windows、安卓、Linux 用户可回到本站下载页获取新版安装包。更新前保留现用配置,完成后先验证原来的连接路径,再检查新增或变化的设置。若首次打开被系统拦截,按下载页的安装放行说明逐项核对来源与提示,不要把访问失败与系统安装提示混为一谈。
获取方式分为两档:iPhone / iPad 在 App Store $2.99 一次性购买,Mac / Windows / 安卓 / Linux 版免费。下列入口全部前往本站下载页的对应分区;系统识别仅用于把当前设备放在前面,实际安装时仍需核对芯片、系统与文件格式。
安装包没有代码签名,首次打开可能出现系统拦截提示。只对已确认来自本站的文件按步骤放行,不应为完成一次安装而关闭整套系统防护。具体提示、操作入口与命令见安装放行说明 。
以下预览使用 iPhone / iPad 的界面词。开始前确认已经取得自己的订阅或服务器信息,并能区分订阅地址与单条服务器参数。首次操作先完成一条可复现的连接路径,再逐项加入规则与自动连接设置;这样出现问题时,可以回到上一个已验证的状态。
01 / Home
添加服务器或已有订阅
在 Home 进入 Add Server。单条服务器按资料选择 Type,填写 Host、Port 及对应认证字段;已有订阅则选择 Subscribe 并保存完整地址。使用 Scan QR Code 时,也应在导入后打开详情核对参数。扫码只是输入方式,不代表参数已经经过连接测试。
保存后检查 SERVER 分组是否出现预期条目,再选择准备测试的服务器。如果导入为空,先检查链接是否被截断、订阅是否有效、返回内容是否正确。不要在尚未确认资料完整时连续创建多个重复条目,也不要把 Config 文件地址当成服务器订阅地址。
02 / Global Routing
确认模式与当前配置
需要规则分流时,在 Global Routing 选择 Config,并到 Config 确认使用的文件。Proxy 与 Direct 可用于分离问题:前者检查代理路径,后者检查直连路径。模式选择不会替代服务器配置,服务器资料错误时,切换模式并不能自动补齐缺失参数。
刚导入新配置时,先查看 Rule 中的策略名称与已有服务器选择是否对应,再检查 FINAL 的处理方式。一次只修改一处,保留原文件用于对照。若只在 Config 下失败,可优先检查 DNS、规则顺序和引用资源,而不是立即删除全部服务器资料。
03 / Connectivity Test
开启连接并验证实际请求
回到 Home 打开连接开关,首次使用按系统提示允许添加连接配置。运行 Connectivity Test 后,还需要打开实际要使用的网站或应用,检查内容能否正常加载。测试结果与真实业务请求并不完全等价,不能只看开关状态就判断全部设置正确。
若连接失败,按「当前网络 → 服务器参数 → Global Routing → Config 与 DNS」的顺序检查。若仅一个网站异常,记录域名和发生时间,再查看请求命中的策略。Wi-Fi 与蜂窝网络分别测试,完成后再启用 On Demand;提交问题时隐藏订阅凭据、密码与个人地址。
设置入口的阅读顺序: 不熟悉界面词时先查术语手册 ,需要操作路径时查教程 ,需要逐项理解 DNS、Ping、Log、Widget、iCloud 或 Proxy 端口时查Settings 设置参考 。界面项目会随系统与应用变化,执行前以设备当前显示为准。
按当前任务选择文章:尚未获取应用,先核对商店信息;已经能够连接,再阅读协议参数;准备更换设备,先制作可恢复的备份。文章只解释客户端操作与用户已有资料的使用,不提供连接服务。
正版购买
从搜索结果进入产品页,依次检查开发者、官方图标与应用 ID,再确认商店账户和付款信息。iPhone / iPad $2.99 一次性购买;Mac、Windows、安卓、Linux 免费。适合首次获取应用以及重装前核对购买记录的用户。
阅读购买步骤 →
协议参考
区分本地密钥、对端公钥与路由范围,按照已有配置资料核对参数来源。示例用于理解字段,不是可直接使用的连接资料;填写前先确认自己的服务器支持相应协议,避免把不同端的密钥位置填反。
阅读参数说明 →
进阶设置
分别说明 iCloud 同步与手动导出 Config 的用途。迁移前记录正在使用的服务器和模式,迁移后重新确认系统权限、当前配置与 On Demand;先测试恢复结果,再清理旧设备和备份文件。
阅读迁移步骤 →