Diagrams.net

Diagrams.net（前身为 draw.io）是一款在全球开发者、系统架构师与 DevOps 工程师中广受推崇的开源免费图表与拓扑系统设计工具。凭借彻底去中心化的纯客户端本地运算底座、极度轻盈敏捷的操作反馈以及独创的双模可编辑矢量文件规范，它打破了商业绘图软件高昂授权费与私有格式绑架的枷锁。

存储与渲染彻底解耦：为什么架构师偏爱无服务器纯前端画板？

在传统的企业级云端制图工具中，用户的系统拓扑、内网服务器 IP 规划与核心数据流转图等极密资产，往往在绘制过程中被静默同步至第三方服务商的集中式数据库中。对于涉及金融清算、涉密军工或严格遵守数据合规的企业而言，这种中心化托管架构存在巨大的数据外泄隐患与合规审计阻碍。

Diagrams.net 从工程底层践行了彻底的计算与存储解耦架构：

官方公网 Web 页面本质上是一个完全由 JavaScript 驱动的静态客户端单页面应用（SPA）。当用户在画布中拖拽 UML 节点、连接网络拓扑曲线时，所有的矢量坐标计算与几何吸附全部在当前浏览器标签页的本地内存堆栈中即时完成，官方服务器不保存用户的一行图形数据。更关键的是，系统将存储持久层的主动权 100% 交还给用户：支持自由指定将文件保存至本地磁盘、GitHub / GitLab 代码仓库、Google Drive 或是企业自建的私有私有云中，真正实现了物理级的数据自主掌控。

揭秘“双模可编辑图”：如何让一张普通 SVG/PNG 兼具展示与重新编辑能力？

在工程文档协作中，最常见的沟通痛点莫过于“在 Wiki 里看到一张架构图，却找不到源文件进行微调”。Diagrams.net 给出了令人叹服的工程解法——双模可编辑图（Dual-mode Editable Images）：

1. 双重生命的 .drawio.svg 矢量文件：在导出 SVG 矢量图时，勾选“包含副本”选项。生成的 SVG 在外观上是一个标准的 W3C 矢量图片，可以直接在浏览器、Markdown 文档或幻灯片中无限放大锐利展示；但在其底层 XML 根节点内部，工具悄悄注入了一个 content 自定义属性，将完整的 draw.io 图层几何描述经过 Base64 编码与 Deflate 压缩封装其中。当其他架构师将这张“看似普通”的 SVG 文件直接拖入 Diagrams.net 窗口时，解析器能瞬间提取出完整的活动图层树，恢复全部节点的重新编辑能力。

2. 嵌入数据块的 .drawio.png 位图文件：同样的机制也被延伸至 PNG 格式中。工具将图表元数据写入 PNG 标准规范所允许的自定义 zTXt 文本块（Text Chunks）中，丝毫不破坏常规图片浏览器的正常解码显示，彻底消灭了“图纸定稿与源文件脱节”的协作断层。

极简 Docker 私有化容器部署：企业涉密内网一键拉起

在完全物理断网、严禁连接外部互联网的涉密内网或私有企业网络中，系统管理员可在几分钟内完成 Diagrams.net 私有化镜像的独立容器编排：

# docker-compose.yml 内网私有化极简编排
version: '3.8'

services:
  drawio:
    image: jgraph/drawio:latest
    container_name: enterprise-drawio
    ports:
      - "8080:8080"
    restart: always
    environment:
      - DRAWIO_BASE_URL=http://localhost:8080
      # 可选：配置关闭所有外部第三方云盘连接，强制使用本地存储
      - DRAWIO_CONFIG={"defaultCustomLibraries":["local"]}

执行 docker compose up -d 后，企业即可拥有完全私有的在线架构设计中心。整套镜像自带高效的 Nginx 静态文件托管引擎与离线矢量字体包，杜绝任何向外网发送的心跳埋点或遥测探针，筑牢绝对的内网数据防火墙。

Git 代码仓库协同规约：避免多架构师合并冲突的存储格式选择

在敏捷研发团队中，架构图常常与源代码一同存放在 Git 仓库中进行版本追踪。但在多位架构师同时修改系统架构时，若直接保存为压缩后的 .drawio 单行哈希文件，极易在 git merge 时产生毁灭性的二进制合并冲突（Merge Conflict）。

建议团队在工程规约中采纳纯文本存储策略：在 Diagrams.net 菜单栏中选择“文件 -> 属性”，关闭“压缩（Compressed）”选项，将图纸保存为格式化且具备清晰标签缩进的 标准未压缩 XML 格式。在此模式下，每个矩形、线条与文本标签都会对应独立的 XML 节点行，Git 能够精准识别具体字段的增删变动，实现像审查代码 Diff 一样审查架构演进，大幅降低多人并发协作冲突。