Official Manual / FAQ

Shadowrocket 常见问题

按购买、首次打开、已有配置导入与连接排查分类。先确认问题发生在哪一步,再逐项检查;每次只更改一个设置,保留可对照的测试结果。

App Store / Purchase

正版核对与购买

核对产品页、购买账户与兼容性,再处理设备间的恢复问题。

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

先从获取应用页打开 App Store 产品页,排除搜索词或搜索结果的影响。如果提示当前地区不可用,核对用于“媒体与购买项目”的 Apple ID 所属国家或地区;再检查“屏幕使用时间”中的内容与隐私限制,确认应用年龄分级没有被限制。需要调整地区时,使用系统设置中 Apple ID → 媒体与购买项目 → 查看账户 → 国家或地区的官方路径,并先处理余额、订阅及付款条件。可用性以商店当时显示为准。

怎样确认打开的是 Shadowrocket 正版产品页?

同时核对产品名 Shadowrocket、开发者 Shadow Launch Technology Limited,以及产品页地址中的应用 ID 932747118,再对照本站页头使用的官方应用图标。名称相似或图标相近都不能单独作为判断依据。购买前还应展开兼容性、价格与购买适用说明,确认适用于当前设备和账户。Shadowrocket 是付费闭源商业应用,唯一获取入口是 App Store;详细核对步骤见获取应用页。

购买 Shadowrocket 后就能直接连接吗?

客户端一次性买断 ≠ 线路套餐。购买获得的是 Shadowrocket 客户端的使用资格,不会自动产生可连接的服务器信息。后续操作以用户已有自己的订阅或服务器信息为前提:先核对配置来源和有效状态,再完成导入、选择默认服务器与系统授权。本站不提供、不销售、不推荐节点、订阅或相关服务。应用价格与购买条件以 App Store 页面标注为准,连接所用配置的有效状态需要单独确认。

换机或重装后,要重新购买 Shadowrocket 吗?

先确认 App Store 中用于“媒体与购买项目”的账户是否与原购买账户一致,再进入账户的已购应用列表查找 Shadowrocket,并打开产品页核对是否显示重新下载入口。设备登录的 iCloud 账户与商店购买账户可能不同,不能只看设置顶部的账户名称。如果仍显示价格,先检查购买记录和当前商店地区,不要急于再次付款。跨设备购买适用性与家人共享资格以 App Store 页面标注为准;重新下载应用不等于恢复本地配置。

iPad 能安装吗?Mac 与 Apple TV 怎么确认?

Shadowrocket 以 iPhone 与 iPad 使用为主,iPad 同样从 App Store 产品页获取。先在商店兼容性栏确认设备和系统要求,再核对当前购买账户是否已有购买记录。Mac、Apple TV 与 Apple Vision 也应查看同一产品页的兼容性信息,系统要求及是否通用购买一律以 App Store 页面标注为准。不要把某一台设备上的可用状态直接套用到其他设备;连接配置与服务器允许的同时使用数量也需要分别核对。

Home / First Connection

安装与首次打开

将系统授权、服务器选择与实际连通分开检查,不把开关状态当作最终结果。

第一次打开时,添加 VPN 配置的提示是什么意思?

这是系统为建立网络连接配置而显示的授权提示。先确认正在操作的是已核对过的 Shadowrocket,并且已有可用的服务器配置,再按系统提示允许添加,必要时完成设备密码或生物识别确认。添加成功只表示系统允许建立连接,不代表服务器已经可用,也不代表所有流量都会采用同一策略;实际路径还受 Global Routing 与 Config 规则影响。授权后返回 Home,选定服务器,再用 Connectivity Test 验证。

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

