FAQ / Official Manual

Shadowrocket 常见问题

购买与恢复、首次授权、已有订阅导入、连接与规则排查。按出现问题的环节逐项核对,避免同时修改多个设置。

官方手册 · 问题索引

先确定问题属于哪个环节:应用是否可购买和安装,系统是否允许建立连接,已有资料是否完整导入,最后才是请求如何匹配规则。应用能打开、开关显示连接、测试出现结果,分别说明不同状态,不能互相替代。

本页以用户已有自己的订阅或服务器信息为前提。需要从头操作时查看入门指南;需要核对单项设置时查看Settings 设置项参考。排查过程中保留原始配置,记录错误原文,不公开含凭据的链接和二维码。

App Store / Purchase

正版核对与购买

先区分购买账户、商店店面与应用内资料。购买资格和连接条件需要分别核对。

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

先检查产品名是否完整输入,再从本站获取应用页打开 App Store 产品页,区分搜索结果问题与当前店面不可用。核对用于媒体与购买项目的 Apple 账户及其国家或地区,而不是只看设备语言。如果确需调整地区,通过系统 Settings 中的 Apple 账户、Media & Purchases、View Account、Country/Region 按官方流程办理;先阅读余额、订阅与付款方式的要求,不要反复改区尝试。

怎样核对 App Store 里的正版应用?

同时核对三处:开发者为 Shadow Launch Technology Limited,应用图标与本站展示的官方图标一致,产品页地址包含 id932747118。只凭名称相似或搜索排序不能完成核验。购买前还应展开产品页的兼容性与购买信息,确认设备适用条件。Shadowrocket 只通过 App Store 获取,本站获取应用页集中说明核验步骤,实际付款与安装在 App Store 内完成。

换 iPhone 或删除重装后,需要再买一次吗?

使用原来购买 Shadowrocket 的 Apple 账户,在 App Store 的账户页面进入已购应用列表,找到应用后重新下载,通常不需要再次购买。若仍显示价格,先核对媒体与购买项目登录的账户、购买记录及当前店面,再检查应用是否被隐藏。不要仅凭 iCloud 已登录就认定购买账户相同。重新下载只恢复应用获取资格,原设备的订阅、服务器信息与本地配置仍需通过自己的备份恢复。

iPad 能安装吗,其他 Apple 设备在哪里核对?

Shadowrocket 以 iPhone 与 iPad 使用为主。在 iPad 上打开同一 App Store 产品页,检查兼容性,并使用原购买账户核对是否可直接下载。Mac、Apple TV 与 Apple Vision 的适用情况也查看同一产品页的兼容性栏;系统要求与通用购买适用范围均以 App Store 页面标注为准。不同设备的布局和操作入口可能不同,不要把某一设备上的按钮位置直接套用到另一设备。

一次性买断包含什么,购买后能直接连接吗?

客户端一次性买断 ≠ 线路套餐。购买的是 Shadowrocket 客户端的使用资格,客户端买断 ≠ 线路套餐;连接仍需要用户已有自己的订阅或服务器信息。本站不提供、不销售、不推荐节点或订阅。美区定价约为 2.99 美元,各店面以当地货币显示,实际价格与购买条件以 App Store 页面标注为准。付款成功不代表已有可用连接,首次使用还需导入资料、选择项目并完成系统授权。

查看 App Store 正版核验与已购恢复步骤 →

Home / Settings

安装与首次打开

系统授权、连接资料与开关状态分开检查;重装前先确认备份范围。

首次打开时,添加 VPN 配置的系统提示是什么意思?

首次开启连接时,系统可能请求允许 Shadowrocket 添加 VPN 配置,用于建立系统网络扩展连接。确认提示来自刚刚主动操作的 Shadowrocket 后,再按系统流程授权;设备可能要求密码或生物识别验证。该授权不会自动补齐服务器地址、认证信息或订阅内容。若此前取消,可回到应用重新开启连接触发提示;受管理设备还可能受组织策略限制,应联系设备管理员核对。

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

