Docker Compose

​

نظرة عامة

​

متطلبات النظام

• رام: تأكد من أن بيئتك تحتوي على ما لا يقل عن 2GB من ذاكرة الرام. قد يؤدي عدم كفاية الذاكرة إلى تعطل العمليات.
• دوكر ودوكر كومبوز: تأكد من تثبيت كلاهما وتحديثهما.

​

الخيار 1: نص سطر واحد

bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)

VERSION=v2.38.1 bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)

• يجب أن يكون VERSION وسم إصدار كاملًا منشورًا على Docker Hub، مثل v2.38.1. لا تُقبل الأسماء المستعارة مثل v2 أو latest.
• يتم جلب docker-compose.yml المطابق من وسم git twenty/<version>، لذا لا يمكن تثبيت الإصدارات الأقدم من هذه الوسوم (v2.9.0 والإصدارات الأقدم) باستخدام البرنامج النصي.

BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)

• استبدل branch-name بالفرع الذي سيتم جلب docker-compose.yml و.env.example منه. تظل الصورة افتراضيًا تستخدم أحدث إصدار ما لم يتم أيضًا تعيين VERSION.

​

الخيار 2: خطوات يدوية

​

الخطوة 1: إعداد ملف البيئة

1. إنشاء ملف .env انسخ ملف البيئة النموذجي إلى ملف .env جديد في دليل العمل لديك:
   curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
   
2. إنشاء مفتاح تشفير قم بتشغيل الأمر التالي لإنشاء سلسلة عشوائية فريدة:
   openssl rand -base64 32
   
   مهم: احتفظ بهذه القيمة سرية ولا تشاركها. فقدان ENCRYPTION_KEY يعني فقدان الوصول إلى كل سر مخزَّن في قاعدة البيانات (رموز OAuth، متغيرات التطبيق، أسرار TOTP، إلخ).
3. تحديث الـ .env استبدل قيمة النائب في ملف .env بالقيمة الرمزية المولدة:
   ENCRYPTION_KEY=random_string
   
   راجع دليل تدوير المفاتيح للحصول على إرشادات حول تدويره بدون توقّف عن العمل.
4. تعيين كلمة مرور PostgreSQL قم بتحديث قيمة PG_DATABASE_PASSWORD في ملف .env باستخدام كلمة مرور قوية بدون أحرف خاصة. تُدرج كلمة المرور دون ترميز في عنوان URL لاتصال Postgres، لذا فإن أحرفًا مثل @ و/ و# أو % تُعطّل سلسلة الاتصال. أنشئ واحدًا باستخدام:
   openssl rand -hex 32
   
   PG_DATABASE_PASSWORD=my_strong_password
   

​

الخطوة 2: الحصول على ملف Docker Compose

curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml

​

الخطوة 3: إطلاق التطبيق

docker compose up -d

​

الخطوة 4: الوصول إلى التطبيق

curl http://localhost:3000

​

التكوين

​

جعل Twenty متاحاً للوصول الخارجي

​

فهم SERVER_URL

• البروتوكول: استخدم http أو https حسب الإعداد الخاص بك.
  • استخدم http إذا لم تقم بإعداد SSL.
  • استخدم https إذا كان لديك SSL تم تكوينه.
• النطاق/الآي بي: هذا هو النطاق أو عنوان IP حيث يكون تطبيقك متاحاً.
• المنفذ: اشمل رقم المنفذ إذا لم تكن تستخدم المنافذ الافتراضية (80 لـ http, 443 لـ https).

​

متطلبات SSL

​

تكوين SERVER_URL

1. حدد عنوان وصولك
   • بدون وكيل عكسي (الوصول المباشر): إذا كنت تصل إلى التطبيق مباشرة بدون وكيل عكسي:
     SERVER_URL=http://your-domain-or-ip:3000
     
   • مع وكيل عكسي (المنافذ القياسية): إذا كنت تستخدم وكيل عكسي مثل Nginx أو Traefik وكان لديك SSL تم تكوينه:
     SERVER_URL=https://your-domain-or-ip
     
   • مع وكيل عكسي (منافذ مخصصة): إذا كنت تستخدم منافذ غير قياسية:
     SERVER_URL=https://your-domain-or-ip:custom-port
     
2. تحديث ملف .env افتح ملف .env وقم بتحديث SERVER_URL:
   SERVER_URL=http(s)://your-domain-or-ip:your-port
   
   أمثلة:
   • الوصول المباشر بدون SSL:
     SERVER_URL=http://123.45.67.89:3000
     
   • الوصول عبر النطاق باستخدام SSL:
     SERVER_URL=https://mytwentyapp.com
     
3. إعادة تشغيل التطبيق لتطبيق التغييرات، أعد تشغيل حاويات Docker:
   docker compose down
   docker compose up -d
   

​

اعتبارات

• تكوين الوكيل العكسي: تأكد من أن الوكيل العكسي يوجه الطلبات إلى المنفذ الداخلي الصحيح (افتراضيًا 3000). قم بتكوين انتهاء SSL وأي ترويسات مطلوبة.
• إعدادات الجدار الناري: افتح المنافذ اللازمة في جدار الحماية للسماح بالوصول الخارجي.
• التناسق: يجب أن يتطابق SERVER_URL مع طريقة وصول المستخدمين إلى تطبيقك في متصفحاتهم.

​

استمرارية البيانات

• أحجام البيانات: يستخدم تكوين Docker Compose وحدات التخزين للاحتفاظ بالبيانات لقاعدة البيانات وتخزين الخادم.
• البيئات غير المرتبطة بالحالة: إذا كنت تقوم بالنشر إلى بيئة غير مرتبطة بالحالة (مثل بعض خدمات السحابة)، فقم بتكوين التخزين الخارجي لحفظ البيانات.

​

النسخ الاحتياطي والاستعادة

​

إنشاء نسخة احتياطية لقاعدة البيانات

docker exec twenty-postgres pg_dump -U postgres twenty > backup_$(date +%Y%m%d).sql

​

أتمتة النسخ الاحتياطية اليومية

0 2 * * * docker exec twenty-postgres pg_dump -U postgres twenty > /backups/twenty_$(date +\%Y\%m\%d).sql

​

الاستعادة من نسخة احتياطية

1. إيقاف التطبيق:

docker compose stop server worker

2. استعادة قاعدة البيانات:

docker exec -i twenty-postgres psql -U postgres twenty < backup_20240115.sql

3. إعادة تشغيل الخدمات:

docker compose up -d

​

أفضل ممارسات النسخ الاحتياطي

• اختبر عمليات الاستعادة بانتظام — تحقق من أن النسخ الاحتياطية تعمل فعلاً
• خزّن النسخ الاحتياطية خارج الموقع — استخدم التخزين السحابي (S3، GCS، إلخ.)
• شفّر البيانات الحساسة — قم بحماية النسخ الاحتياطية بالتشفير
• احتفِظ بنسخ متعددة — احتفِظ بنسخ احتياطية يومية وأسبوعية وشهرية

​

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

​

الاستضافة المُدارة