官方手册 · 疑难解答

Shadowrocket
安装与连接问题

先确认问题发生在哪一步,再按分类核对。以下操作以 iPhone / iPad 界面为例,电脑与安卓的安装问题单独说明。

点击问题展开答案,可同时打开多条进行对照。涉及已有订阅或服务器的操作,请先保留原始信息。

STORE / ACCOUNT

正版核对与购买

先核对获取渠道与购买账户,再处理商店地区、换机和设备兼容性。

查看正版核对说明 →
iPhone / iPad 与其他平台分别怎样获取?

iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。iPhone / iPad 从本页给出的 App Store 产品页进入,系统要求以 App Store 页面标注为准。其他平台从本站下载页选择对应安装包,文件路径位于本站 /dl/shadowrocket/ 下。安装时若出现系统拦截,先按“安装与首次打开”中的对应说明核对,再决定是否放行。

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

先核对 Apple ID 所属商店地区,而不是设备语言或当前网络位置。中国大陆商店没有此应用,可在系统 Settings 中进入 Apple 账户、Media & Purchases、View Account,再查看 Country/Region。需要更改地区时,沿该页面的 Change Country or Region 操作,并按 Apple 提示处理余额、订阅与付款资料;不要仅为搜索结果反复修改地区。

怎样在商店里核对是不是 Shadowrocket?

同时核对开发者 Shadow Launch Technology Limited、本站展示的官方图标,以及产品链接末尾的应用 ID 932747118。不要只凭搜索结果中的名称或相似图案判断。进入产品详情页后,再确认设备兼容性与购买信息;如果搜索结果与这三项不一致,返回本站产品页入口重新核对。电脑与安卓版本则从本站下载页进入,不以搜索结果中的同名安装包作为依据。

换 iPhone 或重新安装,需要再次购买吗?

iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。换机或重装时,先登录原来完成购买的 Apple ID,再到 App Store 的已购项目中查找 Shadowrocket 并重新下载。若页面仍显示购买价格,先核对购买账户与商店地区,不要连续付款。购买记录不等于配置备份,原设备中的服务器、订阅和规则仍需另行保存或重新导入。

iPad 能安装吗?和 iPhone 的购买如何对应?

可以。iPhone / iPad 版 App Store $2.99 一次性付费,两种设备使用同一购买账户获取;Mac / Windows / 安卓 / Linux 版免费。在 iPad 上登录购买时所用的 Apple ID,从已购项目找到 Shadowrocket,设备系统要求以 App Store 页面标注为准。首次使用仍需导入自己的服务器或订阅,并确认连接权限;iPhone 上已有的配置不会因为购买记录存在就自动完整出现在 iPad 上。

购买客户端后,是否就有可用线路?

客户端一次性买断 ≠ 线路套餐。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;这两档都指客户端获取方式。开始配置前,需要用户已有自己的订阅或服务器信息。本站不提供任何节点或订阅。导入后若出现认证、到期或连接失败,应核对已有服务的参数和状态,而不是重复购买客户端。

INSTALL / PERMISSION

安装与首次打开

区分安装文件不匹配、系统拦截与连接权限未确认,避免把三种问题混在一起处理。

查看安装放行步骤 →
电脑和安卓能用 Shadowrocket 吗?

能。Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费;iPhone / iPad 版 App Store $2.99 一次性付费。到本站下载页选择设备对应的版本,不要把不同系统的安装文件互换使用。桌面与安卓安装包没有代码签名,首次打开可能触发系统提示;Windows 查看 SmartScreen,Mac 查看隐私与安全性,安卓查看允许安装未知应用,具体步骤见本分类后续问答。

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

打开 Apple 菜单中的“关于本机”,查看“芯片”或“处理器”一项。显示 Apple 芯片时选 Apple 芯片版,显示 Intel 时选 Intel 版;不要凭机身外观或购买年份猜测。两个入口都在本站下载页的 Mac 分区。将应用移入 Applications 后再打开;如果系统提示无法验证开发者,按下一条 Mac 放行说明核对来源,并在隐私与安全性中处理。

Windows 出现 SmartScreen 提示,怎样处理?

