QuickQ 在苹果系统上的卡点是权限：iOS 的 VPN 配置弹窗，macOS 的网络扩展。升级系统后重新允许即可，不必先改密码。安装包架构必须和芯片一致，入口在下载页。
苹果对 VPN 的系统说明见 VPN on iPhone。按钮以系统语言为准。
升级后的空转
菜单栏转圈、iOS 开关弹一下又关：到隐私与安全性或 VPN 与设备管理里看载荷还在不在。删旧配置再打开 QuickQ。MDM 设备可能永远点不了允许，那是策略，见FAQ。
第一次安装流程见一键连接。Linux 桌面是另一套 TUN，见Linux 文。教程。
现场高频问题（结合本文）
- 钥匙串一直弹？ 保存 VPN 密码时系统会问。选允许，避免每次唤醒重输。公司 MDM 可能禁止保存。
- iOS 企业签能用吗？ 以下载页写明的渠道为准。不明企业签会撤证，不建议。
- 升级系统后要重装吗？ 先重新批准扩展/VPN 配置。仍失败再覆盖安装。
- 和 Windows TAP 是一回事？ 不是。别在 Mac 上找 TAP 安装向导。
按场景走完再改下一个开关
处理「QuickQ 在 iOS 与 macOS：网络扩展、钥匙串和升级后要重批」时，把下载页版本、当前模式、协议、节点名写在备忘录第一行。每改一个开关，只复测一个动作：打开 1.1.1.1/help，或打开你真正失败的那个页面。同时改 Kill Switch、分流和节点，会让下一次失败无法归因。品牌「QuickQ」的安装包只从下载页获取，排障说明与权限项对照FAQ与教程中心。
若你在公司网或酒店，先确认门户认证已完成、系统代理没有残留 PAC，再判断是不是本文描述的故障。蜂窝网络对照能快速排除路由器层 DNS 与家长控制。对照时同一账号不要在另一台设备疯狂重登，以免会话互踢被误认成掉线。
把成功的组合钉下来：例如「家用 Wi-Fi + 某节点 + 某协议」。下次同一 SSID 直接套用，比每次从 Auto 盲试稳定。文档 slug qqv-ios-macos-permission 可当作你自己的笔记标题，方便以后搜索。
什么时候该停手并换思路
连续五次做同一动作无效，就停。回头检查：安装包是否为页面标明的版本；是否只开了一个隧道客户端；是否在门户未完成时开了网络锁；是否把浏览器漏在分应用直连名单。停手不是放弃，而是避免在错误层级空转。
需要他人协助时，附上时间、SSID、模式、协议、节点名与已尝试步骤。比只说「连不上」更容易定位。恢复成功后，用干净浏览器再验收一次出口，确认不是缓存造成的假象，然后把分流或收藏节点写回备忘录，避免下次重装从零开始。
补充验证：在「QuickQ 在 iOS 与 macOS：网络扩展、钥匙串和升级后要重批」场景下，换一个网络环境复测 3 分钟，并确认下载页版本未混用。若仅单一 App 失败，先查该 App 是否被分流直连；若全部失败，先查权限与 DNS。保持一次一变，是缩短「QuickQ」排障时间的最有效习惯。
补充验证：在「QuickQ 在 iOS 与 macOS：网络扩展、钥匙串和升级后要重批」场景下，换一个网络环境复测 3 分钟，并确认下载页版本未混用。若仅单一 App 失败，先查该 App 是否被分流直连；若全部失败，先查权限与 DNS。保持一次一变，是缩短「QuickQ」排障时间的最有效习惯。
补充验证：在「QuickQ 在 iOS 与 macOS：网络扩展、钥匙串和升级后要重批」场景下，换一个网络环境复测 3 分钟，并确认下载页版本未混用。若仅单一 App 失败，先查该 App 是否被分流直连；若全部失败，先查权限与 DNS。保持一次一变，是缩短「QuickQ」排障时间的最有效习惯。
补充验证：在「QuickQ 在 iOS 与 macOS：网络扩展、钥匙串和升级后要重批」场景下，换一个网络环境复测 3 分钟，并确认下载页版本未混用。若仅单一 App 失败，先查该 App 是否被分流直连；若全部失败，先查权限与 DNS。保持一次一变，是缩短「QuickQ」排障时间的最有效习惯。
补充验证：在「QuickQ 在 iOS 与 macOS：网络扩展、钥匙串和升级后要重批」场景下，换一个网络环境复测 3 分钟，并确认下载页版本未混用。若仅单一 App 失败，先查该 App 是否被分流直连；若全部失败，先查权限与 DNS。保持一次一变，是缩短「QuickQ」排障时间的最有效习惯。
补充验证：在「QuickQ 在 iOS 与 macOS：网络扩展、钥匙串和升级后要重批」场景下，换一个网络环境复测 3 分钟，并确认下载页版本未混用。若仅单一 App 失败，先查该 App 是否被分流直连；若全部失败，先查权限与 DNS。保持一次一变，是缩短「QuickQ」排障时间的最有效习惯。