官方手册 · 问题索引

Shadowrocket 常见问题

先区分获取、导入与连接问题,再按顺序核对。覆盖 iPhone、iPad、Mac、Windows、安卓与 Linux。

还未安装?先查看全平台下载与安装说明;已有服务器信息,可从入门指南开始。

  • 2 档获取
  • iPhone / iPad $2.99 一次性 · 其他平台免费
  • 按现象逐项检查

点击问题展开答案。连接开关、无法上网与耗电问题归入「规则与分流」中的故障排查。

正版与购买

先核对产品条目和购买账户,再处理地区与换机问题。

电脑和安卓能用 Shadowrocket 吗?费用怎么区分?

可以。iPhone / iPad 版从 App Store 获取,$2.99 一次性付费;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。其他平台安装包经全平台下载页获取,地址位于本站 /dl/shadowrocket/ 下。客户端一次性买断 ≠ 线路套餐,本站不提供、不销售、不推荐节点或订阅;使用前需要准备用户已有的订阅或服务器信息。

怎样核对 App Store 中的 Shadowrocket 正版条目?

打开指定产品页,依次核对产品名 Shadowrocket、开发者 Shadow Launch Technology Limited、应用 ID 932747118,并与本站页头的官方图标对照。不要只凭搜索结果中的名称判断。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;商店的实际结算金额以所属店面显示为准,同名且标价免费的商店条目不能据此认作正版。

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

先打开指定 App Store 产品页,再核对购买项目所用 Apple 账户的国家或地区、内容与年龄分级限制、账户登录状态。中国大陆店面没有此应用,设备语言与所在位置不等于账户店面。确需调整地区时,沿系统 Settings → Apple 账户 → Media & Purchases → View Account → Country/Region 查看官方流程,先处理余额、订阅与付款方式要求,不要反复切换地区试错。

换 iPhone 或重新安装,需要再买一次吗?

已购买的 iPhone / iPad 用户,应先登录当时购买所用的 Apple 账户,再到 App Store 的已购项目中查找并重新下载;若仍显示购买金额,先核对账户和购买记录,不要直接重复付款。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费,后者换机时重新从本站下载对应安装包即可。购买记录不会自动恢复用户自己的服务器凭据与本地配置,换机前应另行备份。

iPad 能安装吗?与 iPhone 的购买有什么关系?

可以,iPhone 与 iPad 使用同一 App Store 产品条目,同一购买账户可从已购项目恢复到另一台兼容设备。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;iPhone 与 iPad 的系统要求以 App Store 页面标注为准。两台设备可以使用同一份配置内容,但服务器是否允许同时连接取决于用户已有服务的限制,不能用客户端购买记录判断。

安装与首次打开

先确认平台、架构和来源,再处理系统的首次运行提示。

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

先打开 Apple 菜单中的「关于本机」:显示「芯片」且名称为 Apple 系列时选 Apple 芯片版,显示 Intel 处理器时选 Intel 版,不要按机型年份猜测。下载页提供两个对应的 dmg 按钮。首次打开若提示无法验证开发者,先核对安装包来自本站,再到系统设置的「隐私与安全性」查看被阻止项目并选择「仍要打开」,按系统提示确认。

Windows 出现 SmartScreen 风险提示,怎样处理?

先确认安装程序来自本站下载页且地址位于 /dl/shadowrocket/,再核对文件是为 Windows 提供的 64 位 exe。确认来源后,在 SmartScreen 提示中选择「更多信息」→「仍要运行」,然后按安装程序完成操作。若按钮被组织策略隐藏,交由设备管理员处理,不要关闭整台设备的安全防护;来源不明或文件名异常时应停止运行,返回下载页重新获取。

Mac 提示无法验证开发者或应用已损坏怎么办?

