Homelab 搭建手记（5）Obsidian 与 Zotero Linux 部署
创建于 2026-06-21
更新于 2026-06-21
科技
Obsidian
Homelab
Debian
Zotero
3903 字 · 约 14 分钟

前言

知识管理是 Homelab 的核心用途之一。Obsidian 是基于 Markdown 的笔记工具，之前在 Obsidan 日记、记账与自动同步 中记录了 Windows 下的完整配置，包括 Templater 模板、Dataview 数据查询、Remotely Save 同步等。Zotero 则是文献管理工具，支持论文收集、标注和引用，是学术工作流的核心组件。两个工具配合使用，前者管理日常笔记和知识图谱，后者管理文献和引用，形成完整的个人知识管理体系。

现在需要在 Debian 服务器上也部署这两个工具，为后续与本地大模型、RAGFlow 等智能体服务对接打下基础。本文聚焦于 Linux 下的官方安装方式和基础 CLI 使用，插件配置和模板设置不再赘述。

一、Obsidian 安装

1.1 安装方式

Obsidian 官方提供 AppImage、Snap、Deb、Flatpak 四种 Linux 安装方式。考虑到 Debian 系统的兼容性和包管理的一致性，选择官方提供的 Deb 包进行安装。

bash
1
2
3
4
5
6
7
8
# 下载官方 Deb 包
wget https://github.com/obsidianmd/obsidian-releases/releases/download/v1.12.7/obsidian_1.12.7_amd64.deb

# 安装
sudo dpkg -i obsidian_1.12.7_amd64.deb

# 修复依赖（如果有缺失）
sudo apt install -f

注意：版本号可能会更新，安装前请前往 Obsidian 下载页面 确认最新版本。

1.2 CLI 激活

Obsidian 的 CLI 默认未启用。首次安装后需要在 Obsidian 图形界面中激活：设置 → 通用 → 命令行接口，点击启用并按照提示将 CLI 链接到系统 PATH（Linux 下会链接到 ~/.local/bin/obsidian）。

注意：CLI 启用后需要重启终端才能生效。

1.3 基础 CLI 使用

Obsidian CLI 是一个功能完整的命令行工具，支持子命令模式操作。在 SSH 远程场景下尤其有用，可以直接在终端中管理笔记库，无需依赖图形界面。

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 查看版本
obsidian version

# 列出已知的 vault
obsidian vaults

# 查看当前 vault 信息
obsidian vault

# 打开今天的日记
obsidian daily

# 搜索笔记
obsidian search query="关键词"

# 创建新笔记
obsidian create name="笔记标题" content="初始内容"

# 读取当前文件
obsidian read

# 列出所有标签及使用次数
obsidian tags counts

# 在日记末尾追加内容
obsidian daily:append content="- [ ] 待办事项"

Obsidian CLI 还支持插件管理（obsidian plugins）、主题管理（obsidian themes）、文件历史（obsidian history）等功能，完整命令列表可通过 obsidian help 查看。在远程桌面或 SSH 场景下，CLI 方式比图形界面启动更灵活，也可以配合 cron 或 systemd 实现自动化笔记操作。

1.4 Vault 同步方案

在 Homelab 场景下，Obsidian 的笔记同步可以通过以下方式实现：

方案 原理 优点 缺点
Syncthing 去中心化点对点同步 无第三方依赖、速度快 需要两端同时在线
Git 版本控制 + 云端同步 有版本历史、可回溯 二进制附件不友好
Remotely Save 插件 WebDAV / S3 / iCloud 跨平台、手机端可用 依赖第三方存储
Obsidian Sync 官方付费服务 端到端加密、最稳定 收费

原文中使用的 Remotely Save 插件基于坚果云 WebDAV 的方案在 Linux 上同样适用。如果追求去中心化和更快的同步速度，推荐后续部署 Syncthing。

二、Zotero 安装

2.1 安装方式

Zotero 官方 Linux 安装方式为下载编译好的 tarball。官方不提供 .deb 包，社区维护的 zotero-deb 虽然推荐用于 Debian 系统，但不在官方支持范围内。按照 官方安装文档 指引，选择 Official Tarball 方式安装。

与 Obsidian 不同，Zotero 的 tarball 安装不需要 sudo 权限。安装到用户目录 ~/.local/opt/zotero 即可，和 Node.js（fnm）、Go 等用户级工具保持一致的安装模式。

  1. 前往 Zotero 下载页面 下载 Linux 64-bit 版本（当前为 Zotero 9）。

    bash
    1
    2
    # 下载 Zotero tarball（当前格式为 .tar.xz，版本号以实际页面为准）
