官方手册 · 问题索引

Shadowrocket 常见问题

按购买、安装、导入、连接的顺序定位问题。先核对当前状态,再一次只调整一个设置。

以下操作以用户已有自己的订阅或服务器信息为前提。需要连续操作步骤时,查看使用教程 →

获取与账号

正版与购买

先确认平台与购买账号。商店恢复应用、恢复配置和获取线路服务需要分别处理。

查看下载与正版核验 →
Shadowrocket 怎么收费,购买客户端是否包含线路?

iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;其他店面按当地货币显示,以商店页面为准。客户端一次性买断 ≠ 线路套餐,客户端获取与线路服务是两件事。使用前应已有自己的订阅或服务器信息,订阅请从你的服务商处获取。本站是官网与官方手册,不提供、不销售、不推荐节点或订阅。

电脑和安卓能用 Shadowrocket 吗?

能。Shadowrocket 覆盖 iPhone、iPad、Mac、Windows、安卓与 Linux。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。电脑与安卓请从本站全平台下载页选择安装包,文件经本站 /dl/shadowrocket/ 路径提供。首次打开可能遇到系统拦截,先核对来源,再按本页安装分类或下载页的安装放行说明处理。

iPad 能安装吗,和 iPhone 需要分别购买吗?

iPad 可以安装 Shadowrocket。iPhone / iPad 版在 App Store $2.99 一次性付费,两种设备通用;Mac / Windows / 安卓 / Linux 版免费。在 iPad 的 App Store 使用原购买账号查看已购项目,找到 Shadowrocket 后重新下载。设备系统要求以 App Store 页面标注为准;如果按钮仍显示价格,先核对购买记录和“媒体与购买项目”账号,不要急于重复付款。

换机或重装后,如何恢复已购项目?

在新设备的 App Store 登录原购买时用于“媒体与购买项目”的账号,进入账户中的已购应用列表,搜索 Shadowrocket 并重新下载;列表名称可能随系统版本变化。iPhone / iPad 版在 App Store $2.99 一次性付费,同一购买账号可恢复已购应用,Mac / Windows / 安卓 / Linux 版免费。恢复应用不等于恢复全部配置,订阅和配置文件仍需从自己的备份或服务商资料中找回。

怎样核对 App Store 中的 Shadowrocket?

从本站下载页进入 App Store 产品页,核对名称 Shadowrocket、开发者 Shadow Launch Technology Limited、应用 ID 932747118,并对照本站页头使用的官方图标。应用 ID 可在产品页地址中确认,不要仅凭搜索结果中的名称判断。电脑和安卓等平台则从本站下载页选择相应安装包。遇到名称相近但开发者或应用 ID 不一致的条目,应停止操作并重新核对产品页。

架构与系统权限

安装与首次打开

先核对文件来源和设备架构,再处理系统提示。只针对已经确认的应用操作,不全局关闭系统防护。

查看安装放行表 →
Mac 应该选 Apple 芯片版还是 Intel 版?

打开苹果菜单中的“关于本机”:显示“芯片”且名称为 Apple M 系列时选 Apple 芯片版;显示 Intel 处理器时选 Intel 版。下载页为两种架构分别提供 dmg,不能根据机身外观或购买年份猜测。将应用放入 Applications 后再打开;如果系统提示无法验证开发者,核对安装包来自本站,再到“系统设置 → 隐私与安全性”查看对应的“仍要打开”操作。

Windows 出现 SmartScreen 风险提示,怎么处理?

先确认文件由本站下载页获取,下载路径属于本站 /dl/shadowrocket/,并确认设备为所需的 Windows 64 位环境。若是 SmartScreen 的“Windows 已保护你的电脑”提示,可在核对来源后点击“更多信息 → 仍要运行”。该步骤是系统放行,不等于安全检测结论。如果提示来自组织策略、文件被安全软件检出或来源无法确认,应停止运行,保留提示内容并先核实原因,不要全局关闭安全防护。

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

先确认应用来自本站并已放入 /Applications。对于“无法验证开发者”,尝试打开后进入“系统设置 → 隐私与安全性”,找到对应应用的“仍要打开”,再按系统提示确认。对于“已损坏”,先重新下载并替换;确认来源及路径无误后,可在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app,再尝试打开。此命令会清除该应用的扩展属性,不应对其他未知文件批量执行;受管理设备应遵循管理员策略。

