🌐 تثبيت Tolgee — منصة إدارة الترجمة والتعريب المباشر للمطورين على Docker

نشر منصة Tolgee على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة عالمياً لإدارة الترجمة والتعريب البرمجي (TMS) مع ميزة التعديل المباشر بالمتصفح (In-Context) والترجمة الآلية على المنفذ 8212.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت مؤتمت — أمر واحد ينشر Tolgee على المنفذ 8212 مع قاعدة بيانات PostgreSQL المدمجة ومحرك الترجمة الفورية والـ API جاهزاً.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/tolgee/tolgee-ubuntu.sh
chmod +x tolgee-ubuntu.sh
sudo bash tolgee-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/tolgee/tolgee-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x tolgee-ubuntu.sh

3 تشغيل المثبت

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم لقاعدة البيانات والصور (`./data`) وتشغيل حاوية Tolgee الرسمية على المنفذ 8212 (المحول من 8080 الداخلي).

sudo bash tolgee-ubuntu.sh

4 إنشاء حساب المشرف وربط حزمة المطورين SDK

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8212. أنشئ حساب المشرف الأول، وأنشئ مشروعك وحدد لغات التطبيق، واربط حزمة Tolgee SDK بتطبيق React أو Next.js أو Vue الخاص بك.

http://<your-server-ip>:8212

المنافذ المستخدمة

المنفذالغرض
8212Web UI + API (host → container 8080)
embeddedPostgreSQL auto-starts inside the container

نظرة عامة

تعد Tolgee منصة إدارة وترجمة وتعريب البرمجيات (Translation Management Platform - TMS) مفتوحة المصدر المصممة خصيصاً للمطورين وفرق البرمجة. تعمل المنصة عبر المنفذ 8212 (المحول من 8080 الداخلي)، لتقدم ميزة ثورية تتمثل في الترجمة الحية داخل السياق (In-Context Translation) مباشرة على واجهات الويب الحية (React وVue وAngular وNext.js). حيث يمكن للمترجم الضغط على زر Alt مع النقر على أي نص بالموقع لتعديل ترجمته فورياً، وتوليد لقطات شاشة تلقائية بـ OCR، واستخدام الترجمة الآلية بالذكاء الاصطناعي (DeepL وGoogle وOpenAI)، ومزامنة النصوص عبر Git.

لماذا تستخدمه

يؤدي التعامل اليدوي مع ملفات التعريب JSON داخل مستودعات Git إلى تعارضات الدمج وضياع النصوص وافتقار المترجمين للسياق البصري للواجهات. كما تفرض المنصات السحابية التجارية (مثل Crowdin وLokalise وPhrase) اشتراكات شهرية باهظة تُحسب بعدد الكلمات والمستخدمين. تمنحك Tolgee منصة تعريب متكاملة ومستضافة ذاتياً بدون أي رسوم تراخيص، مع ميزة التعديل البصري المباشر على الواجهات، وسيادة كاملة لبياناتك البرمجية.

متى تحتاجه

  • تطور تطبيقات ويب أو هواتف وتحتاج لمنصة مؤتمتة لإدارة ترجمات اللغات المتعددة (i18n) بكفاءة
  • تريد ميزة الترجمة بالسياق المباشر (In-Context) لتعديل النصوص العربية والإنجليزية بنقرة زر على موقعك الحي
  • تحتاج إلى توليد لقطات شاشة تلقائية للواجهات توضح للمترجمين موقع النص بدقة لمنع أخطاء الترجمة السياقية
  • تريد الاستفادة من اقتراحات الترجمة الآلية الفورية (DeepL وGoogle Translate وOpenAI) لتسريع التعريب
  • تبحث عن بديل مفتوح المصدر ومستضاف ذاتياً لمنصات Crowdin وLokalise وPhrase باهظة الثمن

من يحتاجه

  • مطورو الواجهات الأمامية وفرق البرمجة لتطبيقات الويب والهواتف متعددة اللغات
  • مديرو المنتجات ومسؤولو الترجمة والتعريب لإدارة المترجمين المحترفين والمساهمين المجتمعيين
  • الشركات الناشئة للتوسع في الأسواق العالمية ودعم اللغات العربية والأوروبية والآسيوية بسلاسة
  • المشاريع البرمجية مفتوحة المصدر لفتح باب المساهمة في التعريب لمتطوعين من جميع أنحاء العالم
  • أصحاب السيرفرات المنزلية لاستضافة أدوات المطورين والإنتاجية البرمجية على خوادم لينكس

