官方手册 / 常见问题

Shadowrocket
常见问题

按获取、安装、导入与连接状态定位问题。先核对当前设备和界面提示,再逐项检查;每次只修改一个设置,便于确认原因。

获取与账户

正版与购买

区分客户端获取与服务器使用权,再核对商店条目和购买记录。

电脑和安卓能用 Shadowrocket 吗,如何获取?

能。iPhone / iPad 版在 App Store 获取,$2.99 一次性付费;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。请从本站客户端下载页选择设备,电脑与安卓安装包通过本站 /dl/shadowrocket/ 路径提供。iPhone / iPad 的系统要求以 App Store 页面标注为准;其他平台应核对下载页的架构与安装说明,首次打开遇到系统拦截时按下方安装问答处理。

iPad 能安装吗,换机或重装要再买一次吗?

iPad 可以安装。iPhone / iPad 版在 App Store $2.99 一次性付费,两种设备通用;Mac、Windows、安卓、Linux 版免费。换机或重装时,使用原购买所用的 Apple ID,在 App Store 的已购项目或应用列表中查找并重新下载。若仍显示购买金额,先核对登录账号、购买记录及商店地区,不要急于重复付款;系统要求以 App Store 页面标注为准。

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

先确认搜索词为 Shadowrocket,再检查 Apple ID 的国家或地区。中国大陆商店未提供此应用,设备系统语言与商店地区并不是同一项设置。可以打开本页提供的 App Store 产品页核对可用性;如需调整地区,在系统设置的 Apple 账户中进入媒体与购买项目、查看账户、国家或地区,阅读官方换区条件。余额、订阅及家庭共享状态可能影响换区,不能靠改变设备语言解决。

如何核对 App Store 中的正版条目?

核对三个信息:应用名 Shadowrocket、开发者 Shadow Launch Technology Limited,以及产品页地址中的应用 ID 932747118,并将图标与本站页头官方图标对照。iPhone / iPad 版 App Store $2.99 一次性付费,Mac、Windows、安卓、Linux 版免费;不要把其他平台的获取规则套到商店同名条目上。电脑与安卓应从本站下载页进入本站安装包路径,而不是依据搜索结果中的同名文件判断来源。

购买客户端后,是否就有可用的服务器?

客户端一次性买断 ≠ 线路套餐。iPhone / iPad 版 App Store $2.99 一次性付费,Mac、Windows、安卓、Linux 版免费;这些获取方式对应客户端本身,不包含服务器使用权。连接前需要准备用户已有自己的订阅或服务器信息,并确认其仍然有效。本站是 Shadowrocket 官网与官方手册,不提供、不销售、不推荐节点或订阅;手册只说明如何导入、配置与排查已有信息。

设备与权限

安装与首次打开

先确认架构和文件来源,再按系统提示处理安装与 VPN 权限。

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

打开 Mac 左上角 Apple 菜单中的关于本机:显示芯片并标注 Apple 芯片的设备选 Apple 芯片版,显示 Intel 处理器的设备选 Intel 版。下载页提供两个同等入口,不要根据购买年份或机身外观猜测。下载对应 dmg 后打开,将 Shadowrocket 放入 Applications 再启动;若系统提示无法验证开发者,确认文件来自本站后,到系统设置的隐私与安全性中使用仍要打开。

Windows 或 Mac 提示有风险,如何处理?

先确认安装包来自本站下载页,并核对文件类型与设备架构。Windows 出现 SmartScreen 提示时,查看更多信息,在确认来源后选择仍要运行;单位管理设备应遵守管理员策略。Mac 提示无法验证开发者时,到系统设置、隐私与安全性中选择仍要打开。若提示已损坏,可在确认来源后执行 xattr -cr /Applications/Shadowrocket.app 再试。不要为启动应用而整体关闭系统安全保护。

安卓和 Linux 下载后,安装前还需要做什么?

安卓应选择下载页提供的 arm64 安装包;系统阻止安装时,只为实际打开安装包的浏览器或文件管理器允许安装未知应用,安装完成后可收回该权限。Linux 按发行版选择 deb、rpm 或 AppImage:前两种交给对应软件包管理器安装,AppImage 先在文件属性中允许作为程序执行再启动。出现架构不匹配、依赖缺失或权限提示时先解决对应原因,不要反复运行不匹配的文件。

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

在 iPhone / iPad 上,先选中一条用户已有的有效服务器,再打开连接开关;首次出现添加 VPN 配置提示时,需要允许并完成系统验证。若此前拒绝过,重新发起连接以触发授权,同时检查系统设置中的 VPN 配置是否存在。暂时断开其他正在工作的 VPN,避免竞争同一连接位置。若开关仍立即关闭,记录当次错误提示再检查配置字段;不要先删除全部服务器或反复重置系统网络。

界面显示英文,教程中的名称该怎样对应?

本手册保留界面英文原文,便于逐项核对:Home 用于查看服务器与连接状态,Add Server 用于手动添加,Subscribe 用于订阅,Config 用于配置文件,Settings 用于设置。Global Routing 是流量处理模式入口,配置、代理、直连分别对应 Config、Proxy、Direct。若系统支持应用单独语言,可在系统的应用设置中检查语言选项;是否出现该选项取决于系统及应用提供的语言,不影响按英文名称操作。

已有信息管理

订阅与节点导入

以下操作均以用户已有自己的订阅或服务器信息为前提。