先核对安装包来源与芯片类型,将应用放入 Applications 后再尝试打开。提示无法验证开发者时,到系统设置「隐私与安全性」选择「仍要打开」。若确认来自本站、应用路径正确且提示已损坏,可在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app 后重试。该命令用于移除所选应用的扩展属性,不是修复任意损坏文件;下载不完整时应重新下载,不要对未知应用照搬命令。

安卓版点下载没反应,或提示不能安装怎么办?

在微信内点击没有反应时,用菜单选择在系统浏览器打开本站下载页,再获取 arm64 apk。安装前,在系统设置中仅为此次使用的浏览器或文件管理器开启「允许安装未知应用」,完成后可收回该权限。系统提示风险时先核对来源,不要忽略来源不明的警告。若出现安装包解析失败,检查设备架构、剩余空间与下载是否完整,再重新获取文件。

Linux 的 deb、rpm、AppImage 怎么选?

Debian、Ubuntu 等选择 deb,Fedora 等选择 rpm,不使用系统包安装流程时可选 AppImage。所有文件均从本站下载页获取。deb 可在文件所在目录用 sudo apt install ./ 加实际文件名安装,rpm 使用 sudo dnf install ./ 加实际文件名;AppImage 先用 chmod +x 加实际文件名赋予执行权限,再启动。遇到系统阻止执行时,先核对来源、架构与执行权限,不要用提升权限代替排查。

界面是英文,应该从哪里开始?

先按界面原文识别位置:Home 查看已有服务器与连接开关,Add Server 添加服务器,Config 管理配置文件,Global Routing 选择流量处理方式,Settings 查看设置。系统支持的语言显示可在应用相关语言设置中核对,具体入口随系统变化。阅读教程时保留这些英文名称,避免把中文解释误当成按钮;首次使用建议按入门指南完成添加、选择模式、连接和验证,不必一次修改所有设置。

订阅与节点导入

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

已有订阅导入失败,应按什么顺序检查?

先检查复制的地址是否完整,是否夹带空格、换行或聊天软件附加的标点,再确认它是用户已有订阅的实际地址,而不是账户管理网页。随后在当前网络下重试,并核对服务状态与有效期;若返回内容是登录页面或错误文本,应向原服务提供方确认地址及格式。不要连续重复添加同一订阅。排查或求助时隐藏地址中的 token、账户信息与服务器凭据,只提供错误提示。

Scan QR Code 扫描后为什么不能添加?

先确认已允许相机权限,二维码清晰、完整且没有被遮挡;再核对二维码内容是否为 Shadowrocket 可识别的服务器分享信息,而不是网页入口或登录凭证。使用用户已有的服务器信息进行添加,识别后在 Add Server 中核对协议、地址、端口与认证字段,确认再保存。二维码包含敏感连接信息,不要发布到公开页面;识别结果异常时停止导入,回到原始资料核对。

怎样更新已有订阅,更新后又要选一次服务器吗?

在 Home 找到对应订阅分组,使用该订阅的更新操作,等待完成后核对列表是否变化以及是否出现错误提示。更新会按返回内容调整分组中的服务器,原先选中的项目若被移除或改名,需要重新选择仍有效的项目。手动添加的服务器与订阅分组应分开管理。更新失败时先保留现有可用配置,检查网络与订阅地址状态,不要通过删除全部内容来替代定位问题。

Subscribe 与 Config 是一回事吗?

不是。Subscribe 通常用于取得用户已有的服务器列表;Config 管理的配置文件还可能包含 General、Rule、Host 等段落,用来决定连接和分流行为。导入服务器列表不等于已经设置好规则,切换配置文件也不一定会更新服务器信息。先确认手中资料的用途,再放到对应入口;修改前保留原配置,导入后分别核对服务器列表、当前配置与 Global Routing,避免把几个独立操作混为一谈。

导入成功但 Connectivity Test 失败,说明什么?

