官方手册 · 问题索引
Shadowrocket 疑难解答
按故障发生的阶段查找:商店核对、安装与首次打开、已有订阅导入、连接与规则。
商店问题适用于 iPhone / iPad;安装条目也覆盖 Mac、Windows、安卓和 Linux。连接操作以 iPhone / iPad 的界面词为例。
如何核对 App Store 上的 Shadowrocket?
在 App Store 产品页核对三项:开发者为 Shadow Launch Technology Limited,图标与本页页头的官方图标一致,产品页地址末尾为 id932747118。只看应用名称或搜索结果里的图标不足以确认是同一个条目。购买前再核对当前商店显示的价格和设备兼容性。
电脑和安卓能用吗?购买客户端包含线路吗?
能用。iPhone / iPad 版在美区 App Store 为 $2.99 一次性付费,以商店页面为准;Mac(Apple 芯片版和 Intel 版)、Windows、安卓、Linux 版免费。电脑和安卓的安装包经本站下载页从 /dl/shadowrocket/ 分发。客户端一次性买断 ≠ 线路套餐;导入时使用你已有的订阅或服务器信息。
iPad 能安装吗?怎样确认系统要求?
能。iPhone 与 iPad 使用同一个 App Store 产品条目;系统要求以 App Store 页面标注为准。在 iPad 上打开产品页查看「兼容性」,再到系统「设置」的「关于本机」核对已安装的 iPadOS。若页面提示设备不兼容,先检查系统是否可以更新,不必重复搜索同名应用。
App Store 搜不到 Shadowrocket,先查什么?
先查购买账号所属的商店地区,而不是设备的语言与地区。打开系统「设置 → Apple ID → 媒体与购买项目 → 查看账户 → 国家/地区」。应用可见性取决于该店面。确需更改时,从同一页选择更改国家或地区,并先按 Apple 的提示核对余额、现有订阅与付款方式。
更换 iPhone 或 iPad,需要重新购买吗?
使用原购买账号且应用仍可重新下载时,不必重复购买。在新设备上打开 App Store,从个人头像进入已购项目查找 Shadowrocket;找不到时先核对「媒体与购买项目」使用的账号及当前店面。重新下载应用不会自动带回所有配置,换机前应另行备份需要保留的 Config。
Mac 应选 Apple 芯片版还是 Intel 版?
打开 Apple 菜单 →「关于本机」。如果「芯片」显示 Apple M 系列,在下载页选 Apple 芯片版;如果「处理器」显示 Intel,选 Intel 版。两个安装包都是 dmg,扩展名相同,不能用它判断芯片类型。提示应用不适用于本机时,先回到这一页核对,不要把架构不匹配当成安全拦截。
Mac 或 Windows 提示有风险,如何处理首次打开?
先停止打开,核对该文件确实由本站下载页经 /dl/shadowrocket/ 获取,且对应设备的系统与架构。仅在来源明确、提示只是无法验证开发者或发布者,且设备策略允许时,才考虑单次放行:macOS 在「系统设置 → 隐私与安全性」查看「仍要打开」;Windows 在 SmartScreen 的「更多信息」中查看「仍要运行」。如果系统明确报告恶意软件、文件来源不明或设备由组织管理,不要绕过拦截。
安卓和 Linux 安装时,如何区分权限问题与包选错?
安卓先核对设备是否支持 arm64。若系统仅提示安装权限,在确认文件来源后,只给用于打开安装包的应用临时授予「允许安装未知应用」,完成后关闭。Linux 按发行版选包:Debian 或 Ubuntu 用 deb,Fedora 或 RHEL 用 rpm;使用 AppImage 时,确认来源后为该文件添加执行权限。出现架构不匹配或依赖报错时,先核对发行版和处理器,不要把提权当成通用修复。
iPhone 或 iPad 的连接开关打不开,先检查哪里?
先在 Home 查看是否已经选中一个可用的 SERVER。首次打开连接时,系统可能要求允许添加 VPN 配置;核对提示中的应用名称后再确认。如果曾拒绝,可回到 Home 重试并观察系统是否再次弹窗。若另一项 VPN 正在使用,先确认是否可以暂时断开再试;受管理设备上的限制应由管理员核对。
界面是英文,按手册操作时要找哪些词?
在 iPhone 或 iPad 上,先用任务定位入口:到 Home 查看连接开关和 Global Routing,到 Config 核对当前配置,到 Settings 查找 On Demand 等设置。Add Server 用于填写已有服务器的信息,Subscribe 用于导入已有订阅。手册保留这些英文名称,查找时不必先修改系统语言。
Shadowrocket 订阅导入失败,怎么判断是哪一步出错?
先确认使用 Subscribe 导入的是服务方给你的完整订阅地址,而不是登录页地址或单个服务器的分享链接。重新从原处复制,检查末尾参数是否被截断或粘进了空格,然后在当前网络下重试。若提示无权限或链接过期,应核对该订阅是否仍有效;如果提示格式无法识别,先向原服务方确认返回内容的格式。不要把完整链接贴到公开页面。
Shadowrocket 订阅更新要重新添加一遍吗?
地址没变时,先更新 Home 中已有的订阅条目,不必再添加一个同名条目。更新后展开订阅,核对原来选中的服务器是否仍在列表里,再进行连接测试。若地址确实更换,先保留旧条目,等新地址导入成功、选中项也已确认后,再决定是否移除旧条目。
手里只有服务器参数,应该用 Subscribe 吗?
不用。已有单个服务器的参数时,打开 Add Server,先选与原信息一致的协议,再按原值填入地址、端口及该协议要求的字段。地址通常不包含协议前缀或路径;需要单独填写的字段不要拼到地址里。例如 VLESS 与 Trojan 所需的认证信息不同,不应互换。保存后回到 Home,选中该条目再测试。
扫二维码后为什么没有出现预期的服务器条目?
先区分扫描失败和导入失败:相机无法识别时,检查 Shadowrocket 的相机权限,以及二维码是否完整、清晰;识别后没有出现预期条目时,核对二维码承载的是订阅地址还是单个服务器信息,因为两者在 Home 中的呈现方式不同。如果扫出的是网页地址,回到原信息确认它是否用于导入。二维码可能含有凭据,排查时不要公开转发。
更新订阅成功,之前选中的服务器却不见了,怎么办?
更新成功只说明客户端读到了本次订阅内容,不代表上一批条目都被保留。展开同一个订阅核对列表,确认原条目是否被移除或更名。若当前没有可用的选中项,先在自己的订阅内重新选择并测试;如果 Config 中有规则依赖特定策略或服务器名称,也要确认引用仍能对应,不必先删除整个 Config。
Global Routing 的配置、代理、直连三种模式怎么选?
需要按规则分流时选 Config(配置),由当前 Config 决定哪些请求走 PROXY 或 DIRECT。需要验证选中的服务器能否处理经客户端接管的请求时,可短时切到 Proxy(代理),也就是常说的全局模式。需要在保持连接开关开启时对比不经代理服务器的访问表现,可选 Direct(直连)。测试结束后,切回原先使用的模式。
连接显示已开启,但网页打不开,应该按什么顺序查?
先关闭连接开关,用同一个地址验证设备当前网络可用;公共 Wi-Fi 若要求登录,先完成登录。网络正常时,重新连接并在 Home 确认选中的 SERVER,运行 Connectivity Test。若只有个别域名打不开,记下当前的 Global Routing 模式,核对活动 Config 的规则与 DNS。每次只改一项,再用相同的网址验证。
切到 Config 后,为什么请求没有按预想走 DIRECT?
先确认修改的是正在使用的 Config,再从上往下核对 [Rule]。同一请求可能先命中位置更靠前的规则;FINAL 只在前面的规则都没命中时才起作用。测试网页时,除了地址栏里的域名,还应留意网页加载资源时访问的其他域名。用 Log 查看实际请求,在明确误命中的规则后再调整顺序。
感觉连接后耗电更快,如何排查 On Demand?
先看系统「设置 → 电池」中的活动记录,不要只根据连接图标判断原因。记录当时用的是 Wi-Fi 还是蜂窝网络,是否频繁切换网络,再到 Settings 核对 On Demand 的启用条件。不需要按需连接时,可以暂时关闭 On Demand,在相近的用网场景中对比;完成后恢复原设置,避免把其他用网变化归到同一个原因。
Connectivity Test 通过,为什么还要测试实际网址?
Connectivity Test 通过只说明这一次测试使用的目标可达,不能代替实际网址的访问结果。同一设备上的实际请求还可能经过不同的规则、DNS 解析或服务器。用发生故障的原网址再试一次,并记录所用网络、Global Routing 模式和失败时间;查 Log 时按这些信息定位,分享记录前删去订阅地址和凭据。