iOS VPN 配置添加失败的排查

iOS 的代理客户端都要先在系统里装一个 VPN 配置才能工作。这一步失败的表现有好几种，原因各不相同。

六种情况

1. 弹窗一闪而过，没点上「允许」

最常见，也最容易解决：关掉客户端重新打开，再点一次连接开关，弹窗会重新出现。

弹窗出现时需要输入设备密码或用面容 ID 确认，没确认就等于没装上。

2. 点了允许，开关还是打不开

多半是旧配置残留或损坏。清理一遍：

1. 设置 → 通用 → VPN 与设备管理
2. 把所有相关的 VPN 配置全部删掉（包括其他代理应用留下的）
3. 回到客户端，重新点连接开关，重新授权

同一时间只能有一个 VPN 配置处于活跃状态，多个应用抢占会互相踢掉。

3. 开关打开一秒自动关闭

除了上面的多配置冲突，还要检查：

• 节点本身不可用：客户端连不上节点时，部分版本会直接关闭开关。先在客户端里测一下延迟。
• 配置格式有问题：订阅返回的节点参数不完整。更新一次订阅，见订阅链接打不开。
• 系统时间不准：会导致握手失败，见握手失败与连接重置。

4. 屏幕使用时间挡住了

如果这台设备开了家长控制或企业管理：

设置 → 屏幕使用时间 → 内容和隐私访问限制 → 确认「VPN」相关项目允许更改。

被限制时通常表现为弹窗直接不出现，或者提示没有权限。

5. 描述文件安装失败

有些机场提供 .mobileconfig 描述文件。安装失败常见于：

• Safari 之外的浏览器下载：描述文件必须用 Safari 下载才能触发安装流程。
• 没去设置里确认：下载后要去「设置 → 通用 → VPN 与设备管理 → 已下载的描述文件」手动点安装。
• 描述文件过期：重新从机场下载一份新的。

安装描述文件等于让对方在你设备上写系统级配置。只安装你信任来源的描述文件，来路不明的不要装。多数情况下用订阅链接就够了，不需要描述文件。

6. 企业网络或 MDM 管理的设备

公司配发的设备可能被 MDM 策略禁止添加 VPN。这种情况客户端层面无解，需要找设备管理员。

一个能省时间的顺序

1. 客户端里先测节点延迟 —— 测不出来就是订阅或节点的问题，与 VPN 配置无关
2. 删光所有 VPN 配置，重新授权一次
3. 检查屏幕使用时间限制
4. 校准系统时间
5. 重启设备（这一步意外地有效，iOS 的网络扩展偶尔会卡死）

客户端相关

iOS 上的具体操作见 Shadowrocket（小火箭）使用教程。

如果配置装上了但网页仍然打不开，那是另一类问题，见客户端显示已连接但网页打不开。