官方手册 · 问答

Shadowrocket 常见问题

按设备、导入方式与连接现象查找说明。先核对当前设置,再一次只改一项,保留可用于对照的原始配置。

正版与购买

按平台确认获取方式,区分应用购买记录、配置备份与已有连接资料。

电脑和安卓能用 Shadowrocket 吗?各平台怎样获取?

能。Shadowrocket 提供 iPhone、iPad、Mac、Windows、安卓和 Linux 版。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。Mac 分 Apple 芯片与 Intel 两种安装包;Windows、安卓和 Linux 也应按设备选择对应格式。电脑与安卓请从本站全平台下载页获取,安装包经本站 /dl/shadowrocket/ 路径提供;首次打开的系统放行步骤见下方安装分类。

iPad 能安装吗?怎样核对商店里的应用?

可以,iPhone 与 iPad 使用同一应用的购买记录,系统要求以 App Store 页面标注为准。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。在商店产品页同时核对名称 Shadowrocket、官方图标、开发者 Shadow Launch Technology Limited 与应用 ID 932747118,不要仅凭中文别称或搜索结果中的相似图标判断。安装时使用持有该应用购买记录的 Apple 账户。

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

先打开本页提供的 App Store 产品页,区分搜索不到与当前商店不可用。中国大陆商店未上架此应用;在设备设置中进入 Apple 账户的 Media & Purchases,查看账户与 Country/Region,并核对 Screen Time 中的内容分级限制。确需变更地区时,按 Apple 账户设置中的官方流程处理余额、现有订阅与付款资料要求,不要只修改设备语言。商店可用性以当前账户实际打开的产品页为准。

换机或重新安装还需要再买一次吗?

iPhone / iPad 换机或重装时,先使用原购买账户进入 App Store 的已购应用列表,再查找 Shadowrocket 并重新下载;使用不同账户时,商店可能不会显示原购买记录。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费,后四种平台重新从本站下载即可。应用购买记录不等于配置备份,移除旧设备上的应用前,应另行保存已有服务器信息与 Config,并妥善保管其中的凭据。

购买客户端之后,是否还要准备自己的连接资料?

需要。客户端一次性买断 ≠ 线路套餐。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费,这些价格说明的是客户端获取方式。使用前应准备自己已有的订阅或服务器信息,包括协议类型、服务器地址、端口与认证字段。本站是 Shadowrocket 官网与官方手册,不提供、不销售、不推荐节点或订阅;导入与排查说明均以用户已有合法使用的连接资料为前提。

安装与首次打开

先确认设备架构与文件来源,再处理系统权限。组织管理的设备应遵循管理员要求。

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

在 Mac 的 Apple 菜单打开「关于本机」,查看显示的是「芯片」还是「处理器」。显示 Apple 芯片时选择下载页的 Mac Apple 芯片版 dmg;显示 Intel 处理器时选择 Mac Intel 版 dmg,不要根据电脑外观或购买年份猜测。打开 dmg 后将 Shadowrocket 移到 Applications 再启动。若出现无法验证开发者的提示,先确认安装包来自本站,再按本分类的 macOS 放行步骤处理;不要反复更换不匹配的芯片版本。

Windows 提示 SmartScreen 风险,怎样处理?

先核对文件确实来自本站下载页,且下载后的文件名与所选 Windows 安装包对应。Windows SmartScreen 显示「Windows 已保护你的电脑」时,可展开「更多信息」,在确认来源后选择「仍要运行」。安装需要管理员权限时,检查用户账户控制提示中的程序与路径再确认。如果安全软件明确报告威胁,或文件来源无法核对,应停止运行并查明原因;不要为安装长期关闭整个系统的防护。受组织管理的设备应先联系管理员。

Mac 提示无法验证开发者或已损坏,怎样首次打开?

确认 dmg 来自本站并已将应用放入 Applications。遇到「无法验证开发者」时,先尝试打开一次,再进入系统设置的「隐私与安全性」,找到本次拦截记录并选择「仍要打开」,随后按系统要求确认。若提示「已损坏」,核对下载是否完整;确认来源后,可在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app,再重新打开。该命令会清除指定应用的扩展属性,仅对已确认来源的这个路径执行,不要扩大到整个目录或磁盘。

安卓和 Linux 首次安装分别要注意什么?

安卓使用本站下载页提供的 arm64 apk;系统拦截时,为本次使用的浏览器或文件管理器开启「允许安装未知应用」,完成安装后可收回该权限。Linux 按发行版选择 deb、rpm 或 AppImage:Debian / Ubuntu 使用 apt 安装本地 deb,Fedora 系使用 dnf 安装本地 rpm;AppImage 需先通过文件属性或 chmod +x 添加执行权限,再运行所下载的文件。命令中的路径必须换成实际文件路径;依赖或运行库报错应按发行版提示处理。

首次打开后连接开关打不开,或立即自动关闭怎么办?

先确认 Home 中已经存在有效的服务器条目,并选中了准备使用的条目。iPhone / iPad 首次连接时,需要在系统提示中允许添加 VPN 配置,并按要求完成设备认证;取消授权后,单独点击开关通常不能完成连接。若曾拒绝授权,可重新发起连接并查看系统 VPN 设置。再检查其他 VPN 连接是否仍在运行,以及 On Demand 是否正在按条件接管连接。受管理设备的配置限制应由管理员核实,无法消除的错误应记录提示原文后再排查。

订阅与节点导入

分别核对 Subscribe、Add Server 与 Config 的用途,保留已有可用条目作为对照。

已有订阅导入失败,应先检查链接还是配置?