先确认已经导入有效项目并选中要使用的服务器,再观察是否出现未完成的系统授权提示。进入系统 Settings 的 VPN 配置管理位置,检查 Shadowrocket 配置是否存在,以及是否有其他连接正在占用。先停止其他 VPN 连接,再单独测试。若仍立即关闭,记录应用提示并查看 Log,检查配置解析与网络扩展错误;保留备份后再考虑重新建立配置,不要直接删除全部资料。

界面是英文,怎样对应教程里的操作位置?

本手册保留界面词英文原文:Home 用于查看和选择连接项目,Add Server 用于填写服务器信息,Config 用于管理配置文件,Settings 用于查看设置,Global Routing 用于选择流量处理姿态。先按这些名称寻找入口,而不是按截图中的固定坐标操作。应用显示语言与可用语言选项以当前安装版本及系统设置为准;若系统提供应用语言设置,可在那里核对,不必为对照教程反复更改整台设备的语言。

开启后耗电增加,要检查哪些项目?

先在系统电池统计中对照相近使用时长,区分持续传输、后台任务与客户端本身的开销。频繁重连、连续测速、详细日志和不稳定网络都可能增加活动量;排查完成后停止反复测试,并按需要降低日志记录强度。检查 On Demand 是否符合预期,避免在不需要时反复触发连接。不要只凭一次电量下降判断原因,也不要把关闭所有规则当作通用省电方案,应一次调整一个变量后观察。

应用更新后,需要重新导入所有内容吗?

应用更新通过 App Store 完成,通常不需要重新导入已有资料,但更新前仍应备份重要配置并妥善保存订阅信息。更新后若出现变化,先检查选中的服务器、Config 文件和 Global Routing 是否与之前一致,再阅读 App Store 更新说明及应用提示。应用更新、Subscribe 内容更新和远程配置更新是不同操作,完成其中一项不会替代另外两项;不要通过反复重装处理尚未定位的问题。

按入门指南核对首次连接流程 →

Subscribe / Add Server

订阅与节点导入

以下操作使用用户已有的资料。先核对内容与格式,再检查网络和有效期。

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

先核对订阅地址是否完整,是否混入空格、换行或说明文字,再确认它确实是自己的订阅地址,而不是账户登录页。检查当前网络能否访问该地址,以及订阅是否过期、被撤销或需要更新授权。若提示解析失败,记录错误并向原服务商确认返回格式是否适用于 Shadowrocket;不要自行猜测修改地址参数。订阅地址可能包含访问凭据,排查时不要把完整地址粘贴到公开留言或截图中。

Subscribe 更新后,列表没有变化是失败了吗?

不一定。更新成功但远端内容未变时,列表可以保持原样。先确认更新的是目标 Subscribe 分组,并查看是否有错误提示;再核对当前网络、订阅有效期及服务商是否实际调整了内容。更新订阅通常处理该订阅管理的服务器条目,不等于更新本地 Config 规则。更新前记下当前选择,更新后检查选中项目是否仍存在,避免把列表变化、连接选择变化与规则变化混为一谈。

Scan QR Code 识别失败,能怎样继续导入?

先在系统中检查相机权限,保证二维码完整、清晰且没有被遮挡,并避免屏幕反光。Scan QR Code 只能处理应用支持的内容,二维码能被识别并不代表其中一定是有效服务器信息。如果识别后提示格式不支持,向原信息提供方核对编码内容;也可使用自己已有的完整链接,或在 Add Server 中手动填写对应字段。不要把二维码截图公开发送,其中可能包含地址、认证信息或订阅凭据。

手动添加 VLESS 等服务器时,地址和端口正确还缺什么?

