retorquere/zotero-pkg · 上手攻略
- 仓库：retorquere/zotero-pkg
- 链接：https://github.com/retorquere/zotero-pkg
- 分类：学术工具 / Linux 发行版包管理
- 作者：Tom
- 更新：2026-08-23
是什么
zotero-pkg 是由社区开发者 retorquere 维护的 Zotero（以及 Juris-M）Debian/Ubuntu 系 Linux 系统包仓库。它将 Zotero 官方 tarball 打包成 .deb 包，提供系统级安装（/usr/lib/zotero）和完整的桌面文件注册、MIME 类型关联，并在 Zotero 发布新版本后 2 小时内同步更新。
同时支持 Nix 包，可在 Nix 环境下直接运行，无需 apt。
解决什么问题
Zotero 官方仅提供 tarball（.tar.bz2）下载，Linux 用户需要手动解压、创建桌面文件关联、配置 MIME 类型，升级时也要手动重复这些步骤。系统自带的 Zotero 包（Debian 官方仓库）长期停滞在旧版本，且 Zotero 依赖的 Node 部分与 Debian 官方包不兼容。
zotero-pkg 解决了 Linux 用户用 apt 管理 Zotero 的需求，让安装/更新/卸载都与普通软件一样简洁。
快速安装
标准方式（curl/wget 一键）
# 安装脚本会自动添加 apt 源和签名密钥
wget -qO- https://raw.githubusercontent.com/retorquere/zotero-pkg/master/install.sh | sudo bash
# 或用 curl
curl -sL https://raw.githubusercontent.com/retorquere/zotero-pkg/master/install.sh | sudo bash
# 更新包列表并安装
sudo apt update
sudo apt install zotero
安装脚本会请求 sudo 权限，用于添加 apt 源和签名密钥到 keyring。执行后 Zotero 出现在应用菜单。
若之前用 tarball 安装过
安装前建议清理旧桌面文件，避免冲突：
rm ~/.local/share/applications/zotero.desktop
安装 Beta 版（夜间构建）
# 添加源后
sudo apt install zotero-beta
Beta 版可与稳定版共存，互不影响。
Nix 方式（无需 apt）
# 首次需要安装 Nix
# https://nixos.org/download/#nix-install-linux
# 使用 retorquere 预构建缓存（无需从源码构建）
nix run github:retorquere/zotero-pkg#zotero # 稳定版
nix run github:retorquere/zotero-pkg#zotero-beta # Beta 版
# 持久安装到 nix profile
nix profile install "github:retorquere/zotero-pkg#zotero"
Nix 方式不修改系统配置，文件存于临时缓存，卸载不影响系统。
卸载
# 下载并执行卸载脚本
wget -qO- https://raw.githubusercontent.com/retorquere/zotero-pkg/master/uninstall.sh | sudo bash
# 彻底删除包
sudo apt-get purge zotero
核心用法
常规升级
sudo apt update && sudo apt upgrade
通过此包安装的 Zotero 关闭了内置自动更新（self-update facility disabled），完全依赖系统包管理器推送更新。新版本发布后通常 2 小时内可从 apt 收到。
验证安装
# 查看版本
zotero --version
# 或打开图形界面确认
zotero
签名密钥问题
若 apt 安装时签名验证失败（Debian 系 key format 变更），重新运行安装脚本即可：
wget -qO- https://raw.githubusercontent.com/retorquere/zotero-pkg/master/install.sh | sudo bash
若想使用新的 deb822 源格式（sources 文件而非 list），加 -m sources 参数：
curl -sL https://raw.githubusercontent.com/retorquere/zotero-pkg/master/install.sh | sudo bash -s -- -m sources
Crostini Chromebook 支持
Chromebook Linux（Crostini）用户参见 项目 Wiki。
典型适用场景
- Debian/Ubuntu/Linux Mint 用户：不想手动管理 Zotero tarball，习惯用 apt 统一管理
- 学术写作用户：需要稳定、方便更新的 Zotero，配合 Zotero 插件（Better BibTeX、JabRef 等）使用
- 需要 Beta 测试：
zotero-beta包可直接安装夜间版，体验最新功能 - NixOS 用户：系统包管理器不提供 Zotero，用 Nix 方式运行预构建二进制
坑与注意
⚠️ 自更新被禁用：通过 apt 安装的 Zotero 无法从 Zotero 菜单内自动更新（Settings→Advanced→General→Software Update 不可用）。必须通过 sudo apt upgrade 更新，这是设计选择，避免破坏系统包管理。如果需要内置更新功能，请用官方 tarball 手动安装。
⚠️ 与 Zotero 官方包差异：此包提供的是官方 Zotero 团队构建的完整 Zotero 二进制包，并非重新打包 Debian 官方的旧版本，质量与官方一致。
⚠️ 签名密钥兼容性：Debian 系 key format 历史上多次变更，若安装后 apt update 报签名错误，re-run 安装脚本是标准解决方案。
⚠️ 卸载后数据保留：apt purge 只删除程序本身，Zotero 附带的数据库（~/Zotero/）和插件不会被删除，重装后配置完全保留。
⚠️ Chromium Crostini 环境：部分 Crostini 容器默认不包含 FUSE，AppImage 方式安装时需用 --appimage-extract-and-run，但 zotero-pkg 的 apt 包不依赖 AppImage，所以 Crostini 用户直接用 apt 安装即可。
与同类对比
| 方案 | 优点 | 缺点 |
|---|---|---|
| 官方 tarball | 官方原版，无依赖问题 | 手动管理，升级麻烦 |
| zotero-pkg（apt） | apt 管理，自动更新，系统集成好 | 关闭内置自更新，需 sudo |
| Debian 官方包 | 系统自带 | 版本老旧，长期不更新 |
| PPA（cogscinl） | Ubuntu 生态内 | 版本不如 zotero-pkg 新 |
| Nix（zotero-pkg） | 不改系统配置，可与 apt 版共存 | Nix 生态有门槛 |
对于 Debian/Ubuntu 用户，zotero-pkg 是最推荐的安装方式——系统集成完整，更新及时，维护者响应活跃（Zotero 新版发布后 2 小时内同步）。
一句话推荐结论
Linux Debian/Ubuntu 发行版用户必装，一行命令解决 Zotero 升级难题，与系统包管理器无缝集成，告别手动 tarball 维护。
⚠️ 关键未核实项：官方 Zotero 对 Debian 官方仓库长期停更的具体原因（Zotero 使用 Firefox 组件的历史兼容问题），以及 retorzere 包与 Zotero 最新版 v7.x 的兼容性细节，请以 GitHub releases 为准。Nix 方式为实验性支持，预构建缓存依赖 retorzere 个人 Cachix，如缓存失效需从源码构建（较慢）。