先检查输入,再检查返回内容。在 Add Server 中选择 Subscribe,粘贴自己已有的完整订阅链接,确认开头、路径、查询参数均未缺失,并去掉复制时带入的空格或换行。链接可能包含凭据,不要发到公开聊天或截图中。若能请求但导入失败,应核对返回的是支持的订阅内容,而不是登录页、过期提示或网页正文;同时确认订阅仍有效、设备日期正确。已有条目能连接时,先保留它们,不要为测试删除全部配置。

Scan QR Code 与 Add Server 手动填写怎样选?

二维码来自自己已有的连接资料且格式受支持时,可在 Home 使用 Scan QR Code,并允许相机访问;识别后仍要检查协议类型、地址与端口。二维码模糊或内容不受支持时,不必反复扫描,可进入 Add Server 手动填写。手动添加要先选对 Type,再按原资料填写密码、UUID、TLS、SNI 或其他对应字段,不同协议的字段不能互相替代。不要把配置文件的下载地址当成单个服务器地址,也不要把订阅 URL 填进密码字段。

更新 Subscribe 后,条目变化或更新失败怎么办?

更新前先确认要刷新的 Subscribe 分组,必要时记录当前使用条目的名称和所引用的策略。更新会依据订阅返回内容调整条目,名称变化、移除或地址更新不等于客户端损坏。若刷新失败,依次检查当前网络、订阅有效期与返回格式,并确认链接没有被编辑截断。刷新后回到 Home 检查所选服务器,再核对 Config 中引用的策略名称是否仍然存在;不要假定原来的选中状态与规则引用一定能自动保持一致。

Subscribe 与 Config 有什么区别,导入一个就够了吗?

Subscribe 主要用于获取或更新已有的服务器条目;Config 用于管理规则、策略引用及相关配置,两者解决的问题不同。只有服务器列表时,仍需检查 Global Routing 与当前启用的 Config;只有配置文件时,也应确认其中引用的服务器或策略确实存在。导入新 Config 前,先保留当前能使用的配置,并检查来源、规则顺序及所引用名称。配置中出现的 PROXY 等策略标识必须与实际定义相符,不能只因文字相似就认定已正确关联。

界面是英文,导入与连接时应认哪些入口?

先按任务识别界面词:Home 查看服务器与连接状态,Add Server 添加已有服务器,Subscribe 导入订阅,Scan QR Code 扫描已有资料,Config 管理配置,Global Routing 选择连接处理方式,Settings 查看设置,Data 查看流量相关信息。官方手册保留这些英文原文,便于直接对照界面。不同平台的入口位置可能不同,应根据名称而不是固定坐标寻找;不要把 Proxy 这一模式名称与配置中的 PROXY 策略标识混为一谈。

规则与故障排查

区分本地网络、服务器连接、DNS 与规则命中。测试结果只说明对应条件,不代替实际访问验证。

Global Routing 的 Config、Proxy、Direct 三种姿态怎样选?

日常按规则分流通常选择配置(Config),连接依据当前 Config 中的规则匹配结果处理;代理(Proxy)用于将连接交由当前代理路径处理,适合临时对照测试;直连(Direct)用于不经代理路径的对照。切换姿态不会修复错误的服务器参数,也不能代替检查订阅有效性。排查时可固定同一个测试目标,分别比较 Direct 与 Proxy,再回到 Config 检查规则,避免同时改服务器、DNS 和模式而失去判断依据。

显示已连接但无法上网,按什么顺序检查?

已连接通常只说明设备建立了本地 VPN 或代理处理通道,不等于远端服务器、DNS 与目标站点都可用。先断开 Shadowrocket,确认当前 Wi-Fi 或移动网络本身能正常访问;再核对 Home 中选中的服务器与认证信息。使用同一个目标比较 Direct、Proxy 与 Config 的表现,必要时运行 Connectivity Test。最后查看错误是连接超时、认证失败还是名称解析失败,按错误类别处理;不要仅因开关保持开启就连续更换所有配置。

Config 下只有部分网站异常,怎样检查规则与 DNS?

先记录异常网站的域名,并在连接记录中查看命中的规则和策略,确认是否被较早出现的 DOMAIN、DOMAIN-SUFFIX 或 IP-CIDR 规则截获。规则通常按顺序匹配,FINAL 应作为兜底保留;检查命中后引用的 PROXY、DIRECT 或 REJECT 是否符合预期。若是解析错误,再核对 Config 中的 DNS 设置与实际网络可达性。每次只调整一处并重新测试,不要凭某个页面打不开就批量删除规则;同一网站也可能请求多个不同域名。

连接后耗电增加,On Demand 应怎样设置?

耗电受实际流量、信号强弱、重连频率、协议实现及后台活动共同影响,不能单凭协议名称判断。先到系统电池统计查看对应时段,再观察是否存在持续下载、弱信号重连或密集测试。On Demand 根据设定的网络条件触发连接,设置前应明确哪些 Wi-Fi 或移动网络场景需要启用;条件互相冲突可能造成反复切换。排查时可暂时关闭 On Demand 并手动连接作对照,确认稳定后再逐条恢复条件,不要频繁运行整组测试。

Connectivity Test 能证明实际访问正常吗?反馈问题要保留什么?

不能。Connectivity Test 的结果取决于测试方法和测试目标,某项成功并不保证所有网站或应用都能使用,也不能直接作为实际传输速度的结论。反馈前应记录设备系统、所用平台、当前 Global Routing 姿态、触发问题的操作及错误原文,并说明 Direct 与 Proxy 的对照结果。分享日志或截图前,移除订阅 URL、密码、密钥、UUID、服务器地址及其他账户资料。优先提供最小复现步骤,不要直接公开完整 Config 或整份连接记录。