Guide de déploiement

LibreTranslate sur VPS : votre API de traduction privée

Déployer sur un VPS Cloud →

Tutoriel

Self-hosting

LibreTranslate sur VPS : votre API de traduction privée

Traduire des fiches produit, des notifications ou des messages de support par une API en ligne, c'est envoyer chaque texte à un tiers et payer au caractère. LibreTranslate fait le même travail sur votre propre serveur : une API JSON de traduction automatique, open source, construite sur les modèles hors ligne d'Argos Translate. Ce guide l'installe sur un VPS avec Docker Compose, charge l'arabe, le français, l'anglais et l'espagnol, ferme l'instance par des clés d'API, la publie en HTTPS derrière nginx et l'appelle depuis une application.

7 min de lecture4 étapes
Sommaire· Ce que fait LibreTranslate1/13
  1. 01Ce que fait LibreTranslate
  2. 02Ce que LibreTranslate apporte
  3. 03LibreTranslate face aux API en ligne
  4. 04Prérequis
  5. 05Installer LibreTranslate avec Docker Compose
  6. 06Ne publiez jamais une instance sans clé
  7. 07Placer LibreTranslate derrière nginx en HTTPS
  8. 08Appeler l'API depuis une application
  9. 09Gérer les clés d'API et les limites
  10. 10Régler LibreTranslate pour un petit VPS
  11. 11Ce qu'il faut savoir sur la qualité
  12. 12Ajouter des langues, sauvegarder et mettre à jour
  13. 13Installation en un clic sur ServOrbit

Ce que fait LibreTranslate

LibreTranslate expose une API HTTP qui reçoit un texte, sa langue source et une langue cible, et renvoie la traduction. Les modèles sont ceux d'Argos Translate, un moteur de traduction neuronale qui fonctionne sans connexion : une fois téléchargés, ils tournent sur le processeur du VPS, sans carte graphique et sans appel à un service extérieur.

Le projet est publié sous licence AGPL-3.0. Il fournit aussi une interface web pour traduire à la main un texte ou un fichier, une détection de langue, et une gestion de clés d'API avec une limite de requêtes par clé. Sur un VPS, c'est la brique qui permet à un site, à un SaaS ou à un outil interne de parler plusieurs langues sans dépendre d'un fournisseur.

Ce que LibreTranslate apporte

  • Une API simple — /translate, /detect et /languages, en JSON, appelables depuis n'importe quel langage.
  • L'arabe et le français — avec l'anglais et l'espagnol, quatre langues chargées d'emblée, dans toutes les combinaisons.
  • La détection de langue — une source auto pour les messages dont vous ignorez la langue.
  • La traduction de fichiers — txt, docx, odt, pptx, epub, html, srt et pdf.
  • Des clés d'API — une par application, chacune avec sa limite de requêtes par minute.
  • La confidentialité — les textes restent sur votre serveur, et rien n'est facturé au caractère.

LibreTranslate face aux API en ligne

Faites défiler le tableau

LibreTranslateGoogle Cloud TranslationDeepL API
HébergementVotre VPSCloud GoogleCloud DeepL
Où vont les textesRestent sur le serveurEnvoyés au fournisseurEnvoyés au fournisseur
FacturationLe VPS seulAu caractèreAu caractère
QualitéCorrecte, relecture conseilléeTrès bonneTrès bonne
Code sourceOuvert (AGPL-3.0)FerméFermé

Prérequis

Un VPS Ubuntu 24.04 avec 2 Go de RAM et 2 vCPU suffit pour quatre langues et un trafic modeste ; prévoyez 4 Go si plusieurs applications traduisent en même temps. Comptez environ 750 Mo de disque pour les modèles des quatre langues, puis une centaine de mégaoctets par paire ajoutée.

Il vous faut Docker avec le plugin Compose, nginx et certbot sur l'hôte, et un nom (traduction.example.com dans ce guide) qui pointe vers l'IP du VPS.

Installer LibreTranslate avec Docker Compose

  1. Écrire le fichier docker-compose.yml

    Dans un dossier dédié (/opt/libretranslate), créez ce fichier. Le port est publié sur la seule boucle locale. LT_API_KEYS active la base de clés, LT_UNDER_ATTACK refuse toute requête sans clé valide, interface web comprise, et LT_LOAD_ONLY limite le téléchargement aux quatre langues utiles.

    services:
      libretranslate:
        image: libretranslate/libretranslate:v1.9.6
        restart: unless-stopped
        ports:
          - "127.0.0.1:5000:5000"
        environment:
          LT_API_KEYS: "true"
          LT_UNDER_ATTACK: "true"
          LT_LOAD_ONLY: "en,fr,ar,es"
          LT_THREADS: "2"
        volumes:
          - lt-db:/app/db
          - lt-models:/home/libretranslate/.local
    
    volumes:
      lt-db:
      lt-models:
  2. Démarrer et attendre les modèles

    Au premier démarrage, LibreTranslate télécharge les modèles avant d'ouvrir le port : suivez les journaux jusqu'à la ligne Listening at.

    docker compose up -d
    docker compose logs -f libretranslate
  3. Créer votre première clé

    La base de clés est créée au démarrage. Ajoutez une clé limitée à 120 requêtes par minute ; la commande l'affiche une seule fois.

    docker compose exec libretranslate ./venv/bin/ltmanage keys add 120
  4. Vérifier que la clé est exigée

    La première requête, sans clé, doit être refusée ; la seconde renvoie translatedText.

    curl -s http://127.0.0.1:5000/translate -H "Content-Type: application/json" \
      -d '{"q":"Bonjour","source":"fr","target":"en"}'
    curl -s http://127.0.0.1:5000/translate -H "Content-Type: application/json" \
      -d '{"q":"Bonjour","source":"fr","target":"en","api_key":"VOTRE_CLE"}'

