LibreTranslate

Zugriff

• Öffnen Sie http://<SERVER_IP> in einem Browser.
• Die API-Dokumentation finden Sie unter /docs.
• Verwenden Sie den generierten API-Schlüssel für API-Anfragen. Er ist gespeichert in /root/libretranslate/.credentials.

API-Nutzung

Beispiel für eine Übersetzungsanfrage:

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

Ersetzen Sie <API_KEY> durch den generierten API-Schlüssel.

Konfiguration

Die wichtigsten Umgebungsvariablen sind gespeichert in /root/libretranslate/.env.

• LT_VERSION: Version des LibreTranslate-Images
• REQ_LIMIT: Maximale Anfragen pro Minute und Client
• CHAR_LIMIT: Maximal erlaubte Zeichen pro Anfrage

Passen Sie die Konfiguration nach Bedarf an.

Übernehmen Sie Änderungen an der Konfiguration mit:

cd /root/libretranslate
docker compose up -d

Wichtige Dateien und Verzeichnisse

• Installationspfad: /root/libretranslate
• Compose-Datei: /root/libretranslate/docker-compose.yml
• Umgebung: /root/libretranslate/.env
• Zugangsdaten: /root/libretranslate/.credentials
• Modelle: /var/lib/docker/volumes/libretranslate_models
• Schlüssel-Datenbank: /var/lib/docker/volumes/libretranslate_db
• Caddy-Konfiguration: /etc/caddy/Caddyfile

Domain und HTTPS (Caddy)

0. HTTPS-Zertifikate können nicht für IP-Adressen ausgestellt werden.

1. Richte eine Domain (zum Beispiel example.com) zur IP-Adresse Ihres Servers.

2. Aktualisierung /etc/caddy/Caddyfile:

example.com {
    reverse_proxy localhost:5000
}

3. Laden Sie Caddy neu:

systemctl reload caddy

4. Rufen Sie LibreTranslate auf unter example.com.

Hinweise

• Passen Sie die Konfiguration nach Ihren Wünschen an in /root/libretranslate/.env.
• Der Under-Attack-Modus ist standardmäßig aktiviert, um die öffentliche API vor missbräuchlichen oder automatisierten Anfragen zu schützen.
• Die Anfragenbegrenzung ist aktiviert, mit einem Standardlimit von 60 Anfragen pro Minute und Client.
• Anfragen sind standardmäßig auf 5000 Zeichen begrenzt.
• Der LibreTranslate-Container lauscht nur auf 127.0.0.1:5000; Caddy stellt den öffentlichen Zugriff bereit.