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 на час, затрудняя подбор пароля сервера.
Как войти
Имя сервера формируется из его IPv4: замените точки на дефисы и добавьте
.fatmetal.net. Например, из45.15.159.124получится45-15-159-124.fatmetal.net. Для расширения нужен полный адрес с ключом из письма, одного имени недостаточно.У этого API нет учетной записи, логин и пароль не нужны. Доступ дает закрытая ссылка из письма о готовности приложения: скопируйте ее адрес целиком, включая случайный ключ и окончание
/v2. При открытии ссылки появится подсказка подключения. Сохраните адрес как пароль и передавайте только тем, кому разрешена проверка текста.Установите расширение LanguageTool из магазина расширений своего браузера. Откройте его настройки, выберите «Экспериментальные настройки» -> «Другой сервер», вставьте закрытый адрес API и нажмите «Сохранить». Подключение и исправления проверены с расширением для Chrome 11.5.0.
При первом запуске на странице приветствия расширения нажмите «Ок, понятно», чтобы разрешить проверку через выбранный сервер. Если страница закрыта, откройте приветствие LanguageTool, подтвердите разрешение и перезагрузите страницы с полями текста.
В поле текста на странице браузера наберите «Я хочю проверить ашибки.», откройте подсказки расширения и выберите «хочу» и «ошибки». Для английского проверьте «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 уже выдается автоматически; свой домен подключается по желанию.
- Направьте
A-запись своего домена на IPv4 этого сервера. - Проверьте командой
ping proofread.example.org, подставив свой домен: имя должно показывать IP сервера. Пока показывает другой адрес, дождитесь обновления DNS. - Подключитесь по SSH учетной записью сервера из личного кабинета. Выполните
sudoedit /etc/languagetool-mp/params.envи задайтеDOMAIN="proofread.example.org", заменив пример на свой домен безhttps://и пути. Сохраните файл. - Выполните
sudo bash /opt/languagetool/install.sh. Установщик применит домен, Caddy получит для него сертификат Let's Encrypt. Ключ доступа сохранится. - В закрытом адресе API из письма о готовности замените только имя сервера на свой домен: получится
https://proofread.example.org/<ваш-ключ>/v2. Логин и пароль по-прежнему не нужны. В расширении LanguageTool откройте «Экспериментальные настройки» -> «Другой сервер», вставьте полученный адрес целиком и сохраните его.
Требования
Тариф CPU2-RAM4-DISK50 подходит для проверенного сценария: рабочие тексты на русском и английском до 19 тысяч знаков, в том числе два одновременных запроса примерно по 10 тысяч знаков. После прогрева приложение и Caddy занимают около 1068 МиБ RAM, наблюдаемый пик при проверках - 1084 МиБ. Два одновременных документа по 10 тысяч знаков обработались примерно за 1,1-1,4 секунды каждый.
Для постоянной массовой проверки документов перед переходом на CPU4-RAM8-DISK100 проверьте собственную нагрузку: число пользователей само по себе ее не определяет. Рецепт ограничен двумя рабочими потоками; увеличение тарифа автоматически не повышает этот предел.