LibreTranslate

الوصول

• افتح http://<SERVER_IP> في المتصفح.
• توثيق واجهة API متاح على /docs.
• استخدم مفتاح API الذي تم إنشاؤه لطلبات API. وهو محفوظ في /root/libretranslate/.credentials.

استخدام واجهة API

مثال على طلب ترجمة:

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

استبدل <API_KEY> بمفتاح API الذي تم إنشاؤه.

الإعدادات

متغيرات البيئة الرئيسية محفوظة في /root/libretranslate/.env.

• LT_VERSION: إصدار صورة LibreTranslate
• REQ_LIMIT: الحد الأقصى للطلبات في الدقيقة لكل عميل
• CHAR_LIMIT: الحد الأقصى لعدد الأحرف المسموح به في كل طلب

عدّل الإعدادات حسب الحاجة.

بعد تغيير الإعدادات، طبّقها بالأمر التالي:

cd /root/libretranslate
docker compose up -d

الملفات والمجلدات المهمة

• مسار التثبيت: /root/libretranslate
• ملف Compose: /root/libretranslate/docker-compose.yml
• البيئة: /root/libretranslate/.env
• بيانات الاعتماد: /root/libretranslate/.credentials
• النماذج: /var/lib/docker/volumes/libretranslate_models
• قاعدة بيانات المفاتيح: /var/lib/docker/volumes/libretranslate_db
• إعدادات Caddy: /etc/caddy/Caddyfile

النطاق وHTTPS (Caddy)

0. لا يمكن إصدار شهادات HTTPS لعناوين IP.

1. وجّه نطاقًا (على سبيل المثال، example.com) إلى عنوان IP الخادم الخاص بك.

٢. حدّث /etc/caddy/Caddyfile:

example.com {
    reverse_proxy localhost:5000
}

3. أعد تحميل Caddy:

systemctl reload caddy

4. ادخل إلى LibreTranslate عبر example.com.

ملاحظات

• عدّل الإعدادات حسب تفضيلاتك في /root/libretranslate/.env.
• وضع Under Attack مفعّل افتراضيًا للمساعدة في حماية واجهة API العامة من الطلبات المسيئة أو الآلية.
• تحديد عدد الطلبات مفعّل بحد افتراضي يبلغ 60 طلبًا في الدقيقة لكل عميل.
• الطلبات محدودة افتراضيًا بـ 5000 حرف.
• حاوية LibreTranslate تستمع فقط على 127.0.0.1:5000؛ ويوفر Caddy الوصول العام.