先确认安装文件是从本站下载页取得,地址位于本站 /dl/shadowrocket/ 下。如果 SmartScreen 显示阻止运行,可展开“更多信息”,核对应用后选择“仍要运行”。系统策略或组织管理可能不提供该按钮,此时应联系设备管理员,不要修改整台设备的安全策略。如果提示来自其他安全组件,或文件来源无法确认,先取消操作并记录完整提示,再判断原因。

Mac 提示无法验证开发者或应用已损坏,怎样放行?

先确认文件来自本站下载页,并把 Shadowrocket 移入 Applications。遇到“无法验证开发者”,尝试打开一次后进入系统设置的“隐私与安全性”,找到对应拦截记录并选择“仍要打开”。若提示“已损坏”,仅在确认来源与应用路径正确后,在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app,再尝试打开。若设备受组织管理,按管理员要求处理,不要关闭整机保护。

安卓与 Linux 首次安装被拦截,分别检查哪里?

安卓应先确认安装包来自本站,再在系统设置中只对当前用于打开文件的浏览器或文件管理器开启“允许安装未知应用”,完成后可关闭该权限。Linux 应选择与发行版匹配的 deb、rpm 或 AppImage;AppImage 需在文件属性中允许执行,或用 chmod +x 后接实际文件名赋予权限,再启动。设备策略禁止安装时应联系管理员,不要绕过组织限制。

Home 的连接开关打不开,或者界面是英文,怎么定位?

先在 Home 选择一条参数完整的服务器,再尝试打开连接开关,并留意系统是否弹出添加 VPN 配置的确认。iPhone / iPad 需要按系统提示授权;若确认窗口被取消,重新发起连接。仍失败时,停止其他正在工作的 VPN 连接,并检查设备管理限制。英文界面按 Home、Config、Data、Settings 定位即可,不要仅凭图标猜测;本手册的步骤保留这些界面词原文。

IMPORT / SUBSCRIBE

订阅与节点导入

以下步骤以用户已有自己的订阅或服务器信息为前提,先辨认内容类型,再选择导入入口。

Add Server Subscribe Scan QR Code
查看连贯操作教程 →
已有订阅和单条分享链接,导入入口相同吗?

不完全相同。先判断内容是单条服务器分享信息,还是会返回服务器列表的订阅地址。单条信息可使用 Scan QR Code,或按 Add Server 中实际提供的入口填写;订阅则在 Add Server 选择 Subscribe,填写用户已有的订阅地址。不要把订阅地址当作服务器地址填入协议参数,也不要把多个分享链接直接拼成一个地址。导入后回到 Home,检查分组与条目是否出现。

Subscribe 导入失败,应该按什么顺序检查?

先检查复制的地址是否完整,前后有无空格、换行或聊天软件附加文字;再确认它是订阅地址,而非登录页面或账户管理页面。随后核对已有服务是否到期、地址是否已重置,以及当前网络能否完成请求。若出现具体错误,记录请求失败、认证失败或内容解析失败等提示分别处理。不要把含有访问凭据的完整订阅地址发到公开截图或讨论中。

怎样更新已有订阅?更新前要保存什么?

在 Home 找到对应订阅分组,进入该分组的编辑或操作入口,使用当前版本提供的更新操作;不要只更新某个单独服务器的备注。更新前记录自己选择的服务器,并备份手动修改过的参数,因为订阅返回的新内容可能覆盖条目或移除旧条目。更新后核对分组中的服务器名称、数量变化和当前选择,再做连接测试。更新失败时先保留现有条目,不必立刻删除整个分组。

扫码后没有出现服务器,能否直接重新扫?

先检查二维码是否包含完整的服务器分享信息或可识别的订阅内容,而不是账户网页入口。使用 Scan QR Code 时允许相机访问,并保持二维码完整、清晰。如果内容来自相册,使用当前界面提供的图片识别入口。出现失败提示后先查看原因,再尝试一次;连续扫描可能形成重复条目。成功后回到 Home 核对实际新增内容,并与自己已有的参数逐项比对。

Add Server 里参数很多,哪些不能凭猜测填写?

