官方手册按问题定位检查步骤

Shadowrocket 常见问题

先区分获取与安装、导入与分流、连接与访问故障,再检查对应设置。以下问答以用户已有自己的订阅或服务器信息为前提;需要完整操作顺序时,转到使用说明。

  • 4 类问题
  • 22 条操作说明
  • 点击问题展开答案

ACQUISITION / 01

正版与购买

核对设备、商店账户与购买记录。获取客户端和配置网络连接是两个独立步骤。

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

能。Shadowrocket 提供 iPhone、iPad、Mac、Windows、安卓和 Linux 版本。iPhone / iPad 版在 App Store $2.99 一次性付费;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。前者通过指定 App Store 产品页获取,其他平台的安装包由本站 /dl/shadowrocket/ 路径提供。先在下载指南中选择设备,再按该平台的安装说明操作,不要用相似名称判断产品身份。

iPad 能安装吗?系统要求在哪里看?

可以。iPhone 与 iPad 使用同一 App Store 产品条目,系统要求以 App Store 页面标注为准。iPhone / iPad 版 App Store $2.99 一次性付费,Mac、Windows、安卓、Linux 版免费。若已用同一 Apple 账户购买,先在 iPad 的已购项目中查找再下载;若页面显示购买按钮,先核对当前用于媒体与购买项目的账户,以及原购买记录,不要直接重复购买。

App Store 搜不到 Shadowrocket 怎么办?

先从下载指南打开指定产品页,再核对 App Store 当前账户的国家或地区。中国大陆商店目前没有此应用,搜索结果为空不等于应用名称需要更换。需要调整地区时,可进入系统 Settings 的 Apple 账户,依次查看媒体与购买项目、显示账户、国家或地区,按系统提示处理余额、现有订阅及付款资料等条件。仅修改设备语言或系统地区不会改变商店账户地区;不同系统的菜单名称可能略有差异。

换机或重装后需要再次购买吗?

iPhone / iPad 版 App Store $2.99 一次性付费,Mac、Windows、安卓、Linux 版免费。iPhone 或 iPad 换机后,使用原购买账户进入 App Store 的已购项目重新下载;没有找到时,先检查购买记录和隐藏的已购项目。其他平台从本站下载指南重新获取对应安装包即可。应用的购买记录与用户自己的配置是两件事,重装前应另行保存配置;不要假定重新下载应用会自动恢复全部服务器信息。

如何核对正版?购买客户端是否包含线路?

iPhone / iPad 在指定 App Store 产品页核对开发者 Shadow Launch Technology Limited、官方图标和应用 ID 932747118,不能仅凭名称或搜索排序判断;其他平台使用本站下载指南提供的 /dl/shadowrocket/ 安装包。iPhone / iPad 版 App Store $2.99 一次性付费,Mac、Windows、安卓、Linux 版免费。客户端一次性买断 ≠ 线路套餐。连接以用户已有自己的订阅或服务器信息为前提,本站不提供、不销售、不推荐节点或订阅。

相关入口:正版核验说明 → · 已购恢复说明 →

INSTALLATION / 02

安装与首次打开

先核对本站来源与设备架构,再处理系统提示。放行操作只针对已确认来源的文件,不替代来源核对。

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

打开 Apple 菜单中的“关于本机”:显示“芯片”及 Apple 芯片名称时选择 Apple 芯片版;显示 Intel 处理器时选择 Intel 版。不要根据机身外观或浏览器识别结果猜测芯片。下载对应 dmg 后,将应用放入 Applications。首次打开若提示无法验证开发者,先确认文件来自本站,再到系统设置的隐私与安全性中选择“仍要打开”。若仍无法启动,记录完整提示,回到下载指南对应步骤排查。

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

先确认安装包来自本站下载指南,并确认芯片类型正确。提示无法验证开发者时,在尝试打开后进入系统设置的隐私与安全性,查看对应应用的“仍要打开”。提示应用已损坏时,先重新下载并替换应用;确认来源和安装路径后,可在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app 清除该应用的隔离属性,再重试。这项操作不是安全检测,不要对来源不明的文件执行,也不要关闭整个系统的安全保护。

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

