> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# إضافة عقدة

> اختر مصدر العقدة الجديدة، والنظام الذي تعمل به، والدور الذي تؤديه في StackKit الخاص بك

العقدة (Node) هي خادم واحد في مختبرك المنزلي: حاسوب مصغر في خزانة، أو حاسوب محمول قديم،
أو VPS، أو خادم تجهزه لك kombify. يسألك معالج **Add Node** في Techstack ثلاثة أسئلة في خطوة
العقدة: من أين يأتي الخادم، وما النظام الذي يعمل به، وما الوظيفة التي يؤديها في StackKit الخاص بك.

<Note>
  Techstack ما زال قبل الإصدار 1.0. تعرض نسخة Windows Alpha والمعاينة المستضافة المعالج نفسه،
  لكن بعض الخيارات تعتمد على ما فعّله حساب kombify الخاص بك. راجع
  [التوفر](/ar/techstack/availability).
</Note>

## مصدر العقدة

يسألك المعالج أولاً من أين تبدأ.

**I already have a device.** أنت تملك الحاسوب أو خادم المنزل أو VPS. ثم تختار كيف يصل
Techstack إليه:

* **Give me a 1-liner.** بعد إنهاء المعالج، يعرض Techstack أمراً شخصياً. تلصقه في
  طرفية الخادم مرة واحدة، فيتصل الخادم بنفسه. هذا هو المسار الأبسط ولا يحتاج إلى تفاصيل
  SSH. راجع [أمر الاقتران](/ar/techstack/pairing-command).
* **Connect my device.** تدخل عنوان الخادم ومفتاح SSH أو كلمة المرور. يسجّل Techstack
  الدخول عبر SSH وينفذ الإعداد نفسه نيابة عنك. راجع
  [الاتصال بخادم عبر SSH](/ar/techstack/ssh-connection).

**I need a server.** ليس لديك جهاز بعد. أمامك خياران:

* **kombify VPS.** تجهز kombify خادماً افتراضياً لدى مزود شريك وتوصله لك. هذا الخيار
  في مرحلة المعاينة ولا يمكن اختياره إلا إذا كانت الخوادم المُدارة مفعّلة في حسابك. راجع
  [الخوادم المُدارة](/ar/techstack/managed-servers).
* **Find a server with a partner.** تستأجر VPS مباشرة من شريك. عندما يصبح جاهزاً، عد إلى
  المعالج، واختر **My device is ready — connect it**، ثم صله بالأمر أو عبر SSH. تبقى
  خياراتك الأخرى في المعالج كما هي.

ينتهي كل مسار بعقدة من النوع نفسه. يعمل الوصول عن بُعد عبر نطاقك الخاص أو عنوان
`*.kombify.me` بالطريقة نفسها للأجهزة المحلية والخوادم المستأجرة؛ راجع
[kombify.me](/ar/kombify-me/overview).

<span id="operating-system" />

## نظام التشغيل

للجهاز الذي تملكه، يبدأ المعالج بالخيار **Ubuntu / Linux**. وهو الخيار القياسي. يفحص المثبّت
نظام التشغيل على جهازك.

* عندما لا يكون Docker موجوداً، يثبّته الإعداد باستخدام مدير حزم Ubuntu (`apt-get`).
* راجع [توافق أنظمة التشغيل](/ar/stackkits/reference/os-compatibility) لمعرفة أنظمة
  التشغيل التي لدى StackKits أدلة دورة حياة لها.

يبدأ kombify VPS دائماً من Ubuntu 24.04، لذلك لا تختار نظاماً له.

يمكن للمعالج أيضاً عرض خيار مشرف افتراضية (hypervisor) للمضيفات التي تشغّل آلات افتراضية.
هذا الخيار ضمن نطاق المعاينة وغير مشمول في التوثيق العام بعد.

## إعداد العقدة

عند إضافة عقدة إلى مختبر منزلي قائم، يسأل المعالج عن غرض العقدة الجديدة:

* **Worker or storage for this StackKit.** تنضم العقدة إلى StackKit الذي فتحت منه المعالج.
  تستخدم الأساس نفسه (مثل Basement Kit) وتحتفظ بالوصول والأشخاص وتسجيل الدخول الحاليين.
  ثم تختار **Worker Node** أو **Storage Node**.
* **New StackKit / main Node.** تصبح العقدة العقدة الرئيسية لـ StackKit جديد داخل المختبر
  المنزلي نفسه، مثل Cloud Kit على VPS إلى جانب Basement Kit في المنزل.

يمكن للمعالج أيضاً أن يعرض هنا مضيف مشرف افتراضية. هذا الخيار ضمن نطاق المعاينة وغير
موثق علناً بعد.

تشرح صفحة [أدوار العقد وأساس StackKit](/ar/techstack/node-roles) كل دور ومتى تبدأ
StackKit جديداً.

## ما يحدث بعد ذلك

بعد التأكيد، يفتح Techstack صفحة تقدم للعقدة الجديدة.

1. **مع أمر الاقتران**، تعرض الصفحة الأمر وزر نسخ. تظهر العقدة **Not connected yet**
   إلى أن تشغّل الأمر على الخادم ويبلّغ الـ Guard الخاص به.
2. **مع SSH**، يسجّل Techstack الدخول إلى الخادم ويثبّت الـ Guard وينتظر تسجيله. لا تلصق
   أي شيء.
3. **مع kombify VPS**، تجهز kombify الخادم وتوصله.

بمجرد اتصال العقدة، يواصل Techstack نشر StackKit ويعرض تقدمه في الصفحة نفسها. وعند
الانتهاء، تظهر العقدة في مختبرك المنزلي مع حالتها وخدماتها.

<CardGroup cols={2}>
  <Card title="أمر الاقتران" icon="terminal" href="/ar/techstack/pairing-command">
    ماذا يفعل الأمر ذو السطر الواحد وكيف تشغّله.
  </Card>

  <Card title="الاتصال عبر SSH" icon="key" href="/ar/techstack/ssh-connection">
    العنوان، ومفتاح SSH أو كلمة المرور، والمستخدم، والمنفذ، وsudo.
  </Card>

  <Card title="أدوار العقد" icon="sitemap" href="/ar/techstack/node-roles">
    عقد الأساس والعمل والتخزين.
  </Card>

  <Card title="الخوادم المُدارة" icon="cloud" href="/ar/techstack/managed-servers">
    خوادم تجهزها لك kombify (معاينة).
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.