[FAQ]官方手册
Shadowrocket 常见问题
从获取与安装开始,按订阅、配置、连接的顺序定位问题。先确认当前设备和报错,再展开对应问答;操作前保留现有可用配置。
还未安装?先查看全平台下载与安装说明。首次使用可按快速上手依次操作。
[Verify]
正版与购买
先核对平台、商店产品页与购买账号,再处理地区或恢复问题。
电脑和安卓能用吗?各平台如何获取?
能。Shadowrocket 提供 iPhone、iPad、Mac、Windows、安卓与 Linux 版本。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。前往全平台下载页选择设备;电脑与安卓的安装包通过本站 /dl/shadowrocket/ 路径提供。客户端一次性买断 ≠ 线路套餐,安装客户端后仍需导入用户已有的订阅或服务器信息。本站不提供、不销售、不推荐节点或订阅。
怎样核对 App Store 里的 Shadowrocket?
打开本页给出的 App Store 产品页,核对名称 Shadowrocket、开发者 Shadow Launch Technology Limited,以及链接中的应用 ID 932747118;图标应为白底蓝紫描边火箭。不要只凭搜索结果中的相近名称判断。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。电脑与安卓请使用本站下载页的安装包入口,不把移动端商店的购买记录当作其他平台安装的前置条件。
App Store 搜不到,应该核对哪里?
中国大陆 App Store 当前不提供此应用的搜索与获取。先在系统 Settings 中进入 Apple Account → Media & Purchases → View Account → Country/Region,核对实际用于购买项目的账号地区,而不是只看设备语言或系统地区。再打开指定产品页确认当前商店的可见性。如需更改地区,使用该页面的 Change Country or Region,并先阅读 Apple 对余额、现有订阅和付款方式的要求;更改设备语言不会改变商店地区。
换机或重装后,需要重新购买吗?
iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。iPhone 或 iPad 使用原购买账号登录 Media & Purchases 后,可在 App Store 的已购应用列表中查找并重新下载,通常不需重复支付;如果仍显示购买按钮,先核对购买账号和购买记录。应用恢复不等于配置恢复,订阅、Config 文件与本地参数仍要单独核对。电脑与安卓换机可重新从本站下载页获取对应安装包。
iPad 能安装吗?与 iPhone 的购买通用吗?
可以。iPhone / iPad 版在 App Store $2.99 一次性付费,使用同一购买账号时可在这两类设备上下载;Mac / Windows / 安卓 / Linux 版免费。iPhone 与 iPad 的系统要求以 App Store 页面标注为准,安装前检查产品页的兼容性项目。两台设备上的连接开关、已选服务器和当前配置需要分别确认;购买通用并不代表连接状态自动同步,也不代表已有服务允许两台设备同时连接。
[Install]
安装与首次打开
确认安装包来源与系统架构,按系统提示放行,再检查连接权限。
Mac 应选 Apple 芯片版还是 Intel 版?
在 Mac 的 Apple 菜单中打开“关于本机”:看到“芯片”及 Apple 芯片名称时选择 Apple 芯片版,看到 Intel 处理器时选择 Intel 版。下载页提供两种对应的 dmg,不要依靠机身外观或购买年份判断。打开 dmg 后将 Shadowrocket 放入 Applications。首次打开若提示无法验证开发者,核对安装包来自本站,再到系统设置的“隐私与安全性”选择“仍要打开”;不要为打开单个应用关闭整机的安全保护。
Windows 或 Mac 提示风险,怎样处理?
先确认文件由本站下载页获取。Windows 出现 SmartScreen 提示时,可在确认来源后选择“更多信息 → 仍要运行”;受组织管理的电脑可能需要管理员批准。Mac 提示无法验证开发者时,在“隐私与安全性”中选择“仍要打开”。若明确提示应用“已损坏”,先重新下载并放入 Applications,确认来源后再执行 xattr -cr /Applications/Shadowrocket.app。来源不明或安全软件报告具体威胁时应停止操作,不要直接忽略告警。
安卓与 Linux 首次安装要注意什么?
安卓从本站下载页获取 apk;如果微信内不能下载,改用系统浏览器打开。在系统设置中仅为实际用于安装的浏览器或文件管理器开启“允许安装未知应用”,安装完成后可关闭该权限。Linux 按发行版选择 deb、rpm 或 AppImage;AppImage 需先在文件属性中允许作为程序执行,或使用 chmod +x 后运行。安装前核对系统架构,遇到组织策略拦截时联系管理员,具体命令与平台放行步骤见下载页的安装说明。
Home 的连接开关打不开或立即关闭怎么办?
先确认 Home 中已选择有效服务器,导入列表不等于已经选中。首次连接时允许系统创建 VPN 配置;此前拒绝过权限的,可重新触发连接并检查系统的 VPN 设置。再暂时停止其他正在使用 VPN 通道的应用,排除同一通道被占用。如果开关立即关闭,查看 Log 中最早出现的错误,重点核对配置语法、证书、端口与权限。不要连续重装,先备份现有 Config 与订阅信息,再按具体报错处理。
界面是英文,应该先认识哪些项目?
先用 Home 找到服务器列表与连接开关,用 Add Server 添加服务器或 Subscribe,用 Config 管理规则文件,用 Settings 查找应用设置。Global Routing 中的 Config、Proxy、Direct 分别对应配置、代理、直连三种姿态。本手册保留这些英文界面词,便于逐项核对;如果设备提供应用语言选项,可到系统 Settings 中查看 Shadowrocket 的语言设置。菜单位置可能随系统和平台变化,应以当前设备实际显示为准。
[Subscribe]
订阅与节点导入
以下操作以用户已有自己的订阅或服务器信息为前提。
已有订阅导入失败,先检查什么?
先确认拿到的是用户已有服务的订阅链接,而不是账号登录页、网页分享页或单个服务器链接。在 Add Server 中选择 Subscribe 后粘贴完整地址,检查首尾空格、换行和复制时遗漏的查询参数。若返回空列表,核对服务状态、链接有效期和订阅格式;若返回网页内容,通常是地址类型或访问验证不符。不要把完整订阅地址发到公开评论或截图中,其中的 token 可能允许他人读取你的服务配置。
手动填写服务器或扫描二维码后仍不能用?
在 Add Server 核对 Type 与用户已有服务器的协议一致,再逐项检查 SERVER、Port、Password 或 UUID,以及 TLS、SNI、传输方式等附加参数。Scan QR Code 只是把二维码里的内容读入客户端,并不能证明内容完整或服务器可用。导入后重新打开条目,与原始信息逐项比较,尤其留意密码中的符号和服务器地址前后的空格。不要为了让连接成功随意关闭 TLS 验证,应先修正证书名称、SNI 或服务器端配置。
怎样更新订阅,更新失败会影响什么?
在 Home 找到对应订阅分组,使用其更新操作,更新后检查服务器列表与当前选中条目。失败时先保留现有可用配置,确认设备能够访问订阅地址,再核对地址是否变更、服务是否到期及返回内容是否为有效订阅。不要通过反复删除重建来代替排查,以免丢失手动修改。订阅更新主要刷新订阅所包含的服务器信息,并不等于同时更新 Config 中的规则文件;两者应分别检查。
订阅与 Config 配置文件有什么区别?
订阅通常用于维护服务器列表,Config 文件用于组织 DNS、规则和策略等配置。只有订阅可用,不代表已启用正确的规则;只有规则文件,也不代表已经具备可连接的服务器。先在 Home 选择服务器,再在 Config 核对需要使用的文件,最后将 Global Routing 设为 Config。编辑前保留原文件副本,每次只修改一类设置,遇到问题才能区分是服务器参数、规则顺序还是 DNS 配置造成的。
换设备前应备份哪些内容?
分别记录订阅来源、手动服务器参数、当前启用的 Config 文件,以及 DNS、On Demand 等自行修改的设置。使用 iCloud 同步时,先核对系统 iCloud 权限与应用中的同步状态,不把打开开关视为备份已经完成。导出的配置文件可能包含地址和访问凭据,应保存到自己控制的位置。新设备恢复后先检查文件和服务器是否齐全,再选择服务器、设置 Global Routing 并测试连接;确认恢复成功后再清理旧设备。
相关参考:首次导入与连接流程 · Settings 设置项参考
[Rule]
规则分流与故障排查
每次只改变一个条件,区分基础网络、服务器连接与规则命中问题。
Global Routing 的三种姿态怎样选?
配置对应 Config,按当前配置文件中的规则决定请求策略,适合需要规则分流的场景;代理对应 Proxy,通常将请求交给所选代理,用于短时确认服务器是否可用;直连对应 Direct,让请求直接连接,可用来与代理路径作对照。日常使用规则时选择 Config,并确认规则中的策略存在。切换姿态只是改变请求处理方式,不会修复服务器参数错误。测试后恢复原有姿态,避免把临时排查设置长期保留。
显示已连接,但网页打不开怎么办?
先关闭连接,确认当前 Wi-Fi 或蜂窝网络本身能够访问正常网页,再重新连接并查看 Log。短时切换到 Proxy 测试:若 Proxy 可用而 Config 不可用,重点检查规则顺序、策略名称与 DNS;若两者都不可用,核对当前服务器参数和服务状态。Connectivity Test 只能反映相应测试目标与方式的结果,不能证明所有网站都能访问。每次只改变一个条件,并记录测试姿态、网络类型和具体失败域名。
Shadowrocket 无法连接,应按什么顺序排查?
按本地网络、系统权限、服务器参数、服务状态、规则配置的顺序排查。先验证基础网络,再确认 VPN 权限和已选服务器;然后检查 SERVER、Port、身份凭据、TLS 与设备时间,最后查看 Log 中首次失败的记录。超时、认证失败和证书错误对应不同原因,不要统一归结为规则问题。向已有服务的维护方反馈时,提供经过脱敏的错误摘要与发生条件,不发送完整订阅地址、密码或包含凭据的配置文件。
规则看似正确,为什么仍然走错策略?
先确认 Global Routing 当前为 Config,且启用的是刚编辑的文件。规则通常按先后顺序匹配,较宽泛的 DOMAIN-KEYWORD 或 IP-CIDR 放在前面时,可能先于后面的具体条目命中;FINAL 通常应置于末尾。再查看实际请求使用的域名、IP 与 DNS 结果,不能只凭浏览器地址栏推断全部连接。更改 DNS 后重新发起请求,必要时重建连接,避免旧连接和缓存影响判断;一次只调整一条规则并观察记录。
开启后耗电增加,On Demand 应怎样检查?
先在系统电池统计中比较相近使用时长与网络条件,长时间传输、网络信号弱、频繁重连和持续记录详细 Log 都可能增加消耗。排查结束后恢复常规日志设置,避免反复执行测速或 Connectivity Test。若连接会自动恢复,检查 On Demand 的网络触发条件;它用于按条件建立连接,不是提升连接质量的开关。先关闭相关条件作对照,再按需要逐项启用,并分别在 Wi-Fi 与蜂窝网络下验证触发是否符合预期。