fridevbi/dia-docker Docker 镜像 - 轩辕镜像

Ubuntu-Dia 镜像文档

镜像概述和主要用途

Ubuntu-Dia镜像是基于Ubuntu操作系统构建的Docker镜像，预安装了Dia流程图绘制工具。Dia是一款开源跨平台图表应用，支持流程图、UML图、网络图等多种图表类型，可导出PNG、SVG、PDF等格式。该镜像提供容器化的Dia运行环境，用户无需在本地系统安装依赖，即可快速启动并使用Dia进行图表绘制。

核心功能和特性

• 基于Ubuntu系统：采用稳定的Ubuntu基础镜像，确保运行环境的可靠性和兼容性
• 预装Dia应用：镜像构建时已完成Dia及其依赖的安装配置，开箱即可使用
• 多图表类型支持：支持流程图、UML类图/序列图、网络图、电路图、组织结构图等
• 丰富导出格式：可导出PNG、JPG、SVG、PDF、EPS等多种常用格式
• 容器化隔离：运行环境与本地系统隔离，避免依赖冲突，使用后可直接清理容器
• 轻量级部署：相比本地安装更节省系统资源，启动速度快，适合临时或频繁使用场景

使用场景和适用范围

• 个人图表绘制：临时或频繁需要使用Dia进行流程图、架构图绘制的个人用户
• 团队协作：团队成员统一使用容器化Dia环境，确保工具版本一致性
• 文档编写辅助：技术文档、设计文档编写过程中快速绘制配套图表
• 教学演示：教学场景中演示图表绘制方法，无需在教学机单独安装Dia
• 临时环境需求：不希望影响本地系统配置的情况下临时使用Dia的场景

使用方法和配置说明

前提条件

• 本地已安装Docker Engine（18.09+版本）
• 若使用GUI界面（Dia为图形应用），需支持X11转发（Linux/macOS需配置X Server，Windows需使用WSL2或VcXsrv等X Server工具）

获取镜像

假设镜像已上传至容器仓库，通过以下命令拉取：

bash
docker pull [镜像仓库地址]/ubuntu-dia:latest

（本地构建需准备Dockerfile并使用docker build命令）

启动容器并运行Dia

Linux系统

bash
# 挂载X11套接字和本地目录（保存文件），启动Dia
docker run -it --rm \
  -e DISPLAY=$DISPLAY \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $(pwd):/workspace \  # 本地当前目录挂载到容器/workspace，用于保存文件
  --name dia-container \
  [镜像仓库地址]/ubuntu-dia:latest \
  dia

macOS系统

bash
# 安装并启动XQuartz（首次使用）
brew install --cask xquartz
open -a XQuartz  # 在偏好设置->安全性中勾选"允许来自网络客户端的连接"

# 获取本地IP并启动容器
IP=$(ifconfig en0 | grep inet | awk '$1=="inet" {print $2}')
xhost + $IP

docker run -it --rm \
  -e DISPLAY=$IP:0 \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $(pwd):/workspace \
  --name dia-container \
  [镜像仓库地址]/ubuntu-dia:latest \
  dia

Windows系统（WSL2环境）

1. 安装VcXsrv并启动，在配置中勾选"Disable access control"
2. 在WSL2终端执行：

bash
export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0.0
docker run -it --rm \
  -e DISPLAY=$DISPLAY \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $(pwd):/workspace \
  --name dia-container \
  [镜像仓库地址]/ubuntu-dia:latest \
  dia

文件保存说明

启动命令中通过-v $(pwd):/workspace将本地当前目录挂载到容器的/workspace目录，在Dia中保存文件时选择/workspace路径，即可将文件保存到本地当前目录，避免容器退出后文件丢失。

自定义配置

如需使用本地Dia配置（如默认字体、画布大小），可挂载本地配置目录：

bash
docker run -it --rm \
  -e DISPLAY=$DISPLAY \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $(pwd):/workspace \
  -v ~/.dia:/root/.dia \  # 挂载本地Dia配置到容器
  --name dia-container \
  [镜像仓库地址]/ubuntu-dia:latest \
  dia