官方手册 / 常见问题
Shadowrocket 常见问题
先确定问题发生在哪一步：商店购买、首次打开、资料导入，还是连接后的访问。以下按这四个阶段整理，每项均可展开阅读。
排查前记录错误文字、当前网络和刚做过的改动。一次只改变一个条件；应用已经安装、订阅已经导入、系统显示已连接，分别代表不同阶段，不能互相替代。
App Store
正版核对与购买
先核对产品，再处理账户与购买记录。账号地区、设备兼容性和线路状态是不同问题。
App Store 搜不到 Shadowrocket，先检查什么？
先从下载指南打开 Shadowrocket 的 App Store 产品页，区分搜索结果缺失和当前店面不可用。网页链接中的 us 不能证明账号已使用该地区商店，实际购买店面由登录账号决定。在系统 Settings 的 Apple 账户中进入 Media & Purchases，查看账户的 Country/Region；具体菜单名称以系统显示为准。若确需更改地区，沿该官方路径阅读余额、现有订阅与付款方式的要求，确认满足条件后再操作。不要反复切换地区来排查普通网络故障。
怎样确认商店里的应用是正版 Shadowrocket？
在产品页同时核对名称 Shadowrocket、开发者 Shadow Launch Technology Limited，以及产品链接中的 id932747118。再将应用图标与本站页头的官方图标比对，不能只凭搜索结果里的名称或排序判断。三个核验要素是开发者、官方图标和应用 ID，任意一项不一致都应重新检查产品页。Shadowrocket 是闭源商业应用，唯一获取入口是 App Store；价格、兼容性和购买适用范围以 App Store 页面标注为准。
一次性买断包含什么，买完就能连接吗？
客户端一次性买断 ≠ 线路套餐。购买获得的是 Shadowrocket 客户端的使用资格，不等于已经具备可连接的服务器信息。美区定价约 2.99 美元，各店面按当地货币显示，最终金额以 App Store 购买确认页为准。连接前需要用户已有自己的订阅或服务器信息，并核对服务状态及参数。本站不提供、不销售、不推荐节点或订阅。遇到连接问题时，应分别检查应用是否已安装、导入内容是否有效，以及当前网络能否访问目标服务器。
换机或重装后，需要再次购买吗？
先用原购买账号登录 App Store，在账户的 Apps 或已购项目中查找 Shadowrocket，再按页面提供的恢复下载入口操作；菜单名称可能随系统变化。若页面仍显示价格，先核对当前用于 Media & Purchases 的账号和原购买凭证，不要立即重复付款。应用购买记录与应用内数据是两件事：恢复客户端并不等于恢复已有订阅、规则和自定义设置。更换设备前应妥善保存自己的配置资料，恢复后逐项检查，购买适用范围以 App Store 页面标注为准。
家人共享能否使用，其他 Apple 设备在哪里确认？
先查看同一 App Store 产品页的家人共享说明和兼容性栏，再检查家庭组的购买共享设置。是否适用取决于商店页面标注、购买项目和账户状态，不能仅凭加入家庭组就认定能够恢复。iPhone、iPad 以外，Mac、Apple TV、Apple Vision 的兼容性、系统要求与购买适用范围也以 App Store 页面标注为准。应用的购买共享不等于订阅资料或服务器访问权限共享；用户仍需自行确认已有服务允许的设备范围和连接条件。
Installation / Home
安装与首次打开
先区分 App Store 下载问题和应用连接问题，再检查系统权限。授权与服务器配置需要分别完成。
iPhone 下载停住，或无法完成购买，怎么处理？
先记录 App Store 提示的完整错误文字，区分付款未完成、下载等待和设备不兼容。检查设备剩余存储空间、当前网络，以及 App Store 账户是否需要完成付款验证或接受新的账户条款。下载等待时可在稳定网络下暂停后重试；购买状态不明时先查看购买记录，避免连续确认付款。系统要求以 App Store 页面标注为准。若其他应用也无法下载，应优先处理商店账户或系统网络问题；只有 Shadowrocket 出现问题时，再检查产品页的可用性与兼容性。
iPad 能安装吗，已有购买怎么使用？
在 iPad 上打开同一 Shadowrocket App Store 产品页，先查看兼容性和系统要求，以 App Store 页面标注为准。已有购买时，使用原购买账号检查已购项目，并按商店提供的入口下载；通用购买的适用范围同样以页面标注为准。iPad 的屏幕布局可能与 iPhone 不同，但查找功能时仍应认准 Home、Config、Settings 等界面词。安装完成后单独核对订阅、服务器参数和当前配置，不要把应用已经恢复下载当作应用内资料也已迁移完成。
首次连接时，添加 VPN 配置的提示是什么意思？
这是系统为应用建立网络连接配置时显示的授权提示，不是购买确认，也不会自动填入服务器信息。应在确认安装的是正版 Shadowrocket、已经核对导入内容，并主动开启连接后阅读提示，再按系统要求完成授权与设备身份验证。如果此前取消了授权，可返回应用重新尝试；仍有提示时，查看系统 VPN 配置状态。受组织管理的设备可能限制新增配置，此时应联系设备管理员。授权完成只代表允许建立连接，实际可用性还取决于服务器、配置与当前网络。
Home 的连接开关打不开，应该按什么顺序检查？
先确认已导入并选中有效服务器，再观察打开开关时是否出现系统授权、错误提示，或短暂连接后立即关闭。若系统授权未完成，先处理 VPN 配置权限；若设备有其他正在工作的 VPN 配置，可先停止其连接再测试。不要为了尝试而直接删除所有系统配置，尤其是组织管理的设备。随后检查服务器必填参数、已有服务状态和当前网络。保留错误文字后再重启应用或设备，并一次只调整一个因素，便于判断是哪一步恢复了连接。
界面是英文，如何对照教程找到设置？
本手册保留界面英文原文，先按名称定位，而不是按截图中的固定位置寻找。Home 用于查看连接入口和服务器列表，Add Server 用于添加信息，Config 用于配置文件，Settings 用于其他设置；Global Routing 决定路由姿态。若想调整应用语言，可在系统 Settings 中查看 Shadowrocket 是否提供 Language 选项，并以设备实际可选项为准。没有对应选项时仍可按英文名称操作。页面位置可能随设备布局变化，遇到差异先确认当前所在页面，再比对所需功能名称。
Add Server / Subscribe
订阅与节点导入
以下仅处理用户已有的资料。先辨认输入内容的类型，再区分请求失败、格式解析失败和连接失败。
已有订阅导入失败，首先检查哪些内容？
先确认复制的是用户已有服务提供的完整订阅链接，而不是账户网页地址、说明页面或单个服务器分享内容。检查链接首尾是否带空格、换行或遗漏参数，并确认服务仍然有效。在 Add Server 中选择 Subscribe 后填入链接，保存并观察获取结果。若提示网络请求失败，先检查当前网络是否可达；若提示解析失败，则核对返回内容是否为受支持的订阅格式。向原服务方求助时提供错误文字即可，不要公开包含个人令牌的完整链接、二维码或配置文件。
单个服务器链接、二维码与 Subscribe 有什么区别？
单个服务器链接通常描述一条连接所需的协议和参数；二维码只是承载这些信息的一种方式，内容也可能是订阅地址。Subscribe 则用于获取并维护一组由来源返回的服务器信息。导入前应先判断内容类型：已有服务器参数可在 Add Server 中按对应协议填写，二维码可通过 Scan QR Code 读取，已有订阅则使用 Subscribe。扫描成功不代表参数一定有效，保存后还需检查地址、端口、认证与传输设置。不要把订阅地址填入服务器地址字段，也不要按名称相似就猜选协议。
订阅导入成功，但列表为空或条目减少，是什么原因？
先确认查看的是刚导入的订阅分组，而不是其他分组或筛选后的列表。随后检查更新结果，判断是确实获取到空内容，还是上一次更新未成功。订阅返回的条目可能因原服务状态、账户权限、格式支持或来源调整而变化，不能只凭条目数量推断应用故障。保留原有信息后再向来源核对当前应返回的内容，不要反复删除并重加同一个地址。若列表已有条目但无法使用，应转到单条服务器的参数和连通性检查，列表存在与连接可用是不同阶段。
怎样更新已有订阅，更新前需要注意什么？
在 Home 中找到对应订阅分组，使用该分组的更新操作，并检查结果提示；具体入口以应用当前显示为准。更新前记下正在使用的服务器，以及对条目做过的本地修改。订阅更新会以来源返回的数据为依据，部分本地修改可能被覆盖，原有条目也可能被替换或移除。更新后重新确认所选服务器仍然存在，再进行连通性验证。遇到失败先保留当前列表并检查地址、服务状态和网络，不要连续重复导入，以免生成多个相同来源的分组而增加排查难度。
向他人提供错误信息时，哪些内容需要隐藏？
保留错误时间、操作步骤、协议类型、错误文字，以及当时使用 Wi-Fi 还是蜂窝网络，这些信息通常有助于定位问题。隐藏完整订阅链接中的个人令牌、认证密码、私钥和可直接导入的二维码；公开配置文件前也要检查其中是否含有相同资料。仅遮住账户名称并不足够，链接参数和日志内容仍可能暴露访问凭据。若敏感资料已被公开，应到原服务方提供的账户管理入口处理更换，再更新应用中的相关信息。本站只说明导入与维护方法，不接收用户的完整访问凭据。
Global Routing / Connectivity Test
规则分流与故障排查
固定测试目标，从本地网络、服务器、路由与配置逐层检查。连接标识与测试结果都需要结合实际访问验证。
Global Routing 的 Config、Proxy、Direct 怎么选？
配置（Config）按当前生效配置中的规则选择策略，适合已经核对规则内容后使用；代理（Proxy）让由应用接管的连接采用所选代理路径，便于对照检查服务器；直连（Direct）让由应用接管的连接采用直接路径，可用于比较本地网络表现。三种姿态改变的是路由方式，不会修复错误的服务器参数，也不保证目标一定可达。日常分流先确认 Config 中启用的是预期文件；排查时固定同一目标，只改变路由姿态并重新发起连接，避免同时更换服务器和规则而失去对照。
显示已连接，但网页无法打开，如何分层排查？
已连接通常说明系统连接配置已经启动，不等于目标访问已经成功。先暂停连接，确认本地网络能否正常访问原本可达的页面；再恢复连接，用 Connectivity Test 检查所选服务器，并核对认证、端口及服务状态。测试结果只反映相应测试目标，仍需实际打开需要访问的页面。如果 Proxy 可用而 Config 不可用，重点检查当前配置的规则、最终策略和 DNS；如果两者均失败，再比较 Wi-Fi 与蜂窝网络。每次改动后重新发起请求，并记录现象，不要同时修改多个设置。
规则已写入 Config，为什么访问结果没有变化？
依次确认 Global Routing 处于 Config、修改的文件已经保存并启用，以及规则顺序符合预期。规则通常自上而下匹配，靠前的宽泛规则可能先于后面的具体规则生效，FINAL 应承担未匹配连接的最终处理。再检查匹配对象：DOMAIN-SUFFIX 面向域名后缀，IP-CIDR 面向地址范围，两者不能互相替代。修改后让目标连接重新建立，已有连接可能继续使用原路径。若仍不符合预期，可结合应用的连接记录核对实际域名、地址和命中策略，再缩小到具体规则排查。
开启 On Demand 后自动连接，应该怎样调整？
On Demand 按已设置的条件触发连接，不是检测服务器是否可用后再自动修复。若手动关闭后又重新连接，先检查是否启用了 On Demand，并核对与当前网络相关的触发条件。需要临时手动排查时，可先停用 On Demand，再固定服务器与路由姿态测试，完成后按实际需要恢复。调整前记下原有条件，避免在多个位置同时修改而无法还原。自动连接并不代表访问一定走代理，具体路径仍由 Global Routing 和当前配置决定，确认开关状态后还要检查实际路由结果。
使用后耗电增加或速度变慢，怎样判断原因？
先在相近的网络、使用时长和访问内容下比较，避免把视频传输、云端同步或蜂窝信号较弱造成的耗电都归到客户端。查看系统电池用量，并留意是否存在反复重连、持续测试或长期打开详细记录的情况。速度方面先比较本地网络，再检查所选服务器和已有服务状态；协议参数应按来源资料核对，不要为尝试而随机改动。排查时一次只改变网络、服务器或配置中的一项，完成后停止不再需要的测试与详细记录。仅凭一个耗电百分比或一次测速，无法判断具体故障层。