先确认 Home 中已经有服务器,并点选一项作为默认服务器,观察左侧是否出现选中圆点。随后核对系统添加 VPN 配置的授权是否完成,以及设备是否存在其他正在工作的 VPN 连接。若是单位或学校管理的设备,还需检查管理策略是否限制 VPN。先停止其他连接再重试,并记录弹窗原文或 Log 中的错误。不要连续删除全部配置;只有确认系统配置异常且已备份后,再考虑重新添加授权配置。

界面显示英文,需要把手机语言改掉吗?

不必为了对照教程而立即更改整台设备的语言。本站按应用中的英文界面词说明操作,例如 Home、Add Server、Config 与 Settings,先按这些名称定位。若希望调整显示语言,可在系统设置中的 Shadowrocket 应用设置页查看是否提供语言选项;可选范围以当前应用和系统实际显示为准。改变语言不会补全服务器参数,也不会修复连接问题。遇到与手册不同的入口,先确认所在页面和操作对象,再对照设置手册。

怎样判断首次连接已经完成,而不只是开关打开?

按三个层次检查:Home 已选中默认服务器,系统连接状态已建立,Connectivity Test 对测试目标返回可用结果。随后再访问实际需要使用的页面或应用,确认目标也能正常工作。开关打开只说明连接过程已启动或隧道已建立,不能代替对目标的访问验证。测试时固定同一服务器、同一网络和同一 Global Routing 姿态,避免同时更改多个变量;若仅部分目标失败,优先转到规则和 DNS 排查,而不是重复添加系统授权。

持续连接会耗电吗?On Demand 应该怎么设置?

耗电受实际流量、无线网络质量、服务器重连频率、测试频率与日志记录等因素共同影响,不能仅凭连接图标判断。先在系统电池页面观察相近使用时长的变化,再减少反复测速和不必要的详细 Log。On Demand 用于按条件触发连接,不等于固定的省电开关;启用前先确认手动连接稳定,再逐项配置条件。如果出现手动断开后又自动连接的情况,先检查 On Demand 的启用状态和匹配条件。

Subscribe / Add Server / Config

订阅与节点导入

以下操作均以用户已有自己的订阅或服务器信息为前提。导入前区分内容用途,更新前保留可恢复的配置。

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

先确认复制的是服务商提供的订阅地址,而不是账户登录页或说明页面地址,并检查是否混入空格、换行或中文标点。接着核对当前网络能否访问该地址,以及服务状态是否有效。如果服务器返回登录页面、错误页面或空内容,即使地址可以打开也不能作为订阅解析。网络访问正常但仍无法识别时,再向原配置提供方确认输出格式与 Shadowrocket 的兼容性。反馈错误时遮盖完整链接中的凭据,不要公开原始订阅地址。

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

先核对 Type 是否与已有服务器信息中的协议一致,再逐项对照地址、端口和认证字段。Shadowsocks、VMess、VLESS、Trojan 等协议需要的字段并不相同,不能把一套参数原样填到另一种 Type。涉及 TLS 或传输设置时,还要检查服务端提供的相关名称与路径,保留原始大小写和字符。端口应使用提供方给出的数字,地址字段不要夹带多余路径。保存后先选中该服务器测试,不要仅以成功保存作为填写正确的依据。

Scan QR Code 扫描成功,却没有可用服务器怎么办?

识别二维码只说明读到了其中的内容,不一定代表内容是 Shadowrocket 支持的服务器信息。先确认二维码来自用户已有配置,且对应的是服务器或订阅内容,而不是账户网页。若扫描后进入参数页,检查 Type、地址与认证字段是否完整,再保存并回到 Home 查找新增项目。若仍无法识别,向原配置提供方核对二维码内容的格式。二维码可能包含认证信息,不要把原图发到公开讨论区;排查时只提供遮盖后的字段与错误提示。

已有订阅怎样更新?更新失败会影响什么?