导入成功只表示内容被识别并保存,不能证明服务器可连接。先核对服务器地址、端口、协议和认证信息,再确认已有服务的状态;随后更换 Wi-Fi 或移动网络复测,判断是否只在某一网络失败。Connectivity Test 的结果受测试方式和目标影响,单次失败不能代表所有业务请求都失败。应同时查看实际访问与日志中的错误类别,每次只改一个变量,保留可复现的现象。

规则与分流

含故障排查:按基础网络 → 服务器 → 模式 → 命中规则的顺序定位。

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

配置对应 Config,按当前配置中的规则决定请求走向,适合日常按规则分流;代理对应 Proxy,将可被客户端处理的请求交给所选代理,可用于短时核对服务器是否可用;直连对应 Direct,用于核对不经代理时的访问情况。三种姿态不是三个服务器,也不是速度等级。排查时先记录原模式,比较同一请求在不同模式下的结果,完成后切回需要的模式,避免误把临时测试设置当作长期配置。

连接开关打不开,或者一打开就关闭怎么办?

先确认已选中一个有效服务器,再查看是否出现系统 VPN 配置授权提示,按系统流程确认。若曾取消授权,重新发起连接并检查系统 VPN 设置;已有其他 VPN 会话时,先停止该会话再测试。随后查看当前配置是否有语法错误、设备是否受管理策略限制,并尝试重新启动应用。不要反复删除系统配置:先记录错误提示,区分授权失败、配置加载失败与服务器连接失败。

显示已连接却无法上网,先查服务器还是规则?

先关闭连接,确认设备自身网络可用,再重新连接并测试同一个目标。若 Proxy 与 Config 都失败,优先检查所选服务器、认证信息、服务状态及 DNS 错误;若 Proxy 可用而 Config 失败,重点查看请求命中的规则与策略。Direct 的结果可作为本地网络对照,但不能单独证明代理正常。每次只更改一项,记录网络类型与错误提示,不要同时替换服务器、DNS 和整份配置。

规则顺序为什么会影响结果?FINAL 放在哪里?

在 [Rule] 段中,请求从上到下逐条匹配,命中后使用该行策略,不再继续查找后面的普通规则。更具体的 DOMAIN 或 DOMAIN-SUFFIX 通常应放在较宽泛的匹配之前,FINAL 作为未命中前序规则时的兜底,放在段末。检查时不能只确认规则存在,还要检查它前面是否已有更早的命中项,以及当前是否处于 Config。PROXY、DIRECT、REJECT 分别表示交给代理、直接连接和拒绝请求。

怎样确认某个请求真的按预期分流?

先在 Global Routing 选择 Config,确认使用的是刚修改并保存的配置,再发起一次目标请求,在连接记录或日志中核对域名、命中规则与策略。测试示例可用 DOMAIN-SUFFIX,example.com,PROXY,FINAL,PROXY 放在 [Rule] 段最后;示例用于说明语法,不代表可直接满足个人网络需求。若日志显示的是 IP 请求,应结合 DNS 解析与 IP-CIDR、GEOIP 的匹配情况检查,不能只根据网页能否打开判断规则是否正确。

On Demand 会一直连接吗?耗电增加怎样检查?

On Demand 按设定的条件触发连接,是否持续连接取决于条件、网络切换和实际请求,不能把它等同于固定时段开关。先暂停相关条件,用同一网络、相近使用量比较手动连接,再查看系统电池统计、后台活动、订阅更新频率与日志量。频繁重连和网络信号不稳定也会影响耗电。逐项减少不必要的后台操作并复测,不要仅凭 VPN 图标常驻就判断客户端持续进行大量传输。

提交问题前,需要保留哪些信息?

记录设备平台、网络类型、Global Routing 模式、所用协议、操作步骤和完整错误提示,并说明关闭连接后是否正常、换网络后是否复现、最近改过哪些设置。可以保留经过脱敏的规则片段,但不要发送完整订阅地址、二维码、密码、私钥或账户凭据。先用最小改动复现问题,再整理信息;如果问题仅涉及已有服务的到期、认证或地址状态,应向原服务提供方核对相应资料。