Shadowrocket 官方手册

Shadowrocket 常见问题

按设备获取、首次连接、已有订阅和规则排查查找答案。先记录当前设置,每次只改变一个条件;涉及连接信息时,以你已有服务商提供的参数为准。

4 类问题 24 项解答 按现象逐项检查

正版与购买

先确认平台、商店账户和应用条目,再处理购买与恢复。

电脑和安卓能使用 Shadowrocket 吗?

可以。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。Mac 提供 Apple 芯片与 Intel 两个版本,其他设备按下载页的平台说明选择。电脑与安卓安装包统一由本站 /dl/shadowrocket/ 路径提供;取得客户端后,仍需准备自己已有的订阅或服务器信息。

购买客户端是否包含可以使用的线路?

不包含。客户端一次性买断 ≠ 线路套餐。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;这些获取方式对应的是客户端本身。连接所需的订阅、服务器地址、端口及认证参数,应使用你已有服务商提供的信息。本站不提供、不销售、不推荐节点或订阅,也不会通过导入教程代为配置线路账户。

App Store 搜不到 Shadowrocket 时应检查什么?

先从下载页打开 Shadowrocket 的 App Store 产品页,确认不是名称拼写或搜索结果造成的遗漏。中国大陆商店目前没有此应用,可在设备的 Settings → Apple 账户 → Media & Purchases → View Account → Country/Region 核对账户地区。如需变更,应按 Apple 官方账户流程操作,并先处理余额、有效订阅及家庭共享等限制;不要仅凭设备的语言或地区设置判断商店地区。

怎样核对 App Store 中的正版条目?

在产品页同时核对名称 Shadowrocket、开发者 Shadow Launch Technology Limited、应用 ID 932747118,并与本站页头的官方图标对照。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;不要把商店中标价免费的同名条目当作本产品。电脑与安卓则从本站下载页获取,安装包地址应位于本站 /dl/shadowrocket/ 路径。

换机、重装或从 iPhone 换到 iPad,需要重新购买吗?

iPhone / iPad 使用原购买 Apple 账户时,可先到 App Store 的已购应用列表查找 Shadowrocket 并重新下载,两种设备通用。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。若仍显示购买价格,先检查登录账户和商店地区,再核对购买记录,不要直接重复付款。应用重新下载并不等于配置恢复,原有订阅和配置还需单独迁移。

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

可以,iPhone 与 iPad 均通过 App Store 产品页获取。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。iPad 的系统要求以 App Store 页面标注为准;若安装按钮不可用,检查当前系统、商店账户地区及设备管理限制。准备使用时,还应保留自己的订阅原文与必要的服务器参数,避免只迁移应用而遗漏连接配置。

相关说明:正版核对 · 已购恢复 · App Store 产品页

安装与首次打开

根据设备架构选择文件;遇到系统提示时,先确认文件来源。

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

打开 Apple 菜单中的“关于本机”:显示 Apple 芯片名称时选 Apple 芯片版,显示 Intel 处理器时选 Intel 版。下载页提供两个对应的 dmg 按钮,不需要根据设备外观或购买年份猜测。安装后若出现“无法验证开发者”,先确认安装包来自本站,再到系统设置的“隐私与安全性”选择“仍要打开”;如果提示“已损坏”,按安装放行说明处理,不要反复下载不同架构碰运气。

Windows SmartScreen 提示风险,或 Mac 提示无法打开,怎么办?

先确认文件来自本站下载页及 /dl/shadowrocket/ 路径。Windows 的 SmartScreen 拦截界面可选择“更多信息 → 仍要运行”。Mac 提示“无法验证开发者”时,到“系统设置 → 隐私与安全性”选择“仍要打开”;提示“已损坏”且已将应用放入 Applications 时,可在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app 后重试。上述操作只针对已确认来源的文件;受管理设备应先联系管理员。

安卓安装受阻,或 Linux AppImage 无法启动,怎么处理?