在 Home 找到对应的 Subscribe 分组或订阅管理入口,使用该订阅的更新操作,再核对列表内容及默认服务器是否仍然有效。具体操作入口以当前应用显示为准;需要自动更新时,再查看相关订阅设置。更新失败后不要立即删除原分组,先记录错误,核对网络、链接有效状态与返回内容。已有条目是否保留取决于实际更新结果,列表中还看得到服务器也不代表它仍可连接。详细步骤可参阅订阅更新文章。

导入订阅与导入 Config 是同一件事吗?

不是。Subscribe 通常用于管理服务器条目的集合及其更新来源,Config 则用于组织规则等连接行为设置;导入其中一种,不应直接假定另一种也已经完成。先确认手中内容的用途,再选择对应入口。更换 Config 前应备份当前配置,并检查其中的策略引用是否与实际服务器或策略组相符。对于陌生配置,先阅读规则与 DNS 等内容,不要直接覆盖日常使用的配置。完成导入后,用同一测试目标验证,便于判断变化来自哪一部分。

Global Routing / Diagnostics

规则分流与故障排查

先检查基础网络,再检查服务器,最后对照规则与目标。记录测试条件比连续切换设置更有帮助。

Global Routing 的 Config、Proxy、Direct 怎么选?

配置姿态 Config 按当前选中的 Config 规则决定连接策略,适合已经核对规则的日常使用;代理姿态 Proxy 用于让连接采用代理路径,适合在排查时确认所选服务器是否可用;直连姿态 Direct 用于直接连接目标,适合对照当前网络的基础访问情况。三种姿态是不同的路由选择,不是由弱到强的等级。测试时保持目标和服务器不变,一次只切换一种姿态,并结合规则命中记录判断差异,避免只凭姿态名称推断访问结果。

显示已经连接,但页面仍打不开,应按什么顺序排查?

先停止连接,确认当前 Wi-Fi 或蜂窝网络本身能够正常访问常用目标;若网络需要网页登录,先完成认证。再返回 Shadowrocket,核对默认服务器和已有服务状态,运行 Connectivity Test。服务器测试通过后,对照 Global Routing:若 Proxy 可用而 Config 不可用,优先检查规则与策略引用;若域名访问失败而其他测试正常,再查看 DNS 相关记录。每次只改一个设置,并保存错误提示,避免同时更换服务器、规则和 DNS 后无法定位原因。

只有某个网站或应用失败,为什么不先换服务器?

部分目标失败时,服务器可能仍在正常工作,差异也可能来自规则匹配、DNS、目标自身状态或应用缓存。先记录失败目标的域名和出现时间,再查看它命中的规则及最终策略。DOMAIN-SUFFIX 用于域名后缀匹配,DOMAIN-KEYWORD 用于域名关键词匹配,规则顺序会影响结果;将具体匹配放在 FINAL 之前。确认当前启用的是刚修改的 Config 后再测试。不要为了单个目标直接替换整份配置,也不要把包含凭据的日志完整公开。

延迟测试有结果,为什么实际访问还是失败?

延迟结果只描述当前测试方法与测试目标下的响应情况,不等于所有网站、协议和应用都能正常使用。先在 Settings 中核对 Ping 相关测试方式与目标,再使用 Connectivity Test 和实际访问交叉验证。比较结果时保持同一网络、同一测试方式与相近时间,不要把不同方法得到的数值直接排序判断。若测试可响应但实际请求失败,应继续检查认证参数、规则策略、DNS 与目标状态;反复测速通常不能修复这些问题。

Log 应该怎样使用?反馈问题前要遮盖哪些内容?

先明确需要复现的一个问题,再按需启用 Log,执行一次对应操作,并记录当时的网络、Global Routing 姿态与测试目标。优先保留错误类型、规则命中和时间顺序,完成后恢复合适的记录级别,避免长期积累不必要的详细数据。反馈前遮盖订阅地址、认证字段、服务器凭据,以及可能识别个人访问行为的域名或请求内容。不要只发一张连接图标截图,也不要直接公开整份配置;最小必要信息更便于定位问题。