ماذا يفعل 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 مقارنة بالواجهات عبر الإنترنت
مرّر الجدول أفقيًا
| LibreTranslate | Google Cloud Translation | DeepL API | |
|---|---|---|---|
| الاستضافة | خادمك | سحابة Google | سحابة DeepL |
| مصير النصوص | تبقى على الخادم | تُرسل إلى المزوّد | تُرسل إلى المزوّد |
| الفوترة | الخادم فقط | حسب الأحرف | حسب الأحرف |
| الجودة | مقبولة، يُنصح بالمراجعة | جيدة جدًا | جيدة جدًا |
| الشيفرة المصدرية | مفتوحة (AGPL-3.0) | مغلقة | مغلقة |
المتطلبات
يكفي خادم Ubuntu 24.04 بذاكرة 2 غيغابايت ومعالجين افتراضيين لأربع لغات وحركة مرور متوسطة؛ خطّط لـ 4 غيغابايت إذا كانت عدة تطبيقات تترجم في الوقت نفسه. احسب نحو 750 ميغابايت من القرص لنماذج اللغات الأربع، ثم نحو مئة ميغابايت لكل زوج يُضاف.
تحتاج إلى Docker مع إضافة Compose، وإلى nginx وcertbot على الخادم، وإلى اسم (traduction.example.com في هذا الدليل) يشير إلى عنوان IP الخاص بالخادم.
تثبيت LibreTranslate باستخدام Docker Compose
كتابة ملف 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:التشغيل وانتظار النماذج
عند أول تشغيل، ينزّل LibreTranslate النماذج قبل فتح المنفذ: تابع السجلات حتى يظهر السطر
Listening at.docker compose up -d docker compose logs -f libretranslateإنشاء أول مفتاح
تُنشأ قاعدة المفاتيح عند التشغيل. أضف مفتاحًا بحدّ 120 طلبًا في الدقيقة؛ يعرضه الأمر مرة واحدة فقط.
docker compose exec libretranslate ./venv/bin/ltmanage keys add 120التحقق من أن المفتاح مطلوب
يجب أن يُرفض الطلب الأول الذي لا يحمل مفتاحًا، بينما يعيد الطلب الثاني
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