LanguageToolv6.8

Корректор русского и английского: орфография, грамматика и пунктуация в браузере - частичная замена Grammarly и облачного LanguageTool.

Рабочие письма и документы проверяются на сервере команды: расширение LanguageTool подчеркивает ошибки прямо в полях браузера, предлагает исправления и применяет выбранную подсказку. Русский и английский можно проверять без оплаты зарубежной подписки, а тексты, отправленные на этот API, обрабатываются на вашей машине.

После создания сервера установка поднимает LanguageTool и Caddy, создает закрытый адрес API со случайным ключом и выпускает HTTPS-сертификат. На чистой машине рецепт завершился примерно за 3 минуты после начала установки; загрузка сервера и скорость скачивания образов добавляют время ожидания. Готовый адрес придет в письме о завершении установки. Останется установить расширение в браузере и указать этот адрес в его настройках.

Что внутри

LanguageTool 6.8 на Java 17
сервер орфографии, грамматики и пунктуации; проверенные языки - русский и английский. Используется образ erikvl87/languagetool:6.8, собранный сообществом и указанный в документации проекта.
Caddy 2.11.9
принимает подключения по HTTPS, выпускает и продлевает сертификат Let's Encrypt, пропускает к проверке только запросы с ключом в адресе.

Два контейнера запускаются через Docker Compose на Ubuntu 24.04 LTS. Версии обоих образов закреплены также контрольными суммами: повторный заказ использует ту же сборку. База данных не требуется, проверяемые тексты на сервере не сохраняются.

Безопасность

  • Закрытый адрес APIустановка создает случайный ключ из 48 символов; без него запрос получает 404. Знания одного домена недостаточно для проверки текста за ваш счет.
  • HTTPS с автопродлениемCaddy шифрует соединение расширения с сервером и самостоятельно продлевает сертификат Let's Encrypt.
  • Внутренний порт закрыт снаружиLanguageTool слушает порт 8010 только на 127.0.0.1; обратиться в обход проверки ключа через интернет нельзя.
  • Тексты и ключ не пишутся в журналы запросовжурналирование настроено без содержимого проверок, Caddy исключает адрес запроса и заголовки из своих диагностических сообщений. Файл с ключом доступен только администратору сервера.
  • Лимиты запросовдо 20 тысяч символов на проверку, до 20 секунд обработки и до 120 запросов в минуту; очередь ограничена 10 заданиями, одновременно работают два потока.
  • fail2banпосле пяти неудачных попыток входа по SSH за 10 минут блокирует IP на час, затрудняя подбор пароля сервера.

Как войти

  1. Имя сервера формируется из его IPv4: замените точки на дефисы и добавьте .fatmetal.net. Например, из 45.15.159.124 получится 45-15-159-124.fatmetal.net. Для расширения нужен полный адрес с ключом из письма, одного имени недостаточно.

  2. У этого API нет учетной записи, логин и пароль не нужны. Доступ дает закрытая ссылка из письма о готовности приложения: скопируйте ее адрес целиком, включая случайный ключ и окончание /v2. При открытии ссылки появится подсказка подключения. Сохраните адрес как пароль и передавайте только тем, кому разрешена проверка текста.

  3. Установите расширение LanguageTool из магазина расширений своего браузера. Откройте его настройки, выберите «Экспериментальные настройки» -> «Другой сервер», вставьте закрытый адрес API и нажмите «Сохранить». Подключение и исправления проверены с расширением для Chrome 11.5.0.

  4. При первом запуске на странице приветствия расширения нажмите «Ок, понятно», чтобы разрешить проверку через выбранный сервер. Если страница закрыта, откройте приветствие LanguageTool, подтвердите разрешение и перезагрузите страницы с полями текста.

  5. В поле текста на странице браузера наберите «Я хочю проверить ашибки.», откройте подсказки расширения и выберите «хочу» и «ошибки». Для английского проверьте «This are a testt sentence.»: подсказки должны дать «This is a test sentence.».

Если письмо недоступно, войдите по SSH учетной записью сервера из личного кабинета и выполните sudo cat /root/languagetool-credentials.txt: там сохранен тот же полный адрес API. Пароль SSH используется только для входа на сервер, он не заменяет ключ API.

Важно

Сервер предоставляет базовую проверку: AI-правила, перефразирование и полный набор возможностей облачного LanguageTool Premium в эту поставку не входят. Веб-редактора и административной панели на сервере нет; тексты проверяются в отдельно установленном расширении или через совместимый клиент API.

Документы длиннее 20 тысяч символов разбивайте на части. При необходимости уменьшите предел: по SSH откройте sudoedit /etc/languagetool-mp/params.env, задайте MAX_TEXT_LENGTH="5000" или MAX_TEXT_LENGTH="10000", затем выполните sudo bash /opt/languagetool/install.sh. Значение по умолчанию - 20000. Там же TZ="Europe/Moscow" задает часовой пояс; повторный запуск применяет параметры и сохраняет ключ API.

Сохраняйте закрытый адрес API в надежном месте. Доступ к нему означает доступ к проверке на вашем сервере; не публикуйте ссылку в открытых документах или скриншотах. Сервер использует модели из поставки; не добавляйте модели из недоверенных источников: в зависимости OpenNLP 1.9.4 есть известные уязвимости загрузки моделей. Публичный API этого рецепта загрузку моделей не предоставляет.

Лицензия

Лицензия ядра LanguageTool - LGPL-2.1-or-later. Образ приложения поддерживает сообщество; Caddy распространяется по Apache-2.0.

Свой домен

Адрес с HTTPS уже выдается автоматически; свой домен подключается по желанию.

  1. Направьте A-запись своего домена на IPv4 этого сервера.
  2. Проверьте командой ping proofread.example.org, подставив свой домен: имя должно показывать IP сервера. Пока показывает другой адрес, дождитесь обновления DNS.
  3. Подключитесь по SSH учетной записью сервера из личного кабинета. Выполните sudoedit /etc/languagetool-mp/params.env и задайте DOMAIN="proofread.example.org", заменив пример на свой домен без https:// и пути. Сохраните файл.
  4. Выполните sudo bash /opt/languagetool/install.sh. Установщик применит домен, Caddy получит для него сертификат Let's Encrypt. Ключ доступа сохранится.
  5. В закрытом адресе API из письма о готовности замените только имя сервера на свой домен: получится https://proofread.example.org/<ваш-ключ>/v2. Логин и пароль по-прежнему не нужны. В расширении LanguageTool откройте «Экспериментальные настройки» -> «Другой сервер», вставьте полученный адрес целиком и сохраните его.

Требования

Тариф CPU2-RAM4-DISK50 подходит для проверенного сценария: рабочие тексты на русском и английском до 19 тысяч знаков, в том числе два одновременных запроса примерно по 10 тысяч знаков. После прогрева приложение и Caddy занимают около 1068 МиБ RAM, наблюдаемый пик при проверках - 1084 МиБ. Два одновременных документа по 10 тысяч знаков обработались примерно за 1,1-1,4 секунды каждый.

Для постоянной массовой проверки документов перед переходом на CPU4-RAM8-DISK100 проверьте собственную нагрузку: число пользователей само по себе ее не определяет. Рецепт ограничен двумя рабочими потоками; увеличение тарифа автоматически не повышает этот предел.

Подробный разбор с замерами и подключением расширения в Базе знаний →
LanguageTool585 ₽/месЗапустить →