官方手册 · 分类排查

Shadowrocket 疑难解答

先定位购买、导入还是连接问题,再按顺序核对。以下操作以用户已有自己的订阅或服务器信息为前提;每次只改变一个设置,保留可用于对照的原始值。

  • 4 类问题
  • 20 项核对说明
  • 点击问题展开答案

PURCHASE

正版核对与购买

先核对产品与购买账户,再处理搜索、付款和已购恢复问题。购买入口与配置来源是两件不同的事。

App Store 搜不到 Shadowrocket,先核对什么?

先从正版获取说明进入指定 App Store 产品页,用应用 ID 932747118 核对目标。搜索不到时,检查当前用于媒体与购买项目的 Apple 账户所属商店地区,再查看屏幕使用时间中的内容与隐私限制是否限制了应用年龄分级。若产品页能打开但无法购买,继续核对付款方式与账户提示;搜索结果本身不能用来判断是否已购买。

如何确认商店里的应用是 Shadowrocket 正版?

在 App Store 产品页同时核对三项:应用名称 Shadowrocket、开发者 Shadow Launch Technology Limited、地址中的应用 ID 932747118,并确认图标与本站展示的官方图标一致。不要只凭中文别称或搜索排序判断。购买金额、兼容性与更新记录以该产品页为准;完成核对后,再在 App Store 内执行购买与安装。

Shadowrocket 一次性买断包含连接服务吗?

客户端一次性买断 ≠ 线路套餐。App Store 收取的是 Shadowrocket 应用的购买费用,应用使用以用户已有自己的订阅或服务器信息为前提。美区定价约 2.99 美元,各店面按当地货币显示,实际金额以购买页面为准。本站是官网与官方手册,只说明客户端操作,不提供、不销售、不推荐节点或订阅。

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

先确认 App Store 当前用于媒体与购买项目的 Apple 账户,与当初购买 Shadowrocket 的账户一致,再到已购项目或应用列表查找并重新下载。若仍显示价格,先核对购买记录、商店地区及账户状态,不要急于重复付款。恢复应用购买不等于恢复应用内配置;旧设备上的订阅、Config 与手动条目应另外备份并核对恢复结果。

商店地区不匹配,应从哪里检查和调整?

先在系统 Settings 的 Apple 账户中进入媒体与购买项目,查看账户的国家或地区,而不是仅修改设备语言或地区格式。确需调整时,通过账户页面的国家或地区入口,按 Apple 的提示检查余额、现有订阅及付款资料等条件。变更可能影响已购内容与付款方式;应先阅读系统提示,产品可用性仍以对应 App Store 页面为准。

FIRST OPEN

安装与首次打开

先确认设备兼容性与系统授权,再检查应用内条目。出现系统提示时,先读完提示再操作。

iPad 可以安装 Shadowrocket 吗?

可以,先在 iPad 的 App Store 打开同一 Shadowrocket 产品页,查看兼容性栏;系统要求以 App Store 页面标注为准。已购买的用户应先使用原购买账户核对已购项目。iPad 上的布局会随屏幕尺寸和方向变化,但订阅、服务器参数与 Config 仍需单独核对;不要把同一账户购买应用理解为配置会自动完整同步。

首次打开时,为什么会要求添加 VPN 配置?

Shadowrocket 建立连接时需要系统允许添加 VPN 配置,系统可能要求设备密码或身份验证。先确认操作由刚安装的 Shadowrocket 发起,再按系统提示处理。该授权只是允许应用建立对应网络连接,并不表示服务器信息已经有效。授权后回到 Home,检查已选条目与 Global Routing,再打开连接开关并验证实际访问。

Home 的连接开关打不开,或刚打开就关闭,怎么办?

先确认已有可用的服务器条目且已选中,再检查首次 VPN 配置授权是否完成。随后到系统 Settings 的 VPN 管理位置查看是否存在配置冲突,并暂时停止其他正在建立的 VPN 连接后重试。若仍立即断开,查看应用内错误提示,记录发生时间与当前网络;不要反复删除配置,先保留已有参数,以便区分授权、配置与服务器问题。

界面是英文,应该怎样对照使用说明?

本手册保留应用界面词英文原文,可按 Home、Config、Settings 与 Global Routing 对照查找,不必先更改语言才能操作。若希望调整显示语言,可在系统 Settings 中查看 Shadowrocket 是否提供首选语言选项,实际可选项以设备和应用显示为准。协议名称及规则关键字本身仍保持英文,不应将中文解释填入服务器类型或规则字段。

更新应用前,需要保存哪些内容?

应用更新通过 App Store 完成。更新前,建议保存用户已有的订阅来源、手动服务器参数与正在使用的 Config,并妥善保管其中的密码或令牌。更新后先核对当前条目、Global Routing 和连接开关,再测试常用访问。App Store 的更新说明用于核对应用变化;重新安装不应作为日常排查的第一步,以免丢失尚未备份的本地设置。

