Shadowrocket 官方手册
Shadowrocket 常见问题
按购买、安装、订阅和连接问题查找处理顺序。先核对当前设备与报错,再逐项检查;修改 Config 或删除订阅之前,先保存备份。
查看全平台下载与安装正版与购买
先区分应用获取与配置恢复,再核对商店条目和购买账号。
电脑和安卓能用 Shadowrocket 吗?
能。Shadowrocket 提供 iPhone、iPad、Mac、Windows、安卓和 Linux 版本。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。Mac 分 Apple 芯片版与 Intel 版;其他平台也应按系统和安装包格式选择。请从下载页进入对应平台:iPhone / iPad 前往 App Store,其他平台安装包由本站 /dl/shadowrocket/ 提供。首次打开遇到系统拦截时,按下方安装分类处理。
iPad 能安装吗?系统要求在哪里看?
可以。iPhone 与 iPad 使用同一 App Store 产品条目,系统要求以 App Store 页面标注为准。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。已购买的用户,应先使用原购买账号查看已购项目,再在另一台兼容设备上下载;不要因搜索结果相似就另选应用。安装后还需导入用户已有自己的订阅或服务器信息,设备间的配置恢复与应用下载是两件事。
App Store 搜不到 Shadowrocket,应该核对什么?
先打开本页提供的 App Store 产品页,确认是否提示当前地区不可用。中国大陆商店目前不提供此应用;请在系统 Settings 的 Apple 账户中进入“媒体与购买项目 → 查看账户 → 国家或地区”,核对商店地区。若确需更改,按 Apple 官方账户设置流程处理余额、有效订阅与付款方式等条件,不要只修改设备语言。找到产品后,核对开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118。
换机或重装后,还需要重新购买吗?
iPhone / iPad 用户先登录原购买时使用的 App Store 账号,在账户的已购项目或应用列表中找到 Shadowrocket,再点重新下载。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;同一购买账号下恢复应用通常无需再次购买。若仍显示购买按钮,先核对账号和购买记录,不要立即重复付款。重新下载应用不等于恢复服务器列表,换机前应另外保存配置备份;电脑和安卓重装时从本站下载页重新获取即可。
购买客户端后,为什么还需要订阅或服务器信息?
客户端负责读取服务器参数、建立连接和执行规则,线路服务是另一部分,因此客户端一次性买断 ≠ 线路套餐。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费,这两档价格都不包含线路服务。本站是 Shadowrocket 官网与官方手册,不提供、不销售、不推荐节点或订阅。后续操作均以用户已有自己的订阅或服务器信息为前提;导入之前,请先确认这些信息仍然有效。
安装与首次打开
先确认系统、芯片与下载来源。系统放行应只针对已经核对的应用。
Mac 应该选择 Apple 芯片版还是 Intel 版?
打开 Mac 左上角 Apple 菜单,进入“关于本机”。如果显示“芯片”并列出 Apple 芯片名称,选择 Mac Apple 芯片版;如果显示“处理器”且名称包含 Intel,选择 Mac Intel 版。两种安装包都在下载页的 Mac 区域,不必根据电脑外观、购买年份或浏览器判断。下载 dmg 后按提示将 Shadowrocket 放入 Applications。若首次打开出现“无法验证开发者”,先核对下载来源,再按下一条的系统设置路径处理。
Mac 提示“无法验证开发者”或“已损坏”,怎么处理?
先确认安装包来自本站下载页的 /dl/shadowrocket/ 路径,并已将应用放入 Applications。提示“无法验证开发者”时,先尝试打开一次,再进入“系统设置 → 隐私与安全性”,在对应提示处选择“仍要打开”,并完成系统确认。若提示“已损坏”,确认来源与应用位置后,可在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app,再重新打开。命令仅针对该应用,不要改成整个磁盘路径,也不要为了运行应用关闭系统整体安全保护。
Windows 出现 SmartScreen 风险提示,如何放行?
先确认 exe 是从本站下载页获取,链接路径为 /dl/shadowrocket/,并核对文件对应 Shadowrocket。SmartScreen 显示“Windows 已保护你的电脑”时,可点“更多信息”,再选择“仍要运行”;随后根据安装程序提示完成操作。若界面没有这个选项,或设备受单位策略管理,应先核对 Windows 安全中心与组织策略,不要反复关闭安全功能。安装完成后首次建立连接,仍需按系统实际提示确认相应网络权限。
安卓 apk 不能安装,或微信里点下载没有反应怎么办?
先用系统浏览器打开本站下载页,选择安卓版,避免在微信内置浏览器中反复点击。下载完成后,如果系统提示不允许安装,请进入当前浏览器或文件管理器对应的“安装未知应用”设置,允许该来源完成本次安装;安装后可按需要收回权限。本站提供 arm64 apk,若仍提示不兼容,应核对设备架构与系统提示,不要改文件扩展名。首次连接出现 VPN 授权窗口时,请核对应用名称后确认,否则连接无法建立。
Linux 应选 deb、rpm 还是 AppImage?
优先按发行版的包管理方式选择:Debian、Ubuntu 一类系统通常使用 deb,采用 RPM 包管理的系统选择 rpm;需要独立文件形式时再考虑 AppImage。所有格式均从本站下载页 Linux 区域获取。deb 可在下载目录使用 sudo apt install ./ 后接实际文件名安装;AppImage 需先用 chmod +x 后接实际文件名赋予执行权限,再运行该文件。命令中的文件名应与本机下载结果一致;若出现权限或依赖错误,先阅读终端提示,不要直接以高权限反复启动。
订阅与节点导入
以下说明以用户已有自己的订阅或服务器信息为前提。先识别内容类型,再选择导入入口。
已有订阅应该从哪里导入?
在 Home 中点添加入口,进入 Add Server 后选择 Subscribe,将用户已有自己的完整订阅链接填入 URL,并设置便于辨认的名称后保存。不同版本入口位置可能略有差别,应以当前应用的字段名称为准。保存后执行一次更新,确认 Home 出现该订阅下的服务器,再选择一项进行测试。订阅链接与单个服务器分享链接不是同一种内容,不要把整个配置文件文本填进 URL;订阅链接可能含访问凭据,也不要贴入公开聊天或截图。
订阅导入失败或更新后列表为空,先检查哪些地方?
先检查链接是否完整,是否混入空格、换行、中文标点或额外说明文字;再确认它是 Subscribe 所需的订阅地址,而不是账户网页或单个服务器链接。随后检查本机网络是否可用,以及原订阅是否仍有效、是否返回了 Shadowrocket 能识别的内容。如果旧列表仍在,不要先删除,先备份并记录错误提示。更新成功但列表为空,说明请求完成不一定代表返回内容有效,应核对订阅端实际返回结果,再决定是否重新导入。
怎样更新订阅,手动修改的节点会被覆盖吗?
在 Home 中找到对应订阅分组或其编辑入口,使用该订阅的更新操作,完成后核对服务器名称、数量变化与当前选中项。不要把更新订阅等同于更新 Config,两者维护的内容不同。订阅内的服务器由远端内容生成,手动改名或改参数可能在后续更新时被替换;需要长期保留的自定义条目,应先单独保存并备份。更新失败时优先保留原有可用列表,记录报错并检查链接,不必反复删除和重建全部分组。
扫码、剪贴板和 Add Server 手填应该怎么选?
已有二维码时使用 Scan QR Code,并按提示授予相机权限;已有服务器分享链接时,可复制完整链接后使用应用提供的剪贴板导入入口,并确认系统允许读取。只有零散参数时,再进入 Add Server,按原始资料选择 Type,填写地址、端口、认证与传输设置。三种方式都应在保存前核对解析结果,尤其是协议类型和端口。二维码无法识别时先确认内容是否为受支持的服务器信息,而不是登录页面或付款页面。
多个订阅出现重复节点,应该怎样整理和备份?
先给每条订阅设置不同名称,按分组确认重复条目属于哪个订阅,再判断是否确实重复。名称相同不代表地址、端口与传输参数相同;延迟相近也不能作为删除依据。若多个订阅包含相同服务器,直接删除分组内条目可能在更新后重新出现,应从保留哪些订阅入手整理。删除前导出当前配置,并另行保存必要的订阅信息;备份文件可能含认证信息,应存放在受控位置。应用恢复后,再逐组更新并确认当前选择,避免一次改动过多。
规则与故障排查
区分本机网络、服务器连接和规则匹配三个环节。测试时保留原配置,每次只改变一项。
Global Routing 的配置、代理、直连三种姿态怎么选?
配置对应 Config,按当前启用配置里的规则为请求选择策略;代理对应 Proxy,用于让通常进入代理处理的流量采用所选服务器;直连对应 Direct,让流量通过本机网络直接连接。日常需要规则分流时先选择 Config,并确认 Config 页面启用的是预期文件。排查时可以短暂切换姿态,对比同一目标的访问结果,但不要把 Proxy 理解为会忽略所有系统绕过项,也不要把 Direct 当作断开 VPN。诊断结束后,应恢复原先需要的姿态。
连接开关打不开,或刚打开就关闭怎么办?
先确认已选中参数完整的服务器,并留意首次连接时系统是否弹出 VPN 配置或连接授权。iPhone / iPad 可在系统 Settings 的“通用 → VPN 与设备管理”中核对相关配置;安卓应检查 VPN 授权是否被拒绝。随后确认是否有其他 VPN 连接占用、设备管理限制或失效配置。不要一开始就删除全部系统配置,先关闭冲突连接、重启应用,再记录应用显示的错误。若启用了 On Demand,也要检查条件是否让连接立即断开。
显示已连接却无法上网,按什么顺序排查?
先断开连接,确认本机网络本身能正常访问;公共 Wi-Fi 还应先完成网页认证。然后核对当前服务器及其认证信息,运行 Connectivity Test,并注意测试成功只说明部分连接条件成立,不代表每个目标都能访问。接着查看 Global Routing、当前 Config 与请求命中的策略,再检查 DNS 设置是否与当前网络冲突。每次只改一个变量,并用相同目标复测;如果 Direct 可用而 Proxy 不可用,重点检查服务器路径,而不是立即重置整台设备网络。
On Demand 没有自动连接,或不断自动重连怎么办?
先确认 On Demand 已启用,并检查系统是否允许对应 VPN 配置按需连接。逐项核对 Wi-Fi SSID、Cellular、Domain 等条件,注意 SSID 必须与当前网络名称一致,多个条件也可能相互影响。排查时先记录现有设置,临时关闭 On Demand,手动连接同一服务器;手动连接正常后,再一次只恢复一条条件观察结果。若反复断开重连,还应检查 Wi-Fi 与蜂窝网络是否频繁切换,不要同时修改服务器、规则和全部触发条件。
界面是英文,Home、Config 和 Settings 分别在哪里用?
本手册保留应用界面词英文原文,便于逐项对应。Home 主要用于查看和选择服务器、操作连接;Add Server 用于新增服务器,Subscribe 用于订阅类型;Config 用于管理与选择配置文件;Settings 用于查看应用设置;Global Routing 用于选择整体路由姿态。不要仅因界面语言不同就重新导入订阅或重装。若希望调整显示语言,可先查看系统为该应用提供的语言选项,实际可选项以当前安装版本和系统界面为准。
连接后耗电增加,Data 流量统计应该怎么看?
先在系统电池设置中比较相近时段的使用情况,同时留意视频传输、后台同步、网络信号和频繁重连。VPN 工作需要处理网络流量,耗电变化不能只根据状态栏图标判断。Data 可帮助观察应用记录的流量,但统计范围与系统或线路侧的计量口径可能不同,不应把它当作账单。排查时停止反复测速,检查 On Demand 是否频繁触发,并比较稳定网络下的表现;如果异常持续,记录复现条件与相关日志,分享前遮去订阅地址和认证信息。