安卓先从本站下载页获取 arm64 安装包,再按系统提示为实际打开文件的浏览器或文件管理器启用“允许安装未知应用”;安装完成后可关闭这项权限。Linux 应先按发行版选择 deb、rpm 或 AppImage;AppImage 需对实际下载文件执行 chmod +x,再尝试运行。不要把一种发行版的包格式强行用于另一种系统;如果提示架构不兼容,应先核对设备架构与下载页说明。

第一次连接时,开关打不开或 VPN 授权不出现怎么办?

先确认 Home 中已经有可选择的服务器,并完成该设备首次连接所需的 VPN 配置授权。iPhone / iPad 可检查系统 Settings 中的 VPN 配置,确认授权没有被取消;同时暂时关闭其他正在占用系统 VPN 的连接再试。若设备受企业或学校管理,权限可能由管理策略限制。仍不能启用时,记录系统提示原文,重启设备后重试,不要连续删除全部配置或重置网络来替代定位。

界面是英文,应该先认识哪些项目?

教程会保留界面原文:Home 用于选择服务器与连接,Add Server 用于添加连接信息,Subscribe 对应订阅类型,Config 用于配置文件,Global Routing 控制流量处理方式,Settings 放置应用设置。先按这些名称找到对应位置,再对照术语手册理解含义。不同平台的菜单位置可能不同,界面语言也应以当前版本实际提供的选项为准,不要因为按钮位置变化就改填服务器参数。

客户端与订阅应该分别怎样更新?

iPhone / iPad 的客户端更新在 App Store 中进行;电脑与安卓可到本站下载页取得对应平台的新安装包,首次运行如被系统拦截,按下载页的安装放行步骤处理。Subscribe 更新则是重新读取你已有服务商的服务器列表,不会更新应用本体。更新前保存必要配置并记录当前选中的服务器;更新后核对原有订阅是否保留,再检查选中项是否仍然有效。

相关说明:安装放行步骤 · 界面术语手册

订阅与节点导入

以下操作以已有订阅或服务器信息为前提,先保留原始资料再修改。

已有订阅应该怎样导入?

先从你已有服务商处取得适用于 Shadowrocket 的完整订阅链接。在 Home 打开 Add Server,按界面选择 Subscribe,将链接填入对应的 URL 项并保存,再执行订阅更新。返回列表后确认是否出现该来源下的服务器,并选择一个进行测试。粘贴前检查链接首尾空格与换行,不要把账户管理网页地址当成订阅地址;订阅链接可能包含访问凭据,不要发到公开评论或截图中。

订阅导入失败或更新后节点为空,先检查什么?

按链接、响应内容、账户状态的顺序检查。首先重新复制完整链接,排除缺字符、转义错误及尾部空格;然后确认服务商返回的是订阅数据,而不是登录页面、错误提示或跳转页面;最后在自己的服务商账户中核对订阅是否仍有效。失败时先保留原有可用列表,不要立即清空全部服务器。若需要反馈,提供错误提示与发生步骤,并遮住订阅 URL 中的访问凭据。

更新订阅后,为什么服务器变少或选中项变了?

Subscribe 更新会按服务商当前返回的数据刷新该来源的列表。服务商移除、改名或调整服务器时,原来的条目可能不再存在,之前选中的项也可能失效。先确认更新的是哪一条订阅,再核对返回列表与账户状态,并重新选择有效服务器测试。不要仅凭列表数量判断导入是否成功;如果导入了多条来源,名称相似并不代表地址、端口或认证信息完全相同。

手动添加 Shadowsocks 或 Trojan 时,哪些参数必须一致?

在 Add Server 中先选择正确协议,再逐项核对服务商给出的地址、端口和认证参数。Shadowsocks 的加密方式与密码必须匹配;Trojan 的密码、TLS 及 SNI 应按服务商要求填写,不能凭网站域名自行猜测。复制内容时注意不可见空格与全角标点。若服务商提供专用导入链接,可优先使用其适配 Shadowrocket 的数据,导入后再核对关键字段;不要用关闭证书验证来掩盖参数错误。

多个订阅怎样分组,才能避免重复导入?

为每条 Subscribe 使用能辨认来源的备注,并在更新前确认所操作的来源。相同链接反复添加会造成重复列表,删除前应先比较订阅 URL 与备注,再保留实际需要的一条。手动添加的服务器与订阅生成的服务器应分开管理,避免误删。整理时先记录当前可用项,再逐条更新与测试;如果服务商更换链接,应确认新链接有效后再移除旧来源,而不是同时保留多份无法区分的记录。

