在 VPS 上用 Docker 部署 Obsidian GUI

在 VPS 上部署 Syncthing 同步 Obsidian 仓库 文章里聊到了把大脑搬上云端的宏观思路。除了用 Syncthing 这种纯文件同步的方式，其实还有一个更“偷懒”且直观的办法：

直接在 VPS 上跑一个 Obsidian 客户端。

为什么要这么干？因为我们大部分人的笔记其实都已经在云端了（比如用了 iCloud、官方 Sync 或者 Remotely Save 存在 S3 上）。如果我们能在 VPS 上打开 Obsidian，登录账号，让它自己把笔记“吐”出来，那数据同步的问题不就解决了吗？

而且，这样做还有一个巨大的红利：你白捡了一个 Web 版的 Obsidian。以后出门在外，随便找台电脑就能写笔记，不用担心同步冲突，因为你就是在编辑服务器上的母本。

第一步 准备 Docker Compose

确保你的 VPS 已经装好了 Docker。找个你喜欢的目录，直接创建一个 docker-compose.yml 文件。

为了不让你的私人笔记变成“全网公开读物”，我们在配置里加上了密码认证。

services:
  obsidian:
    image: lscr.io/linuxserver/obsidian:latest
    container_name: obsidian
    security_opt:
      - seccomp:unconfined # 解决 Electron 应用启动闪退的玄学问题
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - CUSTOM_USER=admin      # 网页登录用户名，随便改
      - PASSWORD=你的强密码     # 网页登录密码，千万别用默认的！
    volumes:
      - ./config:/config       # 存放插件和配置
      - ./vaults:/vaults       # 重点：这是笔记数据真正落地的地方
    ports:
      - 3000:3000
    restart: unless-stopped
    shm_size: "1gb"

复制进去，保存。然后一行命令启动：

docker compose up -d

第二步 初始化你的云端大脑

服务跑起来后，浏览器访问 http://你的IP:3000。输入刚才设置的账号密码，你会看到熟悉的 Obsidian 欢迎界面。

接下来的操作和你刚买了一台新电脑一模一样，但有一个关键点别选错：

1. 创建仓库：点击 Create new vault（创建新仓库）。
2. 选择路径（关键）：在仓库名称里随便填（比如 MyBrain），但在 Location（位置）这一栏，一定要点击 Browse，然后选择我们挂载进去的 /vaults 目录。
   • 注意：只有选这里，笔记文件才会真实地保存在你的 VPS 硬盘上。
3. 创建完毕：现在你拥有了一个空空如也的仓库。

第三步 把数据“骗”下来

现在这个空仓库已经建好了，接下来的任务就是把你在其他设备上的笔记同步过来。

这完全取决于你平时用什么同步：

• 官方 Sync 用户：直接在设置里登录账号，连接远程仓库，等待同步完成。
• Remotely Save / Livesync 插件：去设置里关闭安全模式，安装插件，填入你的 S3 配置，点击“拉取”。
• Git 用户：甚至可以在终端里直接 git clone。

见证奇迹的时刻

当同步进度条跑完，你会在浏览器里看到你熟悉的笔记目录、精心调教的主题、甚至那堆复杂的插件配置，全都完美复刻到了这个网页里。

但这还不是最爽的。

切回你的 SSH 终端，看一眼 ./vaults 目录。你会发现，所有的 Markdown 文件都已经实实在在地躺在了 VPS 的硬盘里。

这就意味着，原本封闭在云端数据库里的笔记，现在变成了 VPS 可以直接读取的本地文件。你的 AI 助手、自动化脚本，现在终于可以对你的知识库大展拳脚了。