Ignis 部署经验

概述

Ignis 是一个开源的自托管 Web 应用，可以在浏览器中运行 Obsidian 笔记软件，无需远程桌面，提供接近原生的使用体验。

核心特点

• 自托管：可以在自己的服务器或 NAS 上部署
• 原生 Web 体验：不是屏幕投影或远程桌面，而是完整的 Web 应用交互
• Docker 部署：使用 Docker Compose 部署
• 多 Vault 支持：支持创建、打开、切换、重命名、删除 Vault
• 实时同步：通过 WebSocket 在标签页之间实时同步
• 插件支持：支持大多数社区插件

部署步骤

1. 安装 Docker

1
2

curl -fsSL https://get.docker.com | sh
systemctl enable --now docker

2. 创建配置目录

1

mkdir -p /opt/ignis/vaults /opt/ignis/data

3. 创建 docker-compose.yml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

services:
  ignis:
    image: nobbe/ignis:latest
    container_name: ignis
    ports:
      - "8080:8080"
    environment:
      - PUID=1000
      - PGID=1000
    volumes:
      - /root/wiki:/vaults/wiki
      - ./data:/app/data
      - obsidian-app:/app/obsidian-app
    restart: unless-stopped

volumes:
  obsidian-app:

4. 启动 Ignis

1

cd /opt/ignis && docker compose up -d

踩坑记录

问题 1：软链接覆盖

问题描述：容器内 /vaults/wiki 是软链接，不是真实目录。

原因：/opt/ignis/vaults 目录下有软链接 wiki -> /root/wiki，Docker 挂载时被软链接覆盖。

解决方案：去掉 ./vaults:/vaults 挂载，只保留 /root/wiki:/vaults/wiki 挂载。

问题 2：文件系统只读

问题描述：Docker 机器的文件系统是只读的（emergency_ro 模式）。

原因：Proxmox VE 虚拟机的文件系统问题。

解决方案：在主机上部署 Ignis，而不是在 Docker 机器上。

配置说明

访问方式

• 本地访问：http://localhost:8080
• 公网访问：需要配置反向代理（如 Lucky）+ SSL

相关链接

• Ignis 官方文档
• GitHub 仓库
• Docker Hub