官方手册 · FAQ

Shadowrocket 常见问题

先定位问题发生在哪一步,再展开对应答案。购买记录、应用安装、订阅列表和实际连接是不同环节,逐项核对比一次修改多处设置更容易找到原因。

正版核验与购买

先核对商店产品与购买账户,再处理设备下载和已购恢复。

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

先从下载指南打开 Shadowrocket 的 App Store 产品页,避免只依靠搜索结果判断。若页面提示当前地区不可用,检查 App Store 当前登录的 Apple 账户及其国家或地区;设备的语言与地区设置不等于商店账户地区。确需更改时,在系统 Settings 中进入 Apple 账户 → Media & Purchases → View Account → Country/Region,按 Apple 提示核对余额、订阅与付款条件。商店可用性以当前页面显示为准,不要反复更改地区来代替排查。

怎样确认正版应用,购买后是否包含连接服务?

在 App Store 产品页同时核对三处:名称 Shadowrocket、与本站页头一致的官方图标,以及开发者 Shadow Launch Technology Limited;再检查产品链接中的应用 ID 932747118。Shadowrocket 是付费客户端,客户端一次性买断 ≠ 线路套餐,使用前需要准备自己已有的订阅或服务器信息。美区定价约为 2.99 美元,实际价格、当地货币与付款结果以 App Store 页面为准。购买应用与确认配置是否有效是两件事,应分别核对。

换机或重新安装 Shadowrocket,需要再购买一次吗?

先用原购买时的 Apple 账户登录 App Store,再到个人账户中的 Apps 或已购项目查找 Shadowrocket;入口名称可能随系统语言与界面调整。找到对应应用后按商店显示重新下载,不要先重复付款。如果仍显示价格,核对购买记录、商店账户与当前产品页是否一致。下载记录恢复不等于订阅、服务器和 Config 自动恢复,换机前应另行备份已有配置,并妥善保管凭据。家人共享及跨设备购买的适用范围以 App Store 页面标注为准。

iPad 能安装 Shadowrocket 吗,已有购买怎样使用?

可以先在 iPad 的 App Store 打开同一产品页,查看兼容性并确认是否提供下载。使用购买时的 Apple 账户检查已购项目,系统要求与是否通用购买一律以 App Store 页面标注为准。iPad 上横屏、分屏和窗口宽度会影响列表与详情的排列,操作时按 Home、Config、Settings 等名称定位,不必照搬 iPhone 上的按钮坐标。应用能够下载不代表服务器配置已经同步;首次使用仍需检查已有订阅、当前所选服务器及 VPN 配置授权。

相关步骤:正版核验 · 已购项目恢复 · iPad 使用说明

安装与首次打开

先区分系统授权、应用入口与连接结果,避免把授权成功当成网络验证。

首次打开时,系统要求和 VPN 配置授权怎样确认?

安装前在 App Store 的兼容性栏检查设备与系统要求,以 App Store 页面标注为准。首次打开后,先确认已有服务器或订阅已经正确导入;启用连接时,系统可能要求添加 VPN 配置,并通过设备密码或系统认证确认。这是允许客户端建立系统 VPN 配置的授权,不等于服务器已经连通。若此前取消,可返回 Shadowrocket 再次尝试启用;若设备受管理限制,应先检查管理策略。完成授权后还需要验证实际访问,不能只凭授权成功判断连接结果。

连接开关打不开,或打开后立即关闭,先检查哪些项目?

先确认 Home 中有可用配置且已选中服务器,再观察系统是否等待 VPN 配置授权。打开系统 Settings,检查 VPN 配置是否存在、是否被其他连接占用,以及设备是否有管理限制;记录现象后再暂时停用其他 VPN 连接进行对照。若开关立即回落,查看 Shadowrocket 的相关日志,重点检查字段缺失、配置解析失败与权限提示。不要直接重置全部设置或删除全部节点。删除并重建 VPN 配置之前,先备份应用内配置,并确认原有连接可以恢复。

界面是英文,怎样对照官方手册找到操作入口?

本手册保留界面英文名称,便于直接对照:Home 用于查看服务器与连接状态,Add Server 用于填写单条服务器信息,Config 用于配置文件,Settings 用于设置。Global Routing 下的 Config、Proxy、Direct 分别对应配置、代理、直连三种姿态。若想调整应用显示语言,可在系统 Settings 的应用设置中检查是否提供 Language 选项;可选语言以设备实际显示为准。界面语言不会自动修正订阅地址或服务器字段,找不到入口时应先核对页面名称,再核对当前布局。

怎样更新 Shadowrocket,更新前需要保存什么?

应用更新通过 App Store 完成,可在商店账户页检查可用更新,或按系统设置使用自动更新。更新前建议保存正在使用的 Config、手动添加的服务器和订阅分组信息,并确认已有订阅地址仍可取得。应用更新与订阅更新相互独立:前者更新客户端,后者刷新已有服务器列表,不能互相替代。遇到异常时先阅读商店中的更新说明,再记录复现条件;不要为了尝试修复而立即删除应用,因为重新下载不保证恢复本地保存的配置。

按顺序操作:查看首次连接教程。

订阅与节点导入

