SHADOWROCKET / 官方手册
Shadowrocket 常见问题
安装、订阅与规则排查
先按症状定位,再展开检查步骤。连接设置以用户已有的订阅或服务器信息为前提;操作前保留当前可用配置,一次只调整一项。
电脑和安卓能用 Shadowrocket 吗,价格如何区分?
可以。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac(Apple 芯片版与 Intel 版)、Windows、安卓、Linux 版免费。进入全平台下载页按设备选择;电脑与安卓、Linux 的安装包由本站 /dl/shadowrocket/ 路径提供。iPhone / iPad 的系统要求以 App Store 页面标注为准;其他平台首次安装的系统放行方法见本页下载安装分类。
如何在 App Store 核对 Shadowrocket?
打开产品页后,同时核对名称 Shadowrocket、白底蓝紫描边火箭官方图标、开发者 Shadow Launch Technology Limited,以及产品链接中的应用 ID 932747118。不要只依据搜索结果的名称判断。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;电脑与安卓、Linux 的安装包请从本站全平台下载页进入。
App Store 搜不到 Shadowrocket,先检查什么?
先检查当前用于 App Store 的 Apple ID 所属国家或地区;中国大陆商店不提供此应用。可打开本页给出的产品页核对可用性,但产品页链接不会自动更改账号地区。如确需调整,在系统 Settings 中进入 Apple ID → Media & Purchases → View Account → Country/Region,并按 Apple 提示处理余额、订阅及付款资料要求,不要把设备语言设置当成商店地区。
换 iPhone、重装或改用 iPad,需要再次购买吗?
iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。iPhone 与 iPad 使用购买时的同一 Apple ID,可在 App Store 已购项目中查找并重新下载;设备仍需满足产品页的系统要求。如果再次出现购买价格,先核对商店账号和购买记录,不要急于重复付款。重新下载应用不等于恢复配置,原有订阅、规则与服务器资料应另行保留。
购买客户端以后,是否已经包含可用线路?
不包含。客户端一次性买断 ≠ 线路套餐;Shadowrocket 用于导入和管理用户已有的订阅或服务器信息。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费,这两档获取方式都不代表附带线路服务。本站不提供、不销售、不推荐节点或订阅。开始配置前,请准备自己的有效连接资料,并确认其使用期限和参数。
Mac 应该选择 Apple 芯片版还是 Intel 版?
在 Apple 菜单中打开“关于本机”,查看显示的是“芯片”还是“处理器”:Apple 芯片设备选择 Apple 芯片版,Intel 处理器设备选择 Intel 版。下载页提供两个对应的 dmg 按钮,不需要凭机器外观判断。首次打开如提示无法验证开发者,确认安装包来自本站后,到系统设置的“隐私与安全性”中选择“仍要打开”;公司管理的设备还可能需要管理员授权。
Windows 提示 SmartScreen 风险,如何继续安装?
先确认安装程序来自本站下载页,并与设备架构相符;Windows 提供 64 位安装程序。安装包没有代码签名,首次运行可能触发 SmartScreen。在已核对来源且决定继续的前提下,点击“更多信息”,再选择“仍要运行”。不要为运行单个程序长期关闭系统防护。如果没有继续按钮,或设备受组织策略管理,应联系设备管理员;遇到明确的恶意软件检测时先停止运行并核实。
Mac 提示无法验证开发者或应用已损坏怎么办?
先核对下载来源与芯片版本,将应用放入 Applications 后再打开。提示无法验证开发者时,前往系统设置 → 隐私与安全性,查看对应记录并选择“仍要打开”。如果提示“已损坏”,确认应用完整且来自本站后,可在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app,再重试。该命令会清除指定应用的扩展属性,不应对来源不明的程序或其他目录批量执行。
安卓安装被拦截,应该修改哪个权限?
从本站下载页取得适合 arm64 设备的安装包后,若系统提示不允许此来源安装,进入系统设置中的“允许安装未知应用”,只为当前用于打开安装包的浏览器或文件管理器授权,再返回继续。完成后可以收回该来源的权限。不同设备的设置名称可能略有差异;如果提示解析失败,应检查文件是否下载完整、设备架构是否匹配,以及是否受到工作资料或家长控制策略限制。
Linux 的 deb、rpm、AppImage 应该怎么选?
Debian、Ubuntu 等通常选择 deb,Fedora 等通常选择 rpm;需要直接运行文件时可查看 AppImage。先从本站下载页选择与系统架构相符的文件,再使用发行版包管理器安装。AppImage 需要先授予执行权限,可对实际下载文件执行 chmod +x 后运行;部分发行版还需要相应的 FUSE 运行支持。安装前查看包管理器的依赖提示,不要仅凭文件扩展名认定所有发行版都兼容。
iPhone / iPad 第一次打开,VPN 权限应该怎样处理?
在准备好自己的订阅或服务器信息后,按教程完成导入,再启动连接。系统请求添加 VPN 配置时,核对请求来自 Shadowrocket,并按提示允许和完成设备认证。若此前拒绝,可重新发起连接并查看系统的 VPN 管理设置。受管理设备可能禁止添加个人 VPN;此时应联系管理员,不要删除组织配置。允许 VPN 配置只是建立本机连接权限,仍需有效服务器及正确参数才能访问网络。
已有订阅链接,如何导入 Shadowrocket?
先从自己的服务商资料中复制完整订阅链接,打开 Home,进入 Add Server,将 Type 设为 Subscribe,在 URL 中粘贴链接并保存;可填写便于识别的名称。回到列表后等待内容加载,再选择其中一个服务器测试。粘贴前后检查是否多出空格、换行或缺少查询参数。订阅链接通常包含访问凭据,不要放进公开截图、聊天记录或反馈正文;具体界面位置可对照订阅导入教程。
订阅导入失败,怎样区分链接问题和网络问题?
先检查 URL 是否完整、订阅是否到期,以及链接是否返回客户端可识别的订阅内容,而非登录页或错误页面。再分别使用 Wi-Fi 与移动网络尝试一次,观察错误是否随网络变化。若出现 HTTP 错误,记录状态码;若是超时,检查当前网络与订阅地址的可达性。不要反复删除原有可用条目,也不要公开完整链接。仍无法确认时,只向自己的服务商提交脱敏后的错误和发生步骤。
怎样更新订阅,更新后服务器为什么变了?
在 Home 找到对应订阅分组,使用该分组的更新操作,等待请求结束后再检查列表。更新会按订阅地址返回的内容刷新条目,服务端移除或调整服务器时,本地名称与可选项也可能改变。更新前先记下当前使用的条目和自定义设置,手动添加的服务器另行保存。遇到空列表或报错时先排查链接有效性,不要连续重复请求;订阅更新也不会自动替代 Config 中单独管理的规则文件。
VLESS 等协议应如何填写,为什么导入后仍不能连接?
按自己服务器提供的协议资料选择 Type,不要把 VLESS、VMess、Trojan 或 Shadowsocks 的字段互相套用。导入只能减少手动输入,并不证明全部参数正确;仍需逐项检查地址、端口、认证信息、TLS、传输方式及相关主机名。遇到连接失败时,先与原始资料逐项对照,再测试单个条目。不要为了消除错误随意关闭证书验证,也不要把含认证信息的完整连接链接贴到公开反馈中。
订阅、服务器和 Config 配置文件分别管理什么?
服务器条目保存具体连接参数;订阅地址用于获取和刷新一组服务器;Config 中的配置文件则用于管理规则、策略及相关网络设置。三者关联使用,但不应当作同一份备份。修改前记录当前启用的 Config,并另行保留手动添加的服务器和已有订阅资料。导入新的规则文件后,应确认其策略名称能对应到实际可用的选择;仅更新订阅,不能据此判断本地规则已经同步更新。
扫描二维码或手动添加后,应该检查哪些内容?
使用 Scan QR Code 或 Add Server 后,先核对 Type、服务器地址、端口及认证字段,再检查 TLS 和传输参数是否与自己的原始资料一致。二维码也可能只包含部分信息,扫描成功不等于服务器可用。保存后先选中单个条目运行 Connectivity Test,再尝试连接和访问目标网站。需要反馈时遮盖二维码、认证字段和订阅 URL,只保留错误提示及不含凭据的设置项名称。
Global Routing 的 Config、Proxy、Direct 怎么选?
配置(Config)按当前配置文件中的规则决定连接去向,适合检查规则分流;代理(Proxy)用于检查流量经所选代理处理时的表现;直连(Direct)用于对照本地网络。排查时一次只改一个姿态,记录同一目标的访问结果。Proxy 不会让无效服务器恢复,Direct 也不是代理连通的证明。完成对照后恢复需要的姿态,并检查当前 Config 是否选对、策略是否引用了有效服务器。
Home 开关打不开,或刚打开就断开怎么办?
先确认已经选中有效服务器,再查看系统是否等待添加 VPN 配置或设备认证。若开关立即回落,检查系统 VPN 设置中是否存在冲突连接,以及设备是否受组织策略限制;需要切换时先正常停止其他连接。保留错误提示后重启应用再试,不要把删除全部配置作为第一步。如果始终无法创建连接,按问题诊断页记录系统版本、触发步骤和脱敏日志,以区分权限失败与服务器连接失败。
显示已连接却无法上网,排查顺序是什么?
先停止连接,确认本地网络能访问正常使用的网站;再恢复连接,对当前服务器运行 Connectivity Test。随后临时用 Proxy 与 Config 对照同一个目标:若 Proxy 可用而 Config 异常,重点检查规则、策略和 DNS;若两者均失败,检查服务器状态、认证参数与网络可达性。已连接只说明本机连接状态已建立,不表示所有目标都能访问。每次只修改一项,保留原配置以便恢复。
Connectivity Test 超时,但有时还能访问网站,如何判断?
Connectivity Test 的结果与测试目标、测试方式及当时网络有关,不能单独代表所有应用的访问结果。先确认选中的服务器,再对照实际需要访问的网站,并在另一种网络下重复一次。若只有测试失败而业务正常,检查测试目标是否可达;若实际访问也持续失败,再排查服务器、端口和 DNS。不要把一次读数当成长期速度结论,也不要为改善单个测试结果同时更换多项设置。
只有部分域名打不开,是否应该修改 DNS?
先比较域名的规则命中结果与当前策略,确认问题不是某条 DOMAIN-SUFFIX 或 GEOIP 规则把连接送到了不合适的去向。再查看相关请求是否出现解析失败,并对照另一网络的结果。修改 DNS 前保存当前 Config,逐项调整并复测同一域名,不要同时更换服务器和全部解析设置。若域名能解析但建立连接失败,应继续检查 TLS、服务器可达性和目标本身,而不是只围绕 DNS 反复修改。
后台耗电增加,On Demand 应该开还是关?
先在系统电池统计中确认耗电时段、后台活动和实际流量,再检查日志是否频繁重连。On Demand 根据条件触发连接,是否适合开启取决于使用场景;网络切换频繁、规则反复满足时,应先检查触发条件。可在相近使用条件下暂时关闭 On Demand 作对照,并记录是否改善。持续的大量传输和其他应用活动同样会影响耗电,不应只凭 VPN 图标常驻就判断原因。
界面是英文,或者更新后设置位置变了怎么办?
本手册保留 Home、Config、Settings、Global Routing、Add Server 等英文界面词,可按这些名称定位,不必根据中文近义词猜测。不同平台及应用更新后的布局可能不同,先按操作目标查找对应设置,再对照教程步骤。更新前保存当前可用配置;更新后异常时先确认所选服务器、Global Routing 和 Config 是否保持原值,再逐项复测,不要仅因位置变化就清除全部数据。
继续查阅对应步骤
需要从头操作时阅读教程;已经有明确症状时进入问题诊断。记录问题时写清设备系统、操作步骤、错误原文,以及更换网络后的对照结果,反馈前移除订阅链接与认证信息。