zapfmeister/obsidian

Obsidian Kasm Workspaces 镜像文档

镜像概述和主要用途

本镜像为Obsidian（强大的知识库和笔记应用）提供自定义Kasm Workspaces环境，允许在Kasm Workspaces中直接运行Obsidian，提供专用且隔离的桌面体验，用于管理Markdown笔记。

核心功能和特性

• Obsidian集成：运行最新版本的Obsidian桌面应用。
• 自动更新：Docker镜像会自动检查并构建最新的Obsidian版本。
• Kasm Workspaces兼容性：针对Kasm Workspaces优化，确保无缝集成。
• 持久化存储：支持Kasm的持久化功能，使Obsidian笔记库和设置可跨会话保存。

使用场景和适用范围

适用于需要在Kasm Workspaces环境中使用Obsidian进行笔记管理的用户，尤其适合需要隔离工作环境、跨设备访问笔记或团队协作管理知识库的场景。

详细使用方法和配置说明

通过Kasm Registry安装（推荐）

将Obsidian工作区添加到Kasm Workspaces部署的最简单方法是通过Kasm Registry：

1. 添加Kasm Registry： 导航至Kasm Workspaces用户界面，进入工作区 -> 注册表，点击"添加注册表"并提供以下URL：

   https://zapfmeister.github.io/kasm-registry/
   

2. 安装Obsidian工作区： 注册表添加后，进入工作区 -> 工作区，点击"添加工作区"，此时应能看到来自"Zapfmeister Registry"的"Obsidian Desktop"工作区，点击"安装"即可添加到Kasm Workspaces。

3. 启动Obsidian： 安装成功后，在Kasm Workspaces用户门户中会显示"Obsidian"应用，点击启动即可使用预配置的Obsidian环境。

手动安装（高级用户或测试用）

对于偏好手动管理工作区的用户：

1. 克隆仓库：

   bash
   git clone https://github.com/Zapfmeister/kasm-registry.git
   

2. 定位工作区JSON文件： Obsidian的workspace.json文件位于： kasm-registry/workspaces/Obsidian/workspace.json

3. 手动部署： 将此workspace.json文件复制到Kasm Workspaces部署的workspaces目录（例如Kasm服务器上的/opt/kasm/current/conf/workspaces/）。确保Docker镜像zapfmeister/obsidian:latest（或特定版本标签）对Kasm部署可用，该镜像在https://hub.docker.com/r/zapfmeister/obsidian%E5%85%AC%E5%BC%80%E6%8F%90%E4%BE%9B%E3%80%82

笔记库的持久化存储

本镜像已配置为与Kasm的持久化存储良好配合。在Kasm中为Obsidian工作区启用持久化后，Obsidian笔记库、插件和设置将跨会话保存。

镜像可用性和构建过程

Obsidian Kasm Workspace的Docker镜像会自动构建和维护：

• 构建自动化：GitHub Actions工作流会自动检查Obsidian新版本，构建Docker镜像（zapfmeister/obsidian）并推送到https://hub.docker.com/r/zapfmeister/obsidian%E3%80%82
• 自动推送：当基础Dockerfile.obsidian或相关配置文件更新时，或按每日计划，会推送新镜像，确保始终提供最新稳定版Obsidian。
• 平台：镜像为linux/amd64架构构建。

贡献

欢迎贡献！如有改进建议或遇到问题，请提交issue或pull request。

许可

本项目开源，基于MIT许可证。

参考资料

• Zapfmeister Kasm注册表：https://zapfmeister.github.io/kasm-registry/
• Obsidian官方网站：[***]
• Obsidian GitHub发布页：https://github.com/obsidianmd/obsidian-releases
• Kasm Workspaces：[***]
• Selfh.st：[***]