دليل النشر

LibreTranslate على VPS: واجهة ترجمة خاصة بك

انشر على VPS Cloud ←

LibreTranslate على VPS: واجهة ترجمة خاصة بك

ترجمة صفحات المنتجات أو الإشعارات أو رسائل الدعم عبر واجهة برمجية على الإنترنت تعني إرسال كل نص إلى طرف ثالث والدفع حسب عدد الأحرف. يقوم LibreTranslate بالعمل نفسه على خادمك: واجهة JSON مفتوحة المصدر للترجمة الآلية، مبنية على نماذج Argos Translate التي تعمل دون اتصال. يشرح هذا الدليل تثبيته على خادم VPS باستخدام Docker Compose، وتحميل العربية والفرنسية والإنجليزية والإسبانية، وإغلاق النسخة بمفاتيح API، ونشرها عبر HTTPS خلف nginx، ثم استدعاءها من تطبيق.

7 دقائق للقراءةعدد الخطوات: 4
المحتويات· ماذا يفعل LibreTranslate1/13
  1. 01ماذا يفعل LibreTranslate
  2. 02ما يقدمه LibreTranslate
  3. 03LibreTranslate مقارنة بالواجهات عبر الإنترنت
  4. 04المتطلبات
  5. 05تثبيت LibreTranslate باستخدام Docker Compose
  6. 06لا تنشر أبدًا نسخة دون مفاتيح
  7. 07وضع LibreTranslate خلف nginx عبر HTTPS
  8. 08استدعاء الواجهة من تطبيق
  9. 09إدارة مفاتيح API والحدود
  10. 10ضبط LibreTranslate لخادم صغير
  11. 11ما يجب معرفته عن الجودة
  12. 12إضافة لغات والنسخ الاحتياطي والتحديث
  13. 13التثبيت بنقرة واحدة على ServOrbit

ماذا يفعل LibreTranslate

يوفّر LibreTranslate واجهة HTTP تستقبل نصًا ولغته المصدر ولغة هدفًا، وتعيد الترجمة. النماذج هي نماذج Argos Translate، وهو محرك ترجمة عصبية يعمل دون اتصال: بعد تنزيلها تعمل على معالج الخادم، دون بطاقة رسومية ودون أي استدعاء لخدمة خارجية.

المشروع منشور برخصة AGPL-3.0. ويوفّر أيضًا واجهة ويب لترجمة نص أو ملف يدويًا، وكشفًا للغة، وإدارة لمفاتيح API مع حدّ للطلبات لكل مفتاح. على خادم VPS، هو اللبنة التي تتيح لموقع أو لمنصة SaaS أو لأداة داخلية التحدث بعدة لغات دون الاعتماد على مزوّد.

ما يقدمه LibreTranslate

  • واجهة بسيطة — /translate و/detect و/languages بصيغة JSON، قابلة للاستدعاء من أي لغة برمجة.
  • العربية والفرنسية — مع الإنجليزية والإسبانية، أربع لغات تُحمَّل منذ البداية بكل التركيبات.
  • كشف اللغة — مصدر auto للرسائل التي لا تعرف لغتها.
  • ترجمة الملفات — txt وdocx وodt وpptx وepub وhtml وsrt وpdf.
  • مفاتيح API — مفتاح لكل تطبيق، ولكل مفتاح حدّه من الطلبات في الدقيقة.
  • السرية — تبقى النصوص على خادمك، ولا شيء يُحتسب حسب الأحرف.

LibreTranslate مقارنة بالواجهات عبر الإنترنت

مرّر الجدول أفقيًا

LibreTranslateGoogle Cloud TranslationDeepL API
الاستضافةخادمكسحابة Googleسحابة DeepL
مصير النصوصتبقى على الخادمتُرسل إلى المزوّدتُرسل إلى المزوّد
الفوترةالخادم فقطحسب الأحرفحسب الأحرف
الجودةمقبولة، يُنصح بالمراجعةجيدة جدًاجيدة جدًا
الشيفرة المصدريةمفتوحة (AGPL-3.0)مغلقةمغلقة

المتطلبات

يكفي خادم Ubuntu 24.04 بذاكرة 2 غيغابايت ومعالجين افتراضيين لأربع لغات وحركة مرور متوسطة؛ خطّط لـ 4 غيغابايت إذا كانت عدة تطبيقات تترجم في الوقت نفسه. احسب نحو 750 ميغابايت من القرص لنماذج اللغات الأربع، ثم نحو مئة ميغابايت لكل زوج يُضاف.

تحتاج إلى Docker مع إضافة Compose، وإلى nginx وcertbot على الخادم، وإلى اسم (traduction.example.com في هذا الدليل) يشير إلى عنوان IP الخاص بالخادم.

تثبيت LibreTranslate باستخدام Docker Compose

  1. كتابة ملف docker-compose.yml

    في مجلد مخصص (/opt/libretranslate) أنشئ هذا الملف. يُنشر المنفذ على واجهة الحلقة المحلية فقط. يفعّل LT_API_KEYS قاعدة المفاتيح، ويرفض LT_UNDER_ATTACK أي طلب دون مفتاح صالح بما في ذلك واجهة الويب، ويحصر LT_LOAD_ONLY التنزيل في اللغات الأربع المفيدة.

    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. التشغيل وانتظار النماذج

    عند أول تشغيل، ينزّل LibreTranslate النماذج قبل فتح المنفذ: تابع السجلات حتى يظهر السطر Listening at.

    docker compose up -d
    docker compose logs -f libretranslate
  3. إنشاء أول مفتاح

    تُنشأ قاعدة المفاتيح عند التشغيل. أضف مفتاحًا بحدّ 120 طلبًا في الدقيقة؛ يعرضه الأمر مرة واحدة فقط.

    docker compose exec libretranslate ./venv/bin/ltmanage keys add 120
  4. التحقق من أن المفتاح مطلوب

    يجب أن يُرفض الطلب الأول الذي لا يحمل مفتاحًا، بينما يعيد الطلب الثاني 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":"YOUR_KEY"}'

