文章摘要
AI摘要生成

Snipaste_2025-12-25_11-37-56

先贴上官网地址：PlantUML Web Server

从官网下载对应的jar包文件

下载地址1：plantuml download | SourceForge.net

下载地址2：Releases · plantuml/plantuml

我1Panel使用的是docker镜像中jdk1.8部署，不是直接使用PlantUML镜像（使用这种可以参考其他文章找找对应方法）

部署

1.上传jar文件到服务器上

image-20251225114830965

2.创建运行环境

image-20251225143753560

项目目录就填刚刚传的自定义目录

启动命令为java -jar plantuml.jar -picoweb:8080

端口映射也是自定义 点击确定即可

image-20251225143927110

部署之后地址为http://XXXXXXX:8080/plantuml/png/

中文方块修复

通过代码调用服务进行生产之后发现会出现方块情况，如下图所示

image-20251225144204369

原因是因为我服务器上面没用中文字体

解决方法是在主机（宿主机，非docker内容器）上安装字体，然后通过挂载将字体文件映射到容器里面

  1. 需要当前主机支持apt下载软件方式（apt自行了解）

  2. 安装字体管理工具apt install fontconfig用于配置和自定义系统字体的重要库和工具集

  3. 安装apt install xfonts-utils系统的字体实用工具

  4. 准备好上传的中文字体文件例如fonts-wqy-microhei.ttc（文泉驿微米黑）fonts-wqy-zenhei.ttc（文泉驿正黑）

    1
    2
    3
    4
    5
    6
    7
    8
    mkdir -p /usr/share/fonts/simsun
    cd /usr/share/fonts/simsun
    # 上传字体文件：xxxx.ttc
    # 安装字体
    mkfontscale
    mkfontdir
    fc-cache -fv
    source /etc/profile

  5. 配置挂载映射/usr/share/fonts/simsunimage-20251225145710903

  6. 配置环境变量JAVA_FONTS=/usr/share/fonts

    image-20251225145741855

    1
    2
    3
    4
    5
    6
    # 设置字体相关环境变量
    LANG=zh_CN.UTF-8
    LANGUAGE=zh_CN:zh
    LC_ALL=zh_CN.UTF-8
    # Java应用可能需要这个
    JAVA_FONTS=/usr/share/fonts

  7. 重启后就可以支持中文文字生成了

参考文章

解决PlantUML的中文乱码问题 | 想啥侃啥