silviof/docker-languagetool

LanguageTool Docker镜像文档

镜像概述

LanguageTool是一款开源的文本校对软件，支持英语、法语、德语、波兰语等20多种语言的语法、拼写检查。本Docker镜像封装了LanguageTool服务，使得无需预先安装Java环境的系统也能便捷部署和运行该校对服务，可配合浏览器插件（如Firefox插件）使用，提供本地文本校对能力。

核心功能与特性

• 多语言支持：覆盖20多种语言的语法、拼写实时校对
• 零Java依赖：内置运行环境，无需系统预先安装Java
• 灵活部署：支持前台交互式运行与后台守护进程模式
• 安全增强：可配置最小权限运行（限制用户、权限、内存）
• ngram扩展：支持挂载ngram语料库目录，提升校对准确性

使用场景与适用范围

• 个人用户本地部署文本校对服务，配合浏览器插件实现实时校对
• 写作/编辑人员需要多语言文本检查工具，确保内容语法正确性
• 开发环境集成本地校对服务，为应用提供文本校验能力
• 对数据隐私敏感场景，需本地处理文本校对而非依赖云端服务

使用方法与配置说明

基本使用流程

1. 拉取镜像

docker
docker pull silviof/docker-languagetool

2. 启动服务

前台运行（输出日志至控制台，按Ctrl+C停止）：

docker
docker run --rm -p 8010:8010 silviof/docker-languagetool

后台运行（添加-d参数保持服务后台运行）：

docker
docker run -d --rm -p 8010:8010 silviof/docker-languagetool

服务启动后默认监听8010端口，可通过http://localhost:8010访问校对接口。

最小权限与资源限制配置

为增强容器安全性，可配置最小权限运行模式，限制资源占用：

docker
docker run --name languagetool \
  --cap-drop=ALL \                     # 移除所有Linux内核权限
  --user=65534:65534 \                 # 使用nobody用户运行（非root）
  --read-only \                        # 容器文件系统设为只读
  --mount type=bind,src=/tmp/languagetool/tmp,dst=/tmp \  # 挂载可写临时目录
  -p 127.0.0.1:8010:8010 \             # 仅本地访问服务端口
  --memory 412m --memory-swap 200m \   # 限制内存使用（412M内存+200M交换空间）
  -e EXTRAOPTIONS="-Xmx382M" \         # 设置JVM最大堆内存
  silviof/docker-languagetool:latest

ngram数据支持配置

1. 下载ngram语料库（以英文为例）

bash
mkdir ngrams  # 创建本地ngram目录
wget https://languagetool.org/download/ngram-data/ngrams-en-20150817.zip  # 下载英文ngram数据
cd ngrams && unzip ../ngrams-en-20150817.zip  # 解压至ngrams目录
cd .. && rm -f ngrams-en-20150817.zip  # 清理压缩包

2. 挂载ngram目录运行服务

docker
docker run -d --name languagetool \
  -p 127.0.0.1:8010:8010 \
  -v /path/to/local/ngrams:/ngrams:ro \  # 挂载本地ngram目录（只读）
  --restart=unless-stopped \  # 异常退出时自动重启（手动停止除外）
  silviof/docker-languagetool

关键配置参数说明