查看 iPad 获取与已购说明

IMPORT

订阅与节点导入

把获取内容、解析条目与建立连接分开检查。导入成功只是第一步,还需要核对参数并验证实际访问。

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

先核对用户已有的订阅链接是否复制完整,尤其是问号后的参数,去掉首尾空格、换行或聊天软件附加的标点。确认加入的是订阅入口,而不是账户管理网页。再检查当前基础网络能否正常访问,并核对来源侧订阅是否仍有效。报错可能来自请求失败或内容解析失败;保留错误文字即可,不要公开包含令牌的完整链接。

订阅添加成功,但列表里没有服务器条目,怎么办?

添加订阅入口并不代表已成功取得有效条目。先对该订阅执行一次手动更新,观察是否出现网络或解析错误,再确认来源实际返回的是客户端支持的订阅内容,而不是登录页、过期提示或空内容。检查账户有效状态与链接格式时,仅核对用户已有资料。不要通过重复添加相同链接排查,否则容易留下多个无法区分的订阅分组。

如何更新已有订阅,并保留可用的本地修改?

在 Home 找到对应订阅,使用该条目的更新操作,完成后核对服务器列表与当前选择;具体菜单位置以应用显示为准。更新可能替换由订阅维护的条目,因此应先记录自行调整过的参数,并把需要长期保留的手动条目单独管理。自动更新是否执行取决于应用设置与系统运行条件,排查时应以一次手动更新的结果为准。

Scan QR Code 扫码失败,或识别后无法连接,怎么办?

先检查系统相机权限、二维码是否完整清晰,以及扫码内容是否为受支持的服务器分享信息。识别出内容后,仍要核对协议类型、服务器地址、端口和认证字段;扫码成功只表示读取到了内容,不代表连接已经验证。使用用户已有资料逐项比对,不要将二维码、密码或令牌发到公开页面;也不要把订阅二维码误当成单个服务器条目。

使用 Add Server 手动添加时,哪些参数必须一致?

在 Add Server 中先选择与已有服务器信息一致的协议类型,再填写地址、端口及该协议要求的密码或其他认证字段。若资料包含 TLS、Server Name、传输方式或路径,也要逐项对应,不能只复制地址和端口。Shadowsocks、VLESS、Trojan 等协议的字段含义不同;参数不明确时应核对原始资料,不要靠切换协议类型或关闭证书验证来试错。

按使用说明完成导入与验证

ROUTING & DIAGNOSTICS

规则分流与故障排查

连接状态、规则命中和实际访问结果需要分别核对。先记录当前配置,再用相同目标和网络条件复测。

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

配置(Config)按当前配置中的规则决定连接策略,适合已经核对过规则与兜底策略的情况;代理(Proxy)主要用于按代理姿态验证所选服务器;直连(Direct)用于按直连姿态核对基础网络。切换姿态不会修复错误的服务器参数。排查时先记录原姿态,再一次只改一项,测试后恢复,避免把姿态变化误认为规则或服务器已经修好。

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

先停止连接,确认基础网络可正常访问,再恢复连接并核对当前服务器与 Global Routing。接着查看连接记录,判断请求是按 DIRECT、PROXY 还是 REJECT 处理,并检查是否只有某个域名失败。Connectivity Test 可用于辅助检查条目,但测试结果不等于所有网页都能正常打开。最后结合错误信息检查认证、DNS 和规则,每次只调整一项。

怀疑 DNS 设置导致域名打不开,应该检查哪里?

先区分域名解析失败与连接建立失败:查看对应请求的记录和错误提示,再核对当前 Config 中的 DNS 配置及相关覆盖设置。若最近刚修改解析方式,记录原值后逐项恢复测试,避免同时改服务器和 DNS。不同网络的解析可达性可能不同,应在当前网络下验证;单凭某个 IP 地址能访问,不能断定带有 TLS 的域名访问必然正常。

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

先确认 Global Routing 为 Config,且当前启用的是刚编辑的配置。再从连接记录核对实际请求域名、命中的规则与最终策略,按配置顺序检查前面的规则是否已先匹配。DOMAIN-SUFFIX 匹配域名后缀,IP-CIDR 匹配地址段,FINAL 用于此前规则未匹配时兜底。修改 REJECT 规则前先确认目标范围,避免把同一域名上的必要请求一并拒绝。

持续连接时耗电增加,如何检查 On Demand 与后台活动?

先在系统电池用量中观察同一时段的使用情况,再核对是否存在大量后台传输、频繁重连或持续测试。On Demand 用于按条件触发连接,应检查条件是否让连接反复建立,而不是把它当成省电开关。耗电受网络信号、流量、协议与服务器响应等多项因素影响,不能仅凭协议名称判断;保留相近使用条件,逐项调整并比较结果。

查看协议参数与选型技术参考