Shadowrocket · 官方手册
Shadowrocket 疑难解答
先确定问题发生在哪一步，再检查对应设置。购买与安装以 App Store 页面为依据；导入与连接以用户已有自己的订阅或服务器信息为前提。展开问题即可查看排查顺序。
App Store · 购买记录
正版核验与购买
先核对产品页，再核对自己的购买账户。价格、兼容性与购买适用性均以商店页面为准。
App Store 搜不到 Shadowrocket，先检查什么？
先从下载指南打开 Shadowrocket 的 App Store 产品页，再核对当前 App Store 登录账户的国家或地区。搜索不到不等于设备不兼容，也可能是当前店面未显示该应用。若产品页提示不可用，先阅读提示并检查账户地区；需要变更时，按 Apple 账户的国家或地区设置流程办理，并先处理余额、有效订阅及家庭组限制。是否可购买以当前店面页面为准。
如何确认打开的是 Shadowrocket 正版产品页？
同时核对应用名 Shadowrocket、开发者 Shadow Launch Technology Limited、官方图标和产品页地址中的 id932747118。应用 ID 为 932747118，图标应与本站使用的官方图标一致；不要只凭搜索结果中的名称判断。购买前再查看产品页的兼容性与价格栏。系统要求以 App Store 页面标注为准，获取与更新均通过 App Store 完成。
换机或重装后，是否需要再次购买？
先使用原购买账户登录 App Store，在账户页面的已购应用记录中查找 Shadowrocket。找到后按商店显示的重新获取按钮操作，通常不需要重复购买。若仍显示价格，先核对媒体与购买项目所用账户、原购买记录及当前店面，不要直接再次付款。重新获取应用与恢复配置是两件事；原设备上的服务器信息和配置需要另行保留，不能假定会随购买记录自动恢复。
一次性买断包含哪些内容？
一次性买断指购买 Shadowrocket 客户端的使用资格。客户端一次性买断 ≠ 线路套餐，购买应用不会自动获得服务器信息或订阅。美区定价为 2.99 美元，各店面按当地货币显示，实际价格以付款前的 App Store 页面为准。后续配置以用户已有自己的订阅或服务器信息为前提；本站不提供、不销售、不推荐节点或订阅，也不处理相关服务费用。
iPad、Mac 与 Apple TV 的购买适用性在哪里核对？
先查看同一 App Store 产品页的兼容性与购买说明。iPhone 和 iPad 是本手册的主要操作设备，Mac、Apple TV、Apple Vision 的设备支持、系统要求及购买适用性均以 App Store 页面标注为准。在另一台设备上获取时，应先用自己的原购买账户检查已购记录；家人共享是否适用也以商店页面和家庭设置为准，不要把某一设备的购买结果直接推定为所有设备都适用。
Home · Settings · VPN
安装与首次打开
安装、导入、系统授权是不同步骤。先确认应用正常打开，再检查连接条件。
iPhone 安装完成后，首次打开应先做什么？
先确认应用可以正常打开，再准备已有的订阅或服务器信息。按 Home 中的添加入口完成导入，检查选中的服务器和 Global Routing，再尝试开启连接。首次建立连接时，系统可能要求添加 VPN 配置；应在确认操作由 Shadowrocket 发起后授权。安装完成本身不代表网络已配置好，也不代表所有请求都会走代理。系统要求以 App Store 页面标注为准。
添加 VPN 配置的系统弹窗是什么意思？
这是系统对建立 VPN 配置的授权确认，不是购买提示。允许后，Shadowrocket 才能通过系统的网络扩展建立连接并执行所选路由设置。应先确认弹窗是在应用内开启连接时出现，再按系统要求验证。若此前拒绝授权，可回到应用重新尝试，并检查系统 Settings 中的 VPN 配置状态；受设备管理限制时，应由设备管理方确认允许的设置，不能靠反复点开关解决。
iPad 能安装吗，操作与 iPhone 有哪些区别？
可以先在 iPad 的 App Store 打开同一产品页，确认设备满足兼容性要求；系统要求以 App Store 页面标注为准。使用自己的原购买账户时，先从已购记录重新获取。iPad 的横屏布局和可见区域可能与 iPhone 不同，但仍按 Home、Config、Settings 等英文界面词定位操作。导入后要重新检查当前服务器和配置，不要仅因账户相同就认为连接设置已经完整迁移。
界面是英文，应该如何对照教程？
本手册保留英文界面词，便于直接定位。Home 用于查看服务器与连接状态，Config 用于管理配置文件，Settings 用于检查设置，Data 用于查看可用的流量统计。Global Routing 中的 Config、Proxy、Direct 分别对应配置、代理、直连三种姿态。看到 Add Server 或 Subscribe 时，按教程对应的导入步骤操作；不要把页面名称 Config 与 Global Routing 中的 Config 选项混为一谈。
连接开关打不开，或打开后立刻关闭怎么办？
先检查是否完成系统 VPN 授权，再确认已选择有效服务器。暂时关闭其他正在运行的 VPN 连接，检查系统是否有设备管理限制，然后重新尝试。若此前修改过配置，先记录当前设置，切回已知可用的配置进行对照。重启设备后仍失败，可查看应用日志中的配置或连接错误。不要首先删除应用；删除前应保存已有订阅地址、服务器信息与配置，避免排查过程中丢失数据。
Subscribe · Add Server · Scan QR Code
订阅与节点导入
导入成功与连接成功分别验证。以下步骤仅用于检查用户已有的订阅或服务器信息。
Subscribe 导入失败，应按什么顺序检查？
先确认使用的是自己已有的订阅地址，并检查复制时是否混入空格、换行或遗漏参数。再确认当前网络可以访问该地址，返回内容是客户端可识别的订阅数据，而不是登录页面、错误提示或普通网页。随后核对订阅是否失效，以及提供方是否变更了地址或格式。浏览器能打开链接只能说明有响应，不代表内容正确；排查时不要将完整订阅地址发送到公开页面。
Add Server 手动添加时，哪些字段最容易填错？
先选择与已有服务器信息一致的协议，再逐项核对地址、端口与认证字段。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 等协议所需字段不同，不能只改协议名称而沿用其他协议的参数。若服务器使用 TLS，还需按原资料检查 server name 等相关项目。地址栏通常填写主机名或 IP，不应把整个网页地址填进去；不要凭猜测更改加密方式、认证值或传输设置。
Scan QR Code 导入成功，为什么仍然连不上？
Scan QR Code 成功只说明二维码内容被识别并建立了条目，不代表服务器当前可用。导入后打开该条目，核对协议、地址、端口及认证信息，再选中它执行 Connectivity Test。若超时，分别检查当前网络、服务器状态和参数是否过期；若测试有响应但网页失败，再检查 Global Routing、DNS 与实际请求的路由结果。二维码本身可能含凭据，分享截图前应移除这些内容。
更新订阅后条目变了，怎样避免误删原设置？
更新前先记录当前选中条目与订阅分组，必要时保留本地配置副本。更新后检查条目数量变化、名称变化及当前服务器是否仍存在，再重新选中可用条目进行测试。订阅更新会按返回内容刷新所属条目，但不能假定手动修改一定会保留；重要的自定义设置应另行记录。Subscribe 的服务器列表与 Config 的规则配置分别检查，不要把更新订阅理解为所有规则也已同步更新。
如何判断订阅失效，提交排查信息时要隐藏什么？
先记录失败发生在获取订阅、解析内容还是连接服务器阶段，再查看应用提示。地址返回认证错误、空内容或格式错误时，应向原信息提供方核对订阅有效性与格式，不能单凭某个服务器超时认定整个订阅失效。提交排查信息时仅保留必要的错误文字、协议和操作步骤，隐藏完整订阅地址、认证参数、密码及二维码。需要对照资料时，使用脱敏后的内容，不要公开可直接使用的凭据。
Global Routing · Connectivity Test · DNS
规则分流与故障排查
系统连接、服务器响应、域名解析、规则命中分别检查。用同一目标做对照，才能判断改动是否有效。
Global Routing 的 Config、Proxy、Direct 应怎样选？
配置姿态 Config 按当前配置中的规则分配请求，适合已确认规则内容的日常使用；代理姿态 Proxy 将进入客户端路由处理的请求按代理模式处理，可用于对照规则是否影响访问；直连姿态 Direct 使用直连路径，可用于检查原始网络。选择 Config 前先在 Config 页面确认启用的文件。三种姿态决定路由方式，不修复错误的服务器参数；排查结束后应恢复自己的正常配置。
显示已连接，但网页无法打开，先检查哪一项？
已连接只表示系统连接已建立，不保证服务器、DNS 与规则都可用。先确认当前网络本身能访问正常页面，再测试当前服务器；然后用同一目标页面对照 Proxy 与 Config。仅 Config 失败时，检查规则命中的策略和所选配置；两者都失败时，继续核对服务器参数、DNS 与日志。每次只改变一项设置并记录结果，避免同时改动多处后无法判断原因。测试结束恢复原路由姿态。
Connectivity Test 正常，为什么实际访问仍失败？
Connectivity Test 的结果取决于测试方式与目标，只能说明该次测试得到响应，不能代表所有域名、协议和请求都能通过。应先确认实际访问时使用的是同一服务器，再查看请求是否被规则分配到 DIRECT、PROXY 或 REJECT。若只有某个域名失败，检查 DNS 解析、目标站点状态及相关规则；若所有页面失败，优先检查实际代理连接与认证参数。不要把一个延迟读数当作全部网络正常的证明。
DNS 解析失败或域名打不开，如何定位？
先查看日志是否出现解析错误，并记录当前配置使用的 DNS 设置。检查解析服务是否能通过当前网络或路由到达，再对照近期是否修改过 DNS、Host 或相关规则。一次只恢复一个已知可用的设置，重新建立连接后测试同一域名；不要连续填入多个陌生解析地址。直接访问 IP 只能作为有限对照，因为网站可能依赖域名与 TLS，IP 能响应也不能说明完整网页访问正常。
规则似乎没有生效，应该看配置文件还是服务器？
先确认 Global Routing 为 Config，再到 Config 检查当前启用的文件。规则通常按顺序匹配，先命中的规则决定策略；DOMAIN-SUFFIX、GEOIP 等条件与 FINAL 兜底规则的位置都会影响结果。随后查看日志中的实际请求与策略，确认规则指定的代理策略有可用服务器。只切换服务器不会自动修正规则顺序。用于说明语法的 example.com 是示例域名，不应被当作适用于所有网站的通用规则。
耗电增加、速度变慢或更新后异常，应怎样排查？
先用相同网络、相同服务器与相同访问目标对照，排除后台下载和信号变化。查看是否开启频繁测试、详细日志或 On Demand，按需要调整并观察；不要仅凭系统电池页的单次占比判定原因。更新后先重新建立连接，检查当前配置和授权状态，再逐项恢复近期改动。持续异常时保留脱敏日志与复现步骤，转到疑难手册继续检查；重装前保存配置，避免把数据丢失变成新的问题。