hcyxsmile/obsidian-docker 基于 Linux 桌面栈运行 Obsidian，通过 Web VNC 端口提供图形界面，vault 目录需挂载以持久化 Markdown 库。属于 GUI/VNC 类 交互应用，资源占用高于纯 Web 编辑器，不适合 无图形会话的 Kubernetes Deployment。与 Obsidian Sync 官方方案相比自托管可控性更强；生产应限制 VNC 访问 IP、启用强密码，vault 卷定期备份。

快速启动

docker run -d --name obsidian \
  -p 6080:6080 \
  -v $(pwd)/vault:/vault \
  docker.io/hcyxsmile/obsidian-docker:latest

推荐实践

docker run -d --name obsidian \
  --restart unless-stopped \
  -p 6080:6080 \
  -v /data/obsidian/vault:/vault \
  -e VNC_PASSWORD=change-me \
  -e TZ=Asia/Shanghai \
  docker.io/hcyxsmile/obsidian-docker:1.5.0

核心参数说明

• -p 6080:6080 — noVNC Web 桌面入口
• -v /data/obsidian/vault:/vault — Obsidian 知识库目录
• -e VNC_PASSWORD — VNC 会话登录密码
• -e TZ — 笔记内时间戳时区
• --restart unless-stopped — 远程编辑会话持续可用
• 限制 — 需浏览器图形交互，非 headless API 服务