Shadowrocket 官方手册 · 问题索引

Shadowrocket 常见问题

从设备与错误现象定位问题:先确认获取方式和安装权限,再检查已有订阅,最后按 DNS、规则与连接记录逐层排查。

按分类跳转,点击问题展开答案。可同时展开多条,便于对照检查。

App Store › Purchase

正版与购买

先区分客户端获取、购买记录与用户已有的连接资料。

电脑和安卓能用 Shadowrocket 吗?价格有什么区别?

能。Shadowrocket 提供 iPhone、iPad、Mac、Windows、安卓和 Linux 版本。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。Mac 提供 Apple 芯片版与 Intel 版,其他平台安装包统一从本站下载指南进入,文件路径为 /dl/shadowrocket/。先按设备选择版本,再按下载指南完成安装,不要把不同系统的安装包混用。

App Store 搜不到 Shadowrocket,应该先检查什么?

先从下载指南打开指定的 App Store 产品页,再检查当前用于“媒体与购买项目”的 Apple 账户地区;中国大陆商店没有此应用。地区设置可在系统 Settings 的 Apple 账户中依次进入“媒体与购买项目”、查看账户、“国家或地区”核对。确需变更时,按 Apple 的官方换区流程处理余额、现有订阅及付款信息;网页产品页的店面地址不会自动改变账户地区。

怎样核对 App Store 中的 Shadowrocket?

打开产品页后同时核对应用名称 Shadowrocket、开发者 Shadow Launch Technology Limited 和产品页地址中的应用 ID 932747118,并比对本站页头使用的官方图标。不要仅凭搜索结果里的名称或图标相似程度判断。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;其他平台按本站下载指南选择 /dl/shadowrocket/ 下的安装包。

换 iPhone 或改用 iPad,需要重新购买吗?

使用购买时的 Apple 账户登录 App Store,在已购项目中查找 Shadowrocket,再下载到兼容的 iPhone 或 iPad;两种设备通用,系统要求以 App Store 页面标注为准。若显示购买按钮,先核对“媒体与购买项目”所用账户及购买记录,不要立即重复支付。价格为 iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。恢复应用不等于恢复已有服务器信息,配置应另行备份。

安装客户端后,为什么还需要自己的订阅或服务器信息?

客户端一次性买断 ≠ 线路套餐。Shadowrocket 负责读取配置、建立连接并按规则处理请求,不会因安装完成而自动获得可用服务器。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;这些是客户端的获取价格。后续操作以用户已有自己的订阅或服务器信息为前提。本站是 Shadowrocket 官网与官方手册,不提供、不销售、不推荐节点或订阅。

相关说明:正版核验步骤 · 恢复已购应用 · 2 档获取与价格

Home › First Open

安装与首次打开

区分安装文件来源提示、设备管理限制和 VPN 配置权限。

Mac 应该选 Apple 芯片版还是 Intel 版?

先打开 Apple 菜单中的“关于本机”:显示“芯片”及 Apple 芯片名称时选 Apple 芯片版,显示 Intel“处理器”时选 Intel 版。两个版本分别使用对应的 dmg 文件,从本站下载指南获取。首次打开若提示无法验证开发者,先确认文件来自本站,再进入“系统设置 → 隐私与安全性”查看“仍要打开”。若设备由单位管理、没有放行选项,应联系管理员,不要反复更换安装包。

Windows 或 Mac 提示有风险,怎样处理首次打开?

先确认安装包来自本站下载指南对应的 /dl/shadowrocket/ 地址。Windows 的 SmartScreen 提示可在核对文件来源后进入“更多信息 → 仍要运行”;Mac 提示无法验证开发者时,在“系统设置 → 隐私与安全性”选择“仍要打开”。Mac 若提示应用已损坏,先重新下载并按下载指南的对应步骤处理。不要全局关闭系统保护;若是恶意软件检测告警而非来源提示,应停止操作并排查。

安卓和 Linux 首次安装需要注意哪些权限?

安卓从本站下载对应安装包后,仅为实际打开文件的浏览器或文件管理器临时允许“安装未知应用”,安装完成可收回该权限;首次连接时再确认系统 VPN 请求。Linux 先按发行版选择 deb、rpm 或 AppImage,AppImage 运行前需要赋予执行权限。若设备策略禁止安装或建立 VPN,应先确认管理限制。具体命令与放行顺序见下载指南,不要把安卓安装权限与 VPN 连接权限混为一项。

首次连接时开关打不开,或者立即回到关闭状态,怎么办?

先确认 Home 的 SERVER 列表中已有可选条目,并已选中用户自己的服务器。首次启用需要同意系统添加 VPN 配置的请求,按提示完成设备认证;此前拒绝过时,可重新发起连接。若开关仍立即关闭,检查是否有其他 VPN 正在运行,以及系统是否有受管理的网络限制,再查看 Log 中的错误。不要一开始就删除全部配置;先保存现有资料,每次只改变一个条件后重试。

界面显示英文,怎样对照官方手册操作?

本手册保留界面英文原文,可直接按 Home、Config、Settings 和 Global Routing 等名称定位。先检查系统首选语言与应用语言选项;只有应用实际提供对应语言时,系统才可能显示可选项,不同系统和版本的菜单也可能不同。无需为改变语言而重置网络配置。查阅步骤时优先核对界面词与功能位置,而不是仅对照按钮颜色;找不到选项时,可在选项手册中按设置路径继续查找。

相关说明:各系统安装放行步骤 · 首次连接教程

Home › Subscribe

订阅与节点导入

以下操作均以用户已有自己的订阅地址或服务器信息为前提。

