LibreTranslate

Accesso

• Apri http://<SERVER_IP> in un browser.
• La documentazione dell'API è disponibile su /docs.
• Usa la chiave API generata per le richieste API. È salvata in /root/libretranslate/.credentials.

Utilizzo dell'API

Esempio di richiesta di traduzione:

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

Sostituisci <API_KEY> con la chiave API generata.

Configurazione

Le principali variabili d'ambiente sono salvate in /root/libretranslate/.env.

• LT_VERSION: versione dell'immagine LibreTranslate
• REQ_LIMIT: numero massimo di richieste al minuto per client
• CHAR_LIMIT: numero massimo di caratteri consentiti per richiesta

Modifica la configurazione secondo le tue esigenze.

Dopo aver modificato la configurazione, applicala con:

cd /root/libretranslate
docker compose up -d

File e directory importanti

• Percorso di installazione: /root/libretranslate
• File Compose: /root/libretranslate/docker-compose.yml
• Ambiente: /root/libretranslate/.env
• Credenziali: /root/libretranslate/.credentials
• Modelli: /var/lib/docker/volumes/libretranslate_models
• Database delle chiavi: /var/lib/docker/volumes/libretranslate_db
• Configurazione Caddy: /etc/caddy/Caddyfile

Dominio e HTTPS (Caddy)

0. I certificati HTTPS non possono essere emessi per indirizzi IP.

1. Punta un dominio (ad esempio, example.com) all'indirizzo IP del tuo server.

2. Aggiorna /etc/caddy/Caddyfile:

example.com {
    reverse_proxy localhost:5000
}

3. Ricarica Caddy:

systemctl reload caddy

4. Accedi a LibreTranslate su example.com.

Note

• Modifica la configurazione in base alle tue preferenze in /root/libretranslate/.env.
• La modalità Under Attack è attiva per impostazione predefinita per proteggere l'API pubblica da richieste abusive o automatizzate.
• La limitazione delle richieste è attiva con un limite predefinito di 60 richieste al minuto per client.
• Le richieste sono limitate a 5000 caratteri per impostazione predefinita.
• Il container LibreTranslate è in ascolto solo su 127.0.0.1:5000; Caddy fornisce l'accesso pubblico.