在docker-drawio中配置默认语言的方法

docker-drawio作为一款开源的绘图工具容器化解决方案，为用户提供了便捷的部署方式。在实际使用过程中，很多用户会遇到需要修改默认语言的需求，特别是非英语用户群体。本文将详细介绍如何在docker-drawio中正确配置默认语言。

配置原理分析

docker-drawio基于Tomcat容器运行，其语言配置机制与原生draw.io有所不同。通过研究发现，直接修改docker-compose.yml文件中的配置参数并不能生效，这是因为语言设置需要通过特定的JavaScript预配置文件来实现。

正确配置方法

要实现默认语言的设置，需要通过挂载jsPreConfig.js文件的方式来完成。具体步骤如下：

1. 首先准备一个PreConfig.js文件，内容为：

window.mxLanguage = 'es';  // 这里'es'代表西班牙语，可根据需要修改为其他语言代码

2. 运行docker容器时，将该文件挂载到指定位置：

docker run -p 55000:8080 \
  -v "/path/to/your/PreConfig.js:/usr/local/tomcat/webapps/draw/js/PreConfig.js" \
  jgraph/drawio:23.1.2

语言代码参考

常用的语言代码包括：

• zh: 中文
• es: 西班牙语
• fr: 法语
• de: 德语
• ja: 日语
• ru: 俄语

注意事项

1. 文件路径必须准确，确保挂载到容器内的/usr/local/tomcat/webapps/draw/js/目录下
2. 文件名必须为PreConfig.js，区分大小写
3. 修改配置后需要重启容器才能生效
4. 不同版本的docker-drawio可能略有差异，建议查看对应版本的文档

高级配置

除了设置默认语言外，PreConfig.js文件还可以配置其他参数，例如：

window.mxLanguage = 'zh';
window.mxBasePath = '/draw';  // 设置基础路径
window.mxLoadResources = false;  // 控制资源加载行为

通过这种方式，用户可以实现更灵活的draw.io定制化配置，满足不同场景下的使用需求。