官方手册 · 常见问题
Shadowrocket
安装、订阅与连接问答
适用于 iPhone、iPad、Mac、Windows、安卓与 Linux。先定位问题所属阶段,再展开答案;导入与连接说明均以用户已有自己的订阅或服务器信息为前提。
先处理获取与系统权限,再核对导入结果,最后检查规则和连接。不要同时修改多个设置,以免丢失有效的对照结果。
查看客户端下载正版核对与购买
按设备确认获取方式;商店核对以开发者、官方图标和应用 ID 为依据。
电脑和安卓能不能用,分别怎样获取?
能。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。Mac 提供 Apple 芯片与 Intel 两种版本,其他平台按设备与发行版选择。进入客户端下载页,iPhone / iPad 跳转 App Store,其余安装包由本站 /dl/ 路径提供。首次打开若被系统拦截,先确认文件来自本站,再按本页安装分类中的系统放行步骤操作。
怎样核对 App Store 中的 Shadowrocket?
不要只看搜索结果中的名称。打开产品页,核对名称 Shadowrocket、开发者 Shadow Launch Technology Limited,以及产品页地址中的应用 ID 932747118;图标应与本站页头的官方图标一致。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费,各店面金额以当地页面显示为准。名称或图标相似但开发者、应用 ID 不一致的条目,不应按本手册继续操作。
App Store 搜不到 Shadowrocket,先检查哪里?
先从客户端下载页打开 App Store 产品页,区分是搜索结果缺失,还是商店提示当前地区不可用。中国大陆 App Store 目前未上架此应用,请核对用于“媒体与购买项目”的 Apple 账户国家或地区,而不只是设备语言。还需检查屏幕使用时间中的内容年龄分级限制。需要调整地区时,按“设置 → Apple 账户 → 媒体与购买项目 → 查看账户 → 国家或地区”进入系统流程,先阅读余额、订阅与付款方式要求。
iPad 能不能安装,换机或重装要不要再买?
iPad 可以安装,系统要求以 App Store 页面标注为准。iPhone / iPad 版 App Store $2.99 一次性付费,两种设备使用同一购买账户时可从已购项目重新下载;Mac / Windows / 安卓 / Linux 版免费。换机后先确认登录的是原购买账户,再到 App Store 的账户页查找已购项目,栏目名称可能随系统变化。重新下载应用不会自动恢复所有本地服务器和配置,换机前应另行备份,并妥善保管其中的凭据。
获取客户端后为什么仍需准备订阅或服务器信息?
客户端一次性买断 ≠ 线路套餐。Shadowrocket 负责读取配置、匹配规则并建立连接,应用购买记录不能替代服务器地址、认证信息或 Subscribe 链接。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;这两档获取方式都不包含线路服务。本站不提供、不销售、不推荐节点或订阅。后续操作均以用户已有自己的订阅或服务器信息为前提,导入前先确认资料完整且仍然有效。
安装与首次打开
先确认文件来源与设备架构。放行仅针对已经核对的应用;受管理设备应遵循管理员策略。
Mac 应该选 Apple 芯片版还是 Intel 版?
在 Mac 的苹果菜单中打开“关于本机”,查看“芯片”或“处理器”一栏。显示 Apple 芯片时选择 Mac Apple 芯片版;显示 Intel 时选择 Mac Intel 版,不要按电脑外观或购买年份猜测。两种安装包均在客户端下载页的 Mac 区域提供。下载后打开磁盘映像,将 Shadowrocket 拖入 Applications。若首次打开出现无法验证开发者的提示,确认来源后到“系统设置 → 隐私与安全性”处理,不必反复更换芯片版本。
Windows 的 SmartScreen 提示风险,怎样继续检查和安装?
先确认下载操作来自本站客户端下载页,安装包由本站 /dl/ 路径提供,并确认准备运行的是刚下载的文件。出现 SmartScreen 提示时,可展开“更多信息”,核对文件后选择“仍要运行”,随后阅读系统权限确认。若没有这个选项,或设备由单位管理,不要尝试绕过组织策略,应联系设备管理员。系统放行只代表允许程序运行,不等于服务器资料已经配置完成,首次打开后仍需导入用户已有的信息。
Mac 提示无法验证开发者或应用已损坏,怎样处理?
先确认安装包来自本站,且已将 Shadowrocket 放入 Applications。提示无法验证开发者时,先尝试打开一次,再进入“系统设置 → 隐私与安全性”,找到对应提示并选择“仍要打开”,按系统要求确认。如果提示应用已损坏,先重新下载并安装;仍有提示且来源确认无误时,可在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app 后再次打开。命令只针对该应用,不应扩大到整个目录;受管理设备应先询问管理员。
安卓安装被阻止,需要打开哪个权限?
从客户端下载页取得适用于设备的安卓安装包后,系统可能要求为当前浏览器或文件管理器开启“允许安装未知应用”。只对实际用来打开安装包的应用授予这项权限,完成安装后可关闭。若提示包无法解析,先检查下载是否完整、设备架构是否适用,再重新下载,不要连续重复安装同一个失败文件。在微信内无法开始下载时,按页面提示改用系统浏览器。首次连接出现 VPN 配置确认时,阅读应用名称与权限说明后再决定是否允许。
Linux 应该选 deb、rpm 还是 AppImage?
按发行版的软件包体系选择:Debian、Ubuntu 等通常使用 deb,采用 RPM 软件包体系的发行版选择 rpm;AppImage 适合以独立文件方式启动的场景,还需满足运行依赖。通过客户端下载页取得包后,deb 可在文件所在目录执行 sudo apt install ./Shadowrocket.deb,其中本地文件名须替换为实际名称。AppImage 需先授予执行权限,例如 chmod +x Shadowrocket.AppImage,再运行对应文件。提示架构或依赖不匹配时先处理报错,不要强制安装。
订阅与服务器导入
先核对链接或字段,再保存与测试。订阅链接、配置备份和二维码都可能包含认证信息。
已有 Subscribe 链接,怎样导入并核对结果?
先确认手中是用户已有的完整订阅链接,而不是网页说明地址。在 Home 进入 Add Server,选择 Subscribe,把链接粘贴到对应 URL 字段,并填写便于辨认的名称,再保存并等待获取完成。返回列表后核对分组名称、服务器条目和协议是否符合预期,不要仅凭出现一个分组就判断成功。订阅链接通常包含认证参数,应视为敏感资料,不要放到公开截图或求助消息中。字段与入口的详细操作可继续查看订阅手册。
订阅导入失败或列表为空,应该按什么顺序排查?
先检查链接首尾有没有空格、换行、截断或多余标点,再确认链接是否仍有效。接着区分报错:超时通常先检查当前网络能否访问订阅地址;认证失败要核对链接参数;获取成功但没有条目,则检查返回内容是否为支持的订阅格式,而不是登录页或错误页面。不要把完整链接交给他人代测。若另一条已有订阅可以更新,问题范围更可能在当前链接或返回内容;保留错误文字,再向原信息提供方核对。
只有服务器参数,Add Server 应该怎样填写?
在 Home 打开 Add Server,先按已有资料选择协议,再填写 Address、Port 与对应的认证字段。Shadowsocks 的加密方式、VMess 或 VLESS 的标识字段、Trojan 的认证信息等不能相互替代;TLS、SNI 与传输参数也应逐项照原资料填写。服务器地址通常不应混入网页路径,端口应为提供方给出的数字。保存后先核对字段,再选择该服务器测试。不要为消除错误随意关闭证书验证;需要修改时先确认原配置要求。
怎样更新订阅,更新会不会改掉手动整理的内容?
在 Home 找到对应的 Subscribe 分组,使用该分组的更新操作,等待结束后再核对条目是否变化。界面中的操作位置可能随版本与平台不同,应以当前分组提供的菜单为准。订阅更新会按远端返回内容重建或调整所属服务器,手动修改的名称、排序或字段不应视为永久保存。重要调整先做备份;需要长期保留的独立服务器可单独管理。更新失败时先保留旧分组,不要立即删除,以免同时丢失排查依据。
多个订阅出现重复服务器,怎样整理而不误删?
先按来源和用途为已有订阅分组命名,再区分是同一链接重复导入,还是不同订阅包含相同服务器。不要只看显示名称判断重复,应核对协议、地址、端口及必要的传输参数;名称相同也可能是不同连接。确认某个分组属于重复导入后,先备份再删除整组,避免逐条删除后下次更新又出现。删除前检查当前选中的服务器是否属于该组。备份文件可能包含密码与订阅参数,应保存在受保护的位置。
规则分流与故障排查
“开关已连接”“服务器可达”和“目标请求成功”是不同结果。按基础网络、系统授权、服务器、DNS、规则的顺序缩小范围。
连接开关打不开,或者打开后马上关闭,怎么办?
先确认已经选中有效服务器,并完成系统要求的 VPN 配置授权。首次授权被取消时,返回应用重新尝试并阅读系统弹窗;仍失败可到系统设置检查对应 VPN 配置是否存在。再检查是否有其他 VPN 连接或设备管理策略占用网络权限,避免同时启用多个相互冲突的连接。若开关随网络变化自动切换,检查 On Demand 的条件。最后记录错误提示与触发步骤,再查看诊断信息,不要一开始就清除所有配置。
开关显示已连接,但网页打不开,怎样定位?
先暂时关闭连接,确认当前 Wi-Fi 或移动网络本身可用;需要网页认证的网络先完成认证。再检查服务器认证信息、有效状态以及系统时间,使用 Connectivity Test 辅助判断可达性,但测试有结果不代表所有网页请求都会成功。如果全部目标失败,优先检查服务器与 DNS;只有部分目标失败,则查看请求记录中的命中规则与策略。每次只改一个设置,测试后记录结果,才能判断是网络、服务器还是规则造成的变化。
Global Routing 的 Config、Proxy、Direct 三种姿态怎么选?
配置(Config)按当前配置文件中的规则决定请求走向,适合已核对规则的日常使用;代理(Proxy)将可代理的流量交给当前选择的代理策略,可用于对照测试;直连(Direct)让请求直接发出,可用于检查基础网络。三种姿态不是三个服务器,也不会自动修复失效的订阅。测试时先记住原来的选择,用同一目标依次对照,完成后恢复所需姿态。Config 的实际结果还取决于规则顺序、策略引用与最后的兜底规则。
DOMAIN-SUFFIX 或 REJECT 没有按预期生效,先看什么?
先确认 Global Routing 处于 Config,并且正在使用刚修改的配置文件。规则通常按顺序匹配,目标可能已被更靠前的 DOMAIN、IP-CIDR 或其他规则处理,尚未到达新写的规则。核对 DOMAIN-SUFFIX 填写的是域名后缀而不是完整网页地址,再从请求记录中查看实际连接的域名与命中策略。REJECT 是按匹配条件拒绝连接,不识别页面内容;同一页面可能请求多个域名,因此不能以页面外观直接判断某一条规则是否生效。
界面是英文,应该从哪些入口开始?
先按用途辨认几个入口:Home 查看与选择服务器,Add Server 添加已有信息,Subscribe 管理订阅,Config 管理配置文件,Global Routing 选择连接姿态,Settings 查看设置。官方手册保留这些英文原文,便于与实际界面对照,不需要把每个词都翻译后才能操作。若系统支持单独设置应用语言,可在设备设置中查看 Shadowrocket 的语言选项;可选语言以实际界面为准。遇到不同平台入口位置变化时,先确认功能名称,再按对应章节操作。
使用时耗电增加,On Demand 和诊断测试要不要调整?
先在系统电池统计中区分应用前台使用、后台连接时长和设备整体网络活动,不要只看一次百分比就判断故障。持续下载、频繁重连、信号较弱、密集的 Connectivity Test,以及一直记录详细日志,都可能增加网络与处理开销。检查 On Demand 是否在当前网络条件下反复触发,并减少不必要的重复测试。一次只调整一项,在相近的使用时长和网络环境下比较;排查结束后恢复合适的日志级别。不要为降低耗电随意改动不理解的认证或规则字段。