wget https://download.zotero.org/client/release/9.0.4/Zotero-9.0.4_linux-x86_64.tar.xz

  2. 解压并将目录移动到用户目录。

    bash
    1
    2
    3
    4
    5
    # 解压
tar -xJf Zotero-9.0.4_linux-x86_64.tar.xz

# 移动到用户目录（无需 sudo）
mv Zotero_linux_x86_64 ~/.local/opt/zotero

  3. 运行 set_launcher_icon 脚本更新 .desktop 文件中的图标路径（.desktop 文件要求绝对路径）。

    bash
    1
    2
    cd ~/.local/opt/zotero
./set_launcher_icon

  4. 创建符号链接到 ~/.local/share/applications/，使其出现在应用启动器中。

    bash
    1
    ln -s ~/.local/opt/zotero/zotero.desktop ~/.local/share/applications/zotero.desktop

  5. 启动 Zotero。

    bash
    1
    ~/.local/opt/zotero/zotero

注意：Zotero 更新后可能需要重新运行 set_launcher_icon 脚本。如果启动器中图标消失，删除旧的符号链接、等待几秒后重建即可。

2.2 Zotero Connector 配置

在浏览器中安装 Zotero Connector 扩展后，可以实现一键保存网页文献到本地 Zotero 库。在 Homelab 服务器上，如果通过 XRDP 远程桌面使用浏览器，Connector 同样可以正常工作。配置步骤：

  1. 在浏览器扩展商店搜索 Zotero Connector 并安装。
  2. 首次使用时，Connector 会自动检测 Zotero 客户端运行状态。
  3. 在 Zotero 设置中配置数据同步和文件同步（可选使用 WebDAV 自建同步服务）。

2.3 Zotero 数据目录

Zotero 默认将数据存储在用户目录下，建议将数据目录迁移到 /home 分区的独立位置，方便备份和管理：

bash
1
2
3
# 修改 Zotero 数据目录（在 Zotero 编辑 - 首选项 - 高级 - 文件和文件夹中设置）
# 默认路径：~/Zotero
# 建议路径：~/data/zotero

三、自动化安装脚本

上述手动安装步骤已整理为 Homelab 环境配置工具的模块脚本，支持一键安装和幂等性升级。这两个模块是 setup/ 仓库（homelab-setup）在Homelab 搭建手记（3）开发环境一键配置发布后新增的，编号为 14-obsidian 和 15-zotero。

3.1 使用方式

bash
1
2
3
4
5
6
# 通过 init.sh 执行（交互式菜单，会自动扫描 modules/ 下所有脚本）
cd setup && bash init.sh

# 直接执行单个模块
bash setup/modules/14-obsidian.sh
bash setup/modules/15-zotero.sh

3.2 脚本特性

特性 Obsidian Zotero
编号 14-obsidian 15-zotero
安装方式 官方 Deb 包 官方 Tarball
安装路径 系统级（dpkg） 用户级 ~/.local/opt/zotero
需要 sudo 是 否
版本检测 GitHub API 下载页面 JSON
自动升级 版本不同则下载新 Deb 安装 版本不同则下载新 Tarball 替换
缓存 cache/obsidian/ cache/zotero/
桌面快捷方式 系统自动管理 set_launcher_icon + 符号链接

3.3 脚本实现要点

两个脚本都遵循 setup/ 仓库的模块规范（详见Homelab 搭建手记（3）开发环境一键配置）：

  • 公共函数统一使用 common.sh 中的 ensure_sudo、log_info、run_with_optional_proxy 等
  • 幂等性检查：已安装且版本一致则跳过，版本不同则自动升级
  • 安装包缓存在 $CACHE_DIR/<tool>/，重复执行不重复下载
  • Zotero 特殊处理：下载页面是 JS 动态渲染，版本号从页面内嵌的 JSON 数据中提取；下载链接通过重定向获取实际 tar.xz 地址（非 tar.bz2）；安装到用户目录无需 sudo

四、总结

本文记录了 Obsidian 和 Zotero 在 Debian 系统上的官方安装方式。两者都是知识管理的核心工具，Obsidian 专注于笔记和知识图谱，Zotero 专注于文献管理和引用。后续文章会继续搭建 Syncthing 同步方案，将 Windows 端和 Debian 端的笔记库打通。

参考

本文作者: 有次元袋的 tiger
本文链接: https://www.superheaoz.top/2026/06/38032/
版权声明: 本站点所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 我的个人天地！
手机扫码阅读