官方手册 · 问题索引
Shadowrocket 疑难解答
按获取、安装、导入、连接的顺序检查。先确认问题发生在哪一步，再展开对应答案；涉及订阅时，以用户已有自己的订阅或服务器信息为前提。
获取方式 / 商店 / 购买记录
正版与购买
先辨认设备的获取方式，再核对商店信息与自己的购买记录。
电脑和安卓能用 Shadowrocket 吗？各平台怎样收费？
能。Shadowrocket 提供 iPhone、iPad、Mac、Windows、安卓与 Linux 版本，采用 2 档获取：iPhone / iPad 版 App Store $2.99 一次性付费，Mac / Windows / 安卓 / Linux 版免费。电脑与安卓请从本站下载页选择设备对应的安装包，文件经本站 /dl/shadowrocket/ 路径提供。首次打开如遇系统风险提示，先核对文件来源，再按下方安装分类中的对应步骤操作，不要把系统提示直接当作安装成功或失败的结论。
App Store 搜不到 Shadowrocket，先检查哪里？
先核对用于 App Store 的 Apple 账号所在商店，而不是只看设备语言、所在地或系统地区。中国大陆商店目前没有此应用；可在 Settings 中进入 Apple 账号的 Media & Purchases，选择 View Account，再查看 Country/Region。需要变更时，按 Apple 的账号设置流程处理余额、现有订阅及付款资料，并确认符合该地区要求。产品页不能显示也可能与商店可见性有关，反复更换搜索关键词通常不能解决账号地区问题。
怎样核对 App Store 中的正版 Shadowrocket？
同时检查应用名称 Shadowrocket、开发者 Shadow Launch Technology Limited、官方图标及产品页地址中的应用 ID 932747118，不要仅凭“小火箭”别称或相似图案判断。iPhone / iPad 版 App Store $2.99 一次性付费，Mac / Windows / 安卓 / Linux 版免费；其他平台的免费获取方式不适用于判断 App Store 同名条目。遇到名称相近的结果，应回到本站下载页核对产品页，付款前再次确认开发者与应用 ID。
换 iPhone、重装或改用 iPad，需要重新购买吗？
iPhone 与 iPad 可使用同一购买记录。在新设备的 App Store 登录当初购买所用的 Apple 账号，从 Apps 或 Purchased 对应的已购列表查找 Shadowrocket 并重新下载；具体入口名称随系统版本变化。若显示购买按钮，先核对账号、商店地区及购买记录，不要立即重复付款。iPhone / iPad 版 App Store $2.99 一次性付费，Mac / Windows / 安卓 / Linux 版免费。应用下载恢复与本地配置恢复是两件事，已有配置仍需提前备份。
客户端购买包含线路吗？家人共享怎样确认？
客户端一次性买断 ≠ 线路套餐。iPhone / iPad 版 App Store $2.99 一次性付费，Mac / Windows / 安卓 / Linux 版免费；这些价格描述的是客户端获取方式，不包含网络线路。使用前应已有自己的订阅或服务器信息，本站不提供、不销售、不推荐节点或订阅。家人共享是否可用，应查看当前 App Store 产品页的 Family Sharing 标注，并检查家庭组的购买共享设置、账号地区与成员资格；不要把同一账号的已购恢复等同于家人共享。
平台选择 / 系统提示 / VPN 授权
安装与首次打开
系统放行操作以来源确认作为前提。受管理设备的限制应由设备管理员处理。
Mac 应该选 Apple 芯片版还是 Intel 版？
打开 Apple 菜单中的“关于本机”：显示 Chip 及 Apple 芯片名称时选 Apple 芯片版，显示 Processor 且为 Intel 时选 Intel 版。不要仅按电脑购买年份或外观判断。前往本站下载页获取对应 dmg，将 Shadowrocket 放入 Applications 后再打开。若系统提示无法验证开发者，先确认文件来自本站 /dl/，再进入 System Settings 的 Privacy & Security，查看此次被拦截的应用并按提示选择 Open Anyway；两种芯片版本不应凭试装来区分。
Windows SmartScreen 提示有风险，怎样处理？
先确认安装文件来自本站下载页，并且下载地址属于本站 /dl/shadowrocket/。这些安装包没有代码签名，首次运行可能出现 SmartScreen 提示。确认来源后，在提示中选择“更多信息”，检查显示的文件，再选择“仍要运行”。若设备由单位或学校管理，按钮可能被策略限制，应联系设备管理员，不要修改组织策略或关闭整套系统防护。若文件来源无法确认、名称异常或下载未完成，应停止运行并从下载页重新获取。
Mac 提示无法验证开发者或应用已损坏，怎么办？
先将本站下载的 dmg 内应用复制到 Applications，再尝试打开。遇到无法验证开发者提示，可到 System Settings → Privacy & Security 查看被拦截记录，确认是 Shadowrocket 后选择 Open Anyway 并完成系统验证。若仍提示应用已损坏，先重新下载并核对芯片版本；仅在确认来源且应用位于指定目录时，在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app，再尝试打开。该命令清除指定应用的扩展属性，不应改写成针对整个磁盘的命令。
iPad、安卓与 Linux 首次安装分别要注意什么？
iPad 可以安装 Shadowrocket，系统要求以 App Store 页面标注为准，并使用自己的 Apple 账号获取。安卓从本站下载页下载 apk，系统询问时仅为当前用于打开文件的浏览器或文件管理器开启“允许安装未知应用”，完成后可关闭该授权。Linux 先按发行版选择 deb、rpm 或 AppImage；AppImage 需在文件属性中允许执行，或对实际文件运行 chmod +x 后打开。电脑和安卓若出现首次运行风险提示，应先核对本站下载来源，再按系统提示处理。
界面是英文、连接开关打不开或立即关闭，先做什么？
手册保留界面原文，Home 用于查看服务器与连接，Config 用于配置文件，Settings 用于设置。连接前先确认已有有效服务器并选中它；首次打开连接开关时，按系统提示允许添加 VPN 配置，并完成设备验证。若拒绝过授权，可再次尝试连接并检查系统 VPN 设置。开关立即关闭时，先断开其他正在运行的 VPN，检查设备管理限制，再重启应用重试。不要一开始就删除应用，以免尚未备份的服务器信息和配置丢失。
Subscribe / Add Server / Config
订阅与节点导入
先区分订阅地址、单个服务器参数和配置文件，再判断错误发生在下载内容还是建立连接的阶段。
已经有订阅链接，怎样导入到 Shadowrocket？
先从自己的服务商资料中复制完整订阅地址，注意不要带入空格、换行或聊天消息中的说明文字。在 Home 进入 Add Server，选择 Subscribe，将地址填入 URL 后保存；具体位置以当前应用界面为准。导入后应看到订阅分组及其服务器条目，再选择其中一项进行 Connectivity Test。若应用自动识别剪贴板，也应先核对地址再确认。订阅地址可能含访问凭据，不要将完整地址贴到公开截图、评论或排查记录中。
订阅导入失败、内容为空或提示格式错误，怎样区分？
先确认复制的是服务商提供的订阅地址，而不是账户登录页、公告页或普通网页链接。请求失败通常要检查当前网络、地址完整性与服务是否有效；返回内容为空时，核对服务状态及该订阅是否确实包含服务器。格式错误则应检查链接类型与当前版本的支持范围。一次只修改一项，再重试并记录错误文字。不要把订阅地址当作单个服务器地址填入，也不要把完整地址发给他人；必要时向自己的服务商核对其返回内容。
怎样更新 Subscribe？更新后为什么条目变了？
在 Home 找到对应订阅分组，使用该分组提供的更新操作，完成后查看条目是否变化及是否有错误提示。订阅由服务商维护，服务器名称、数量或参数可能随返回内容改变，更新并不表示原先选中的条目仍然有效。更新前可记录当前分组与选择，但不要在订阅生成的条目中长期保存手动修改，因为下一次更新可能覆盖它。更新失败时先检查网络与订阅状态，不要连续删除重建；重要的本地配置应先备份。
手动填写服务器或扫描二维码后，为什么仍不能连接？
导入成功只代表资料被写入，不代表参数正确或服务器可用。对照自己已有的服务器信息，逐项检查协议、地址、端口与认证字段；涉及 TLS 时继续核对 Server Name、传输方式和路径等服务端要求。WireGuard 的私钥、公钥与 Endpoint 也不能互相替代。扫描二维码后仍需检查识别出的协议与字段，不应凭名称相似就沿用其他服务器的设置。先做 Connectivity Test，再根据错误定位认证、解析或传输问题。
Subscribe 与 Config 有什么区别？配置怎样备份？
Subscribe 主要提供服务器条目及其连接参数；Config 承载规则、DNS 等请求处理设置。已有订阅不代表已经选好合适的规则配置，导入配置也不一定会自动补齐自己的服务器。修改前先在 Config 确认当前使用的文件，并通过应用提供的分享或导出功能保存副本；服务器资料与订阅地址也应分别记录。备份可能含认证信息，应存入自己控制的位置。换机后先恢复资料，再核对当前配置、服务器选择与 Global Routing，逐项验证。
Global Routing / DNS / On Demand
规则与故障排查
区分基础网络、服务器连通、域名解析与规则命中。显示已连接不代表每个请求都已完成。
Global Routing 的配置、代理、直连三种姿态怎么选？
Config（配置）按当前配置文件的规则决定请求策略，适合需要分流且已经检查规则的情况；Proxy（代理）将请求交给代理策略处理，适合临时确认代理路径是否可用；Direct（直连）让请求直接连接，不能代替服务器连通测试。日常需要规则分流时先选 Config，并确认启用的是预期文件。排查时可以在相同网络与相同目标下比较三种姿态的结果，但应记录原设置并在测试后恢复，不要把临时切换当作修好规则。
显示已连接但无法上网，应该按什么顺序排查？
先断开连接，确认当前 Wi-Fi 或蜂窝网络本身能正常访问原本可访问的网站。再连接 Shadowrocket，确认所选服务器属于当前有效的订阅，并运行 Connectivity Test。随后核对 Global Routing、当前 Config 与请求记录，观察目标域名实际采用的策略。若多种网络都失败，检查服务器状态与认证参数；若只在某个 Wi-Fi 失败，检查该网络的登录页及限制。每次只改一个变量，并记录现象，避免同时更换服务器、DNS 与规则后无法判断原因。
Connectivity Test 正常，但网页打不开，是 DNS 问题吗？
可能与 DNS 有关，但测试正常不等于网页所需的全部请求都正常。Connectivity Test 只反映相应测试条件下的连通结果，网页还依赖域名解析、TLS、规则选择及多个资源地址。先核对请求记录中的域名与命中策略，再查看 DNS 设置是否来自当前可用配置；只改动自己能说明用途的项目。可在相同服务器下比较不同网络，并用另一个原本可访问的网站作对照。不要同时堆叠多个陌生 DNS 地址，也不要仅凭一个测试结果判断所有目标都可访问。
规则不生效，DOMAIN-SUFFIX 与 FINAL 应该怎样检查？
先确认 Global Routing 为 Config，且当前启用的是刚修改的配置文件。规则通常从上到下匹配，命中后执行对应策略；较宽泛的规则放得过早，会使后面的具体规则没有机会命中。DOMAIN-SUFFIX 用于域名后缀匹配，不能直接填入带路径的完整网页地址；IP-CIDR 用于 IP 网段。FINAL 应位于末尾，为未命中前述条件的请求指定策略。结合请求记录核对实际命中项，再调整顺序，不要单凭网页是否打开判断某条规则已经执行。
连接后耗电增加或网络切换时反复连接，怎么检查？
先在系统电池统计中观察相同使用时段，区分大流量传输、信号较弱、频繁重连与持续记录日志的影响，不要只比较某一瞬间的电量。检查是否在 Wi-Fi 与蜂窝网络之间反复切换，以及 On Demand 条件是否与预期一致；需要临时对照时，先记录原设置，再关闭按需连接进行测试。诊断结束后停止不再需要的详细日志，并通过对应平台的更新方式保持客户端更新。若只有某个网络或服务器触发重连，优先排查该条件，而不是清空全部配置。