Subscribe 导入失败,怎样判断是链接还是网络问题?

先确认复制的是用户已有的订阅地址,而不是管理页面或登录页面地址,并去掉首尾空格及换行。检查该地址是否过期、访问令牌是否变更、服务商是否要求重新生成,再观察客户端给出的错误:请求超时优先检查当前网络,返回内容无法解析则核对订阅格式。不要把完整订阅地址发到公开页面,它通常包含访问凭据。排查时只记录错误类型,必要时向自己的服务商核实地址和格式。

Add Server 手动添加后无法连接,哪些字段必须核对?

按用户已有的服务器资料逐项核对协议类型、地址、端口和认证信息,再核对该协议实际要求的加密方式、TLS、SNI、传输方式与路径等字段。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的参数并不相同,不能只填相同的地址和端口就认为配置等价。保存后重新选中该条目并进行 Connectivity Test;若仍失败,以 Log 的具体错误继续检查,不要随意修改多个高级字段。

Scan QR Code 扫描后没有条目,应该检查什么?

先确认二维码承载的是客户端可识别的服务器或订阅信息,而不是普通网页入口;再检查系统是否已允许相机访问。对屏幕上的二维码,保持完整边缘与足够清晰度,避免反光、裁切或缩放模糊。若扫描能识别文字却无法添加,应让自己的服务商确认编码内容与协议格式,也可用已有资料改为手动填写。二维码可能包含密码或访问凭据,排查时不要将原图公开分享。

更新订阅后条目变化了,怎样避免选错服务器?

订阅更新会按远端返回内容刷新所属分组,名称、数量及排列都可能变化。更新前先记下正在使用的分组与条目,更新后检查是否仍选中预期对象,并重新运行 Connectivity Test。若提示更新失败,先保留现有可用条目,核对网络与订阅地址;不要反复删除再导入。手动修改订阅内条目也可能被后续刷新覆盖,因此临时测试的参数应另行记录,长期变更以服务商提供的资料为准。

Subscribe 与 Config 是同一份内容吗?

不是。Subscribe 通常用于获取和刷新用户已有的服务器列表;Config 用于规则、策略引用及相关配置。导入订阅不代表已自动启用合适的规则文件,导入 Config 也不代表其中引用的服务器一定存在。排查时分两步确认:先在 Home 检查 SERVER 列表及所选条目,再在 Config 确认当前启用的配置和策略引用。移动设备或恢复应用后,两类资料也应分别核对,避免只恢复其中一类就开始连接。

相关说明:Add Server 操作 · 已有订阅导入

Config › Rule / Settings › DNS

规则分流与故障排查

把“系统已建立连接”与“目标请求可达”分开验证,保留每一步的结果。

Global Routing 的配置、代理、直连三种姿态怎么选?

配置对应 Config,按当前启用配置中的规则决定请求走向;代理对应 Proxy,让进入该模式处理范围的请求使用代理;直连对应 Direct,不经所选代理服务器转发。日常需要规则分流时选择 Config,并确认规则文件已启用;临时诊断可用 Proxy 与 Config 对照同一请求的表现。不要把模式名称与规则里的大写策略 PROXY、DIRECT 混为同一层设置,也不要将 Direct 当作服务器可用性的验证结果。

显示已连接却无法上网,应按什么顺序排查?

先关闭连接,确认当前 Wi-Fi 或移动网络本身能访问正常网站;再开启连接,核对所选服务器并运行 Connectivity Test。若测试失败,先检查服务器参数和可用状态;若测试正常但网页失败,再看 Settings 中的 DNS 与 Log,区分解析错误、连接超时和规则命中问题。最后用同一个目标对比 Config 与 Proxy。每次只改一项并记录结果,避免同时换服务器、DNS 和规则后失去判断依据。

Connectivity Test 正常,为什么部分网站仍打不开?

Connectivity Test 只反映所选测试方式下的结果,不等于所有域名、端口和应用请求都可成功。先查看失败网站在 Log 中的解析与连接记录,再核对是否命中了预期规则、策略是否引用有效服务器,以及 DNS 是否返回可用地址。若只有某个应用异常,还应检查它是否保留旧连接或有自己的网络设置。不要只凭一次测试结果反复调低测试超时;应针对实际失败请求逐层缩小范围。

怎样判断规则优先级和 FINAL 是否写对?

规则通常从上到下匹配,先命中的规则决定策略,因此更具体的 DOMAIN 或 DOMAIN-SUFFIX 应放在可能覆盖它的宽泛规则之前。FINAL 用于前面规则均未匹配时的兜底,应放在规则末尾,并检查它引用的 PROXY、DIRECT 或策略组是否符合预期。修改后先确认启用的正是这份 Config,再用 Log 查看实际命中。若已有较宽泛规则提前命中,继续向文件底部追加同类规则通常不能改变结果。

开启后耗电增加,On Demand 和 Log 应怎样检查?

先在系统电池统计中观察具体时段及后台活动,再对照是否有大流量传输、频繁重连、订阅刷新或持续诊断。On Demand 按配置条件触发连接,不等于所有场景都应开启;可暂时停用并手动连接,比较同类使用条件下的变化。Log 用于排查问题,完成记录后应退出持续观察,并核对是否启用了额外调试选项。不要通过随意缩短测试间隔来判断稳定性,也不宜一次关闭所有设置来比较耗电。

继续查阅:Settings › DNS · Config › Rule · Settings › On Demand

记录排查结果时,保留错误类型、所用模式与复现步骤;分享 Log 前先遮去服务器地址、认证信息及订阅访问凭据。