软件与创作

draw.io:自建流程图与架构图编辑器

  • 0 次阅读
  • 0 条评论
文章摘要

draw.io 提供流程图、架构图、UML 与其他图表编辑能力。自托管编辑器方便统一入口,图纸是否保存到本地、浏览器或其他存储则由选择的保存方式决定。 图形库、连接线和页面布局帮助表达系统结构,可编辑图纸用于长期更新。自托管编辑器不自动提供云存储。 适合流程图、UML 和架构配图。保存方式需要明确选择,避免只保留浏览器临时状态。

项目介绍

draw.io 提供流程图、架构图、UML 与其他图表编辑能力。自托管编辑器方便统一入口,图纸是否保存到本地、浏览器或其他存储则由选择的保存方式决定。

图形库、连接线和页面布局帮助表达系统结构,可编辑图纸用于长期更新。自托管编辑器不自动提供云存储。

适合流程图、UML 和架构配图。保存方式需要明确选择,避免只保留浏览器临时状态。

核心功能

功能 作用与使用方式
图形编辑 建立节点与文字
连接关系 表达流程方向
图层布局 组织复杂内容
多格式导出 生成 SVG PNG PDF
源文件 保存 .drawio 文档

界面展示

draw.io 官方页面

图 1:官方公开页面截图,用于说明项目入口与功能;不是本机部署画面。

项目信息

项目 说明
类型 Docker
分类 软件与创作
项目仓库 jgraph/docker-drawio
官方入口或文档 直接访问
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 从 docker-drawio 的当前官方分支选择镜像与启动方案,确认 HTTP、HTTPS 和可选集成参数,不把任意 data 挂载当成自动云存储。
  2. 启动编辑器后创建一张测试流程图,加入判断节点和连接线,保存原始 .drawio 文件。
  3. 分别导出 SVG、PNG 与 PDF,用独立查看器检查字体和布局。需要继续编辑时保留原始图纸,不只保存截图。
  4. 为项目教程使用简洁图例和统一命名,涉及内部地址或账号时先用示例替换,再发布图片。

首次使用与操作检查

画一个含判断分支的流程,移动节点核对连线,导出后检查字体。

源文件重新打开测试,确认不依赖当前浏览器。内部地址在公开图中替换为示例。

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 官方页面,保留原页面标识。