安卓安装时提示不允许安装,在哪里放行?

从本站下载页获取适用于 arm64 的安装包后,系统可能要求为当前浏览器或文件管理器开启“允许安装未知应用”。只为实际打开安装包的那个应用临时授权,完成安装后可关闭该授权。若仍提示解析失败,检查下载是否完成、设备架构是否匹配以及是否存在旧文件;不要反复打开同一个未下载完整的文件。微信内下载受限时,可使用菜单在系统浏览器中打开本站下载页。

Linux 的 deb、rpm 和 AppImage 怎么选?

按发行版的软件包体系选择:Debian、Ubuntu 系通常使用 deb,Fedora 等系统通常使用 rpm;希望直接运行时可查看 AppImage 是否适合当前环境。下载后在文件所在目录操作,deb 可用 sudo apt install ./ 后接实际文件名,rpm 可用 sudo dnf install ./ 后接实际文件名。AppImage 先对实际文件执行 chmod +x,再运行文件。先核对来源与架构;缺少运行依赖时按报错补齐,不要将不同包格式反复混装。

首次连接时开关打不开,应该先查哪里?

以 iPhone / iPad 为例,首次启用会请求添加 VPN 配置,需要按系统提示允许,并完成设备验证。若误点取消,返回 Shadowrocket 再次启用,检查系统 Settings 中的 VPN 配置是否存在。还应确认已选中有效服务器,暂时断开其他正在使用 VPN 通道的应用,并检查设备是否受描述文件或组织策略限制。开关立即回落时记录具体报错,不要先删除全部配置,也不要把添加配置的系统确认误认为连接已经成功。

已有资料的导入与维护

订阅与节点导入

订阅请从你的服务商处获取。导入失败、更新失败和服务器连接失败是不同阶段,应分别核对。

按教程检查导入步骤 →
Subscribe 导入失败,如何区分链接问题和客户端问题?

先确认复制的是从你的服务商处获取的完整订阅链接,而不是网页标题、说明文字或登录页面地址。检查首尾空格、换行和被截断的查询参数,再核对 Add Server 中的 Type 是否选择 Subscribe。保留具体错误:超时应先检查当前网络能否访问订阅地址;返回格式不支持或没有服务器时,向服务商确认内容格式与订阅状态。不要把含有访问凭据的完整链接发到公开截图或讨论中。

Shadowrocket 订阅更新后为什么还是原来的服务器?

先确认更新的是当前正在使用的 Subscribe 分组,而不是另一个同名分组,再观察更新是否实际成功。更新成功仅表示重新获取了服务商返回的内容,服务商未更改列表时,服务器名称可能完全相同。若出现异常,先备份当前资料,核对订阅状态与有效期,并向服务商确认返回内容;不要为了刷新列表连续删除重建。更新后还需检查当前选中的服务器是否仍在列表中,以及原有配置引用是否有效。

Scan QR Code 扫描后没有导入,是什么原因?

先检查相机权限、二维码是否完整清晰,以及它承载的是服务器分享信息、订阅地址还是普通网页。二维码可以被识别,不代表其中的数据一定能作为服务器导入。若识别出订阅地址,应按 Subscribe 的方式添加;若是服务器信息,则核对协议类型和必要字段。可以向你的服务商索取原始文本信息用于核对,避免对模糊截图反复扫描。二维码中也可能包含密码或订阅凭据,分享前需遮盖。

Add Server 手动填写时,哪些字段不能混用?

先按服务商提供的信息选择 Type,再填写对应字段。Address 填服务器地址,Port 填端口;密码、UUID、密钥等认证信息应放在各协议对应的位置,不能互相替代。使用 TLS 时还要核对 Server Name、证书相关选项,以及服务商要求的传输参数。服务器地址与 TLS 名称可能不同,不应为了看起来一致而自行改写。不确定字段时先查协议参考,再向服务商确认,不要通过关闭证书验证来掩盖参数错误。

更新后手动改过的服务器参数消失了,怎样避免?

