دليل النشر

Weblate على VPS: ترجم تطبيقاتك مباشرة من Git على خادمك

انشر على VPS Cloud ←

Weblate على VPS: ترجم تطبيقاتك مباشرة من Git على خادمك

كثيرًا ما تنتهي ترجمة تطبيق إلى العربية والفرنسية والإنجليزية بملفات JSON متبادلة بالبريد، ومتغيرات مكسورة، وترجمات تصل بعد الإصدار. يحل Weblate المشكلة من أصلها: يتصل بمستودع Git الخاص بك، ويعرض كل سلسلة على المترجمين في المتصفح، ويعيد الترجمات المعتمدة على شكل commits. يثبّته هذا الدليل على خادم VPS باستخدام Docker Compose، ويغلقه أمام الغرباء، وينشره عبر HTTPS خلف nginx، ويربط به أول مستودع.

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

ما الذي يفعله Weblate

Weblate منصة ترجمة مستمرة: بدل تصدير الملفات يدويًا، تعطيه عنوان مستودع Git الخاص بتطبيقك. فيقرأ ملفات اللغات — gettext PO وJSON (i18next وvue-i18n) وXLIFF وYAML وAndroid وiOS وARB وخصائص Java — ويعرض كل سلسلة على المترجمين في محرر ويب. وتعود الترجمات المعتمدة إلى المستودع على شكل commits، أو pull requests إن فضّلت المراجعة.

المشروع منشور برخصة GPL-3.0. وتعتمد صورة Docker الرسمية على PostgreSQL وعلى Valkey (أو Redis) للتخزين المؤقت وطابور المهام. على الخادم، توقّع نحو 1.7 غيغابايت من الذاكرة في وضع الخمول مع عمليتي عمل.

ما الذي يقدمه لك Weblate

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

منصة مستضافة أم Weblate على خادمك

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

منصة مستضافة (Crowdin وLokalise…)Weblate على خادمك
أين تعيش السلاسلخوادم المزوّدخادمك
الربط بالشيفرةتكامل مع Gitتكامل مع Git
حسابات المترجمينحسب الاشتراكبقدر ما تريد
النصوص غير المنشورةلدى طرف ثالثعندك
رخصة الخادمخدمة احتكاريةGPL-3.0

المتطلبات

خادم VPS بنظام Ubuntu 24.04 بذاكرة 4 غيغابايت ومعالجين افتراضيين. تحتاج إلى Docker مع إضافة Compose، وnginx وcertbot على المضيف، واسم (weblate.example.com في هذا الدليل) يشير إلى عنوان IP الخاص بالخادم. وجهّز أيضًا حساب SMTP يستمع على المنفذ 587 مع TLS: يرسل Weblate الدعوات وإعادة تعيين كلمات المرور بالبريد.

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

  1. تجهيز المجلد وملف ‎.env

    يستخدم Docker Compose وحاوية Weblate الملف نفسه. يغلق WEBLATE_REGISTRATION_OPEN=0 التسجيل، ويفرض WEBLATE_REQUIRE_LOGIN=1 تسجيل الدخول لقراءة أي شيء. استبدل أسطر SMTP الثلاثة بأسطر مزوّدك.

    mkdir -p /opt/weblate && cd /opt/weblate
    cat > .env <<EOF
    WEBLATE_SITE_DOMAIN=weblate.example.com
    WEBLATE_ENABLE_HTTPS=1
    WEBLATE_SECURE_PROXY_SSL_HEADER=HTTP_X_FORWARDED_PROTO,https
    WEBLATE_IP_PROXY_HEADER=HTTP_X_FORWARDED_FOR
    [email protected]
    WEBLATE_ADMIN_PASSWORD=$(openssl rand -hex 16)
    WEBLATE_REGISTRATION_OPEN=0
    WEBLATE_REQUIRE_LOGIN=1
    [email protected]
    [email protected]
    WEBLATE_EMAIL_HOST=smtp.example.com
    [email protected]
    WEBLATE_EMAIL_HOST_PASSWORD=<SMTP_PASSWORD>
    POSTGRES_HOST=database
    POSTGRES_DB=weblate
    POSTGRES_USER=weblate
    POSTGRES_PASSWORD=$(openssl rand -hex 16)
    REDIS_HOST=cache
    REDIS_PASSWORD=$(openssl rand -hex 16)
    EOF
    chmod 600 .env
  2. كتابة ملف docker-compose.yml

    ثلاث خدمات: PostgreSQL، وValkey محمي بكلمة مرور، وWeblate. المنفذ منشور على الواجهة المحلية فقط: وحده nginx سيكون معرّضًا للإنترنت.

    services:
      database:
        image: postgres:18.7-alpine
        restart: unless-stopped
        environment:
          POSTGRES_DB: weblate
          POSTGRES_USER: weblate
          POSTGRES_PASSWORD: "${POSTGRES_PASSWORD}"
        volumes:
          - weblate-db:/var/lib/postgresql
    
      cache:
        image: valkey/valkey:9.1.3
        restart: unless-stopped
        command: ["valkey-server", "--save", "60", "1", "--requirepass", "${REDIS_PASSWORD}"]
        volumes:
          - weblate-redis:/data
    
      weblate:
        image: weblate/weblate:2026.11.2.0
        restart: unless-stopped
        depends_on: [database, cache]
        env_file: .env
        ports:
          - "127.0.0.1:8080:8080"
        volumes:
          - weblate-data:/app/data
          - weblate-cache:/app/cache
        tmpfs: [/run, /tmp]
    
    volumes:
      weblate-db: {}
      weblate-redis: {}
      weblate-data: {}
      weblate-cache: {}
  3. التشغيل والتحقق

    ينشئ التشغيل الأول القاعدة وحساب admin، ويستغرق ذلك دقيقة إلى دقيقتين. يجب أن تجيب نقطة الصحة بـ 200، ويعرض الأمر الأخير كلمة مرور المسؤول:

    docker compose up -d
    docker compose ps
    curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/healthz/
    grep WEBLATE_ADMIN_PASSWORD .env

