项目介绍
draw.io 提供流程图、架构图、UML 与其他图表编辑能力。自托管编辑器方便统一入口,图纸是否保存到本地、浏览器或其他存储则由选择的保存方式决定。
图形库、连接线和页面布局帮助表达系统结构,可编辑图纸用于长期更新。自托管编辑器不自动提供云存储。
适合流程图、UML 和架构配图。保存方式需要明确选择,避免只保留浏览器临时状态。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 图形编辑 | 建立节点与文字 |
| 连接关系 | 表达流程方向 |
| 图层布局 | 组织复杂内容 |
| 多格式导出 | 生成 SVG PNG PDF |
| 源文件 | 保存 .drawio 文档 |
界面展示

图 1:官方公开页面截图,用于说明项目入口与功能;不是本机部署画面。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | 软件与创作 |
| 项目仓库 | jgraph/docker-drawio |
| 官方入口或文档 | 直接访问 |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 从 docker-drawio 的当前官方分支选择镜像与启动方案,确认 HTTP、HTTPS 和可选集成参数,不把任意 data 挂载当成自动云存储。
- 启动编辑器后创建一张测试流程图,加入判断节点和连接线,保存原始
.drawio文件。 - 分别导出 SVG、PNG 与 PDF,用独立查看器检查字体和布局。需要继续编辑时保留原始图纸,不只保存截图。
- 为项目教程使用简洁图例和统一命名,涉及内部地址或账号时先用示例替换,再发布图片。
首次使用与操作检查
画一个含判断分支的流程,移动节点核对连线,导出后检查字体。
源文件重新打开测试,确认不依赖当前浏览器。内部地址在公开图中替换为示例。
Docker Compose
依据官方 dev 分支 Compose 的镜像与 HTTP 端口整理基础编辑器。打开 http://NAS_IP:3120,图纸仍需主动保存为文件;此配置不包含云盘、Google Drive 或其他集成。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/drawio/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/drawio
cd /volume1/docker/drawio
HALO_PREPARE
cd /volume1/docker/drawio
services:
drawio:
image: jgraph/drawio:latest
restart: unless-stopped
ports:
- "3120:8080"
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- 保存浏览器本地数据与保存到 NAS 文件目录是两回事,刷新后应检查文件实际位置。
- AI 生成 draw.io 图表属于另一层集成,这篇只介绍基础编辑器。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
原始图纸与导出图片成对保存,模板和自定义图形库一并备份。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。
参考资料
页面截图来源:draw.io 官方页面,保留原页面标识。