订阅条目通常由服务商返回的数据维护,更新时可能重建或覆盖条目,因此不应把订阅中的手动修改当作长期保存方式。确需单独调整时,先备份原资料,再将必要信息保存为独立的手动条目,并与原订阅分组区分命名。之后仍需自行核对服务商是否更改地址、端口或认证信息。不要把服务器条目更新与 Config 文件更新混为一谈,两者的来源、内容和启用状态应分别检查。

排查导入问题时,可以提供哪些信息?

可以提供设备系统、所选 Type、失败发生在导入还是连接阶段、完整错误提示,以及经过遮盖的相关设置截图。应遮盖订阅链接中的访问凭据、密码、UUID、Private Key 和二维码内容;保留字段名称有助于定位,但不必公开字段原值。如果服务商需要核对订阅状态,应通过其已有的私密支持渠道处理。本站手册只说明导入和使用方法,不需要收集你的订阅链接、服务器认证信息或账号密码。

从通道状态到实际请求

规则分流与故障排查

连接开关、服务器测试与目标请求不是同一件事。保持测试条件一致,才能判断是哪一层出现问题。

查看协议字段与选型参考 →
Global Routing 的 Config、Proxy、Direct 三种姿态怎么选?

配置(Config)按当前启用配置中的规则决定请求策略,日常需要规则分流时先检查这一项。代理(Proxy)让进入客户端处理范围的请求使用所选代理,适合短时判断是否为规则匹配问题。直连(Direct)让相应请求直接连接,可用于核对本地网络基线。切换姿态不等于切换服务器,也不会修复错误认证信息。对比测试时保持网络、服务器和目标一致,每次只改一个条件,测试后恢复所需姿态。

开关已连接却无法上网,应该按什么顺序排查?

先断开连接,确认当前 Wi-Fi 或蜂窝网络本身可用,再连接并检查选中的服务器是否正确。随后区分“所有目标都失败”与“只有部分目标失败”:前者先查服务器认证、到服务器的连通性及 DNS,后者优先查规则命中和目标服务状态。可用同一目标短时对照 Proxy 与 Config;若仅 Config 失败,回查当前 Config 的 Rule 顺序与策略引用。系统显示 VPN 已建立,只能说明本地通道状态,不能证明远端请求成功。

Connectivity Test 有结果,为什么实际请求仍然失败?

测试结果只对应当时的测试方法和测试目标。连接到服务器端口、完成协议握手、解析域名以及访问实际应用,是不同的检查层次,不能用一个结果替代全部判断。先核对测试使用的服务器与实际选中项一致,再查看目标请求的规则策略和 DNS 情况。对同一网络、同一目标重复少量测试并记录错误类型,比只比较延迟数值更有意义;不要据此承诺实际速度,也不要把一次超时直接归结为客户端异常。

连接后感觉耗电,和 On Demand 有关系吗?

耗电受持续流量、无线信号、协议处理、网络切换和后台请求共同影响,不能只看 VPN 图标是否存在。先在系统电池统计中比较相近日常使用时段,再检查是否长期开启大量测试、详细日志或频繁订阅更新。On Demand 会按条件触发连接;如果手动断开后很快重连,应检查对应条件,测试时可暂时关闭。不要为了降低耗电随意改变协议认证或传输参数,应先减少不必要的诊断活动并观察差异。

界面是英文,应该从哪些项目开始找?

本手册保留界面英文原文,便于直接定位:Home 查看服务器与连接,Add Server 添加信息,Subscribe 表示订阅类型,Config 管理配置文件,Global Routing 选择处理姿态,Settings 查看设置。若希望调整显示语言,可先检查系统是否为该应用提供语言选项,再以应用实际提供的选项为准。界面语言不会改变服务器参数的含义;不确定开关作用时,先记录原值并查阅教程,不要逐项尝试所有设置。

修改 Rule 后没有生效,怎样确认当前配置和规则顺序?

先在 Config 确认编辑的文件就是当前启用文件,再检查 Global Routing 是否为 Config;处于 Proxy 或 Direct 时,不应按同一套规则分流结果判断。Rule 通常自上而下匹配,较早命中的宽泛规则可能使后面的精确规则没有机会处理,FINAL 应作为末尾兜底。还要核对策略名称是否存在、拼写是否一致,以及远程配置更新是否覆盖了本地修改。保存后用同一目标重新发起请求,必要时查看日志确认实际命中的规则。