لا تنشر نسخة مفتوحة

مع WEBLATE_REGISTRATION_OPEN=1 يستطيع أي شخص إنشاء حساب على نسختك، وبدون WEBLATE_REQUIRE_LOGIN=1 تُقرأ المشاريع العامة دون حساب — بما في ذلك سلاسل ميزة لم يُعلن عنها بعد. احتفظ بالإعدادين الواردين في هذا الدليل واترك المنفذ على 127.0.0.1.

نشر Weblate عبر HTTPS باستخدام nginx

أنشئ /etc/nginx/sites-available/weblate بكتلة الخادم هذه، ثم فعّلها برابط رمزي في sites-enabled. الترويسة X-Forwarded-Proto ضرورية: فهي التي تخبر Weblate أن الطلب وصل عبر HTTPS.

server {
    listen 80;
    server_name weblate.example.com;
    client_max_body_size 100m;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

تحقق من الإعداد، وأعد تحميل nginx، واطلب الشهادة؛ يضيف certbot بنفسه كتلة HTTPS والتحويل من HTTP.

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

ثم افتح https://weblate.example.com/accounts/login/ وسجّل الدخول باسم المستخدم admin.

ترجمة أول مستودع Git

أنشئ مشروعًا ثم مكوّنًا. أدخل عنوان المستودع والفرع وقناع ملفات اللغات — مثلًا locales/*.json لـ vue-i18n أو locale/*/LC_MESSAGES/django.po لـ Django. يستنسخ Weblate المستودع، ويكتشف اللغات الموجودة، ويقترح إضافة غيرها.

ولكي يعيد الترجمات، افتح الإدارة › مفاتيح SSH، وولّد مفتاح النسخة وأضفه كمفتاح نشر بصلاحية الكتابة على المستودع، ثم اضبط عنوان الدفع للمكوّن عبر SSH. يجمع Weblate التعديلات ويدفعها على شكل commits. ولكي يتحدّث فور دفع أحد المطورين للشيفرة، صرّح بـ webhook نحو https://weblate.example.com/hooks/github/ (وتوجد أيضًا /hooks/gitlab/ و/hooks/gitea/).

ويمكن التحكم في كل شيء أيضًا عبر واجهة REST، بالرمز المعروض في ملفك الشخصي:

curl -s https://weblate.example.com/api/projects/ \
  -H "Authorization: Token <API_TOKEN>"

ربط LibreTranslate للاقتراحات

يقدّم Weblate اقتراحات آلية تحت كل سلسلة. إذا كانت لديك نسخة LibreTranslate خاصة، افتح الإدارة › خدمات الترجمة، وأضف خدمة LibreTranslate بعنوان نسختك ومفتاح واجهتها البرمجية. يرى المترجمون حينها اقتراحًا بالعربية أو الفرنسية أو الإنجليزية أو الإسبانية، يصححونه قبل اعتماده: لا يغادر النص خوادمك. ويوجد الإعداد نفسه على مستوى المشروع إن أردت حصره في بعض المشاريع.

النسخ الاحتياطي والتحديث

شيئان يجب نسخهما احتياطيًا: قاعدة PostgreSQL والحجم weblate-data، الذي يحوي المفتاح السري للنسخة ومفاتيح SSH ونسخ المستودعات.

cd /opt/weblate
docker compose exec -T database pg_dump -U weblate weblate | gzip > weblate-db-$(date +%F).sql.gz
docker run --rm -v weblate_weblate-data:/data -v "$PWD":/backup alpine:3.22 \
  tar czf /backup/weblate-data-$(date +%F).tar.gz -C /data .

للتحديث، اقرأ أولًا ملاحظات الإصدار على GitHub، وخذ نسخة احتياطية، ثم غيّر وسم الصورة؛ يطبّق Weblate ترحيلاته عند التشغيل:

cd /opt/weblate
sed -i 's|weblate/weblate:2026.11.2.0|weblate/weblate:<NEW_VERSION>|' docker-compose.yml
docker compose pull && docker compose up -d

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

على خادم ServOrbit، يُثبَّت Weblate من المتجر. ينشر السكربت الصورة الرسمية مع PostgreSQL وValkey، ويولّد كلمة مرور المسؤول وكلمات مرور الخدمات، ويغلق التسجيل، ويفرض تسجيل الدخول، ويضبط الوكيل العكسي nginx عبر HTTPS — على نطاق فرعي من أحد نطاقاتك أو على النطاق الفرعي المجاني للخادم. تسجّل الدخول باسم المستخدم admin وكلمة المرور المعروضة في مساحة العميل، ثم تربط أول مستودع كما سبق. لا يبقى إلا ضبط SMTP لدعوة المترجمين.

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