ddsderek/excalidraw

ddsderek/excalidraw 镜像文档

镜像概述

ddsderek/excalidraw是一个容器化的Excalidraw协作绘图工具镜像，旨在提供简单、快速的部署方案。Excalidraw是一款轻量级、开源的手绘风格绘图工具，适用于创建流程图、架构图、思维导图等，支持实时协作功能。该镜像封装了Excalidraw应用及必要依赖，支持多架构部署，便于用户在不同环境中快速搭建绘图服务。

核心功能与特性

• 多架构支持：提供amd64架构专用镜像（latest标签）及ARM/v6、ARM/v7、ARM64/v8、ppc64le、s390x架构镜像（latest-other标签）
• 配置灵活：通过环境变量自定义时区、用户ID和组ID
• 数据持久化：支持挂载本地目录保存应用数据，避免容器重启后数据丢失
• 自动重启：默认配置为容器退出时自动重启，保证服务稳定性

使用场景

• 个人日常绘图需求（流程图、思维导图、草图等）
• 团队协作绘图（实时共享编辑）
• 临时演示环境搭建
• 开发/测试环境中的快速工具部署

使用方法与配置说明

架构选择

• amd64架构（如x86_64处理器的PC、服务器）：使用ddsderek/excalidraw:latest镜像
• 其他架构（ARM/v6、ARM/v7、ARM64/v8、ppc64le、s390x）：使用ddsderek/excalidraw:latest-other镜像

Docker Compose部署示例

amd64架构部署

yaml
version: '3.3'
services:
    excalidraw:
        ports:
            - '8063:80'  # 映射容器80端口到主机8063端口
        environment:
            - TZ=Asia/Shanghai  # 设置时区为上海
            - PUID=1000         # 运行容器的用户ID
            - PGID=1000         # 运行容器的组ID
        volumes:
            - './data:/app/web'  # 挂载本地data目录到容器内/app/web，实现数据持久化
        restart: unless-stopped  # 容器退出时自动重启（除非手动停止）
        image: 'ddsderek/excalidraw:latest'  # amd64架构镜像

其他架构部署（ARM/v6、ARM/v7、ARM64/v8等）

yaml
version: '3.3'
services:
    excalidraw:
        ports:
            - '8063:80'  # 映射容器80端口到主机8063端口
        environment:
            - TZ=Asia/Shanghai  # 设置时区为上海
            - PUID=1000         # 运行容器的用户ID
            - PGID=1000         # 运行容器的组ID
        volumes:
            - './data:/app/web'  # 挂载本地data目录到容器内/app/web，实现数据持久化
        restart: unless-stopped  # 容器退出时自动重启（除非手动停止）
        image: 'ddsderek/excalidraw:latest-other'  # 其他架构镜像

配置参数说明

端口映射

• 8063:80：将容器内的80端口映射到主机的8063端口，可根据需求修改主机端口（左侧数值）

环境变量

数据卷

• ./data:/app/web：本地目录./data挂载到容器内/app/web目录，用于持久化保存Excalidraw的配置和绘图数据。建议使用绝对路径或确保相对路径正确。

重启策略

• restart: unless-stopped：容器退出时自动重启，除非手动执行docker stop或docker-compose down停止容器。

启动与停止

1. 启动服务：在docker-compose.yml文件所在目录执行

   bash
   docker-compose up -d
   

2. 停止服务：

   bash
   docker-compose down
   

3. 查看日志：

   bash
   docker-compose logs -f
   

访问服务

服务启动后，通过浏览器访问 http://主机IP:8063 即可使用Excalidraw绘图工具。