Type、服务器地址、端口和认证信息必须与已有服务器资料一致;涉及 TLS、SNI 或传输方式时,也应按对应资料填写。尤其不要把 SNI 当成任意备注,或在没有依据时关闭 TLS 相关检查。Shadowsocks、VMess、VLESS、Trojan 等协议的字段含义并不相同。保存后先测试单条服务器,再加入日常使用配置;缺少参数时,应回到已有服务的说明中核对。

切换设备或重装前,怎样整理订阅与配置?

把服务器信息、订阅地址和 Config 中使用的配置文件分开整理,并记录当前 Global Routing 选择与必要的手动修改。购买记录只能帮助重新获取应用,不能代替这些内容的备份。导出或复制时使用自己控制的存储位置,避免把含有密码、访问凭据的文件公开分享。新设备导入后先检查参数和规则,再建立连接,不要只凭文件名相同就判断内容已经完整恢复。

ROUTING / DIAGNOSIS

规则分流与故障排查

每次只改变一个条件。连接开关、服务器可达性、DNS 与目标请求是不同的核对层次。

PROXY DIRECT REJECT
查看完整使用手册 →
Global Routing 的配置、代理、直连三姿态怎么选?

日常按规则使用时选择配置,对应 Config,由当前配置文件的规则决定流量策略;代理对应 Proxy,用于让适用流量走当前代理路径;直连对应 Direct,用于不经过代理路径的核对。Proxy 不会自动修复服务器认证或 DNS 问题,Direct 也不等于删除配置。排查时一次只切换一种姿态,记录同一目标的结果,测试结束后回到原计划使用的模式。

开关显示连接成功,但网页打不开,先排查什么?

先临时断开,确认设备自身网络可用;再检查当前服务器是否仍有效、认证参数是否改变,并用 Connectivity Test 获取初步结果。随后核对 Global Routing 与 Config 中实际启用的文件,避免把规则未命中误认为服务器故障。最后检查 DNS 是否能正常解析目标。每次只改变一个设置,并分别记录网页、应用与测试结果;连接开关状态本身不代表目标请求已经成功。

Config 中有规则,为什么目标仍没有按预期分流?

先确认 Global Routing 处于 Config,再确认 Config 中启用的是刚刚编辑的文件。规则通常按顺序匹配,前面的宽泛规则可能先于后面的具体规则生效;检查 DOMAIN、DOMAIN-SUFFIX、IP-CIDR 等条件是否对应实际请求,并检查 FINAL 的最终策略。规则中的 PROXY、DIRECT、REJECT 与具体策略引用也要保持有效。排查时先缩小到一个目标,不要同时重写整份规则。

DNS 调整后仍异常,要继续更换地址吗?

不要连续叠加修改。先记录修改前的 DNS 设置,确认当前配置确实使用了新设置,再区分是所有域名失败、部分域名失败,还是只有某个应用失败。只有域名访问异常时,应核对解析结果与请求路径;如果服务器本身也无法连接,应先处理服务器连通性。恢复到可解释的基础配置后逐项测试,比同时更换 DNS、服务器和规则更容易确定原因。

使用时耗电增加,On Demand 应不应该关闭?

先在系统电池页面比较相近使用时长和网络条件下的消耗,再结合 Data 查看实际流量。弱信号、频繁重连、持续传输或过密测试都可能增加消耗,不宜只凭一次电量变化判断。On Demand 用于按条件触发连接,是否关闭应取决于使用需求;排查时可暂时关闭,观察手动连接是否稳定,再逐项恢复条件。测试期间避免同时改变服务器、规则和连接触发设置。

排查后仍有问题,应该保留哪些信息?

记录设备系统、问题发生时使用的网络类型、Global Routing 姿态、当前配置文件名称,以及完整错误提示。补充说明问题是否影响所有目标、是否能在另一网络重现、最近是否更新过订阅或配置。可用 Connectivity Test 与 Data 辅助确认现象,但测试结果不能代替实际目标访问。分享记录前遮盖服务器地址、密码和完整订阅地址,只保留定位问题所需的界面词与错误内容。

Shadowrocket 官方下载