官方手册 · 按问题现象核对
Shadowrocket 常见问题
购买、导入与连接排查
先确认问题发生在哪一步，再修改对应设置。购买问题看商店账户，导入问题看内容与格式，连接问题则从设备网络、服务器、规则到 DNS 依次核对。
- 4 类问题
- 20 项核对说明
- 点开问题查看步骤
首次使用可先阅读 使用说明；需要购买或恢复应用，请查看 App Store 正版核对。
官方手册 · 按问题现象核对
先确认问题发生在哪一步，再修改对应设置。购买问题看商店账户，导入问题看内容与格式，连接问题则从设备网络、服务器、规则到 DNS 依次核对。
首次使用可先阅读 使用说明；需要购买或恢复应用，请查看 App Store 正版核对。
先核对用于 App Store 购买的 Apple 账户所属商店，而不是只看设备语言或当前所在位置。在系统设置中进入 Apple 账户、媒体与购买项目、查看账户、国家或地区，确认当前店面，再打开 Shadowrocket 产品页查看可见性。如需更改地区，使用该处的官方更改入口，并先阅读页面对余额、现有订阅和付款方式的要求。更改设备地区不能替代商店账户地区变更，也不能保证应用可见。
同时核对应用名称、官方图标与开发者信息：产品名为 Shadowrocket，开发者为 Shadow Launch Technology Limited，产品页地址包含 id932747118。图标应与本站页头使用的 App Store 官方图标一致。不要仅凭搜索结果排序、相似名称或图标颜色判断。进入产品详情后再检查兼容性、价格和购买账户；系统要求与购买适用范围以 App Store 页面标注为准。本站获取说明页集中列出了这些核对位置。
Shadowrocket 是 App Store 付费客户端，采用一次性买断方式；美区定价为 $2.99，实际价格与购买条件以当前商店页面为准，其他店面按当地货币显示。客户端一次性买断 ≠ 线路套餐，购买应用不等于获得服务器或连接服务。使用前仍需准备用户已有的订阅或服务器信息。本站不提供、不销售、不推荐节点或订阅；已有服务的有效期和可用状态应在其原有管理渠道核对。
先使用原来购买应用的 Apple 账户，在 App Store 的账户页面查看已购项目或应用列表，再查找 Shadowrocket 并尝试重新下载。若显示价格，先确认媒体与购买项目使用的账户是否正确，并核对购买记录，不要立即重复付款。商店地区、应用可见性及当前购买适用范围可能影响恢复，以 App Store 页面标注为准。恢复应用与恢复个人配置是两件事，已有服务器、订阅和配置应另行妥善保存。
Shadowrocket 可在 iPhone 和 iPad 上使用，系统要求与设备兼容性以 App Store 页面标注为准。在 iPad 上先确认媒体与购买项目登录的是原购买账户，再从已购项目查找应用。家人共享应查看产品页是否标注支持，以及家庭组当前的购买共享设置，不要据此推定所有账户都能直接恢复。Mac、Apple TV、Apple Vision 也应在同一产品页核对兼容性与购买适用范围，获取入口均为 App Store。
从已有服务器、系统授权和当前配置开始核对。英文项目名按应用界面保留，不用猜测名称对应关系。
先准备并导入用户已有的订阅或服务器信息，确认 Home 中有可选服务器，再检查 Global Routing 与当前 Config，最后打开连接开关。仅安装客户端并不会自动产生可用连接。首次测试建议使用一份已知有效的配置，不要同时调整 DNS、规则和多个高级选项。若导入后列表仍为空，应先处理导入问题；若列表存在但不能连接，再检查服务器参数和系统授权，避免把两类问题混在一起。
首次启用连接时，系统可能要求允许添加 VPN 配置，这是建立系统网络连接所需的授权步骤。先确认弹窗是在刚刚操作 Shadowrocket 开关后出现，再按系统提示确认并完成设备身份验证。若之前取消，可以返回应用重新尝试连接。系统 VPN 配置与订阅、规则文件不是同一项内容，授权成功也不代表服务器一定可用。遇到单位或学校管理的设备，应先核对管理策略是否限制添加 VPN 配置。
先检查是否已选择服务器、当前配置是否能正常载入，再确认系统授权有没有被取消。打开系统设置中的 VPN 管理页面，观察 Shadowrocket 配置是否存在，同时停止其他正在占用 VPN 连接的任务后重试。如果仍立即断开，查看应用可用的连接记录，区分参数错误、配置读取失败与系统限制。不要反复删除全部数据；先保存当前设置与错误提示，再通过 App Store 检查应用更新，必要时重启设备后复测。
本手册保留界面英文原文，便于逐项对应。Home 主要用于查看服务器列表与连接状态，Add Server 用于添加服务器信息，Config 用于管理配置，Settings 用于检查相关设置。Global Routing 是选择流量处理方式的入口，不是服务器协议选择。设备语言与应用可用语言的关系，以当前应用和系统显示为准。查教程时先按页面名称定位，再找具体项目，不要把名称相近的系统 VPN 设置与应用内 Config 当作同一个入口。
先在系统电池页面观察耗电时段与使用情况，区分持续传输、反复重连、频繁测速以及其他应用的后台活动，不要只凭电量下降就归因于某个协议。测试时减少重复 Connectivity Test，检查 On Demand 是否导致频繁触发连接，并核对网络切换时是否反复断开。调整一项后在相近条件下观察，再决定是否保留。不要为了省电随意删除必要规则或改动安全参数；持续异常时保存记录并检查配置与连接状态。
以下说明以用户已有自己的订阅或服务器信息为前提。先辨认内容类型，再导入、更新和整理。
订阅通常用于一次导入并维护一组服务器信息，单个服务器则需要核对地址、端口和协议等参数。先确认手中内容是订阅地址、单个服务器分享内容还是完整配置，再使用应用对应的导入入口；不要把订阅地址填入服务器地址字段。可从 Add Server 查看适用的类型与字段，按原始资料填写并保存。导入完成后回到 Home 检查实际条目是否出现。以下操作均以用户已有自己的订阅或服务器信息为前提。
先检查地址是否复制完整，是否混入空格、换行或聊天软件附带的标点，再核对该地址的有效状态与访问条件。导入返回网页、登录提示或空内容时，不代表已取得可识别的订阅数据。随后确认当前网络能否访问该地址，以及内容格式是否适用于所选导入方式。每次只更正一个因素再重试；仍失败时记录错误文字，向原有信息提供方核对格式与状态，反馈时不要公开完整订阅地址或其中的凭据。
协议类型必须与已有服务器资料一致，不能仅为测试随意切换。VMess、VLESS 需按资料核对地址、端口、UUID、传输方式与 TLS 相关字段；WireGuard 则应核对密钥、地址和对端参数。其他协议也应逐项对应其实际字段，不要套用另一种协议的填写方法。某些字段留空有特定含义，不能把未知值当作默认值。保存后若认证失败，先检查复制完整性和参数对应关系，再检查网络，而不是连续修改多组设置。
在 Home 中找到对应订阅组，使用该组可用的更新操作，并观察结果提示；具体操作位置以当前应用界面为准。更新会重新读取原订阅内容，因此名称、数量和参数可能随原内容改变。更新前记下正在使用的条目，完成后重新确认所选服务器仍存在。若失败，不要立即删除仍可用的旧组，先检查地址有效性与网络。客户端订阅更新、Config 更新和 App Store 应用更新各有不同作用，不能互相替代。
先按原有订阅来源分组核对，确认是同一地址被重复导入，还是不同订阅本身包含同名服务器。名称相同不代表参数相同，不宜只按名称批量删除。对确认重复的订阅组，先保留当前连接所用的一组，再移除多余组并复查列表。手动改动订阅生成的服务器参数，后续更新时可能被原内容替换，因此应把长期需要的独立配置与订阅维护范围区分开。分享排查截图时隐藏地址、凭据和完整订阅链接。
日常按规则分流时使用配置姿态 Config，由当前配置的规则决定流量去向；代理姿态 Proxy 主要用于让流量通过所选代理处理；直连姿态 Direct 用于直接连接。三种姿态对应不同处理方式，不是速度等级。排查时可以暂时切换姿态作对照，但应同时记下当前服务器与配置，避免改变多个变量。若 Proxy 可用而 Config 不可用，优先检查规则和策略；测试结束后恢复原先所需姿态，具体流量处理仍应结合当前设置核对。
先断开连接，确认设备本身的网络能访问已知正常的页面，再重新连接并核对选中的服务器。接着用同一目标分别检查当前姿态、规则命中与 DNS 解析结果，观察是否只有部分域名失败。Connectivity Test 有结果只说明对应测试过程取得响应，不能证明所有网页均可访问。若更换网络后恢复，检查原网络条件；若只有 Config 失败，检查规则与策略。每轮保留相同目标并只改一项，记录错误提示后再继续。
服务器测试与网页域名解析并非同一过程，因此前者正常不能排除 DNS 故障。先核对当前 Config 和 Settings 中实际生效的 DNS 相关设置，再查看失败域名是否有解析错误、结果异常或请求未完成。不要连续叠加多个陌生 DNS 地址，也不要直接照抄与当前配置不匹配的片段。先记录原值，按配置说明恢复到一组明确的设置，再复测同一域名。若解析已完成而连接仍失败，应继续检查规则、服务器与目标服务本身。
先确认 Global Routing 为 Config，并确认正在使用的是预期配置，再查看异常域名实际命中了哪条规则。DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD 等规则应结合排列顺序核对，前面已命中的规则可能使后面的规则不再参与处理。FINAL 用于前面规则均未命中时的最终策略，不能修正已经被更早规则选中的流量。修改前保存原配置，只调整相关条目后复测同一目标；也要检查规则引用的策略是否仍指向可用服务器。
先记录 On Demand 当前条件，再暂时停用自动触发，回到 Home 手动连接一次，确认服务器与基础配置是否正常。随后逐项核对网络条件、规则匹配及网络切换时的表现，避免把自动触发与服务器断开混为一谈。如果手动连接稳定，恢复 On Demand 时一次只启用一项所需条件，并观察触发是否符合预期。自动连接条件不等于分流规则，前者决定何时建立连接，后者决定连接后的流量如何处理，两处需要分别检查。