官方手册 / 问题索引
Shadowrocket 常见问题
按获取、安装、导入、连接的顺序查找答案。先确认问题发生在哪一步，再只调整对应设置，避免同时更改服务器、模式和规则。
已有完整报错时，先保留原文；分享截图前遮住订阅地址与认证信息。
正版核对与价格
先核对平台与购买账户，再区分应用获取、配置恢复和服务器连接。
Shadowrocket 各平台多少钱，电脑和安卓能用吗？
在 App Store 怎样核对正版条目？
打开 Shadowrocket 产品页，核对开发者 Shadow Launch Technology Limited、官方图标和应用 ID 932747118 三项。图标应与本站页头的官方图标一致，产品页地址中的数字也应一致，不要仅凭搜索结果里的名称判断。iPhone / iPad 版为 $2.99 一次性付费，Mac、Windows、安卓、Linux 版免费；商店内标价免费的同名条目不能视为该付费条目。
App Store 搜不到 Shadowrocket 怎么办？
先核对用于“媒体与购买项目”的 Apple 账户地区，而不是只看设备的语言与地区。中国大陆 App Store 未提供此应用，可先打开本站给出的产品页核对可用性。如确需变更地区，在系统 Settings 中进入 Apple 账户 → 媒体与购买项目 → 查看账户 → 国家或地区，按 Apple 提示检查余额、现有订阅和付款条件，不要反复修改设备地区代替账户地区。
换 iPhone 或改用 iPad，需要再购买吗？
使用曾购买该应用的 Apple 账户登录“媒体与购买项目”，在 App Store 的已购应用列表中查找并重新下载；同一购买账户可在兼容的 iPhone 与 iPad 上恢复获取。iPhone / iPad 版 $2.99 一次性付费，Mac、Windows、安卓、Linux 版免费。若仍显示购买金额，先核对购买记录与当前账户，不要直接重复付款；恢复应用不会自动恢复未备份的本地配置。
获取客户端后，是否就能直接建立代理连接？
客户端一次性买断 ≠ 线路套餐。Shadowrocket 负责读取配置、匹配规则并连接用户已有的服务器；客户端买断 ≠ 线路套餐，安装完成不等于已经具有可用的服务器信息。请先准备自己已有的订阅或服务器参数，再进行导入和连接。本站不提供、不销售、不推荐节点或订阅；本手册只说明已有信息的录入、配置与排查方法。
应用与服务器列表分别怎样更新？
应用更新和订阅更新是两件事。iPhone / iPad 在 App Store 的应用更新列表中检查 Shadowrocket；Mac、Windows、安卓、Linux 从本站下载页获取新版安装包。订阅更新则是在客户端内重新读取你已有的订阅内容，不会升级应用本身。更新应用前先备份本地配置；更新订阅前记录当前所选服务器，完成后确认该条目是否仍存在、是否仍被选中。
各平台安装与首次打开
先核对安装包来源，再处理系统提示。受管理设备应遵循组织的安装策略。
Mac 应选 Apple 芯片版还是 Intel 版？
在 Apple 菜单中打开“关于本机”：若显示“芯片”及 Apple 芯片名称，选择 Apple 芯片版；若显示 Intel 处理器，选择 Intel 版。两种安装包都在本站下载页的 Mac 分区，不能仅凭电脑外观或购买年份判断。安装后若系统阻止打开，先确认文件来自本站，再到系统设置 → 隐私与安全性，查看针对该应用的提示并选择“仍要打开”。
Windows 出现 SmartScreen 风险提示怎么处理？
先确认安装包来自本站下载页，并核对正在运行的是刚下载的 Shadowrocket 安装程序。SmartScreen 显示“Windows 已保护你的电脑”时，点击“更多信息”，核对程序后选择“仍要运行”；若出现用户账户控制提示，再按安装需要确认。不要为了安装而长期关闭系统防护。单位管理的设备可能禁止手动放行，此时应交由设备管理员处理。
Mac 提示无法验证开发者或应用已损坏怎么办？
确认安装包来自本站，并已将应用移到 Applications。“无法验证开发者”可在系统设置 → 隐私与安全性中选择“仍要打开”。若提示“已损坏”，先重新下载并替换；确认来源后，可在 Terminal 执行 xattr -cr /Applications/Shadowrocket.app 再尝试打开。命令只针对该应用路径，不要扩大到整个磁盘；受管理设备应遵循管理员的安全策略。
安卓版下载后不能安装，微信内点下载也没反应？
在微信内无法下载时，用系统浏览器打开本站下载页，获取安卓版安装包。系统阻止安装时，进入设置中的“允许安装未知应用”，仅为本次使用的浏览器或文件管理器授权，完成后可关闭该权限。本站提供 arm64 安装包；若提示不兼容，应核对设备架构和系统提示。安装失败也可能由文件未下载完整或存储空间不足导致，不要连续重复点击安装。
Linux 应选择 deb、rpm 还是 AppImage？
先按发行版选择：Debian、Ubuntu 系通常使用 deb，Fedora 等通常使用 rpm；需要直接运行时可查看 AppImage。安装包均从本站下载页获取。deb 可用 sudo apt install 加上下载文件的本地路径，rpm 可用 sudo dnf install 加上本地路径。AppImage 首次运行前用 chmod +x 加上文件路径赋予执行权限；遇到系统拦截时按本机策略确认放行，不要以 root 身份直接运行图形客户端。
iPad 能安装吗，首次打开要允许哪些权限？
可以在兼容的 iPad 上安装，系统要求以 App Store 页面标注为准。iPhone / iPad 版 App Store $2.99 一次性付费，Mac、Windows、安卓、Linux 版免费。首次打开后先导入自己已有的配置，再尝试连接；系统询问是否添加 VPN 配置时，核对发起应用为 Shadowrocket 后允许。该授权用于建立本地网络接管入口，不表示已经具备可连接的服务器。
订阅与节点导入
以下操作以你已有自己的订阅或服务器信息为前提。导入成功与连接成功需要分别确认。
订阅链接导入失败，应先检查什么？
先确认复制的是自己已有的完整订阅链接，而不是服务商的登录页或说明页；检查首尾空格、换行和被截断的参数。然后确认当前网络能访问订阅地址，并查看错误属于超时、认证失败还是格式解析失败。认证失败需核对链接是否仍有效，解析失败需核对输出格式。订阅链接可能包含访问凭据，不要把完整链接贴入公开截图或排查记录。
怎样手动更新订阅，自动更新又有什么区别？
在 Home 中找到对应的订阅分组，使用其更新操作，等待完成后核对条目是否变化。若 Settings 中提供打开时更新的选项，可按需要启用；不同版本的选项位置应以实际界面为准。自动更新只是省去手动触发，不会修复失效链接或网络故障。更新后若原服务器被移除，需重新选择可用条目；不要把更新成功当作每个服务器都能连接的证明。
Scan QR Code 扫码失败，能改为手动添加吗？
可以。先确认二维码来自你已有的服务器信息，画面完整、清晰，且相机权限已允许；网页地址、登录确认码并不一定是可导入的服务器二维码。仍无法识别时，进入 Add Server，按原始资料选择协议并填写服务器、端口和认证字段。手动填写不能省略协议要求的参数；保存后再次核对字符大小写、空格与端口，再执行连通性检查。
Subscribe 与 Config 是同一种文件吗？
不是。Subscribe 通常用于读取和更新一组服务器条目；Config 用于管理规则、DNS 等配置内容，二者的使用位置和作用不同。把订阅地址当作配置文件导入，可能造成解析失败；只更新订阅也不会自动替换当前规则。导入前先确认手头资料的用途，配置变更前备份当前文件，应用后核对 Global Routing 与所选服务器，避免同时更改多处后无法判断原因。
手动添加服务器时，协议和参数怎样核对？
Add Server 中的协议应与原始服务器资料完全对应，例如 Shadowsocks、VMess、VLESS 或 Trojan；不能只填写地址和端口后随意选择协议。再逐项核对认证信息、加密方式、传输方式以及 TLS 相关字段，服务端未要求的项目不要凭猜测补填。保存成功只表示信息已录入，不表示远端验证通过。若连接失败，先与原始资料逐项比对，再测试网络可达性。
更换设备前怎样保留配置，截图能当备份吗？
截图适合记录开关状态，不适合替代完整配置备份。更换设备前，保存自己已有的订阅地址，并使用应用提供的导出或备份功能保留本地配置，确认文件确实可读取。备份可能含有服务器凭据，应存放在本人可控的位置。新设备恢复后，重新核对当前配置、所选服务器和系统 VPN 授权；本地规则的恢复与重新下载应用是两个独立步骤。
规则分流与连接排查
按基础网络、服务器、模式、DNS、规则的顺序缩小范围，保留每次测试的条件与结果。
Global Routing 的 Config、Proxy、Direct 怎么选？
三种常用姿态为配置（Config）、代理（Proxy）、直连（Direct）。Config 按当前配置中的规则决定请求走向；Proxy 将适用的请求交给所选代理服务器；Direct 用于直接连接。日常规则分流通常先使用 Config。排查时可临时切到 Proxy 或 Direct 对比同一目标的表现，但一次只改变一个条件，并在测试后恢复原模式；模式切换不能修复错误的服务器参数。
连接开关打不开，或刚打开就自动关闭怎么办？
先检查是否已选择服务器，以及首次连接时是否允许添加 VPN 配置。若曾拒绝授权或删除系统 VPN 条目，返回 Shadowrocket 再次发起连接，并按提示重新授权。随后检查是否有其他 VPN 连接或设备管理策略占用相关能力，必要时先停止冲突连接再试。若仍立即关闭，记录系统提示和客户端日志；不要反复删除全部配置，应先备份后再做重建操作。
已经连接，却无法上网，按什么顺序检查？
先断开连接，确认当前 Wi-Fi 或蜂窝网络本身可用；再核对所选服务器与 Connectivity Test 结果。随后检查 Global Routing、DNS 和实际命中的规则，尤其注意 FINAL 的策略是否符合预期。若仅部分网站失败，记录目标域名并查看对应日志，不要立刻更换全部设置。每次只改一项，并用同一目标复测；系统显示 VPN 已连接只说明通道已建立，不保证每次请求都能完成。
DNS 与规则冲突时，怎样定位？
先区分域名无法解析，还是解析完成后连接失败。检查当前 Config 中的 DNS 设置，再查看请求匹配到哪条 Rule。DOMAIN-SUFFIX 匹配域名及子域名，IP-CIDR 匹配地址网段；较靠前的适用规则可能先决定策略，FINAL 应作为末尾的兜底规则。不要通过堆叠多条相似规则来试错；先保留最小必要规则，记录命中结果，再逐条恢复并复测。
界面显示英文，应该怎样对照教程？
本手册保留界面词原文，可直接对照 Home、Add Server、Config、Settings、Global Routing 和 On Demand 查找操作入口。系统语言、应用语言设置及应用版本可能影响实际显示；若系统提供单独的应用语言选项，可在该应用的系统设置中查看。不要只凭图标位置判断功能，优先核对英文名称。找不到入口时，可先阅读入门指南中的操作顺序，再核对当前所在页面。
使用后耗电增加，On Demand 要关闭吗？
先在系统电池统计中比较相近时段的使用情况，并检查是否存在持续下载、频繁重连或大量诊断日志。On Demand 会按设定条件触发连接，若条件过宽，可能在不需要时继续连接；可暂时停用并观察，但不要把它视为所有耗电问题的原因。减少重复测试和过密的订阅刷新，检查网络是否稳定。对比时保持使用习惯相近，避免仅凭一次电量下降判断客户端异常。