QuickQ 使用手册
本手册对应客户端 v5.2.0，覆盖协议选择、全平台安装、分流配置、IPv6 处理与故障排查。每一章都能独立阅读，遇到问题建议先看第八章的排查顺序。
一、三套协议怎么选
QuickQ 客户端内置 WireGuard、IKEv2 与 OpenVPN 三套开放标准协议，客户端的实现未做私有改动。选择依据是网络环境，而不是安全强度。
| 协议 | 传输方式 | 延迟与吞吐 | 典型场景 |
|---|---|---|---|
| WireGuard | UDP | 最佳 | 默认选项，游戏、串流与日常使用 |
| IKEv2 | UDP 500/4500 | 优秀 | 公司或校园网络、移动网络切换频繁 |
| OpenVPN | TCP 443 | 一般 | 仅开放 443 端口的极端受限网络 |
选择顺序：先试 WireGuard；连不上或频繁掉线时改 IKEv2；如果连 IKEv2 也无法握手，再考虑 OpenVPN over TCP。客户端会记住你最后一次的选择。
二、Windows 安装与配置
适配 Windows 10 1809 及以上与 Windows 11 的 64 位系统。安装过程会创建一张虚拟网卡，这是加速功能正常工作的前提。
安装步骤
- 在客户端下载页获取
QuickQ-Setup-5.2.0-x64.exe； - 执行
certutil -hashfile QuickQ-Setup-5.2.0-x64.exe SHA256核对校验值； - 运行安装程序，遇到虚拟网卡驱动提示时选择允许；
- 启动客户端并用邮箱注册，注册完成后自动登录。
建议调整的设置
- 协议：默认 WireGuard；公司或校园网络建议改用 IKEv2。
- 断线保护：建议保持开启，隧道异常时冻结网络访问。
- 开机自启：常用设备可以打开，省去手动连接。
- 质量面板：开启后可在托盘悬浮窗看到链路耗时与抖动。
三、macOS 安装与配置
通用安装包同时支持 Apple Silicon 与 Intel，通过系统网络扩展接管流量，与 iCloud 私密转发可以共存。
安装步骤
- 下载
QuickQ-5.2.0-universal.dmg并核对 SHA-256； - 打开磁盘映像，把 QuickQ 拖入「应用程序」；
- 首次启动时在「系统设置 → 隐私与安全性」中允许加载网络扩展；
- 登录后从菜单栏图标连接，菜单中可直接切换节点与协议。
排查提示：若授权提示始终没有出现，先在终端执行 sudo killall -HUP mDNSResponder 刷新网络服务，再重新打开客户端。
四、移动端安装
移动端通过系统网络扩展建立隧道，默认使用 ChaCha20-Poly1305，在移动芯片上的能效优于 AES。
iOS / iPadOS（15.0 及以上）
- 在 App Store 搜索 QuickQ，或从下载页跳转；
- 首次连接时允许添加 VPN 配置；
- 在「设置 → 通用 → 后台 App 刷新」中允许 QuickQ，确保切网后自动恢复；
- 如需进一步省电，可在客户端开启省电模式。
Android（11.0 及以上）
- 从 Google Play 安装，或从本页下载 APK；
- APK 安装需要在系统中允许来自该来源的安装请求；
- 首次连接时授权 VPN 服务；
- 在「设置 → 电池」中把 QuickQ 设为不受限制，避免后台被系统回收。
五、路由器与命令行
需要覆盖电视、游戏主机与智能家居设备时，把加速放在路由器层最省心：配置一次，全网生效。
Linux 命令行
# 安装客户端
curl -fsSL https://dl.quickqwork.com/setup.sh | sh
# 登录并探测香港区域的可用对等点
quickq-cli login
quickq-cli peers --region hk
# 以守护进程方式接入指定对等点
quickq-cli up --peer hkg-02 --daemonOpenWrt 路由器
- 确认固件版本为 OpenWrt 22.03 或更高；
- 在「系统 → 软件包」中安装
quickq-core与luci-app-quickq； - 进入 LuCI 的 QuickQ 菜单，填入账号中心生成的设备密钥；
- 在策略路由中指定需要走隧道的设备或网段。
性能提醒：路由器 CPU 往往是瓶颈。若多台设备同时跑高带宽业务，建议选择带硬件转发加速的型号，或只对部分设备启用加速。
六、分流配置
分流解决的问题是：不要因为开了加速，就让所有本地访问都绕一圈。QuickQ 支持按域名与按进程两种匹配方式，可以混用。
什么时候用域名规则
- 只希望某个网站走加速，其余保持直连；
- 目标是网页服务，且该服务会调用多个子域；
- 同一进程既需要访问内网、又需要访问外网，按进程分流会误伤。
什么时候用进程规则
- 游戏、会议、设计软件这类整程序都需要加速的场景；
- 需要精确控制某个客户端，而不影响同机的浏览器；
- 进程会访问大量随机域名，域名规则难以穷举。
推荐做法：先给本地网盘、打印机、内网系统与管理后台加一条直连规则，再逐个把需要加速的程序加入隧道名单。规则可以在多台设备间同步。
七、IPv6 双栈处理
现在的网络环境大致分三类：纯 IPv4、双栈、纯 IPv6。客户端会自动识别并按对应策略协商，通常不需要人工干预。
- 双栈网络：优先与 IPv6 直连对等点建链，实测平均链路耗时再降约 9%。
- 纯 IPv6 网络：客户端自动完成地址转换，不需要手工配置隧道或额外网关。
- 纯 IPv4 网络：按常规流程协商，功能不受影响。
- 泄漏防护：IPv6 泄漏防护默认开启，防止流量绕过隧道直连。
如果你想确认实际走了哪条协议族，可以在客户端的连接详情里查看「数据路径」一行。
八、诊断与排查
遇到问题请按下面的顺序逐项排除。不要一上来就重装客户端，那样往往会丢掉现场信息。
第一步：确认本地网络
关闭加速后能否正常打开普通网站。如果不能，问题在本地网络，与客户端无关。
第二步：换协议
从 WireGuard 切到 IKEv2 再试一次。许多连不上的情况只是所在网络限制了 UDP，换协议即可解决。
第三步：换对等点
看客户端显示的链路耗时。数值低于 40 ms 说明当前线路收益有限，直接换到收益更高的对等点。
第四步：排除软件冲突
关闭其它代理插件、企业安全软件的流量过滤模块，以及任何会改写系统路由表的程序。
第五步：导出诊断报告
在「设置 → 导出诊断报告」生成文件，连同操作系统版本、客户端版本、所选对等点与问题出现时间一起提交到联系我们页面。报告不含访问记录，提交前可以自行查看。
九、术语表
- 直连对等点
- 与本地运营商网络直接互联的接入点。流量在这里离开本地网络，跳数比经集中式机房转发更少。
- 链路耗时
- 客户端显示的、相对直连节省的往返时间，用于判断当前节点是否值得继续使用。
- 会话级调度
- 以单个连接为单位迁移出口，而不是整台设备一起切换，避免一条出口拥塞影响全部流量。
- 双栈
- 同一网络同时支持 IPv4 与 IPv6，客户端会按优先级选择更优的协议族建链。
- 断线保护
- 隧道意外中断时自动冻结网络访问的安全机制，用于避免真实地址暴露。
- 分流
- 按域名或进程决定哪些流量走隧道、哪些保持直连的配置方式。