地址与端口只是连接参数的一部分。以 VLESS 为例,还要按已有资料核对 UUID、传输方式、TLS 及相关服务器名称;使用特定传输时,还可能需要对应的路径或 Host。字段必须与服务器实际配置成组一致,不能从不同示例里拼接。先确认 Add Server 中选对协议类型,再逐项对照原始资料;不确定的字段向原服务商核实,不要通过关闭证书验证来掩盖名称或证书错误。

换机后列表空了,重新下载应用为什么没有恢复订阅?

App Store 购买记录与应用内连接资料是两类数据,重新下载应用不等于恢复订阅、服务器和本地规则。先确认原设备是否启用并完成 iCloud 同步,或是否保留了导出的配置及自己的订阅地址。恢复后分别检查服务器列表、当前 Config 和 Global Routing,再进行连接测试。不要把一份规则配置文件视为全部资料的备份;导出内容与同步范围应在原设备实际核对,并保护其中可能包含的认证信息。

查看配置备份与换机迁移说明 →

Global Routing / Diagnostics

规则分流与故障排查

先测试基础网络,再检查服务器、规则与 DNS。每轮只改变一个条件,便于回退和对照。

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

配置对应 Config,按当前启用配置中的规则决定请求去向;代理对应 Proxy,主要使用所选代理处理请求;直连对应 Direct,主要直接访问目标。日常需要规则分流时先检查 Config 文件并选 Config;排查服务器连接时,可短暂切换 Proxy 做对照,再恢复原设置。Direct 可用于对照本机网络是否正常,但不能验证代理服务器可用。系统流量、排除项及特殊配置仍可能影响结果,姿态名称不等于对全部流量的绝对保证。

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

先关闭连接,对照当前 Wi-Fi 或蜂窝网络能否正常访问原本可用的网站;若基础网络异常,先处理本机网络。随后开启 Shadowrocket,确认所选服务器有效,检查 Global Routing 和当前 Config。用同一目标对照 Proxy 与 Config:若只有 Config 失败,重点查规则及 DNS;若都失败,继续核对服务器认证、TLS 和服务端状态。每次只改一项,并记录 Log 中对应请求的错误,不要把已连接状态当作目标网站必然可达的证明。

Connectivity Test 有结果,为什么网页仍打不开?

Connectivity Test 反映的是特定测试方式和测试目标在当时的结果,不等于所有网站或所有应用的实际体验。测试目标可达时,业务目标仍可能因 DNS、TLS、规则匹配、服务器出口或目标自身状态而失败。先确认测试方式与目标,再在实际使用姿态下重试同一网页,并查看对应请求记录。不要只按一次测试数值判断连接优劣;连续测试也不能替代对具体错误和规则去向的检查。

规则没有按预期生效,怎样检查匹配顺序?

先确认 Global Routing 为 Config,且正在使用刚编辑的配置文件。Rule 按自上而下顺序匹配,应把更具体的规则放在宽泛规则之前,并把 FINAL 兜底放在末尾。随后在请求记录中核对实际域名、目标地址与命中的策略,区分 DOMAIN-SUFFIX、IP-CIDR 等规则的匹配对象。REJECT 只影响命中该策略的请求,不能保证屏蔽页面中的全部内容;缓存、复用连接及同域资源也可能影响观察结果。

怀疑 DNS 异常时,要直接更换 DNS 设置吗?

先确认故障是否表现为域名解析失败,而不是认证失败、连接超时或证书错误。记录当前 Config 中的 DNS 设置,并用实际请求日志核对解析结果及请求去向;如使用 dns-server = system,表示使用系统提供的 DNS 配置,并不保证当前网络解析一定正确。需要调整时先备份,只改变一个相关选项后重试相同目标。不要叠加多个来源不明的 DNS 设置,也不要把所有无法访问的问题都归因于 DNS。

继续核对设置与术语

保留一份可以回退的配置,再进入具体设置项逐条排查。规则关键字和策略名称保留英文原文,避免把 Global Routing 的姿态与某条规则中的策略混用。