确认系统版本与架构
Windows 建议 10 及以上（64 位），macOS 建议 12 及以上，Android 建议 8.0 及以上，iOS 建议 14 及以上。下载前在系统设置中核对位数，避免装错架构的安装包。
Preparation
下载前准备：先把案板擦干净
很多安装失败并非软件问题，而是准备工作没到位。下面四项检查建议在下载前完成，能省掉大部分返工。
核对下载来源为官方域名
请确认地址栏为 quickq.cafe 官方域名，页面顶部带有官方标识。第三方站点提供的「绿色版」「加速版」可能被二次打包，存在安全风险，不建议使用。
预留足够磁盘空间
安装包本身不大，但运行过程会生成缓存与日志。建议在系统盘预留至少 500MB 可用空间，避免安装到一半因空间不足中断。
暂时关闭冲突的安全策略
部分安全软件会拦截未经签名的安装行为。若安装被中断，可临时将安装包加入信任列表，安装完成后再恢复安全策略，切勿长期关闭防护。
Platforms
各平台安装步骤：按口味上桌
不同系统的安装方式略有差异，但核心逻辑一致：运行安装包 → 授予必要权限 → 完成初始化 → 首次连接。
Windows 安装
- 从官方域名下载 Windows 安装包，右键查看文件属性确认大小与来源。
- 双击运行安装程序，在用户账户控制弹窗中选择「是」。
- 选择安装路径，建议保持默认路径以便后续更新。
- 等待进度条完成，勾选「创建桌面快捷方式」后点击完成。
- 首次启动时允许网络访问权限，进入主界面。
macOS 安装
- 下载 macOS 版本安装包，打开后拖入「应用程序」文件夹。
- 首次打开若提示「无法验证开发者」，前往系统设置中的隐私与安全性。
- 在「仍要打开」选项中确认放行，输入开机密码完成授权。
- 在系统设置中允许其添加网络配置，否则无法建立连接。
- 从启动台打开应用，等待初始化完成即可使用。
Android 安装
- 在官方页面下载 APK 文件，注意浏览器可能提示「此类文件可能有风险」。
- 在系统设置中允许对应浏览器或文件管理器「安装未知应用」。
- 点击 APK 文件开始安装，等待系统校验完成。
- 首次启动时授予必要的网络与通知权限。
- 建议在电池优化中将其设为不受限制，避免后台被清理。
iOS 安装
- 在官方页面点击 iOS 下载按钮，跳转至 App Store 对应页面。
- 使用 Apple ID 完成下载与安装，注意核对开发者名称。
- 首次打开时允许添加 VPN 配置，系统会要求验证面容或指纹。
- 在设置中确认配置描述文件已生效。
- 返回应用完成初始化，即可开始首次连接。
Baking Timeline
首次连接出炉时间线
安装完成后，按照下面的时间线依次操作，大约三到五分钟即可完成首次连接，体验自研传输协议。
第 1 分钟：启动应用与初始化
首次启动会进行组件初始化与网络环境探测，此时请保持网络畅通。若界面长时间停留在初始化，可尝试退出后重新打开。
第 2 分钟：登录与账号绑定
按提示完成账号登录或本地模式进入。建议使用常用邮箱注册，便于后续在其它设备上同步配置。
第 3 分钟：选择节点与协议模式
在节点列表中优先选择延迟较低的线路。自研传输协议默认开启智能模式，会根据网络状况自动切换策略，一般无需手动干预。
第 4 分钟：建立首次连接
点击连接按钮，等待状态由「连接中」变为「已连接」。首次握手时间略长属于正常现象，后续连接会明显加快。
第 5 分钟：验证连通性与速度
打开常用网页确认访问正常，并在应用内查看实时速率。若速率偏低，可更换节点或切换协议模式再测一次。
Chalkboard
出烤箱前的自检小黑板
安装完成后，对照下面这份清单逐项确认，能提前发现绝大多数潜在问题。
Installation Checklist
安装包来源为官方域名✓ 已确认
系统版本满足最低要求✓ 已确认
必要权限已授予✓ 已确认
网络配置允许修改✓ 已确认
首次连接状态显示已连接✓ 已确认
实时速率处于正常区间✓ 已确认
协议模式已了解并选择✓ 已确认
Myth Busting
常见误区辟谣：别把好面包烤糊了
关于下载与安装，网络上流传着不少说法。下面三条是最常被问到的误区，我们逐一给出正解。
误区安装包越大，功能越完整
正解安装包体积与功能完整度没有直接关系。官方安装包经过压缩与精简，体积更小反而说明冗余组件少。体积异常大的安装包更值得警惕，可能被捆绑了第三方内容。
误区安装失败一定是网络问题
正解安装失败的原因很多，权限不足、磁盘空间不足、安全软件拦截、安装包损坏都可能导致。建议先查看安装日志中的具体报错代码，再针对性处理。
误区手动修改协议参数能显著提速
正解自研传输协议已内置智能调度，会根据实时网络状况自动调整。随意修改底层参数反而可能破坏自适应逻辑，导致连接不稳。建议保持默认配置。
Knowledge
行业知识科普：烘焙原理小课堂
了解几个基础概念，能帮助你更好地理解安装与连接过程中发生的事情。
什么是自研传输协议
传输协议决定了数据在客户端与服务器之间的封装、校验与调度方式。自研协议通常针对特定网络环境做了拥塞控制与重传策略优化，在高延迟或抖动较大的网络下表现更稳定。想深入了解可阅读协议原理解析。
为什么首次连接更慢
首次连接需要完成密钥协商、线路探测与节点握手，相当于「预热烤箱」。这些结果会被缓存，后续连接直接复用，因此速度会明显提升。若长期很慢，则可能是节点或本地网络问题。
安装包签名有什么用
数字签名用于验证安装包的来源与完整性。系统在安装时校验签名，可防止文件被篡改。这也是为什么部分系统会拦截「未验证开发者」的应用，属于正常的安全机制，而非软件本身有问题。
Local Ovens
地域与本地服务：就近出炉更香
节点距离越近，握手与传输的往返时延越低。我们在多个城市部署了接入节点，建议优先选择物理距离较近的线路。
选择节点时不必只盯着「最快」标签，实际体验还受本地运营商、时段与跨境链路影响。建议在高峰与低峰各测一次，选出稳定性最好的线路长期使用。若所在城市不在列表中，可选择邻近区域节点，通常差异不大。
安装时提示「文件已损坏」或「无法打开」怎么办？
先确认安装包是否下载完整，可重新从官方域名下载一次。macOS 用户若遇到「无法验证开发者」，请在系统设置的隐私与安全性中点击「仍要打开」。Windows 用户可右键安装包，在属性中勾选「解除锁定」后再运行。
安装完成后无法建立首次连接怎么办？
依次检查：是否授予了网络配置权限、系统防火墙是否拦截、节点是否可用。可尝试切换节点或重启应用。若仍失败，请查看应用内日志中的错误码，并参考常见问题页面的对应条目处理。
为什么安装包会被安全软件拦截？
部分安全软件对未经其白名单收录的安装行为较为敏感，属于正常提示。请确认安装包来源为官方域名后，将其临时加入信任列表再安装，安装完成后恢复原有安全策略即可。
自研传输协议需要手动开启吗？
默认已启用智能模式，会根据网络状况自动选择策略，一般无需手动干预。若你希望固定使用某种模式，可在设置的协议选项中切换。具体原理可阅读自研传输协议原理解析。
如何确认自己下载的是官方版本？
请核对下载页面域名是否为 quickq.cafe，并检查安装包的数字签名信息。官方版本不会要求关闭系统安全防护，也不会索取与功能无关的权限。更多技术动态可关注技术动态与行业资讯。
Fresh From Oven
最新资讯 · 新鲜出炉
最近一周的安装与协议相关动态，帮助你及时了解版本变化与使用建议。
安装引导流程优化上线
新版安装向导增加了权限检查提示，安装过程中若缺少必要权限会直接标注，减少安装后无法连接的返工情况。
Windows 安装包体积进一步精简
通过移除冗余组件，Windows 安装包体积有所下降，下载与安装速度提升，功能保持完整。
macOS 权限引导说明更新
针对「无法验证开发者」提示，帮助文档补充了更清晰的分步截图说明，新用户可对照操作完成授权。
节点延迟显示精度提升
节点列表中的延迟数值更新频率提高，选择线路时可以更及时地看到实时变化，便于挑选稳定节点。
自研传输协议握手策略调整
首次连接的握手流程做了小幅优化，弱网环境下的首次连接成功率有所提升，详细说明见技术动态页。
移动端后台保活建议发布
针对 Android 与 iOS 的后台清理机制，整理了一份保活设置建议，帮助减少连接被系统中断的情况。