Ne publiez jamais une instance sans clé

Sans LT_API_KEYS ni LT_UNDER_ATTACK, LibreTranslate traduit pour quiconque connaît l'adresse. Une instance ouverte est vite trouvée et utilisée par des robots : c'est votre processeur qui travaille pour eux. Gardez le port sur 127.0.0.1 et laissez nginx seul face à Internet.

Placer LibreTranslate derrière nginx en HTTPS

Créez un server block dans /etc/nginx/sites-available/ et activez-le. client_max_body_size fixe la taille maximale d'un fichier envoyé à traduire : sans cette ligne, nginx refuse tout envoi de plus de 1 Mo.

server {
    server_name traduction.example.com;
    client_max_body_size 20m;

    location / {
        proxy_pass http://127.0.0.1:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
    }
}

Puis vérifiez la configuration et demandez le certificat :

sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d traduction.example.com

Appeler l'API depuis une application

Toute requête est un POST JSON avec le texte (q), la langue source (source, ou auto), la langue cible (target) et la clé (api_key).

curl -s https://traduction.example.com/translate -H "Content-Type: application/json" \
  -d '{"q":"Votre commande est expédiée.","source":"fr","target":"ar","api_key":"VOTRE_CLE"}'

En Python, la même requête tient en quelques lignes :

import requests

r = requests.post(
    "https://traduction.example.com/translate",
    json={"q": "Your invoice is ready.", "source": "auto", "target": "es", "api_key": "VOTRE_CLE"},
    timeout=30,
)
print(r.json()["translatedText"])

/languages liste les paires disponibles, /detect renvoie la langue d'un texte avec un indice de confiance, et /translate_file traduit un fichier envoyé en multipart.

Gérer les clés d'API et les limites

Créez une clé par application ou par client : vous pourrez en révoquer une sans toucher aux autres, et chaque clé porte sa propre limite de requêtes par minute. Depuis le dossier de l'application :

docker compose exec libretranslate ./venv/bin/ltmanage keys
docker compose exec libretranslate ./venv/bin/ltmanage keys add 60
docker compose exec libretranslate ./venv/bin/ltmanage keys remove <cle>

Une clé inconnue reçoit Invalid API key, une requête sans clé Please contact the server operator to get an API key. Dans l'interface web, l'icône en forme de clé (« Set API Key ») en haut de la page enregistre la clé dans le navigateur.

Régler LibreTranslate pour un petit VPS

Quatre variables d'environnement suffisent à adapter l'instance à la taille du serveur. LT_THREADS fixe le nombre de processus de traduction : chacun charge les modèles en mémoire, d'où la valeur de 2 sur un VPS de 2 Go ; montez-la si vous avez de la RAM et plusieurs applications qui traduisent en parallèle. LT_CHAR_LIMIT plafonne la longueur d'un texte par requête, ce qui évite qu'un seul appel occupe un processus pendant des minutes. LT_DISABLE_FILES_TRANSLATION coupe la traduction de fichiers si vous ne l'utilisez pas, et LT_DISABLE_WEB_UI retire l'interface web pour ne garder que l'API.

Après chaque changement dans docker-compose.yml, relancez avec docker compose up -d : le conteneur est recréé, les volumes et donc les clés et les modèles sont conservés. Surveillez la mémoire avec docker stats pendant une journée d'usage réel avant de fixer ces valeurs pour de bon.

Ce qu'il faut savoir sur la qualité

Les modèles d'Argos Translate sont bien plus petits que ceux des services commerciaux. La traduction reste fiable pour comprendre un message, trier des tickets, produire un premier jet ou traduire du contenu courant ; elle est moins sûre sur les tournures idiomatiques, le vocabulaire très spécialisé et les textes longs et littéraires.

Une règle simple : traduisez automatiquement ce qui sert à comprendre, et faites relire par une personne ce qui sera publié sous votre nom — pages de vente, conditions générales, courriels marketing. Testez aussi vos propres phrases dans les deux sens avant de brancher une application : la qualité varie d'une paire de langues à l'autre, et l'anglais sert souvent de pivot entre deux langues qui ne sont pas l'anglais.

Ajouter des langues, sauvegarder et mettre à jour

Pour ajouter une langue, complétez LT_LOAD_ONLY avec son code (de, it, pt, tr…) et relancez avec docker compose up -d : les modèles manquants se téléchargent au démarrage.

À sauvegarder : le seul volume lt-db, qui contient la base des clés. Les modèles de lt-models se retéléchargent d'eux-mêmes, et LibreTranslate ne conserve pas les textes traduits. Pour mettre à jour, changez le tag de l'image dans docker-compose.yml après avoir lu les notes de version, puis :

docker compose pull
docker compose up -d

Installation en un clic sur ServOrbit

Sur un VPS ServOrbit, LibreTranslate s'installe depuis le Marketplace : le script déploie l'image officielle avec l'arabe, le français, l'anglais et l'espagnol, génère votre clé d'API, ferme l'instance à toute requête sans clé et configure nginx en HTTPS. L'adresse est un sous-domaine de l'un de vos domaines ou le sous-domaine gratuit du VPS, certificat compris, et la clé s'affiche dans votre espace client.

Partager cet articleservorbit.com/ma-fr/blog/self-host-libretranslate-vps