collabora/languagetool

镜像概述

https://www.languagetool.org/是一款开源校对软件，支持英语、法语、德语、波兰语等20多种语言。本Docker镜像基于https://github.com/silvio/docker-languagetool构建，无需Java环境即可运行，可与https://hub.docker.com/repository/docker/collabora/code Docker镜像配合使用。

注意：本镜像免费使用，但功能有限且不提供支持。如需支持选项，请访问https://languagetool.org/premium?a=collabora。

核心功能和特性

• 多语言支持：支持英语、法语、德语等20多种语言的语法、风格和拼写检查
• 无需Java环境：基于Docker镜像，无需本地安装Java即可运行
• 灵活集成：可与collabora/code等文档编辑工具集成，提供实时校对
• ngram支持：通过挂载ngram数据目录，提升错误检测准确性
• 安全配置：支持降权运行、只读文件系统、内存限制等安全选项

使用场景和适用范围

• 个人用户本地部署文本校对服务
• 与collabora/code集成，为在线文档编辑提供实时语法检查
• 开发环境中集成校对功能，提升内容质量
• 需要多语言校对支持的企业或团队

使用方法和配置说明

基本使用

服务器运行在8010端口，需暴露该端口。

拉取镜像

bash
docker pull docker.xuanyuan.run/collabora/languagetool

运行容器

bash
docker run --rm -p 8010:8010 docker.xuanyuan.run/collabora/languagetool

后台运行

添加-d选项后台运行：

bash
docker run -d --rm -p 8010:8010 docker.xuanyuan.run/collabora/languagetool

安全运行配置

以最小权限和资源限制运行：

bash
docker run --name languagetool \
    --cap-drop=ALL \
    --user=65534:65534 \
    --read-only \
    --mount type=bind,src=/tmp/languagetool/tmp,dst=/tmp \
    -p 8010:8010 \
    --memory 412m --memory-swap docker.xuanyuan.run/500m \
    -e EXTRAOPTIONS="-Xmx382M" \
    collabora/languagetool:latest

参数说明：

• --cap-drop=ALL：删除所有Linux capabilities，降低权限
• --user=65534:65534：以nobody用户运行
• --read-only：容器文件系统设为只读
• --mount：挂载本地目录到容器/tmp，提供可写临时空间
• --memory/--memory-swap：限制内存使用
• EXTRAOPTIONS：JVM额外参数，如-Xmx设置最大堆内存

与collabora/code集成

collabora/code默认关闭LanguageTool支持，需通过extra_params环境变量设置以下选项：

• --o:languagetool.enabled=true：启用LanguageTool
• --o:languagetool.base_url=http://<主机IP地址>:8010/v2：设置LanguageTool服务地址

示例：

bash
docker run -i -t --name collabora_code \
    -p 9980:9980 -e "extra_params=--o:ssl.enable=false \
    --o:ssl.termination=false --o:languagetool.enabled=true \
    --o:languagetool.base_url=http://192.168.100.20:8010/v2" \
    --privileged docker.xuanyuan.run/collabora/code

ngram支持

为支持https://dev.languagetool.org/finding-errors-using-n-gram-data，需将额外卷或目录挂载到容器的/ngrams目录。添加-v选项到docker run命令：

bash
docker run ... -v /path/to/ngrams:/ngrams ...

下载英文ngrams数据

bash
mkdir ngrams
wget https://languagetool.org/download/ngram-data/ngrams-en-20150817.zip
(cd ngrams && unzip ../ngrams-en-20150817.zip)
rm -f ngrams-en-20150817.zip

使用ngrams运行容器

通过浏览器插件“Local server (localhost)”设置使用ngrams：

bash
docker run -d --name languagetool -p 8081:8010 -v `pwd`/ngrams:/ngrams:ro --restart=unless-stopped docker.xuanyuan.run/collabora/languagetool