حالات الاستخدام الشائعة

  • الضغط بـ Alt+Click على أي جملة في موقع React لتعديل الترجمة العربية وإرفاق لقطة شاشة تلقائياً
  • دمج أداة Tolgee CLI في خطوط GitHub Actions لتصدير ملفات ترجمة JSON مبنية تلقائياً عند كل إصدار برمجيات
  • الترجمة الآلية المسبقة لـ 100 نص إنجليزي جديد إلى 5 لغات بنقرة زر واحدة عبر محرك DeepL
  • دعوة المترجمين المستقلين للوحة التحكم مع تقييد صلاحياتهم على لغات محددة فقط
  • إدارة قواعد الجمع المعقدة بصيغ ICU MessageFormat والمتغيرات الديناميكية دون كسر الأكواد

الميزات الرئيسية

  • الترجمة الحية بالسياق (In-Context): تعديل النصوص البرمجية مباشرة من داخل التطبيق أثناء تصفحه بـ Alt+Click
  • التقاط الشاشات التلقائي بنقرة واحدة: حفظ لقطات شاشة للواجهة مع تحديد موضع النص بدقة لمنح المترجم السياق الكامل
  • تكامل مع محركات الترجمة الآلية: ربط خدمات DeepL وGoogle Translate وAWS وOpenAI لاقتراحات فورية
  • حزم SDK رسمية لكافة الواجهات: دعم كامل لـ React وNext.js وVue وSvelte وAngular وجافاسكريبت النقية
  • مزامنة مؤتمتة بـ CLI وCI/CD: سحب ورفع ملفات الترجمة تلقائياً عبر سكريبتات GitHub Actions
  • دعم صيغ ICU المتطورة: معالجة نصوص الجمع، وصيغ المذكر والمؤنث، والمتغيرات الديناميكية
  • إدارة المستخدمين والصلاحيات على المنفذ 8212: صلاحيات دقيقة للمشرفين، والمراجعين، والمترجمين
  • معمارية Docker Compose تجمع Tolgee مع ربط مجلد `./data` لحفظ قاعدة البيانات والمشاريع والصور

كيفية الاستخدام بعد التثبيت

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8212 لبدء شاشة Tolgee
  • أنشئ حساب المشرف الأول بالبريد الإلكتروني وكلمة المرور الآمنة
  • اضغط على '+ Add Project' وحدد اللغة الأساسية (مثل الإنجليزية) واللغات المستهدفة (مثل العربية والفرنسية)
  • استخرج مفتاح API للمشروع من Project Settings ← API Keys
  • ثبت حزمة Tolgee في تطبيقك (`npm install @tolgee/react`) واضبط رابط السيرفر ومفتاح الـ API
  • ضع Tolgee خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
  • أعد سكريبت نسخ احتياطي دوري لمجلد البيانات `./data`

أفضل ممارسات الأمان

  • تنبيه أمني حاسم: غيّر كلمة مرور المشرف فوراً وعطّل التسجيل المفتوح للعامة من الإعدادات
  • استخدم تشفير HTTPS دائماً في الإنتاج لحماية مفاتيح الـ API وبيانات الدخول المنقولة بالشبكة
  • استخدم مفاتيح API مقيدة (مثل مفاتيح للقراءة فقط لحزم الإنتاج ومفاتيح للتعديل في بيئة التطوير)
  • لا تنشر مفاتيح API ذات الصلاحيات الكاملة داخل مستودعات Git العامة نهائياً
  • احمِ مجلد البيانات `./data` الذي يحتوي على قاعدة البيانات ولقطات الشاشة بصلاحيات نظام مناسبة بالسيرفر
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار

المنافذ وإعدادات جدار الحماية

