QzoneArchive安装教程：Windows、macOS、Linux、Android与NixOS一键安装全平台覆盖

QzoneArchive 是一款将 QQ 空间历史动态、照片、视频与互动记录安全归档到本地的开源桌面 / 移动端工具。本教程覆盖 Windows、macOS、Linux、Android 与 NixOS 五大平台的安装步骤，全程无需编译，从官方 Releases 下载对应安装包即可一键安装，适合第一次使用 QQ 空间归档工具的新手。

第一步：从 Releases 下载对应系统的安装包

所有平台都只需要一个动作：打开项目的 Releases 发布页，找到与你系统匹配的安装包（版本以页面最新为准）。官方安装说明见 website/install/index.md。

平台	安装包格式	说明
Windows	.exe	NSIS 安装程序，需 Windows 10 及以上
macOS	.dmg	区分 Intel / Apple Silicon 两款
Android	.apk	侧载安装
Linux	.deb / .rpm / .AppImage	按发行版三选一
NixOS	.tar.gz 一键包	含预构建 Nix store，一条命令装完

💡 请只从项目官方 Releases 页面获取安装包，不要使用来路不明的第三方渠道。

Windows 一键安装（.exe 安装程序）

1. 下载 .exe 安装程序并双击运行；
2. 按向导提示完成安装，桌面会出现应用图标。

系统要求 Windows 10 或更新版本，通常已自带 WebView2 运行时，无需额外安装。

macOS 安装（.dmg，区分芯片架构）

1. 根据设备芯片选择 Intel 或 Apple Silicon 对应的 .dmg 并双击打开；
2. 将应用拖入「应用程序」文件夹完成安装。

首次启动时，macOS 可能提示应用来自未知开发者。此时打开 系统设置 → 隐私与安全性，点击「仍要打开」即可。

Android 安装（.apk 侧载）

1. 下载 .apk 文件；
2. 允许浏览器或文件管理器「安装未知来源应用」；
3. 按提示完成安装，桌面出现应用图标即成功。

Android 端与桌面端功能一致，方便在手机上直接查看归档结果。

Linux 三种安装包，按发行版对号入座

每个 Release 提供三种 Linux 安装包，选其一即可（*.ext 代表你实际下载到的文件名）：

Debian / Ubuntu 系（.deb）

sudo apt install ./*.deb

apt 会自动联网补齐依赖，日常推荐使用；dpkg -i 只安装包本身，提示缺依赖时用 sudo apt-get install -f 补装。

Fedora / openSUSE / RHEL 系（.rpm）

sudo rpm -i *.rpm

其他发行版（.AppImage 绿色免安装）

chmod +x ./*.AppImage
./QzoneArchive*.AppImage

⚠️ 若提示 libfuse.so.2 错误（常见于 Ubuntu 24.04+），先 sudo apt install libfuse2，或改用 ./QzoneArchive*.AppImage --appimage-extract-and-run 免 FUSE 运行。AppImage 是绿色软件，删除文件即完成卸载。

NixOS 一键安装：一条命令搞定

NixOS 用户无需 AppImage / deb / rpm。每个 Release 提供二进制包 qzonearchive-nixos-x86_64-linux.tar.gz，内含预构建的完整 Nix store closure 与安装脚本：

tar -xzf qzonearchive-nixos-x86_64-linux.tar.gz && ./install.sh

脚本会把依赖导入 /nix/store 并安装到当前用户 profile，完成后在终端运行 qzonearchive 即可启动。

⚠️ 请务必运行包内的 ./install.sh，不要手动对解压目录执行 nix profile install 或直接运行二进制——应用依赖的 store 路径必须先由脚本导入。

如果你更倾向于源码构建，项目提供了 Nix Flake（见 flake.nix 与 nix/qzonearchive.nix），进入项目目录执行：

nix build
./result/bin/qzonearchive

安装后第一次启动：登录并开始归档

安装完成后启动应用，流程非常简单：

1. 阅读免责声明（本工具仅用于备份本人或已授权账号的资料）；
2. 使用 二维码登录 或桌面端的网页登录，全程不接触密码；
3. 打开「归档任务」页，确认网络与本地磁盘空间后开始归档；
4. 在「归档内容」与「媒体时光轴」中核验结果，必要时导出独立 HTML 文件。

常见问题速查（安装后遇到问题看这里）

问题	解决办法
安装包找不到包名（Linux 卸载时）	用 dpkg -l | grep qzonearchive 或 rpm -qa | grep qzonearchive 确认实际包名
macOS 打不开	「隐私与安全性」中允许未知来源应用
AppImage 报 libfuse 错误	安装 libfuse2 或用 --appimage-extract-and-run 运行
Linux 需要 QQ 客户端吗？	不需要，登录后扫描 QQ 空间二维码即可使用

数据说明：所有归档数据以 SQLite 保存在本机应用数据目录，不会上传任何服务器。卸载或迁移设备前，建议先导出 HTML 备份，详情见 website/data-and-safety/index.md。

按照以上步骤，你已经在自己的设备上装好了 QzoneArchive。更多功能与开发说明可参考 README.md 与 website/development/index.md，祝归档顺利！