armv8a/drawio

draw.io Docker镜像文档

镜像概述

https://github.com/jgraph/drawio 是一款开源的白板/绘图软件。本Docker项目提供了draw.io的多种实现及相关工具，包括：

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

基础信息

该Dockerfile基于 tomcat:9-jre11-openjdk-slim 构建（详见 https://hub.docker.com/_/tomcat/%EF%BC%89%E3%80%82

注意：从16.5.3版本开始，不再维护alpine和debian镜像，统一使用安全性漏洞最少的tomcat镜像。

本项目派生自 https://github.com/fjudith/docker-draw.io%E3%80%82

核心功能

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

使用场景

• 本地部署的绘图工具，用于团队协作或个人使用
• 企业内部私有绘图服务，确保数据不泄露到外部
• 集成到Nextcloud等协作平台，提供内置绘图功能
• 需要PlantUML支持的技术文档绘图场景
• 需离线使用或自定义存储配置的场景

使用方法

快速启动

运行容器：

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

在浏览器中访问：

• http://localhost:8080/?offline=1&https=0（HTTP方式）
• https://localhost:8443/?offline=1（HTTPS方式）

若使用Docker Toolbox，访问：

• <[***]>
• <[***]>

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

环境变量配置

通过Let's Encrypt配置HTTPS证书

先决条件

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

配置方法

使用jgraph/drawio镜像运行以下命令：

bash
docker run -it -m1g -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能以独立模式工作；将主机443端口映射到容器8443端口，使Tomcat直接提供HTTPS服务。

修改diagrams.net配置

配置通过 DRAWIO_* 环境变量管理。有关变量列表，请查看 main 目录下的 docker-entrypoint.sh 文件。这些变量可用于启用Google Drive、OneDrive等集成。

参考链接

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