يقدم Tolgee واجهة الويب والـ REST API عبر منفذ TCP 8212 (المحول من 8080 الداخلي). يجب السماح بالمنفذ 8212 في جدار الحماية للشبكة المحلية (`ufw allow 8212/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8212، مع إبقاء المنفذ 8212 مغلقاً خارجياً.

النسخ الاحتياطي والصيانة

  • انسخ مجلد `./data` احتياطياً، والذي يحتوي على كامل قاعدة بيانات PostgreSQL المدمجة بالمشاريع ومفاتيح الترجمة والمستخدمين
  • انسخ لقطات الشاشة المرفوعة والمحفوظة داخل مجلد البيانات
  • احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env` الذي يحتوي على مفاتيح الترجمة الآلية
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من استرجاع المشاريع بنجاح

الأخطاء الشائعة

  • وضع مفاتيح API بصلاحية التعديل داخل حزم الإنتاج المتاحة للعامة بدلاً من تصدير ملفات JSON ثابتة
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر مما يمنع عمل أداة التعديل المباشر بالمتصفح
  • عدم ربط مجلد التخزين الدائم `./data`، مما يسبب فقدان المشاريع والترجمات عند تحديث الحاوية
  • نسيان إدخال مفاتيح خدمات الترجمة الآلية (DeepL أو Google) مما يعطل ميزة الاقتراحات التلقائية
  • ترك تسجيل المستخدمين الجدد مفتوحاً للعامة على سيرفر متصل بالإنترنت

استكشاف الأخطاء وإصلاحها

  • نافذة التعديل المباشر لا تظهر عند الضغط بـ Alt+Click — تأكد من تفعيل وضع التطوير (`NODE_ENV=development`) وتفعيل حزمة المطورين
  • اقتراحات الترجمة الآلية تفشل — تأكد من صحة مفاتيح الـ API في Project Settings ← Machine Translation Services
  • ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs tolgee -f`
  • فشل حفظ لقطات الشاشة — راجع صلاحيات مجلد البيانات بالأمر: `chown -R 1000:1000 ./data`
  • خطأ في مصادقة أداة الـ CLI — تأكد من امتلاك مفتاح الـ API لصلاحيات `translations.view` و`translations.edit`

البدائل

منصة Weblate مفتوحة المصدر لترجمة ملفات Git. منصة Crowdin التجارية السحابية. منصة Lokalise للترجمة المؤسسية. منصة Phrase السحابية. مكتبة i18next للتعريب في الواجهات الأمامية.

متى لا تستخدمه

تجنب استخدام Tolgee إذا كنت تبحث فقط عن قاموس ترجمة ثابت من 10 أسطر لسكريبت بسيط (حيث يكفي ملف JSON عادي). وإذا كان مشروعك يعتمد بالكامل على برامج الترجمة المكتبية لملفات GNU gettext (.po) المربوطة بـ Git، فإن منصة Weblate مخصصة لملفات الـ PO.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هي منصة Tolgee وما المقصود بالترجمة بالسياق (In-Context)؟

تعد Tolgee منصة لإدارة الترجمة والتعريب البرمجي (TMS). وتتيح ميزة الترجمة بالسياق للمطورين والمترجمين الضغط بـ Alt+Click على أي نص مباشرة داخل التطبيق الحي لتعديل الترجمة فورياً مع لقطة شاشة توضيحية.

هل تدعم Tolgee الترجمة الآلية بواسطة DeepL أو الذكاء الاصطناعي؟

نعم! يمكنك إدخال مفاتيح API الخاصة بك لخدمات DeepL وGoogle Translate وAWS وOpenAI للحصول على اقتراحات ترجمة آلية دقيقة ومجانية بدون أي رسوم إضافية على الكلمات.

ما هي أطر عمل الواجهات الأمامية المدعومة في Tolgee؟

توفر Tolgee حزم SDK رسمية لكل من React وNext.js وVue وSvelte وAngular وجافاسكريبت، بالإضافة لحزم تطبيقات الهواتف لـ Flutter وأندرويد وiOS.

هل يمكن أتمتة مزامنة الترجمات في خطوط الـ CI/CD؟

نعم! باستخدام أداة Tolgee CLI الرسمية، يمكنك سحب الترجمات المحدثة واستخراج النصوص الجديدة تلقائياً خلال عمليات البناء المؤتمتة في GitHub Actions أو GitLab CI.

كم تستهلك Tolgee من الذاكرة العشوائية (RAM)؟

تم بناء Tolgee بـ Java/Spring Boot مع قاعدة بيانات PostgreSQL مدمجة، وتستهلك عادة ما بين 350 إلى 700 ميجابايت من الذاكرة العشوائية داخل Docker.