Skip to content

The open alternative to Salesforce, designed for AI.

13.2 KB
Raw Blame
---
title: Docker Compose
description: تشغيل عشرون في الإنتاج مع مكوّن Docker.
---

import { PageBanner } from "/snippets/page-banner.mdx"

## نظرة عامة

<Warning>
حاويات Docker مخصصة للاستضافة في بيئة الإنتاج أو للاستضافة الذاتية. للمساهمة، يُرجى الاطلاع على [الإعداد المحلي](/ar/developers/contribute/capabilities/local-setup).
</Warning>

يوفر هذا الدليل تعليمات خطوة بخطوة لتثبيت وتكوين تطبيق "Twenty" باستخدام Docker Compose. الهدف هو جعل العملية مباشرة ومنع المشاكل الشائعة التي يمكن أن تؤدي إلى تعطيل إعدادك.

**مهم:** عدّل الإعدادات المذكورة صراحة في هذا الدليل فقط. قد يؤدي تعديل التكوينات الأخرى إلى مشاكل.

راجع [إعداد متغيرات البيئة](/ar/developers/self-host/capabilities/setup) لإعداد متقدم. يجب إعلان جميع متغيرات البيئة في ملف `docker-compose.yml` على مستوى الخادم و/أو العامل، اعتمادًا على المتغير.

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

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

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

قم بتثبيت أحدث إصدار مستقر من Twenty باستخدام أمر واحد:

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

لتثبيت إصدار محدد:

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

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

لجلب ملفات الإعدادات من فرع بدلًا من ذلك، على سبيل المثال لاختبار التغييرات غير المنشورة:

```bash
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 جديد في دليل العمل لديك:

   ```bash
   curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
   ```

2. **إنشاء مفتاح تشفير**

   قم بتشغيل الأمر التالي لإنشاء سلسلة عشوائية فريدة:

   ```bash
   openssl rand -base64 32
   ```

   **مهم:** احتفظ بهذه القيمة سرية ولا تشاركها. فقدان `ENCRYPTION_KEY` يعني فقدان الوصول إلى كل سر مخزَّن في قاعدة البيانات (رموز OAuth، متغيرات التطبيق، أسرار TOTP، إلخ).

3. **تحديث الـ `.env`**

   استبدل قيمة النائب في ملف .env بالقيمة الرمزية المولدة:

   ```ini
   ENCRYPTION_KEY=random_string
   ```

   راجع [دليل تدوير المفاتيح](/ar/developers/self-host/capabilities/key-rotation) للحصول على إرشادات حول تدويره بدون توقّف عن العمل.

4. **تعيين كلمة مرور PostgreSQL**

   قم بتحديث قيمة `PG_DATABASE_PASSWORD` في ملف .env باستخدام كلمة مرور قوية بدون أحرف خاصة. تُدرج كلمة المرور دون ترميز في عنوان URL لاتصال Postgres، لذا فإن أحرفًا مثل `@` و`/` و`#` أو `%` تُعطّل سلسلة الاتصال. أنشئ واحدًا باستخدام:

   ```bash
   openssl rand -hex 32
   ```

   ```ini
   PG_DATABASE_PASSWORD=my_strong_password
   ```

<Note>
تصل المتغيرات التي يمرّرها `docker-compose.yml` دون قيمة افتراضية `:-`، مثل `SERVER_URL` ومتغيرات `STORAGE_S3_*`، إلى الخادم كسلسلة فارغة عندما تكون فارغة أو مفقودة في `.env`، ويتعامل الخادم مع السلسلة الفارغة باعتبارها قيمة مُعدّة بدلًا من اعتبارها غير معيّنة. أبقِ `SERVER_URL` معيّنًا، وعند استخدام `STORAGE_TYPE=S_3`، عيّن كل متغير `STORAGE_S3_*` مطلوب: إذ إن `STORAGE_S3_NAME` الفارغ يُعطّل كل عملية رفع. تعود المتغيرات ذات القيمة الافتراضية في `docker-compose.yml`، مثل أجزاء `PG_DATABASE_*` و`REDIS_URL`، إلى تلك القيمة الافتراضية عندما تكون فارغة أو مفقودة.
</Note>

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

قم بتنزيل ملف `docker-compose.yml` إلى دليل العمل الخاص بك:

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

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

بدء حاويات Docker:

```bash
docker compose up -d
```

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