先区分订阅地址、单条分享链接和手填字段,再选择对应导入入口。

已有订阅导入失败,怎样区分链接、网络和格式问题?

先完整复制自己已有的订阅地址,检查前后空格、换行及查询参数是否被截断,不要把账户管理页面地址当成订阅地址。随后按提示区分故障:无法连接或超时,先检查当前网络能否访问该地址;认证失败或链接失效,核对原有订阅状态;能够获取但无法识别,则核对返回内容是否为客户端支持的格式。订阅地址通常包含凭据,排查时不要公开粘贴完整地址或二维码。保留原分组与错误提示,确认原因后再重试,避免重复导入造成混淆。

只有单条服务器信息,Add Server、扫码和剪贴板怎样选?

已有完整分享链接时,可使用应用提供的剪贴板导入入口;已有二维码时使用 Scan QR Code,并按系统提示允许相机访问。若只有字段信息,则进入 Add Server,先选择与原配置一致的协议,再逐项填写地址、端口及相应认证字段。Shadowsocks、VMess、VLESS、Trojan 等协议的字段不能混用,TLS、Server Name 与传输设置也应按原配置填写。保存后重新打开详情核对一次,再进行连接测试。不要根据链接外观猜测缺失参数,也不要把订阅地址填入单条服务器地址栏。

怎样更新订阅,自动更新失败时是否需要重新导入?

先在 Home 中找到对应的 Subscribe 分组,使用该分组的更新操作,并观察更新时间提示、服务器列表与错误信息;具体入口以当前应用界面为准。若需要自动更新,在 Settings 的订阅相关设置中检查打开应用时更新等可用选项,不要把它理解为始终在后台定时执行。更新失败时,先核对地址有效性、网络可达性和返回格式,通常不必立即删除分组。重新导入前应保存原地址及自定义备注,避免丢失排查依据;更新成功后还要重新确认当前选中的服务器。

更新后节点减少、重复或排序变化,是导入出错了吗?

不一定。订阅更新会依据返回内容刷新服务器列表,原有条目可能被移除、改名或调整顺序;手动添加的条目与多个订阅分组也可能出现相同名称。先按分组检查条目的实际地址、端口与协议,不要仅凭名称判断重复。确认更新成功后,再检查原先选中的服务器是否仍存在。整理前保存手动填写的字段和备注,避免误删后只能凭记忆重建。延迟排序只反映当次测试结果,不代表所有目标的访问速度;批量清理前应先验证实际连接与分组归属。

字段、分组与备份说明:订阅与节点管理手册。

规则分流与故障排查

以同一网络、同一目标做对照,分别验证基础网络、服务器连接和规则选择。

Global Routing 的 Config、Proxy、Direct 应该怎样选?

需要按规则区分流量时选择 Config,并确认当前启用的配置文件与规则顺序;需要将通常可代理的连接统一交给所选服务器测试时选择 Proxy;需要直连对照时选择 Direct。配置、代理、直连对应的界面词分别是 Config、Proxy、Direct。Config 中的 DIRECT、PROXY 等策略由命中的规则决定,不能只看 Home 中选中了哪个服务器。排查时保持同一网络、同一目标,每次只切换一个姿态;Direct 可访问而 Proxy 失败时,应优先检查服务器连接,而不是立即重写整份规则。

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

已连接通常只说明系统 VPN 通道已建立,不保证当前服务器、DNS 和目标地址都可用。先暂停连接,确认基础网络可以正常访问;随后恢复连接,核对所选服务器,再用同一目标分别测试 Direct 与 Proxy。如果 Proxy 也失败,检查服务器认证、地址、端口及网络可达性;如果 Proxy 正常而 Config 失败,检查当前配置、规则命中与 DNS 设置。只在部分应用失败时,记录目标域名和错误现象。每次只改一个项目并保留原值,避免同时换节点、换规则与改 DNS 后无法判断原因。

后台耗电偏高,On Demand 应怎样取舍?

先在系统 Settings 的电池页面查看 Shadowrocket 的前台、后台活动与统计时段,再结合设备总耗电判断,不要只看占比。持续传输、信号不稳和频繁重连都可能增加耗电。检查 On Demand 是否因 Wi-Fi、蜂窝网络或域名条件反复触发;可在保留原设置后暂时关闭相关条件,按相近使用时长对照。按需连接不等于必然更省电,频繁触发也会带来额外连接活动。应按实际使用场景选择常驻或按需,并分别记录重连次数、网络环境与电池变化。

Connectivity Test 正常,为什么访问仍失败,日志该怎样提供?

Connectivity Test 的成功只证明相应测试目标在当时满足测试条件,不能代替所有网站、应用或协议的实际访问。先记录测试方式、当前 Global Routing 姿态、所选服务器及失败目标,再在重现问题后查看对应日志;重点区分 DNS 解析、连接超时、认证失败与规则策略。提供排查材料时,只保留必要的错误行与时间顺序,并遮盖订阅地址、密码、认证标识和二维码。日志中的完整 URL 也可能带凭据。不要只发送一张成功测试的截图,应同时说明具体哪一步失败以及已经做过的对照。

需要从头核对连接过程时,返回使用教程,按导入、选择姿态、连接与验证的顺序重新检查。