先停止操作并检查下载来源,确认文件来自本站下载指南指向的 /dl/shadowrocket/ 路径,且是 Windows 安装包。确认后,SmartScreen 页面可通过“更多信息”查看文件信息,再选择“仍要运行”。若界面没有该选项,可能受到设备管理策略限制,应联系设备管理员,不要尝试关闭整套防护。安装过程中出现与预期不同的文件名称、权限请求或额外程序时,取消操作,重新核对下载入口。

安卓下载后不能安装,或在微信里点不开怎么办?

在微信内无法下载时,将本站下载指南交给系统浏览器打开,再下载安卓安装包。安装时若系统提示权限不足,到系统设置中为刚才使用的浏览器或文件管理器开启“允许安装未知应用”,完成安装后可关闭该权限。授权只针对实际使用的应用,不必给所有应用开放。若提示安装包解析失败,先删除未下载完整的文件并重新获取,再检查设备是否适用 arm64 安装包,不要反复安装同一份异常文件。

Linux 应选择哪种安装包?首次运行要注意什么?

在下载指南中按发行版选择 deb、rpm 或 AppImage,不要仅依据桌面环境判断。使用 deb 或 rpm 时,优先让系统的软件安装工具处理依赖;使用 AppImage 时,先在文件属性中允许作为程序执行,再启动文件。若终端提示权限或依赖错误,保留完整输出并按发行版说明处理。安装包应从本站获取;运行前核对文件来源与架构,不要为了消除错误而给未知程序授予管理员权限。

相关入口:按平台选择安装包 → · 安装放行步骤 →

SUBSCRIBE & ROUTING / 03

订阅与节点导入、规则与分流

本类合并导入与路由问题:先确认服务器信息完整,再确认 Config 和 Global Routing 的处理方式。

已有订阅导入失败,应先检查哪些内容?

先确认复制的是用户已有的完整订阅地址,而不是账户管理页面、说明页面或聊天中的截断文本。检查地址前后是否带空格、换行和多余标点,并确认当前网络能访问订阅地址。随后按使用说明在 Add Server 中选择 Subscribe,粘贴地址并保存。若返回内容不是可解析的订阅数据,记录错误类型,向原服务方核对格式与有效期。不要把含访问凭据的完整地址贴到公开页面,也不要用别人的地址替换测试。

订阅如何更新?更新后服务器列表变化正常吗?

在 Home 中找到对应的 Subscribe 条目,使用该条目的更新操作;不同设备上的入口以实际界面为准。更新会重新读取订阅返回的服务器列表,名称、顺序和可用条目可能随返回内容变化。更新后重新检查当前默认服务器,不要只看原来的名称是否还在。若更新失败而旧条目仍可使用,先保留现有数据,检查网络、地址与有效期,不要立即删除整个订阅;排查前可记录条目名称和错误提示,但应隐藏地址中的凭据。

服务器订阅与 Config 配置文件有什么区别?

服务器订阅主要用于导入和更新服务器信息,Config 配置文件用于组织路由规则及相关设置。列表中出现服务器,不代表已经启用了合适的规则;导入 Config,也不代表其中引用的服务器或策略名称都已存在。首次设置时先确认服务器可以连接,再检查当前选中的 Config、规则目标名称和 Global Routing。导入已有文件前先阅读其内容,保存原配置副本,避免为处理一个连接问题而覆盖所有设置。

Global Routing 的 Config、Proxy、Direct 怎么选?

Config(配置)按照当前配置中的规则分流;Proxy(代理)将客户端接管的流量交给代理处理;Direct(直连)让客户端接管的流量直接连接。日常使用已有规则时先选 Config。临时排查时,可对同一目标分别测试 Proxy 与 Direct,观察差异,再恢复原模式。不要把 Proxy 理解为自动修复所有连接,也不要把 Direct 理解为关闭系统里的 VPN 配置;模式决定流量处理方式,连接开关决定是否建立客户端连接。

Config 中的规则为什么没有按预期生效?

先确认 Global Routing 处于 Config,并确认启用的是刚修改的配置。规则通常按顺序匹配,较早命中的规则可能先于后面的细分规则处理请求;检查 DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP 等条件和最终的 FINAL。还要核对规则目标是否存在、域名是否确实匹配,以及测试应用是否复用了旧连接。保存后重新发起一次请求并查看相关记录,每次只改一项;不要通过同时修改 DNS、规则和服务器来判断单条规则的效果。