إذا كنت تستضيف twentyCRM على جهازك، فافتح المتصفح وانتقل إلى [http://localhost:3000](http://localhost:3000).

إذا كنت تستضيفه على خادم، فتحقق من أن الخادم يعمل وأن كل شيء على ما يرام باستخدام

```bash
curl http://localhost:3000
```

## التكوين

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

افتراضياً، يعمل Twenty على `localhost` على المنفذ `3000`. تقوم واجهة المستخدم بحل واجهة برمجة التطبيقات (API) من مصدر المتصفح نفسه، لذلك يتم تحميلها من أي اسم مضيف يصل إلى الحاوية — لكن يجب مع ذلك تعيين `SERVER_URL` إلى عنوان URL العام الخاص بك: يستخدمه الخادم للروابط المُنشأة (رسائل البريد الإلكتروني، استدعاءات OAuth) ولاكتشاف HTTPS لملفات تعريف الارتباط الآمنة.

#### فهم `SERVER_URL`

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

### متطلبات SSL

SSL (HTTPS) مطلوب لعمل ميزات معينة في المتصفح بشكل صحيح. بينما قد تعمل هذه الميزات أثناء التطوير المحلي (بما أن المتصفحات تعامل localhost بشكل مختلف)، هناك حاجة إلى إعداد SSL صحيح عند استضافة Twenty على نطاق عادي.

على سبيل المثال، قد يطلب API للحافظة السياق الآمن - بعض الميزات مثل أزرار النسخ في جميع أنحاء التطبيق قد لا تعمل بدون تمكين HTTPS.

نوصي بشدة بإعداد Twenty خلف وكيل عكسي مع إنهاء SSL للأمان والوظيفية المثلى.

<Tip>قبل إتاحة Twenty على الإنترنت، اقرأ [تأمين مثيلك](/ar/developers/self-host/capabilities/security). يمكن لمعظم الفرق إبقاء التطبيق خاصًا وفتح بضعة مسارات فقط.</Tip>

#### تكوين `SERVER_URL`

1. **حدد عنوان وصولك**
   * **بدون وكيل عكسي (الوصول المباشر):**

     إذا كنت تصل إلى التطبيق مباشرة بدون وكيل عكسي:

     ```ini
     SERVER_URL=http://your-domain-or-ip:3000
     ```

   * **مع وكيل عكسي (المنافذ القياسية):**

     إذا كنت تستخدم وكيل عكسي مثل Nginx أو Traefik وكان لديك SSL تم تكوينه:

     ```ini
     SERVER_URL=https://your-domain-or-ip
     ```

   * **مع وكيل عكسي (منافذ مخصصة):**

     إذا كنت تستخدم منافذ غير قياسية:

     ```ini
     SERVER_URL=https://your-domain-or-ip:custom-port
     ```

2. **تحديث ملف `.env`**

   افتح ملف `.env` وقم بتحديث `SERVER_URL`:

   ```ini
   SERVER_URL=http(s)://your-domain-or-ip:your-port
   ```

   **أمثلة:**

   * الوصول المباشر بدون SSL:
     ```ini
     SERVER_URL=http://123.45.67.89:3000
     ```
   * الوصول عبر النطاق باستخدام SSL:
     ```ini
     SERVER_URL=https://mytwentyapp.com
     ```

3. **إعادة تشغيل التطبيق**

   لتطبيق التغييرات، أعد تشغيل حاويات Docker:

   ```bash
   docker compose down
   docker compose up -d
   ```

#### اعتبارات

* **تكوين الوكيل العكسي:**

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

* **إعدادات الجدار الناري:**

  افتح المنافذ اللازمة في جدار الحماية للسماح بالوصول الخارجي.

* **التناسق:**

  يجب أن يتطابق `SERVER_URL` مع طريقة وصول المستخدمين إلى تطبيقك في متصفحاتهم.

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

* **أحجام البيانات:**

  يستخدم تكوين Docker Compose وحدات التخزين للاحتفاظ بالبيانات لقاعدة البيانات وتخزين الخادم.

* **البيئات غير المرتبطة بالحالة:**

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

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

تحمي النسخ الاحتياطية المنتظمة بيانات نظام إدارة علاقات العملاء لديك من الفقدان.

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

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

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

أضف إلى crontab لديك (`crontab -e`):

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

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

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

```bash
docker compose stop server worker
```

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

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

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

```bash
docker compose up -d
```

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

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

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

إذا واجهت أي مشكلة، فارجع إلى [استكشاف الأخطاء وإصلاحها](/ar/developers/self-host/capabilities/troubleshooting) للحصول على الحلول.

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

<Tip>
  تُفضّل عدم تشغيل وصيانة Twenty بنفسك؟ [اعثر على شريك استضافة Twenty معتمد](https://twenty.com/partners/list?categories=HOSTING\&ref=docs-docker-compose) لنشر واستضافة وإدارة مثيلك من البداية إلى النهاية. *(أو تواصل مع فريقنا: [[email protected]](mailto:[email protected]).)*
</Tip>

<PageBanner illustration="dev-self-host" />