iOS 代理客户端教程：Shadowrocket 导入订阅与 5 种连不上排查
简答：已经装好客户端和订阅，却遇到 VPN 已连接但网页打不开？通常问题在 App 来源、订阅格式、更新状态、Global Routing 或当前网络。按“核对 App → 导入并 Update → 选择节点 → 允许 VPN → 分别测试 Wi-Fi 与蜂窝网络”的顺序排查，通常可以缩小到具体环节。
定义：iOS 代理客户端教程，是指在 iPhone 或 iPad 上安装网络代理应用、导入已有服务器配置或订阅链接、建立系统 VPN 配置并验证连接的操作指南。
先做 30 秒自检：不要把 App、订阅和连接混在一起
本文只讲 iPhone 和 iPad 上的 Shadowrocket，不展开其他客户端的具体操作。本站是第三方使用指南站，不是相关应用的官方页面。Shadowrocket 的 App Store 产品页将其描述为规则代理工具，并明确说明它不包含代理服务或服务器资源；应用价格、版本、开发者、兼容设备和系统要求，以你当前打开的 App Store 产品页为准。
| 检查项 | 你要看到什么 | 没有看到时先做什么 |
|---|---|---|
| App 来源 | App Store 页面显示 Shadowrocket、开发者和兼容设备 | 不要使用第三方安装包；重新核对 App Store 地区、名称和开发者 |
| 订阅状态 | Home 中出现订阅条目，更新后能看到服务器条目 | 确认使用的是完整订阅 URL，并执行一次 Update |
| 节点状态 | 已选择一个节点，客户端自带测试能返回结果 | 更换一个节点，但不要同时修改 DNS、规则和路由模式 |
| 系统权限 | iOS 显示 VPN 已连接或已允许 VPN 配置 | 断开后重新连接，确认系统授权提示来自已安装的应用 |
| 网络验证 | Wi-Fi 和蜂窝网络都能分别完成测试 | 关闭 Wi-Fi，仅用蜂窝网络测试一次，再反向测试 |
速查卡：App 来源正确 ✓ 订阅已 Update ✓ 已选择节点 ✓ Global Routing 有明确模式 ✓ Wi-Fi 与蜂窝网络各测一次 ✓
如果你的订阅明确标注为 sing-box JSON，请转到站内的 sing-box 导入配置文件教程；如果你使用的是 Stash，请参考 Stash iPhone 订阅导入步骤。本文不把其他客户端的字段直接套到 Shadowrocket 上。
下载前核对 App Store、账户和设备条件
- 打开 iPhone 或 iPad 的 App Store，搜索 Shadowrocket。
- 核对应用名称、图标、开发者、兼容设备和当前价格。App Store 页面会变化，不要根据旧截图判断价格、版本或系统要求。
- 如果下载应用需要使用另一组 Apple Account，只在“媒体与购买项目”中切换，不要为了下载一个 App 退出 iCloud。Apple 的账户说明可参考 Apple Support 关于 iPhone Apple Account 的说明。
- 下载后可打开 App Store 账户头像，查看购买记录或已购项目。购买记录的具体中文名称可能随 iOS 界面变化，以当前设备显示为准；可参考 Apple Support 关于购买记录和订阅的说明。
Shadowrocket 只是客户端，不自动提供服务器、订阅或可用节点。安装成功只代表 App 已装好，不代表网络连接已经完成。预算和地区有顾虑时，先以 App Store 当前页面为准；也可以查看站内的 Stash 订阅导入教程，但不要把 Shadowrocket 的字段路径直接照搬过去。
Shadowrocket 导入订阅：按 Home → “+” → Subscribe 操作
Shadowrocket 的 App Store 页面只公布功能概述，没有提供完整的中文界面手册。因此，下面的菜单名称按常见当前界面整理；如果你的版本显示不同，以 App 内实际文字为准。
- 打开 Shadowrocket，进入首页
Home。 - 点击右上角的
+，进入添加服务器或添加配置页面。 - 找到
Type，选择Subscribe。如果你拿到的是一条订阅 URL，不要选择 Shadowsocks、VMess、VLESS 或其他单节点协议类型。 - 把完整订阅地址粘贴到
URL字段。不要加入前后空格、换行、引号或说明文字，也不要擅自删除 URL 后面的参数。 - 在名称、备注或类似字段中填写便于识别的名称。当前版本是否显示
Alias、Remark或其他名称，以 App 内显示为准；不要把密码、令牌等认证信息写进名称字段。 - 点击右上角的完成、保存或同义按钮，返回
Home。 - 找到刚刚添加的订阅条目，执行
Update。不同版本可能通过点击条目、进入编辑页，或在订阅条目上左滑后显示更新操作；入口以当前 App 界面为准。 - 更新完成后，确认订阅分组内出现服务器条目，再点击其中一个节点作为首次测试对象。
只看到订阅名称、不显示节点，通常说明只是保存了 URL，还没有成功拉取内容，或者返回内容为空。此时不要重复创建同名订阅，先检查 URL 是否完整、当前网络是否能访问该地址，再重新执行 Update。订阅链接可能包含访问凭据，不要把完整链接公开到群组、截图或工单中。
| 你拿到的内容 | 是否直接按本文操作 | 正确处理方式 |
|---|---|---|
| 明确写着 Shadowrocket 或通用订阅，并提供 URL | 通常可以 | Home → “+” → Type → Subscribe → URL → 保存 → Update |
| 只有一个服务器地址、端口和密码 | 不应选择 Subscribe | 选择与协议对应的 Type，按字段手动填写 |
| 明确标注 sing-box JSON | 不要假设兼容 | 使用对应 JSON 导入方法，参考站内 sing-box 配置导入教程 |
| 提供方给出分享链接二维码 | 可以是正常导入方式 | 使用 App 内的扫码导入功能，导入后检查协议、地址和端口 |
| 要求安装来源不明的描述文件或证书 | 不要直接继续 | 先确认来源、用途和权限；无法解释的配置不要安装 |
首次连接：节点、Global Routing 和 VPN 权限怎么设置
- 在
Home中选择一个已经出现在订阅分组里的节点。 - 打开
Global Routing。常见选项包括Config、Proxy和Direct；当前版本是否显示其他选项，以 App 内为准。 - 首次排查时，如果你已经有明确可用的规则配置，可选择
Config，并进入Config检查当前配置文件是否真的处于启用状态，而不是只存在于列表中。 - 如果你只是想先判断节点本身能否连接，可以暂时选择
Proxy做单变量测试；测试完成后记下原来的模式，并恢复到你的实际使用模式。Direct会绕过代理，不适合用来判断代理节点是否可用。 - 回到
Home，打开连接开关。iOS 第一次可能弹出允许添加 VPN 配置的系统提示，确认提示来自已安装的 Shadowrocket 后，再按系统提示操作。 - 使用客户端自带的节点延迟、连通性或测试功能。App Store 页面确认 Shadowrocket 提供连接测速和网络流量测试相关功能，但按钮名称和位置可能随版本变化，以当前界面为准。
- 先关闭 Wi-Fi，仅使用蜂窝网络测试；再恢复 Wi-Fi 测试一次。记录节点测试、浏览器网页和目标 App 的结果，不要只凭状态栏的 VPN 图标判断所有应用都已正常。
成功判定应至少包括：节点测试返回结果、VPN 权限已允许、浏览器能够打开固定测试页面，并且 Wi-Fi 与蜂窝网络的结果已分别记录。如果只有 VPN 图标而网页打不开，继续看下一节，不要立即反复更换所有设置。
5 种常见故障：每次只改一个变量
| 现象 | 按顺序检查 | 预期结果与判定 |
|---|---|---|
| App Store 搜不到或无法下载 | 检查当前 App Store 地区、名称、开发者、兼容设备和账户；不要改用第三方安装包 | 能打开正确的产品页并完成安装；仍不可用时，说明当前账户或地区条件未满足 |
| 订阅保存后没有节点 | 检查是否选择 Type → Subscribe；确认 URL 完整；返回 Home 对订阅条目执行 Update | 订阅分组内出现服务器条目；仍为空时，核对链接有效性和订阅格式 |
| 所有节点测试超时 | 先确认订阅已更新，再只更换一个节点；分别测试 Wi-Fi 和蜂窝网络 | 某个节点成功，问题集中在节点或当前网络；全部失败时继续核对订阅状态、网络可达性和 VPN 权限 |
| VPN 已连接但网页打不开 | 检查 Home → Global Routing 的当前模式；若使用 Config，进入 Config 确认配置文件已启用；暂时不要同时改 DNS、规则和按需连接 | 切换到单一测试模式后恢复，说明问题可能在规则或路由；仍失败则换一个节点并重复网络测试 |
| 浏览器能打开，只有某个 App 失败 | 先记录浏览器结果，再检查当前 Config 中该应用域名匹配到的规则和策略 | 浏览器正常而单个 App 失败，优先检查规则、DNS 或应用自身网络要求，不要直接判定订阅失效 |
若连接在锁屏或后台后中断，先记录发生条件：是否开启低电量模式、是否从 Wi-Fi 切换到蜂窝网络、是否刚从后台回到前台。Apple 说明，低电量模式会关闭后台 App 刷新；可参考 Apple Support 关于低电量模式和后台活动的说明。排查时先关闭低电量模式并重复同一网络测试，再决定是否检查 App 内的后台更新或按需连接选项；这些选项是否存在，以当前版本界面为准。
如果系统保留旧的 VPN 配置，可打开“设置 → 通用 → VPN 与设备管理”查看。删除前先确认配置确实属于不再使用的项目；Apple 关于描述文件查看和移除的说明可参考 Apple Support 配置描述文件指南。
安全边界：订阅链接、Apple Account 和描述文件
- 订阅 URL 可能包含令牌或其他访问凭据，不要公开完整链接；求助时只保留域名和必要的错误信息。
- 不要使用共享 Apple Account 下载应用，也不要把自己的 Apple Account 密码交给他人。需要更换下载账户时，优先只处理“媒体与购买项目”，不要退出 iCloud。
- 二维码不一定有问题：如果它只是提供方给出的订阅或单节点分享链接，可以使用 App 内扫码功能；但二维码若引导安装未知描述文件、证书或无法解释的配置，应先停止。
- 不要为了排错随机关闭证书验证、导入不明规则或安装来源不明的描述文件。先保留原配置，每次只改一项，并记录改变前后的结果。
- 教程仅用于合法的设备配置和网络连接，请遵守所在地法律法规，以及所使用网络和服务的条款。
如果你想先理解订阅、节点和不同网络连接方式的区别，可阅读站内的 机场和 VPN 的区别与订阅方式。
常见问题
iOS 代理客户端教程里的“订阅”是什么？
订阅通常是一条用于获取服务器列表或配置内容的 URL，不等于 App，也不等于 VPN 权限。Shadowrocket 需要先安装应用，再通过 Home → “+” → Type → Subscribe 保存并更新这条链接。
为什么订阅导入后只显示名称，没有节点？
常见原因是没有执行 Update、URL 被复制时带入换行或引号、链接缺少参数，或订阅返回内容为空。回到 Home 找到订阅条目并更新；仍为空时，再核对链接格式和提供方状态。
Shadowrocket 显示 VPN 已连接，就代表所有应用都能用吗？
不代表。VPN 状态只说明系统连接过程已经建立，具体应用还会受到当前 Global Routing、Config 规则、DNS、网络类型和节点可达性的影响。应分别测试客户端节点、浏览器、Wi-Fi 和蜂窝网络。
需要退出 iCloud 才能下载 Shadowrocket 吗？
通常不需要。Apple 的账户体系允许设备使用一个主要 Apple Account 管理 iCloud，同时使用另一个账户处理“媒体与购买项目”；具体入口以当前 iOS 界面为准，可参考 Apple Support 关于媒体与购买账户的说明。
为什么别人看到的 Shadowrocket 价格、版本或界面不同？
App Store 的价格、可用地区、版本、系统要求和界面会变化，也可能因账户地区不同而不同。请以截至 2026 年 10 月 23 日你当前打开的 App Store 产品页和设备界面为准，不要根据旧截图判断。
常见问题
iOS 代理客户端教程里的“订阅”是什么？
订阅通常是一条用于获取服务器列表或配置内容的 URL，不等于 App，也不等于 VPN 权限。Shadowrocket 需要先安装应用，再通过 Home → “+” → Type → Subscribe 保存并更新这条链接。
为什么订阅导入后只显示名称，没有节点？
常见原因是没有执行 Update、URL 被复制时带入换行或引号、链接缺少参数，或订阅返回内容为空。回到 Home 找到订阅条目并更新；仍为空时，再核对链接格式和提供方状态。
Shadowrocket 显示 VPN 已连接，就代表所有应用都能用吗？
不代表。VPN 状态只说明系统连接过程已经建立，具体应用还会受到当前 Global Routing、Config 规则、DNS、网络类型和节点可达性的影响。应分别测试客户端节点、浏览器、Wi-Fi 和蜂窝网络。
需要退出 iCloud 才能下载 Shadowrocket 吗？
通常不需要。Apple 的账户体系允许设备使用一个主要 Apple Account 管理 iCloud，同时使用另一个账户处理“媒体与购买项目”；具体入口以当前 iOS 界面为准。
为什么别人看到的 Shadowrocket 价格、版本或界面不同？
App Store 的价格、可用地区、版本、系统要求和界面会变化，也可能因账户地区不同而不同。请以当前 App Store 产品页和设备界面为准，不要根据旧截图判断。