LibreTranslate

Acceso

• Abre http://<SERVER_IP> en un navegador.
• La documentación de la API está disponible en /docs.
• Usa la clave API generada para las peticiones a la API. Está guardada en /root/libretranslate/.credentials.

Uso de la API

Ejemplo de petición de traducción:

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

Sustituye <API_KEY> por la clave API generada.

Configuración

Las principales variables de entorno están guardadas en /root/libretranslate/.env.

• LT_VERSION: versión de la imagen de LibreTranslate
• REQ_LIMIT: máximo de peticiones por minuto y por cliente
• CHAR_LIMIT: máximo de caracteres permitidos por petición

Modifica la configuración según necesites.

Después de cambiar la configuración, aplícala con:

cd /root/libretranslate
docker compose up -d

Archivos y directorios importantes

• Ruta de instalación: /root/libretranslate
• Archivo Compose: /root/libretranslate/docker-compose.yml
• Entorno: /root/libretranslate/.env
• Credenciales: /root/libretranslate/.credentials
• Modelos: /var/lib/docker/volumes/libretranslate_models
• Base de datos de claves: /var/lib/docker/volumes/libretranslate_db
• Configuración de Caddy: /etc/caddy/Caddyfile

Dominio y HTTPS (Caddy)

0. No se pueden emitir certificados HTTPS para direcciones IP.

1. Apunta un dominio (por ejemplo, example.com) a la dirección IP de su servidor.

2. Actualiza /etc/caddy/Caddyfile:

example.com {
    reverse_proxy localhost:5000
}

3. Recarga Caddy:

systemctl reload caddy

4. Accede a LibreTranslate en example.com.

Notas

• Modifica la configuración según tus preferencias en /root/libretranslate/.env.
• El modo Under Attack está activado por defecto para proteger la API pública frente a peticiones abusivas o automatizadas.
• La limitación de peticiones está activada con un límite por defecto de 60 peticiones por minuto y por cliente.
• Las peticiones están limitadas a 5000 caracteres por defecto.
• El contenedor de LibreTranslate solo escucha en 127.0.0.1:5000; Caddy proporciona el acceso público.