已有订阅导入失败,应该按什么顺序检查?

先确认粘贴的是用户已有的完整订阅链接,而不是账户管理网页或单条服务器分享链接。检查首尾空格、换行、缺失参数及链接是否过期,再在 Subscribe 中保存并尝试更新。若出现网络错误,先确认当前网络能够访问订阅地址;若返回内容格式错误,需要核对该链接是否输出客户端支持的数据。不要把含有个人访问参数的订阅链接贴到公开评论或截图中,也不要用浏览器显示出的登录页面内容代替订阅。

如何更新订阅,更新后为什么没有新服务器?

进入已有订阅对应的管理入口,执行更新并查看结果,再返回服务器列表检查该订阅分组。更新成功表示获取并解析了当前返回内容,不代表服务器数量一定改变;原订阅内容没有变化时,列表也可能保持不变。若更新失败,先检查链接有效性和当前网络,再核对错误提示。更新前记录正在使用的服务器及手动改动,更新后重新检查选择项,因为原条目可能被订阅内容替换或移除。

Scan QR Code 与剪贴板导入适合什么内容?

两种方式都用于导入用户已有的信息,但二维码或剪贴板内容必须是客户端能够识别的链接或数据。单条分享链接通常只包含一台服务器,订阅链接则用于获取并更新一组服务器,导入前应先分清类型。使用 Scan QR Code 时允许相机权限,并保证二维码完整清晰;剪贴板导入前确认复制了整段内容。导入完成后核对协议、地址与端口,不能仅凭出现一条新记录就判断连接信息正确。

Add Server 手动填写时,哪些字段最容易出错?

先选择与已有服务器一致的协议,再填写地址、端口和相应认证信息。Shadowsocks 的加密方式、VMess 或 VLESS 的身份字段、Trojan 的密码,以及 TLS 与传输相关字段不能相互替代。尤其注意地址栏不要混入网页路径或多余空格,端口应与原始信息一致;启用 TLS 时还要核对相关主机名。保存后先测试单条记录,失败时逐项对照原始资料,不要同时修改多个字段来猜测正确组合。

多个订阅如何整理,删除前需要备份什么?

为每个已有订阅使用容易辨认的名称,并将手动添加的服务器与订阅生成的条目区分开。清理重复项前,先核对所属分组、地址与协议,不要仅依据相似备注批量删除。删除订阅或重新导入前,保存原始订阅链接、手动填写的字段以及正在使用的 Config;如使用应用提供的导出功能,应将导出文件作为敏感资料妥善保管。订阅备份与规则配置备份不是同一件事,恢复后需要分别核对。

模式与诊断

规则与故障排查

固定测试目标,依次检查服务器、Global Routing、DNS 和规则。

Global Routing 的配置、代理、直连三姿态怎么选?

配置对应 Config,按当前配置文件中的规则决定流量去向;代理对应 Proxy,让进入客户端处理范围的流量使用所选代理;直连对应 Direct,使用直接连接。日常需要规则分流时先检查 Config 是否选中且规则完整,Proxy 可用于对照判断是否是规则问题,Direct 可用于确认直接连接表现。若界面还显示 Scene,应按场景设置理解,不能把它当成另一条服务器。切换姿态后用同一目标重新测试,避免同时更换服务器。

显示已连接却无法上网,先排查哪几项?

先断开连接,确认当前 Wi-Fi 或蜂窝网络本身可用;再连接并检查所选服务器是否有效,运行 Connectivity Test 观察是否超时。随后核对 Global Routing,临时用 Proxy 对照 Config 的结果;如果只有 Config 失败,重点检查规则命中与 FINAL 去向。若多个目标都失败,再检查 DNS、认证字段和服务器状态。每次只改变一项并重试同一目标,连接开关保持开启不等于远端服务器或所有网站都可访问。

怀疑 DNS 出错或规则走错,怎样缩小范围?

先记录失败目标的域名与发生时间,再查看当前 Config 和连接记录,判断请求是否被送往预期策略。DOMAIN-SUFFIX 匹配域名后缀,IP-CIDR 匹配地址段,FINAL 处理此前未匹配的流量;规则顺序变化可能改变结果。若出现域名解析错误,核对当前 DNS 设置与所用网络,不要一次替换全部 DNS 和规则。修改后重新发起请求,避免把旧连接或缓存结果当作新设置的效果;记录中涉及个人信息的部分应先遮蔽。

开启后耗电增加,应该检查 On Demand 吗?

可以检查,但应先在系统电池统计中观察实际使用时段,同时留意视频、下载等持续流量是否增加。On Demand 控制在设定的网络条件下自动连接,并不等同于固定的省电开关;若设置导致网络切换时反复连接,应分别核对 Wi-Fi 与蜂窝网络条件。服务器不稳定、频繁重试、持续测试或长时间详细记录也可能增加活动。每次调整一项并观察一段相近的使用时间,不以单次电量变化判断原因。

Connectivity Test 的结果能代表实际网速吗?

不能直接等同。Connectivity Test 用于辅助判断特定测试条件下的连通性,结果会受到测试目标、当前网络与服务器响应影响。测试有响应不代表所有网站或所有协议都正常,超时也需要结合测试方式和实际访问结果判断。排查时固定同一网络、同一服务器和同一目标,再分别比较连接前后及不同 Global Routing 模式。需要进一步定位时记录错误时间、协议、模式和经过遮蔽的日志,不公开密码、身份字段或完整订阅链接。