手动 Add Server 时应该选择哪种协议?

以用户已有服务器信息明确标注的协议为准,在 Add Server 中选择对应 Type。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 和 Hysteria2 的字段不能互相套用,不能只把地址和端口复制过去就认为配置完整。逐项核对认证信息及服务端要求的 TLS、传输方式和相关参数;没有提供的内容不要凭名称猜测。若通过二维码导入,也应在保存前核对类型与关键字段,协议名称本身不能保证连接速度或可用性。

相关入口:导入与首次连接说明 → · 协议参考 →

DIAGNOSTICS / 04

故障排查

按基础网络、连接权限、服务器、路由和 DNS 的顺序缩小范围。“已连接”与“目标可访问”需要分别确认。

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

先在 Home 中选择一个有效服务器作为默认项,再打开连接开关。iPhone / iPad 首次连接需要按系统提示允许添加 VPN 配置;如果之前取消过,重新触发并完成系统认证。检查是否有其他 VPN 连接、设备管理限制或系统权限阻止建立连接。若应用立即报错,先记录完整文字,再检查所选服务器的必填字段。反复点击开关不会补齐缺失的配置,也不应为了测试而删除设备中用途不明的管理描述文件。

显示已连接,但网页无法打开怎么排查?

先关闭客户端连接,确认当前 Wi-Fi 或移动网络本身可以正常访问网页,再恢复连接。运行 Connectivity Test,观察所选服务器是否可达;然后检查 Global Routing 与当前 Config,确认流量没有被不适用的规则处理。若服务器测试可达但域名访问失败,再检查 DNS 设置与实际解析错误。用同一目标、同一网络逐项测试,每次只改一个变量。连接状态只说明客户端连接已建立,不代表远端服务器、解析和每个目标网站都正常。

Connectivity Test 有结果,是否代表所有应用都能访问?

不能直接这样判断。Connectivity Test 是针对测试目标和当前服务器的一次连通检查,其结果不能替代目标网站或应用的实际访问,也不能当作带宽测试。若测试通过而某个应用失败,检查该应用访问的域名、命中的规则、DNS 结果以及是否沿用了旧连接。记录测试时使用的网络、服务器和路由模式,再重试同一目标;不要把不同网络条件下的测试数字直接比较,也不要仅凭单次结果删除全部配置。

界面是英文,如何对应中文教程操作?

官方手册保留界面词的英文原文:Home 对应服务器列表所在页面,Add Server 用于添加服务器,Subscribe 用于订阅条目,Config 用于配置管理,Settings 用于设置,Global Routing 用于选择路由模式。先按英文关键词定位,再阅读旁边的中文操作解释,不需要根据图标位置猜测。不同平台或系统下布局可能不同;如果某项入口与教程位置不一致,应以当前设备上的同名项目为准,不要把系统设置页面与应用内 Settings 混为一处。

开启连接后耗电增加,如何判断原因?

先在系统电池统计中确认变化发生的时间段,再区分持续传输、弱信号、后台任务与反复重连等因素。代理连接的耗电受协议、网络质量、流量和连接稳定性共同影响,不能仅凭协议名称判断。排查时保持相同网络和使用场景,暂停不必要的下载,检查是否有连续连接失败或重试记录;每次只改变一个设置。不要为降低耗电而随意关闭必要的认证或加密,也不要把短时间的电量波动当作长期结论。

On Demand 为什么自动连接?如何停止反复触发?

On Demand 会依据已设置的条件触发连接,因此手动断开后,符合条件的网络活动仍可能再次建立连接。先查看 On Demand 是否启用及其匹配条件,临时排查时可关闭该设置,再观察手动连接是否稳定。不要只反复关闭 Home 开关而保留同一触发条件;也不要把自动触发与服务器连接失败混为一谈。确认问题后再逐项恢复需要的条件,并在切换 Wi-Fi 与移动网络时分别验证,避免一次调整多组条件后无法判断原因。

相关入口:功能与设置说明 → · 返回分类导航 ↑