pubuzhixing/drawnix Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

OpenWhiteboard 开源白板工具 Docker 镜像文档

1. 镜像概述和主要用途

1.1 概述

OpenWhiteboard 是一款开源的一体化在线白板工具（SaaS），提供可视化协作平台，支持思维导图、流程图、自由绘图等多种创作形式。该 Docker 镜像封装了完整的应用服务，可快速部署至本地服务器或云环境，无需复杂依赖配置。

1.2 主要用途

• 团队协作：支持多人实时在线协作，适用于头脑风暴、项目规划、需求评审等场景。
• 内容创作：提供多样化绘图工具，满足思维导图梳理、流程图设计、自由手绘等创作需求。
• 知识管理：支持内容导出与分享，可作为团队知识库或个人笔记工具使用。
• 教学演示：适用于线上/线下教学场景，通过可视化白板提升教学互动性。

2. 核心功能和特性

2.1 核心功能

• 思维导图：内置多种布局模板（树状、辐射状等），支持节点添加/删除/拖拽、样式自定义。
• 流程图：提供标准流程图符号库（起止框、处理框、判断框等），支持自动连线与布局调整。
• 自由绘图：模拟手绘体验，支持画笔、形状工具（矩形、圆形等）、文本标注、颜色填充。

2.2 扩展特性

• 多人实时协作：支持多用户同时编辑，实时同步光标位置与操作内容。
• 模板库：内置项目管理（如看板、甘特图）、教育（如教案框架）、设计（如用户旅程图）等场景模板。
• 内容导出：支持导出为 PNG、JPG、PDF 格式，或生成分享链接（支持密码保护）。
• 版本历史：自动记录编辑历史，支持回溯至任意版本。
• 第三方集成：可对接 Slack、Notion、GitHub 等工具，实现内容双向同步。

3. 使用场景和适用范围

3.1 典型使用场景

3.2 适用范围

• 用户类型：企业团队、教育机构（学校/培训机构）、自由职业者、个人用户。
• 部署环境：本地服务器、私有云（如阿里云 ECS、AWS EC2）、边缘计算设备（如树莓派）。

4. 使用方法和配置说明

4.1 前提条件

• 已安装 Docker Engine（20.10+）及 Docker Compose（v2+）。
• 服务器需开放应用端口（默认 8080，可自定义），并确保磁盘空间 ≥ 1GB（用于数据持久化）。

4.2 通过 docker run 快速部署

4.2.1 基础部署（内置 SQLite 数据库）

bash
docker run -d \
  --name openwhiteboard \
  -p 8080:80 \  # 主机端口:容器内端口（容器内默认 80）
  -v /opt/openwhiteboard/data:/app/data \  # 挂载数据卷（持久化白板内容、用户配置等）
  -e ADMIN_EMAIL="***" \  # 管理员***（首次登录账号）
  -e ADMIN_PASSWORD="SecurePass123!" \  # 管理员密码（需 ≥8 位，含大小写+数字）
  -e LOG_LEVEL="info" \  # 日志级别（debug/info/warn/error，默认 info）
  openwhiteboard:latest

4.2.2 高级部署（对接外部数据库）

若需使用 MySQL/PostgreSQL 作为外部数据库（适用于生产环境），需额外配置数据库连接参数：

bash
docker run -d \
  --name openwhiteboard \
  -p 8080:80 \
  -v /opt/openwhiteboard/data:/app/data \
  -e ADMIN_EMAIL="***" \
  -e ADMIN_PASSWORD="SecurePass123!" \
  -e DB_TYPE="mysql" \  # 数据库类型：mysql/postgres（默认 sqlite）
  -e DB_HOST="mysql-server" \  # 数据库主机地址（需与容器网络互通）
  -e DB_PORT="3306" \  # 数据库端口（mysql 默认 3306，postgres 默认 5432）
  -e DB_USER="whiteboard_user" \  # 数据库用户名
  -e DB_PASSWORD="db-pass-123" \  # 数据库密码
  -e DB_NAME="openwhiteboard" \  # 数据库名称（需提前创建）
  openwhiteboard:latest

4.3 通过 docker-compose 部署

4.3.1 单服务配置（内置 SQLite）

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  openwhiteboard:
    image: openwhiteboard:latest
    container_name: openwhiteboard
    restart: always  # 容器退出后自动重启
    ports:
      - "8080:80"  # 主机端口映射
    volumes:
      - ./data:/app/data  # 相对路径挂载数据卷（当前目录下 data 文件夹）
    environment:
      - ADMIN_EMAIL=***  # 管理员***（必填）
      - ADMIN_PASSWORD=SecurePass123!  # 管理员密码（必填）
      - PORT=80  # 容器内服务端口（默认 80，可自定义）
      - DATA_DIR=/app/data  # 数据存储目录（默认 /app/data）
      - LOG_LEVEL=info  # 日志级别
      - ENABLE_REGISTRATION=true  # 是否允许普通用户注册（默认 true）

启动服务：

bash
docker-compose up -d  # 后台启动
docker-compose logs -f  # 查看实时日志（确认服务启动成功）

4.3.2 多服务配置（含外部 MySQL）

若需使用外部数据库，可在 docker-compose.yml 中添加 MySQL 服务：

yaml
version: '3.8'
services:
  openwhiteboard:
    image: openwhiteboard:latest
    container_name: openwhiteboard
    restart: always
    ports:
      - "8080:80"
    volumes:
      - ./data:/app/data
    environment:
      - ADMIN_EMAIL=***
      - ADMIN_PASSWORD=SecurePass123!
      - DB_TYPE=mysql
      - DB_HOST=mysql  # 与下方 MySQL 服务名一致
      - DB_PORT=3306
      - DB_USER=whiteboard_user
      - DB_PASSWORD=db-pass-123
      - DB_NAME=openwhiteboard
    depends_on:
      - mysql  # 依赖 MySQL 服务启动后再启动应用

  mysql:
    image: mysql:8.0
    container_name: openwhiteboard-mysql
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=root-pass-123
      - MYSQL_DATABASE=openwhiteboard  # 预创建数据库
      - MYSQL_USER=whiteboard_user
      - MYSQL_PASSWORD=db-pass-123
    volumes:
      - ./mysql-data:/var/lib/mysql  # 持久化 MySQL 数据

4.4 环境变量配置说明

4.5 数据持久化

应用数据（白板内容、用户配置、数据库文件等）默认存储于容器内 /app/data 目录，需通过 Docker 数据卷挂载至主机目录（如 ./data:/app/data），避免容器重建后数据丢失。

5. 访问与验证

部署完成后，通过浏览器访问 http://<主机IP>:<映射端口>（如 [***]），使用配置的 ADMIN_EMAIL 和 ADMIN_PASSWORD 登录管理员账号，即可创建白板并开始使用。