uname -m 显示 aarch64，能装哪个包？
应选择 aarch64（ARM 架构）对应的 DEB 包；x86_64 的安装包无法在 ARM 机器上运行。先运行 uname -m 确认输出，再到QuickQ 下载中心选择与输出一致的架构版本下载。
QuickQ 客户端下载
QuickQ Linux 安装环境、依赖与连接排查
Linux 安装的核心原则只有一条：环境确认优先于安装。发行版、系统架构、桌面环境与依赖是否就绪，直接决定安装命令能不能跑通、QuickQ 客户端能不能启动。本文先教你用几条命令把环境看清，再给出 DEB 包的安装命令与典型输出，重点放在「怎么读输出、判断成功还是失败」上，最后是连接状态查看、日志位置与权限问题的排查。QuickQ 客户端当前为 v3.21，提供 Ubuntu 与 Debian 等发行版使用的 DEB 安装包，安装约占用 200MB 磁盘。全程通常 10 到 15 分钟，每一步都用命令输出作为判断依据。
先确认环境：发行版、架构与桌面
在终端依次运行下面三条命令，把输出记录下来，再对照官网下载页选择对应的安装包。三条命令分别回答：你用的是什么发行版、什么架构、是否在图形桌面里。
查看发行版
$ cat /etc/os-release NAME="Ubuntu" VERSION="22.04 LTS" ID=ubuntu PRETTY_NAME="Ubuntu 22.04 LTS"
输出中的 PRETTY_NAME 即发行版名称与版本。QuickQ Linux QuickQ 客户端提供适配 Ubuntu 与 Debian 等发行版的 DEB 包；其他基于 Debian 的发行版通常也可尝试安装，但依赖补齐方式略有差异。
查看系统架构
$ uname -m x86_64
x86_64 表示 64 位 PC 架构；aarch64 表示 ARM 架构（常见于部分开发板与 ARM 笔记本）。架构必须与安装包文件名中的架构一致，装错架构会直接无法运行。
确认桌面环境
$ echo $XDG_CURRENT_DESKTOP GNOME
有输出且为 GNOME、KDE 等桌面环境名称，说明当前处于图形桌面，QuickQ 客户端可以正常启动窗口。纯命令行服务器（无图形界面）上运行图形QuickQ 客户端没有意义，这类场景请先确认使用需求。
三项确认无误后，再前往QuickQ 下载中心下载与架构对应的 DEB 安装包。
下载 DEB 包并安装
假设安装包已下载到当前目录，文件名为 quickq_3.21_amd64.deb（按你实际下载的文件名替换）。安装分两步：先尝试直接安装，若提示依赖缺失，再用系统包管理器自动补齐。
第一步：直接安装
$ sudo dpkg -i quickq_3.21_amd64.deb [sudo] password for youruser: 正在选中未选择的软件包 quickq。 正在解压 quickq (3.21) ... dpkg: 依赖关系问题使得 quickq 的配置工作不能继续： quickq 依赖于 libxxx；然而：未安装软件包 libxxx。
出现「依赖于……未安装」这类提示是预期内的情况，不是安装失败，直接进入第二步即可。
第二步：自动补齐依赖后重装
$ sudo apt-get install -f 正在读取软件包列表... 完成 正在设置 libxxx (版本号) ... $ sudo dpkg -i quickq_3.21_amd64.deb 正在设置 quickq (3.21) ... 正在处理用于 man-db 的触发器...
apt-get install -f 会根据上一步记录的缺失项自动下载并安装依赖；完成后重新执行 dpkg -i，看到「正在设置 quickq」即表示安装成功。
安装包只从官网获取，不要使用来源不明的第三方仓库版本。整个过程约占用 200MB 磁盘空间。
如何读懂命令输出
Linux 排查的关键能力是「读输出」。同一段输出里，哪些是正常提示、哪些是真正的报错，对照下表判断，不要一看到英文就重装。
| 输出特征 | 含义 | 下一步 |
|---|---|---|
| 「正在设置 quickq」且无后续报错 | 安装成功 | 启动QuickQ 客户端，进入QuickQ 登录环节 |
| 「依赖关系问题……依赖于 libxxx 未安装」 | 缺依赖，可自动修复 | 运行 sudo apt-get install -f，再重装一次 |
| 「无法安装架构 amd64 的软件包」 | 架构不匹配 | 用 uname -m 确认架构，换对应版本的 DEB 包 |
| dpkg 提示「被中断的需要 -f 的安装」 | 上次安装未完成 | 先运行 sudo apt-get install -f 修复状态，再继续 |
| Could not get lock /var/lib/dpkg | 另一个包管理器正在运行 | 等待软件中心或更新进程结束后再执行 |
判断原则：错误信息落在「依赖、锁、架构」三类时都有明确的下一步；只有提示与安装包本身损坏有关时，才回到下载环节重新获取。
启动、登录与连接状态查看
安装成功后，从应用菜单找到 QuickQ 图标启动，或在终端直接运行：
$ quickq （QuickQ 客户端窗口弹出，进入登录界面）
登录使用注册或购买时登记的账号。登录后先确认QuickQ 套餐与剩余期限——QuickQ 套餐总体支持 3–5 台设备同时使用，具体上限以套餐价格页面为准；登录异常参考账号登录失败与权益异常处理指南。
连接状态以QuickQ 客户端窗口显示为准，同时可以配合两条命令做辅助确认：
$ ps aux | grep -i quickq youruser 12345 0.5 ... quickq $ firefox https://example.com
前者确认进程在运行，后者用浏览器打开日常网页做真实验证。「已连接」加上「网页能打开」两个条件同时满足，才算连接验证通过。更换线路或连接优化的思路与桌面端一致，可参考macOS 安装、授权与首次连接指南中的验证方法。
日志位置与权限问题
连接异常时，日志比反复重装更有用。QuickQ 客户端的日志通常保存在当前用户目录下的配置目录中，按下面的顺序查找：
- 配置目录：在文件管理器或终端进入 ~/.config 与 ~/.local/share，查找名称含 QuickQ 的目录，日志文件一般以 .log 结尾。
- 运行权限：QuickQ 客户端以普通用户身份运行即可，不需要 sudo 启动；如果曾用 sudo 启动导致配置目录归属异常，chown 回当前用户或删除异常的配置目录后重启QuickQ 客户端。
- 网络前置检查：先断开QuickQ 客户端，确认浏览器能正常打开网页；基础网络不通时，先恢复系统网络再谈QuickQ 客户端问题。
- 记录再求助：联系客服前，记录 dpkg 的报错输出、连接发生时间、使用的线路；涉及账号的截图先遮盖邮箱与手机号。
Windows 与移动端的安装说明分别见Windows 安装与使用教程和Android 安装、授权与后台连接排查，常见问题汇总在常见问题中。
常见问题（FAQ）
dpkg 安装时报「依赖关系无法满足」怎么办？
这是常见且可自动修复的提示。运行 sudo apt-get update 刷新软件源，再运行 sudo apt-get install -f，系统会自动下载缺失的依赖；完成后重新执行 dpkg -i 安装即可。不要因此换用来源不明的安装包。
安装完成后在应用菜单里找不到QuickQ 客户端？
先确认 dpkg 安装返回成功。可在终端直接输入 quickq 尝试启动；仍找不到时，运行 dpkg -L quickq 查看安装路径。桌面环境不同，应用菜单的收录可能有延迟，注销重新登录一次通常即可看到。
命令行下怎么确认客户端是否在运行？
运行 ps aux | grep -i quickq，能看到对应进程说明客户端在运行。图形界面的连接状态以客户端窗口显示为准；配合浏览器打开日常网页做真实验证，不要只凭进程存在就判断连接正常。
连接异常时日志在哪里看？
客户端日志位于用户目录下的配置目录（通常为 ~/.config 或 ~/.local 下的 QuickQ 相关目录）。联系客服前，记录命令输出的关键报错、发生时间与使用的线路，并按提示遮盖个人账号信息后再提供。
更多问题请查看常见问题；版本、依赖与兼容性以官网正式发布资料为准，其他平台指南见QuickQ 帮助中心。