ilovenaibao/drawio

diagrams.net Docker镜像文档

镜像概述和主要用途

diagrams.net（原draw.io）是一款免费在线图表软件，支持流程图、网络图、UML、ER图、数据库 schema 设计、BPMN、电路图等多种图表绘制。本Docker镜像包含始终与diagrams.net版本同步的主程序镜像、支持PDF和图片导出的导出服务器镜像，以及多种部署配置（如独立运行、Nextcloud集成等）。镜像基于Tomcat构建，可直接使用或部署在反向代理后。

注意：从16.5.3版本开始，不再维护alpine和debian镜像，统一使用安全漏洞最少的Tomcat镜像。本镜像复刻自fjudith/draw.io。

核心功能和特性

• 基于Tomcat：可直接使用或部署在反向代理后
• 证书支持：自动生成自签名证书；支持Let's Encrypt证书自动生成
• SSL配置：支持将SSL密钥库挂载至/user/local/tomcat/.keystore
• 多部署模式：提供独立运行、与Nextcloud集成、无外部依赖（含导出服务器、PlantUML、Google Drive/OneDrive支持、EMF转换）等多种docker-compose配置
• 文件导入：支持导入.vsdx、Gliffy™和Lucidchart™文件

使用场景和适用范围

• 企业内部搭建私有图表绘制工具
• 开发团队协作绘制架构图、流程图
• 集成Nextcloud实现文档与图表的统一管理
• 需要离线使用或数据本地化的场景
• 需自定义证书和安全配置的部署环境

使用方法和配置说明

快速启动

临时运行（测试用）

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

后台持久运行

bash
docker run -itd --name="draw-io" --restart=always -p 8001:8080 fjudith/draw.io

访问方式

• 本地访问：http://localhost:8080/?offline=1&https=0 或 https://localhost:8443/?offline=1
• Docker Toolbox环境：http://192.168.99.100:8080/?offline=1&https=0 或 https://192.168.99.100:8443/?offline=1

说明：?offline=1 是安全特性，用于禁用云存储支持。

环境变量配置

Let's Encrypt SSL证书配置

前提条件

• 联网的Linux机器，开放80和443端口
• 指向该机器IP的域名/子域名（如drawio.example.com）

配置步骤

1. 创建Let's Encrypt数据存储目录：

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

2. 运行容器获取证书并启动服务：

   bash
   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 jgraph/drawio
   

说明：将主机80端口映射到容器80端口以支持certbot standalone模式，443端口映射到容器8443端口以提供HTTPS服务。

修改diagrams.net配置

配置通过DRAWIO_*环境变量管理，支持启用Google Drive、OneDrive等集成。具体变量列表可查看镜像主目录下的docker-entrypoint.sh文件。

部署示例

除基础docker run命令外，仓库还提供多种docker-compose配置：

• diagrams.net与导出服务器协同运行
• diagrams.net集成Nextcloud
• 独立运行（含导出服务器、PlantUML、云存储支持、EMF转换）

参考链接

• https://github.com/jgraph/drawio