diagrams.net Docker 镜像使用指南

简介

diagrams.net（原 draw.io）是一款免费在线图表工具，可用于绘制流程图、网络图、UML 图、ER 图、数据库架构图、BPMN 图、电路图等，支持导入 .vsdx、Gliffy™ 和 Lucidchart™ 文件。

本仓库包含以下内容：

• 与 diagrams.net 版本同步更新的 Docker 镜像
• 导出服务器镜像（支持将 diagrams.net 图表导出为 PDF 和图片）
• 用于运行 diagrams.net 及导出服务器的 docker-compose 配置
• 集成 Nextcloud 的 docker-compose 配置
• 独立运行配置（无需依赖 diagrams.net 官网，包含导出服务器、PlantUML、Google Drive/OneDrive 支持及 EMF 转换支持（用于 VSDX 导出））

镜像说明

Dockerfile 基于 tomcat:9-jre11 构建（详见 Docker Hub tomcat 镜像）。

注意：自 16.5.3 版本起，不再维护 alpine 和 debian 镜像，统一使用单一镜像以减少安全漏洞。
本项目从 fjudith/draw.io fork 而来。

功能特性

• 基于 Tomcat 构建，可直接部署或通过反向代理使用
• 自动生成自签名 SSL 证书
• 支持 Let's Encrypt 证书自动生成
• 支持将 SSL Keystore 挂载至 /user/local/tomcat/.keystore

快速启动

运行容器

执行以下命令启动 diagrams.net 容器：

docker run -it --rm --name="draw" -p 8080:8080 -p 8443:8443 jgraph/drawio

访问服务

• 本地环境：在浏览器中访问
  [***] （HTTP）或 [***]
• Docker Toolbox 环境：访问
  [***] 或 [***]

参数说明：?offline=1 是安全特性，启用后将禁用云存储支持。

环境变量配置

通过环境变量可自定义容器行为，变量说明如下：

配置 Let's Encrypt SSL 证书

前提条件

1. Linux 服务器需联网，且开放 80（HTTP）和 443（HTTPS）端口
2. 已注册域名/子域名，并将其解析至服务器 IP（例如 drawio.example.com）

配置步骤

1. 创建目录：用于存储 Let's Encrypt 数据（日志、配置、证书）

   mkdir -p /opt/docker/drawiodata/letsencrypt-log /opt/docker/drawiodata/letsencrypt-etc /opt/docker/drawiodata/letsencrypt-lib
   

2. 启动容器：运行以下命令生成并配置 Let's Encrypt 证书

   docker run -it -m1g \
     -v "/opt/docker/drawiodata/letsencrypt-log:/var/log/letsencrypt/" \
     -v "/opt/docker/drawiodata/letsencrypt-etc:/etc/letsencrypt/" \
     -v "/opt/docker/drawiodata/letsencrypt-lib:/var/lib/letsencrypt" \
     -e LETS_ENCRYPT_ENABLED=true \
     -e PUBLIC_DNS=drawio.example.com \  # 替换为你的域名
     --rm --name="draw" \
     -p 80:80 -p 443:8443 \  # 80端口供 certbot 验证，443映射容器8443（Tomcat HTTPS端口）
     jgraph/drawio
   

修改 diagrams.net 配置

容器配置通过 DRAWIO_* 环境变量管理，例如启用 Google Drive/OneDrive 集成等。具体变量列表可查看仓库 main 目录下的 docker-entrypoint.sh 文件。

参考链接

• diagrams.net ***仓库