لا تنشر أبدًا نسخة دون مفاتيح

دون LT_API_KEYS وLT_UNDER_ATTACK يترجم LibreTranslate لكل من يعرف العنوان. النسخة المفتوحة تكتشفها الروبوتات بسرعة وتستغلها: فيعمل معالجك لحسابها. أبقِ المنفذ على 127.0.0.1 ودع nginx وحده في مواجهة الإنترنت.

وضع LibreTranslate خلف nginx عبر HTTPS

أنشئ كتلة server في /etc/nginx/sites-available/ وفعّلها. يحدّد client_max_body_size الحجم الأقصى للملف المرسل للترجمة: دون هذا السطر يرفض nginx أي ملف يتجاوز 1 ميغابايت.

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;
    }
}

ثم تحقّق من الإعداد واطلب الشهادة:

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

استدعاء الواجهة من تطبيق

كل طلب هو POST بصيغة JSON يتضمن النص (q) ولغة المصدر (source أو auto) واللغة الهدف (target) والمفتاح (api_key).

curl -s https://traduction.example.com/translate -H "Content-Type: application/json" \
  -d '{"q":"Your order has shipped.","source":"fr","target":"ar","api_key":"YOUR_KEY"}'

وفي Python يكفي بضعة أسطر للطلب نفسه:

import requests

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

يسرد /languages الأزواج المتاحة، ويعيد /detect لغة النص مع درجة الثقة، ويترجم /translate_file ملفًا مرسلًا بصيغة multipart.

إدارة مفاتيح API والحدود

أنشئ مفتاحًا لكل تطبيق أو لكل عميل: يمكنك إلغاء أحدها دون المساس بالبقية، ولكل مفتاح حدّه من الطلبات في الدقيقة. من مجلد التطبيق:

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 <key>

يتلقى المفتاح غير المعروف الرسالة Invalid API key، والطلب دون مفتاح الرسالة Please contact the server operator to get an API key. في واجهة الويب، تحفظ أيقونة المفتاح («Set API Key») أعلى الصفحة المفتاح في المتصفح.

ضبط LibreTranslate لخادم صغير

تكفي أربعة متغيرات بيئة لملاءمة النسخة مع حجم الخادم. يحدّد LT_THREADS عدد عمليات الترجمة: كل عملية تحمّل النماذج في الذاكرة، ولهذا القيمة 2 على خادم بذاكرة 2 غيغابايت؛ ارفعها إذا توفرت الذاكرة وكانت عدة تطبيقات تترجم بالتوازي. يضع LT_CHAR_LIMIT حدًا لطول النص في كل طلب، حتى لا يشغل طلب واحد عملية لدقائق. يوقف LT_DISABLE_FILES_TRANSLATION ترجمة الملفات إن لم تكن تستخدمها، ويزيل LT_DISABLE_WEB_UI واجهة الويب للإبقاء على الواجهة البرمجية وحدها.

بعد كل تعديل في docker-compose.yml أعد التشغيل بالأمر docker compose up -d: يُعاد إنشاء الحاوية وتبقى المجلدات، أي المفاتيح والنماذج. راقب الذاكرة بالأمر docker stats خلال يوم من الاستخدام الفعلي قبل تثبيت هذه القيم.

ما يجب معرفته عن الجودة

نماذج Argos Translate أصغر بكثير من نماذج الخدمات التجارية. تبقى الترجمة موثوقة لفهم رسالة وفرز التذاكر وإنتاج مسودة أولى وترجمة المحتوى اليومي؛ وهي أقل دقة في التعابير الاصطلاحية والمفردات المتخصصة جدًا والنصوص الأدبية الطويلة.

قاعدة بسيطة: ترجم آليًا ما يساعدك على الفهم، واجعل شخصًا يراجع ما سيُنشر باسمك — صفحات البيع والشروط العامة ورسائل التسويق. واختبر جملك الخاصة في الاتجاهين قبل ربط أي تطبيق: تختلف الجودة من زوج لغات إلى آخر، وغالبًا ما تكون الإنجليزية لغة وسيطة بين لغتين غير الإنجليزية.

إضافة لغات والنسخ الاحتياطي والتحديث

لإضافة لغة، أضف رمزها (de وit وpt وtr…) إلى LT_LOAD_ONLY وأعد التشغيل بالأمر docker compose up -d: تُنزَّل النماذج الناقصة عند التشغيل.

ما يجب نسخه احتياطيًا: المجلد lt-db وحده، لأنه يحتوي على قاعدة المفاتيح. أما نماذج lt-models فتُنزَّل من جديد تلقائيًا، ولا يحتفظ LibreTranslate بالنصوص المترجمة. للتحديث، غيّر وسم الصورة في docker-compose.yml بعد قراءة ملاحظات الإصدار، ثم:

docker compose pull
docker compose up -d

التثبيت بنقرة واحدة على ServOrbit

على خادم ServOrbit، يُثبَّت LibreTranslate من المتجر: ينشر السكربت الصورة الرسمية مع العربية والفرنسية والإنجليزية والإسبانية، ويولّد مفتاح API الخاص بك، ويُغلق النسخة أمام أي طلب دون مفتاح، ويضبط nginx عبر HTTPS. العنوان نطاق فرعي من أحد نطاقاتك أو النطاق الفرعي المجاني للخادم مع الشهادة، ويظهر المفتاح في مساحة العميل.

شارك هذا المقالservorbit.com/ma-ar/المدونة/استضافة-libretranslate-على-vps