> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> تثبيت ClickHouse على نظام Linux من Debian/Ubuntu

# تثبيت ClickHouse على Debian/Ubuntu

> يُوصى باستخدام حزم `deb` الرسمية المُجمَّعة مسبقًا لـ **Debian** أو **Ubuntu**.

<Steps>
  <Step>
    ## راجع التوصيات

    قبل تثبيت ClickHouse، راجع التوصيات التالية:

    * **Swap:** عطِّل ملف المبادلة الخاص بنظام التشغيل في بيئات الإنتاج.
    * **Disk space:** يتطلب الملف التنفيذي لـ ClickHouse ما لا يقل عن 2.5 جيجابايت من مساحة القرص لإتمام التثبيت.
    * **Network:** في عمليات النشر الموزعة (العنقدة)، استخدم اتصال شبكة بسرعة لا تقل عن 10 جيجابت. ويُعد عرض النطاق الترددي للشبكة عاملًا حاسمًا في معالجة الاستعلامات الموزعة التي تتضمن كميات كبيرة من البيانات الوسيطة، وكذلك في النسخ المتماثل.

    **تقدير متطلبات التخزين**

    لتقدير مساحة القرص المطلوبة لبياناتك:

    1. **Estimate data volume:** خذ عينة من بياناتك واحسب متوسط حجم الصف، ثم اضربه في عدد الصفوف التي تخطط لتخزينها.
    2. **Apply the compression coefficient:** حمِّل عينة إلى ClickHouse وقارن بين حجم البيانات الأصلي وحجم الجدول المخزَّن. فعلى سبيل المثال، تُضغط بيانات Clickstream عادةً بمعدل يتراوح بين 6 و10 مرات.
    3. **Account for replicas:** إذا كنت تخطط لتخزين البيانات في عدة نسخ متماثلة، فاضرب الحجم التقديري في عدد النسخ المتماثلة.

    للاطلاع على متطلبات الأجهزة بمزيد من التفصيل، راجع ["توصيات تحديد السعة والأجهزة"](/ar/guides/oss/best-practices/sizing-and-hardware-recommendations)
  </Step>

  <Step>
    ## إعداد مستودع Debian

    لتثبيت ClickHouse، شغّل الأوامر التالية:

    ```bash theme={null}
    # تثبيت الحزم المطلوبة مسبقًا
    sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

    # تنزيل مفتاح GPG الخاص بـ ClickHouse وتخزينه في حلقة المفاتيح
    curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

    # الحصول على معمارية النظام
    ARCH=$(dpkg --print-architecture)

    # إضافة مستودع ClickHouse إلى مصادر apt
    echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg arch=${ARCH}] https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list

    # تحديث قوائم حزم apt
    sudo apt-get update
    ```

    * يمكنك استبدال `stable` بـ `lts` لاستخدام [إصدارات](/ar/resources/support-center/knowledge-base/setup-installation/production) مختلفة بحسب احتياجاتك.
    * يمكنك تنزيل الحزم وتثبيتها يدويًا من [packages.clickhouse.com](https://packages.clickhouse.com/deb/pool/main/c/).

    <br />

    <Accordion title="الطريقة القديمة لتثبيت حزم deb على التوزيعات الأقدم">
      ```bash theme={null}
      # تثبيت الحزم المطلوبة مسبقًا
      sudo apt-get install apt-transport-https ca-certificates dirmngr

      # إضافة مفتاح GPG الخاص بـ ClickHouse لمصادقة الحزم
      sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

      # إضافة مستودع ClickHouse إلى مصادر apt
      echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
          /etc/apt/sources.list.d/clickhouse.list
          
      # تحديث قوائم حزم apt
      sudo apt-get update

      # تثبيت حزمتَي clickhouse-server و clickhouse-client
      sudo apt-get install -y clickhouse-server clickhouse-client

      # بدء خدمة ClickHouse server
      sudo service clickhouse-server start

      # تشغيل عميل سطر الأوامر الخاص بـ ClickHouse
      clickhouse-client # أو "clickhouse-client --password" إذا قمت بإعداد كلمة مرور.
      ```
    </Accordion>
  </Step>

  <Step>
    ## تثبيت ClickHouse server وclient

    ```bash theme={null}
    sudo apt-get install -y clickhouse-server clickhouse-client
    ```
  </Step>

  <Step>
    ## بدء تشغيل ClickHouse

    لبدء ClickHouse server، شغّل:

    ```bash theme={null}
    sudo service clickhouse-server start
    ```

    لبدء ClickHouse client، شغّل:

    ```bash theme={null}
    clickhouse-client
    ```

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

    ```bash theme={null}
    clickhouse-client --password
    ```
  </Step>

  <Step>
    ## تثبيت standalone ClickHouse Keeper

    <Tip>
      في بيئات production، نوصي بشدة بتشغيل ClickHouse Keeper على عُقد مخصصة.
      في بيئات الاختبار، إذا قررت تشغيل ClickHouse Server وClickHouse Keeper على الخادم نفسه،
      فلن تحتاج إلى تثبيت ClickHouse Keeper لأنه مُضمَّن مع ClickHouse server.
    </Tip>

    لتثبيت `clickhouse-keeper` على خوادم standalone ClickHouse Keeper، شغّل:

    ```bash theme={null}
    sudo apt-get install -y clickhouse-keeper
    ```
  </Step>

  <Step>
    ## تمكين ClickHouse Keeper وبدء تشغيله

    ```bash theme={null}
    sudo systemctl enable clickhouse-keeper
    sudo systemctl start clickhouse-keeper
    sudo systemctl status clickhouse-keeper
    ```
  </Step>
</Steps>

<div id="packages">
  ## الحزم
</div>

فيما يلي تفاصيل حزم deb المختلفة المتاحة:

| Package                        | Description                                                                                                                                                                                                                                                    |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `clickhouse-common-static`     | يثبّت الملفات الثنائية المُجمَّعة الخاصة بـ ClickHouse.                                                                                                                                                                                                        |
| `clickhouse-server`            | ينشئ رابطًا رمزيًا لـ `clickhouse-server` ويثبّت تهيئة الخادم الافتراضية.                                                                                                                                                                                      |
| `clickhouse-client`            | ينشئ رابطًا رمزيًا لـ `clickhouse-client` وأدوات أخرى مرتبطة بالعميل، ويثبّت ملفات تهيئة العميل.                                                                                                                                                               |
| `clickhouse-common-static-dbg` | يثبّت الملفات الثنائية المُجمَّعة الخاصة بـ ClickHouse مع معلومات التنقيح.                                                                                                                                                                                     |
| `clickhouse-keeper`            | يُستخدم لتثبيت ClickHouse Keeper على عُقد ClickHouse Keeper المخصّصة. إذا كنت تشغّل ClickHouse Keeper على الخادم نفسه الذي يعمل عليه ClickHouse server، فلن تحتاج إلى تثبيت هذه الحزمة. كما يثبّت ClickHouse Keeper وملفات تهيئة ClickHouse Keeper الافتراضية. |

<br />

<Info>
  إذا كنت بحاجة إلى تثبيت إصدار معيّن من ClickHouse، فيجب تثبيت جميع الحزم بالإصدار نفسه:
  `sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7`
</Info>