QuickQ 使用文档
本文档对应客户端 v3.8.1，覆盖从安装前准备到分流策略、安全机制与故障排查的完整内容。每章都可以独立阅读，遇到问题时建议先看第八章的排查顺序。
一、安装前准备
QuickQ 的首次使用只需要准备三样东西：一个能收信的邮箱、一条可用的互联网连接，以及你知道自己主要访问哪些服务。第三点会直接影响后面的节点选择。
先想清楚三件事
- 主要用途：实时对战看重抖动，视频观看看重带宽，远程开发看重长连接稳定性，三者择一为主可以少走弯路。
- 目标地区：尽量选择与目标服务同区域或邻近区域的节点，绕远路是速度不达预期最常见的原因。
- 设备范围：只有一两台设备就逐台安装，超过四台或包含电视盒子时，路由器方案通常更省事。
建议：第一次连接先保持默认设置，确认能正常访问目标服务后，再回头调整协议与分流。这样万一出问题，容易判断是配置引入的还是网络本身的问题。
二、Windows 安装与配置
适配 Windows 10 1809 及以上与 Windows 11 的 64 位系统，安装过程需要创建一张虚拟网卡，这是加速功能正常工作的前提。
安装步骤
- 在下载页获取
QuickQ-Setup-3.8.1-x64.exe； - 执行
certutil -hashfile QuickQ-Setup-3.8.1-x64.exe SHA256核对校验值； - 运行安装程序，遇到虚拟网卡驱动的安装提示时选择允许；
- 启动客户端并用邮箱注册，注册完成即自动登录。
建议调整的设置
- 协议：默认使用 Nova；如果所在网络对 UDP 限制严格，切换为 IKEv2 往往更稳。
- 断线保护：建议保持开启，隧道异常时会冻结网络访问，避免以真实地址继续联网。
- 开机自启：常用设备可以打开，省去每次手动连接。
- 悬浮窗：开启后能随时看到链路评分，评分低于 70 分时提示会直接出现在窗口上。
三、macOS 安装与配置
提供同时支持 Apple Silicon 与 Intel 的通用安装包，通过系统网络扩展接管流量，与 iCloud 私密转发可以共存。
安装步骤
- 下载
QuickQ-3.8.1-universal.dmg并核对 SHA-256； - 打开磁盘映像，把 QuickQ 拖入「应用程序」；
- 首次启动时，在「系统设置 → 隐私与安全性」中允许加载网络扩展；
- 登录后从菜单栏图标连接，菜单中可以直接切换节点。
排查提示：如果授权提示始终没有出现，先在终端执行 sudo killall -HUP mDNSResponder 刷新网络服务，再重新打开客户端。
四、移动端安装
移动端通过系统网络扩展建立隧道，重点是保证在 Wi-Fi 与蜂窝网络之间切换时不掉线，同时控制后台耗电。
iOS / iPadOS（15.0 及以上）
- 在 App Store 搜索 QuickQ，或从下载页跳转；
- 首次连接时允许添加 VPN 配置；
- 在「设置 → 通用 → 后台 App 刷新」中允许 QuickQ，确保切网后能自动恢复；
- 如需更省电，可在客户端里开启低电量模式。
Android（10.0 及以上）
- 在 Google Play 安装，或从本页下载 APK；
- APK 安装需要在系统里允许来自该来源的安装请求；
- 首次连接时授权 VPN 服务；
- 在「设置 → 电池」中把 QuickQ 设为不受限制，避免后台被系统回收。
五、路由器与命令行
需要覆盖电视、游戏主机与智能家居设备时，把加速放在路由器层是最省心的做法：只配置一次，全网生效。
Linux 命令行
# 安装客户端
curl -fsSL https://dl.quickqtool.com/setup.sh | sh
# 登录并探测亚太区域的可用线路
quickq-cli login
quickq-cli probe --region ap
# 以守护进程方式接入指定节点
quickq-cli up --node sg-eq4 --daemonOpenWrt 路由器
- 确认固件版本为 OpenWrt 21.02 或更高；
- 在「系统 → 软件包」中安装
quickq-core与luci-app-quickq； - 进入 LuCI 的 QuickQ 菜单，填入账号中心生成的设备密钥；
- 在策略路由中指定需要走加速通道的设备或网段。
性能提醒：路由器 CPU 往往是瓶颈所在。如果整屋设备同时跑高带宽业务，建议选择带硬件转发加速的型号，或只对部分设备启用加速。
六、场景策略与分流
QuickQ 会按进程自动匹配场景策略，也允许你手动覆盖。理解这套机制可以避免「一开加速，本地服务全失效」这类常见问题。
三种内置策略
| 策略 | 优化目标 | 适用应用 |
|---|---|---|
| 低抖动通道 | 优先稳定帧间隔 | 实时对战、语音会议、远程桌面 |
| 低延迟通道 | 优先缩短首包时间 | 网页浏览、接口调试、即时通讯 |
| 大带宽通道 | 优先提升吞吐上限 | 视频串流、文件回传、素材下载 |
配置直连名单
直连名单里的应用不会经过加速通道，适合局域网设备管理、本地打印机、网银客户端这类不需要跨境的程序。
- Windows 与 macOS：设置 → 分流 → 添加应用规则，可按进程名或安装路径匹配；
- Android：设置 → 应用级分流，勾选需要走加速通道的应用；
- iOS：受系统限制，仅提供全局与按域名两种模式。
自定义 DNS
默认使用隧道内的加密 DNS，可以避免解析结果被中途篡改。如果你有自建解析服务，可以在「设置 → 高级 → DNS」中填写，客户端会校验返回值以防止泄漏。
七、安全机制
加密与密钥
移动端默认使用 ChaCha20-Poly1305，在同等安全强度下对移动芯片更友好；桌面端可切换为 AES-256-GCM。两者都通过 X25519 完成密钥交换，具备前向保密能力，会话密钥每小时自动轮换。
三层泄漏防护
- DNS 泄漏防护：所有域名解析都被强制走隧道内的加密解析器；
- IPv6 泄漏防护：在双栈网络中阻止流量绕过隧道直连；
- 断线保护：隧道中断时立即冻结网络访问，避免真实地址暴露。
数据保留范围
我们不保存访问域名、传输内容与 DNS 查询记录。账号系统中只有邮箱、订阅状态与设备数量；节点侧仅有无法回溯到个人的聚合流量计数，用于容量规划。最近一次第三方安全评估的情况可查看产品动态。
八、故障排查
遇到问题时按下面的顺序排查，绝大多数情况可以在前三步解决。不要一上来就重装客户端，那样往往会丢失现场信息。
第一步：确认本地网络
关闭加速后能否正常打开常规网站。如果不能，问题在本地网络，与客户端无关。
第二步：查链路评分
打开客户端首页，看当前节点的评分。低于 70 分直接切换下一个推荐节点，不要在当前线路上继续调试。
第三步：换协议与端口
依次尝试 Nova、WireGuard 与 IKEv2。如果三种协议都连不上，多半是所在网络限制了 UDP，此时把连接端口改为 443 再试。
第四步：排除软件冲突
关闭其它代理插件、企业安全软件的流量过滤模块，以及任何会修改系统路由表的程序。多套代理同时运行是导致连接异常的常见原因。
第五步：导出诊断报告
如果以上步骤都无效，在「设置 → 导出诊断报告」生成文件，连同操作系统版本、客户端版本、所选节点与问题出现的时间一起提交到客服支持页。报告不包含访问记录，提交前你可以自行查看内容。
九、术语对照
- 链路评分
- 客户端综合延迟、抖动与丢包计算出的 0 至 100 分指标，用于快速判断当前线路是否适合继续使用。
- 多路径并发
- 同时建立并维护多条候选链路，主链路质量下降时把流量迁移到更优路径的机制。
- 链路预热
- 在需要切换之前预先准备好备用路径的会话状态，使切换过程接近无感。
- 应用级分流
- 按进程或域名决定哪些流量走加速通道、哪些走本地出口的配置方式。
- 断线保护
- 隧道意外中断时自动冻结网络访问的安全机制，用于避免真实地址暴露。
- 前向保密
- 即使长期密钥日后泄露，也无法解密此前已完成的会话内容的密钥协商特性。