迁移配置或请人排查时,哪些内容不能直接公开?

订阅 URL、服务器密码、认证令牌及可能包含这些信息的二维码都应作为私密数据处理。迁移到自己的设备时使用受控渠道,完成后检查临时文件与图片是否仍保留在共享位置。请求排查可提供协议类型、报错原文、Global Routing 选择与已做过的检查,但应遮盖完整地址中的凭据。Config 里也可能包含私人域名、Host 映射或认证信息,不能只遮住服务器名称就直接公开整个文件。

相关说明:订阅导入与首次连接 · 订阅为空的检查顺序

规则与故障排查

区分本机网络、服务器连通性和规则匹配,避免一次修改多项设置。

Global Routing 的 Config、Proxy、Direct 应该怎样选?

配置(Config)按当前启用配置中的规则分配策略;代理(Proxy)用于让受客户端处理的流量走代理路径,适合短时确认服务器是否可用;直连(Direct)用于直接连接目标,适合与系统原有网络表现对照。日常需要规则分流时使用 Config,并确认已启用正确配置。Proxy 不会修复错误的服务器参数,Direct 也不是关闭系统 VPN 授权;排查结束后应恢复原来需要的模式。

显示已连接,但网页打不开,应该按什么顺序排查?

先断开客户端,确认设备本身能正常访问网络,尤其检查公共 Wi-Fi 是否还需网页认证。再连接并测试当前服务器,临时改用 Proxy 对照;若 Proxy 也失败,优先核对服务器状态、认证信息与订阅有效性。若只有 Config 失败,再查看规则和 DNS。每轮只改一个条件,并记录失败的具体域名与错误提示;系统显示已连接通常只说明 VPN 通道已建立,并不保证远端服务器或目标网站可达。

DOMAIN-SUFFIX 规则看起来正确,为什么没有生效?

先确认 Global Routing 选择 Config,且当前启用的是刚修改的配置。Rule 通常按顺序匹配,较早命中的规则会先决定策略;应把针对性的 DOMAIN-SUFFIX 规则放在可能覆盖它的宽泛规则之前,并将 FINAL 留在末尾。例如 DOMAIN-SUFFIX,example.com,PROXY 用于该域名及其子域名。保存后重新发起请求再查看匹配记录,注意网页可能同时请求多个域名,不能只观察地址栏中的名称。

Connectivity Test 成功,为什么某个网站仍然失败?

Connectivity Test 只反映该测试方式与目标的结果,不能代替所有网站的实际访问测试。先确认失败网站是否命中了预期策略,再查看 DNS 解析、TLS 错误和该网站自身状态。若其他网站正常,可换同一订阅中的另一台服务器进行对照,但不要同时修改 DNS、规则与协议参数。若仅某个应用失败,还需检查它是否使用独立连接方式或缓存;测试时记录具体请求,而不是只看服务器测试结果。

持续连接耗电较多,怎样区分原因?

先在系统电池统计中比较相近使用时段,区分屏幕、后台下载与客户端相关的耗电;VPN 连接会参与处理其他应用的流量,不能仅凭归属名称判断全部消耗来自客户端。排查时减少持续测速、过于频繁的订阅更新和长时间详细日志,并观察弱信号或不稳定服务器是否造成重复连接。每次只调整一个因素,再比较相似网络与使用强度下的表现,不要依赖一次短时读数下结论。

On Demand 总是重新连接,怎样暂停并检查条件?

先检查 Shadowrocket 与系统 VPN 设置中是否启用了 On Demand。按需连接条件仍满足时,手动断开后可能再次建立连接;需要暂时停用时,应先关闭对应的 On Demand 设置,再断开连接。随后分别检查 Wi-Fi、蜂窝网络及相关触发条件,避免把自动重连误判为开关故障。若设备有管理配置,应先确认是否由管理员统一控制;排查完成后仅恢复确实需要的条件。

相关说明:代理模式选择 · 规则与配置参考