LanguageTool
Проверка орфографии, грамматики и пунктуации русского и английского в браузере через свой сервер: рабочие тексты обрабатываются на сервере команды, а базовая проверка частично заменяет Grammarly и облачный LanguageTool без оплаты зарубежной подписки. Развернули 6.8 на Fatmetal Cloud Server, замерили память и проверили исправления в расширении.
Вердикт
- автору технических писем на двух языках, которому нужен свой адрес проверки в расширении
- разработчику редакционной системы, которому нужны позиции ошибок и варианты замены через API
- тем, кому нужны AI-правила, перефразирование и полный набор возможностей облачного LanguageTool Premium
- автору, которому достаточно готового российского корректора без обслуживания VPS
Что остается в расширении со своим сервером
LanguageTool ищет ошибки и возвращает варианты исправлений. Расширение подчеркивает слова прямо в поле страницы; щелчок по подсказке заменяет фрагмент. Перенос проверки на свой сервер меняет адрес обработки текста, а привычный способ работы сохраняется.
Собственный сервер сохраняет базовую проверку, но не воспроизводит AI-правила, перефразирование и полный набор возможностей облачного LanguageTool Premium.
В нашем примере русский текст «Я хочю проверить ашибки.» получил две орфографические подсказки. После выбора «хочу» и «ошибки» расширение вставило исправленный текст и показало ноль замечаний. Английская фраза «This are a testt sentence.» тоже получила исправления грамматики и написания.
Собственный LanguageTool server предоставляет API - интерфейс для программ. Веб-редактор в эту поставку не входит. На снимках ниже настоящее расширение работает в явно обозначенном тестовом поле браузера.
Чем отличается от платных корректоров
Для одного автора аренда сервера не обязательно выгоднее подписки. Сравнивайте нужный язык, способ работы и оплату: API для своего приложения и готовый корректор в браузере решают разные задачи.
| Вариант | Цена | Что получает читатель |
|---|---|---|
| LanguageTool на VPS | 650 руб./мес. за CPU2-RAM4-DISK50 | Свой API русского и английского; обслуживание сервера на владельце |
| Grammarly Pro | $30 помесячно или $144 за год на участника | Облачный помощник; доступ из России запрещен правилами вендора |
| Орфограммка | 150 руб. за 100 тыс. знаков; 400 руб./мес. за 1 млн знаков | Готовый русский корректор; оплата картой «Мир» и через СБП |
Цены проверены 14 ноября 2026 по прайсу Grammarly и тарифам Орфограммки. Запрет Grammarly для России действует и на подключения через публичные VPN.
Год аренды при помесячной оплате стоит 7 800 руб. Это расчет сервера: время администратора и хранение резервных копий оплачиваются отдельно. Для небольшого объема русского текста розничный сервис дешевле уже до этих расходов.
Как устроен собственный API
Один контейнер запускает Java-сервер LanguageTool, второй - Caddy, который принимает HTTPS и передает разрешенные запросы. База данных и очередь сообщений не нужны. Используемый образ erikvl87/languagetool поддерживает сообщество, это не официальный контейнер вендора.
Публичный адрес имеет вид https://ваш-домен/секрет/v2. Секретная часть играет роль ключа: Caddy удаляет ее перед передачей запроса Java-серверу, а по другим путям отвечает 404. Передавать отдельные заголовки авторизации расширению не приходится.
Сам сервер слушает только локальный порт 8010. Входной прокси также отвечает на предварительные запросы браузера OPTIONS: без этого собственная веб-интеграция может получить ошибку еще до проверки текста.
Какой сервер взять
Для базовой проверки двух языков выберите CPU2-RAM4-DISK50: 2 vCPU, 4 ГБ памяти и 50 ГБ диска. Именно на этом тарифе завершились проверки длинных документов и двух одновременных запросов.
В инструкции Java получает до 1 ГБ кучи - области памяти для объектов. Контейнеру оставлено 2 ГБ: кроме кучи процессу нужны библиотеки, потоки и служебная память. Остаток достается системе и HTTPS-прокси.
Сначала ограничьте объем запроса. Конфигурация принимает до 20 000 знаков за проверку, выделяет 20 секунд и два рабочих потока. Это управляемый предел для редакционных фрагментов, а не обещание обслужить произвольное число авторов.
Большие n-gram-наборы - статистические данные для дополнительных проверок по сочетаниям слов - в эту конфигурацию не входят. Выбор тарифа относится к базовой поставке, показанной в статье.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий сервис на своем домене, валидный TLS и файл с доступами.
Рекомендуемая конфигурация:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe от 585 ₽/мес
Развертывание на Fatmetal Cloud Server
Понадобятся SSH, работа с текстовыми файлами и свой домен. Команды ниже создают весь стек; переписывать файлы из стороннего руководства не нужно. Ключ подключения храните как пароль.
Подготовьте Ubuntu и Docker
Возьмите чистую Ubuntu 24.04, откройте входящие TCP 80/443 и SSH. Подключитесь по SSH и выполните
sudo -i; остальные команды вводятся в этой оболочке администратора.apt-get update && apt-get install -y ca-certificates curl openssl install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc chmod a+r /etc/apt/keyrings/docker.asc echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu noble stable" > /etc/apt/sources.list.d/docker.list apt-get update apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginЗадайте домен и создайте ключ
Вместо
ваш-доменукажите свое имя с A-записью на IP сервера. Домен нужен Caddy для сертификата. Каталог и файл закрыты от остальных пользователей машины.install -d -m 700 /opt/languagetool && cd /opt/languagetool umask 077 cat > .env <<ENV APP_DOMAIN=ваш-домен LT_TOKEN=$(openssl rand -hex 24) ENVСохраните compose с закрепленными версиями
Файл запускает проверенные версии вместо изменяемого latest. Привязка 8010 к localhost закрывает прямой доступ к проверке в обход ключа.
cat > compose.yaml <<'YAML' services: languagetool: image: erikvl87/languagetool:6.8 restart: unless-stopped ports: ["127.0.0.1:8010:8010"] environment: {Java_Xms: 256m, Java_Xmx: 1024m, langtool_maxTextLength: "20000", langtool_maxCheckTimeMillis: "20000", langtool_maxCheckThreads: "2", langtool_maxWorkQueueSize: "10", langtool_requestLimit: "120", langtool_requestLimitPeriodInSeconds: "60"} volumes: ["./logback.xml:/LanguageTool/logback.xml:ro"] mem_limit: 2g logging: {driver: local, options: {max-size: 10m, max-file: "3"}} caddy: image: caddy:2.11.9 restart: unless-stopped ports: ["80:80", "443:443"] environment: {APP_DOMAIN: "${APP_DOMAIN}", LT_TOKEN: "${LT_TOKEN}", ACME_CA: "${ACME_CA:-https://acme-v02.api.letsencrypt.org/directory}"} volumes: ["./Caddyfile:/etc/caddy/Caddyfile:ro", "caddy_data:/data", "caddy_config:/config"] logging: {driver: local, options: {max-size: 10m, max-file: "3"}} volumes: {caddy_data: {}, caddy_config: {}} YAMLНастройте HTTPS и ограничение доступа
Caddy выпускает сертификат, скрывает URI и заголовки в своем служебном журнале. Logback оставляет ошибки Java-сервера вместо подробного журнала запросов с текстами.
cat > Caddyfile <<'CADDY' { acme_ca {$ACME_CA} log default { format filter { fields { request>uri delete request>headers delete } } } } {$APP_DOMAIN} { @authorized path /{$LT_TOKEN}/v2/* handle @authorized { uri strip_prefix /{$LT_TOKEN} header >Access-Control-Allow-Origin "*" @preflight method OPTIONS header @preflight { Access-Control-Allow-Methods "GET, POST, OPTIONS" Access-Control-Allow-Headers "Content-Type" } respond @preflight 204 request_body { max_size 128KB } reverse_proxy languagetool:8010 } respond "Not found" 404 handle_errors { header Access-Control-Allow-Origin "*" respond "Request rejected." {err.status_code} } } CADDY cat > logback.xml <<'XML' <configuration><appender name="STDERR" class="ch.qos.logback.core.ConsoleAppender"><target>System.err</target><encoder><pattern>%date %-5level %logger - %msg%n</pattern></encoder></appender><root level="ERROR"><appender-ref ref="STDERR"/></root></configuration> XMLЗапустите и проверьте API
Compose дождется проверки здоровья Java-сервера; Caddy отдельно получает сертификат. Сначала запустите контейнеры и посмотрите его журнал.
docker compose pull docker compose up -d --wait --wait-timeout 180 docker compose logs --tail 30 caddyДождитесь сообщения
certificate obtained successfully. Повторяйте просмотр журнала, пока оно не появится; после этого выполните проверку ниже. В JSON нужны версия 6.8 и массив matches с замечаниями.. ./.env curl --fail --silent --show-error "https://$APP_DOMAIN/$LT_TOKEN/v2/check" --data-urlencode 'language=ru' --data-urlencode 'text=Я хочю проверить ашибки.' printf 'https://%s/%s/v2\n' "$APP_DOMAIN" "$LT_TOKEN" > client-url.txtПодключите расширение
Установите LanguageTool для Chrome. Откройте «Настройки», разверните дополнительные настройки внизу, в разделе «Сервер LanguageTool API» выберите «Внешний сервер». Скопируйте адрес из
/opt/languagetool/client-url.txt, нажмите «Сохранить» и примите уведомление о передаче текста выбранному серверу.
Как убедиться, что расширение исправляет текст
Откройте страницу с многострочным полем ввода, разрешите расширению работать на этом сайте и введите русский пример из проверки API. В углу поля появится счетчик замечаний. Откройте его и выберите предложенные замены.
Затем введите «This are a testt sentence.». Для нашего примера исправления «is» и «test» дали «This is a test sentence.». Не применяйте все варианты подряд: корректор предлагает альтернативы, а смысл выбирает автор.
У проверенного расширения 11.5.0 настройки и кнопки русские при русском языке браузера. Пояснения к английским правилам приходят на английском. После смены адреса обновите страницу с текстом, чтобы новая проверка ушла на выбранный сервер.
Сколько памяти и времени занимает проверка
Цифры получены на CPU2-RAM4-DISK50 с Ubuntu 24.04.4 и Docker 29.9.3. Память указана для двух контейнеров вместе после обычной работы с документами.
| Память в прогретом простое | 1 068 МиБ |
| Наблюдаемый пик при документах | 1 084 МиБ |
| Распакованные образы | 783 МиБ |
| Занято на диске с Ubuntu и Docker | 3,5 ГиБ |
| Первый ответ после пересоздания контейнеров | 13 с для английского; русский готов через 17 с |
| Короткая проверка через публичный HTTPS | 0,42 с русский; 0,14 с английский |
| Документ около 19 тыс. знаков | 1,8 с русский; 1,4 с английский |
| Два одновременных документа по 10 тыс. знаков | 1,4 с русский; 1,1 с английский |
Все длинные документы завершились без усечения результата. За серию проверок дисковые данные не выросли; процесс Java удержал дополнительно около 178 МиБ после прогрева. Поэтому ориентироваться стоит на прогретую память, а не на первые секунды запуска.
Практический вывод. Для показанных фрагментов 4 ГБ хватило с запасом. Первым заметным пределом станет ограничение 20 000 знаков на запрос; большие документы делите по абзацам.
Проверено на версии v6.8, 14 ноября 2026. На новых версиях результаты могут отличаться.
Где может сломаться
Причина. Java-сервер пытается проверить предварительный запрос браузера без текста.
Решение. Сохраните обработчик OPTIONS из Caddyfile выше. После правки проверьте конфигурацию и перечитайте ее.
cd /opt/languagetool
docker compose exec -T caddy caddy validate --config /etc/caddy/Caddyfile
docker compose exec -T caddy caddy reload --config /etc/caddy/CaddyfileПричина. Первый HTTPS-запрос пришел раньше готовности сертификата Caddy.
Решение. Дождитесь сообщения certificate obtained successfully в журнале Caddy, как в шаге запуска. Проверка здоровья Java не проверяет готовность TLS; журнал также покажет ошибку выдачи сертификата.
cd /opt/languagetool
docker compose up -d --wait --wait-timeout 180
docker compose logs --tail 30 caddyПричина. В нашем профиле предел - 20 000 знаков или 128 КБ тела запроса у прокси.
Решение. Разбейте документ по абзацам. Размер входного файла можно проверить до отправки; знаки и байты для русского различаются.
wc -m -c document.txtПричина. Caddy отвергает путь без правильного ключа. Корень домена намеренно не открывает редактор.
Решение. Сверьте адрес в расширении с client-url.txt: он должен заканчиваться на /v2. Проверяйте с добавлением /check, не заменяйте ключ на пароль SSH.
Причина. Прокси работает, а Java-сервер остановлен. В нашем опыте расширение показало ошибку проверки.
Решение. Проверьте контейнеры и ошибки, затем запустите сервис.
cd /opt/languagetool
docker compose ps
docker compose logs --tail 50 languagetool
docker compose up -d languagetoolКак обновлять и сохранять конфигурацию
Перед обновлением сохраните каталог настройки и сертификаты Caddy. Личный словарь расширения хранится на стороне клиента; копия сервера его не заменяет. Архивы ниже содержат ключ доступа, поэтому остаются в закрытом каталоге root.
cd /opt/languagetool
docker compose stop
tar czf /root/lt-config.tgz -C /opt languagetool
docker compose run --rm --no-deps --interactive=false -v /root:/backup --entrypoint tar caddy czf /backup/lt-tls.tgz -C /data .
docker compose up -dДля восстановления распакуйте конфигурацию, верните сертификаты и запустите стек. Перенесите оба архива на отдельное защищенное хранилище: копия на том же диске не спасет при его потере.
tar xzf /root/lt-config.tgz -C /opt
cd /opt/languagetool
docker compose stop
docker compose run --rm --no-deps --interactive=false -v /root:/backup --entrypoint tar caddy xzf /backup/lt-tls.tgz -C /data .
docker compose up -dДля обновления сначала сделайте эту копию, затем поменяйте тег нужного образа в compose.yaml на выбранную версию и выполните команды ниже. Повторите проверки русского и английского; при неудаче верните прежний тег.
cd /opt/languagetool
docker compose pull && docker compose up -dНе публикуйте файл client-url.txt и не вставляйте ключ в общую переписку. При утечке замените LT_TOKEN в .env, пересоздайте Caddy и обновите адрес у клиентов: прежний путь перестанет работать.
cd /opt/languagetool
sed -i "s/^LT_TOKEN=.*/LT_TOKEN=$(openssl rand -hex 24)/" .env
docker compose up -d --force-recreate caddy
. ./.env
printf 'https://%s/%s/v2\n' "$APP_DOMAIN" "$LT_TOKEN" > client-url.txt
Уязвимости зависимости OpenNLP
В выбранном образе 6.8 находится OpenNLP 1.9.4. Это затронутая версия зависимости, поэтому нашу сборку нельзя назвать исправленной. Номера ниже полезны и владельцам прежних установок.
| Бюллетень | Риск | Затронутые / исправленные OpenNLP |
|---|---|---|
| CVE-2026-42027 | Critical: создание класса из недоверенной модели | До 1.9.5; 2.0-2.5.8; 3.0.0-M1/M2 / 1.9.5, 2.5.9, M3 |
| CVE-2026-40682 | Critical: XML-словарь может раскрывать файлы | Те же диапазоны / те же исправления |
| CVE-2026-42440 | High: поврежденная модель исчерпывает память | Те же диапазоны / те же исправления |
Сопровождающий LanguageTool объясняет: обычный API берет фиксированные модели из поставки, а соответствующий XML API не используется. Это ограничивает применимость бюллетеней, но не исправляет библиотеку.
Не добавляйте модели из недоверенных источников. При выборе следующего образа проверьте версию библиотеки и повторите проверки; замена имени тега без проверки состава не гарантирует устранения CVE.
cd /opt/languagetool
docker compose exec -T languagetool find /LanguageTool -iname '*opennlp*'
Как использовать результат в своем приложении
API получает текст и код языка в форме POST, возвращает JSON. Поле matches содержит смещение, длину фрагмента и варианты replacements. Сохраните оригинальный текст и применяйте выбранные автором замены к нему: длина строки после замены меняется.
Для веб-приложения запрос идет на тот же закрытый адрес. CORS разрешен, но ключ в браузерном коде увидит пользователь. Если доступ нужен только вашему приложению, отправляйте запрос со своего бэкенда и храните адрес там.
- Расширение браузера - проверяет поля сайтов и дает человеку выбрать вариант исправления.
- Редакционная система - получает замечания через /v2/check и рисует свою панель подсказок.
- Caddy - остается единой точкой входа, выпускает TLS и ограничивает размер запроса.
Когда это НЕ ваш выбор
Нужны перефразирование и весь Premium
Открытый сервер не воспроизводит облачные AI-правила и генеративные функции. Покупка VPS не дает лицензию на Premium или готовую командную панель.
Нужно массово раздать корпоративное расширение
LGPL-2.1-or-later относится к ядру. Условия проприетарного клиента и облака отдельные; право на корпоративную поставку из лицензии сервера не следует. API можно подключить к собственному приложению.
Требуется полная сетевая изоляция или сертификация
Свой адрес проверки не означает отключение всех внешних функций расширения. Установка также не дает автоматического соответствия требованиям к персональным данным или сертифицированной поставки.
Нужен готовый корректор без обслуживания
Для личных русских текстов сервис с оплатой в рублях может обойтись дешевле. Здесь вы отвечаете за доступ, обновления и резервные копии, а качество подсказок все равно оценивает автор.
Частые вопросы
Нужна ли облачная учетная запись для нашего сценария?
Сохранение своего API и проверка текста в испытанном клиенте прошли без входа в облачный аккаунт.
Какой адрес вводить в расширении?
Полный адрес из /opt/languagetool/client-url.txt, включая секретный фрагмент и окончание /v2. Это не пароль сервера.
Где включить русский интерфейс?
Используйте русский язык браузера. В проверенном Chrome-клиенте он включил русские настройки и панель замечаний.
Нужна ли база данных?
Нет. Для этой поставки сохраняются конфигурация, ключ и сертификаты; база документов на сервере не создается.
Можно ли использовать открытое ядро коммерчески?
Лицензия ядра LGPL-2.1-or-later допускает коммерческое использование. Словари и сторонние компоненты имеют свои лицензии; условия клиента рассматриваются отдельно.
Итог
LanguageTool дает собственную точку проверки для расширения и приложений. Выбирайте этот путь, когда нужен управляемый API русского и английского, а не просто еще одно место для написания текста.
Рекомендуемая конфигурация для установки:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe
Не хотите устанавливать вручную?
Запустите LanguageTool на этой конфигурации автоматически - от 585 ₽/мес.
Этот стек у нас запущен на тарифе CPU2-RAM4-DISK50. Нашли баг в гайде - напишите, поправим в течение дня.