LibreTranslate

Доступ

• Откройте http://<SERVER_IP> в браузере.
• Документация API доступна по адресу /docs.
• Используйте сгенерированный API-ключ для запросов к API. Он хранится в /root/libretranslate/.credentials.

Использование API

Пример запроса на перевод:

curl -X POST http://<SERVER_IP>/translate \
  -d q='Hello' \
  -d source=en \
  -d target=es \
  -d api_key='<API_KEY>'

Замените <API_KEY> на сгенерированный API-ключ.

Конфигурация

Основные переменные окружения хранятся в /root/libretranslate/.env.

• LT_VERSION: версия образа LibreTranslate
• REQ_LIMIT: максимальное число запросов в минуту на одного клиента
• CHAR_LIMIT: максимальное число символов в одном запросе

Измените конфигурацию по своему усмотрению.

После изменения конфигурации примените её командой:

cd /root/libretranslate
docker compose up -d

Важные файлы и директории

• Путь установки: /root/libretranslate
• Файл Compose: /root/libretranslate/docker-compose.yml
• Окружение: /root/libretranslate/.env
• Учётные данные: /root/libretranslate/.credentials
• Модели: /var/lib/docker/volumes/libretranslate_models
• База ключей: /var/lib/docker/volumes/libretranslate_db
• Конфигурация Caddy: /etc/caddy/Caddyfile

Домен и HTTPS (Caddy)

0. HTTPS-сертификаты нельзя выпустить для IP-адресов.

1. Направьте домен (например, example.com) на IP-адрес вашего сервера.

2. Обновите /etc/caddy/Caddyfile:

example.com {
    reverse_proxy localhost:5000
}

3. Перезагрузите Caddy:

systemctl reload caddy

4. Откройте LibreTranslate по адресу example.com.

Примечания

• Измените конфигурацию под свои предпочтения в /root/libretranslate/.env.
• Режим Under Attack включён по умолчанию, чтобы защитить публичный API от злоупотреблений и автоматизированных запросов.
• Ограничение запросов включено, лимит по умолчанию 60 запросов в минуту на одного клиента.
• Запросы по умолчанию ограничены 5000 символами.
• Контейнер LibreTranslate слушает только 127.0.0.1:5000; публичный доступ обеспечивает Caddy.