> ## 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.

# أمر الاقتران

> صل خادماً بـ Techstack بتشغيل أمر شخصي واحد في طرفيته

أمر الاقتران هو مسار **Give me a 1-liner** في معالج Add Node. تنسخ سطراً واحداً من Techstack
وتلصقه في طرفية خادمك، فيتصل الخادم بنفسه. لا تحتاج إلى إدخال تفاصيل SSH في Techstack.

## ماذا يفعل الأمر

ينزّل الأمر مثبّت Techstack من Techstack الخاص بك ويشغّله برمز اقتران شخصي قصير الأمد. على
الخادم، يقوم المثبّت بما يلي:

1. يكتشف المنصة ويثبّت **Guard** الخاص بـ Techstack، وهو وكيل صغير يبلّغ عن حالة الخادم؛
2. يثبّت وقت تشغيل StackKits المثبّت الذي يحتاجه النشر؛
3. يستبدل رمز الاقتران، ما يربط هذا الخادم بمختبرك المنزلي؛
4. يثبّت Docker باستخدام `apt-get` عندما لا يوجد وقت تشغيل حاويات صالح؛
5. يثبّت خدمة النظام `techstack-agent` ويشغّلها، فيبقى الـ Guard يعمل بعد إعادة التشغيل.

يتحدث الـ Guard مع Techstack عبر اتصال HTTPS **صادر** فقط. يرسل نبضة وجرداً مقيساً كل 30
ثانية تقريباً. ولا تفتح منفذاً وارداً على الخادم من أجله.

الرمز يعمل مرة واحدة. يخزّن Techstack تجزئة بيانات الاعتماد التي يستلمها الخادم فقط، ولا
يُحفظ الأمر في تقارير المهام.

## قبل التشغيل

* **خادم Linux مع systemd.** Ubuntu هو النظام القياسي؛ راجع
  [إضافة عقدة](/ar/techstack/add-node#operating-system).
* **صلاحيات المسؤول.** شغّل الأمر بصفة `root` أو بمستخدم يستطيع استخدام `sudo`. يكتب المثبّت
  ملفات النظام ويثبّت خدمة.
* **`curl` على الخادم.** يستخدمه الأمر لتنزيل المثبّت.
* **الخادم يستطيع الوصول إلى Techstack.** تعرض صفحة التقدم الحقل
  **Techstack URL reachable from the server**. يجب أن يُفتح العنوان في هذا الحقل من
  الخادم، وليس من حاسوبك فقط. مع [Windows Alpha](/ar/techstack/install-windows)، يصل الخادم
  إلى حاسوب Windows على منفذ TCP `5264` في شبكتك المحلية، لذا أبقِ عميل Windows يعمل أثناء
  الاقتران.
* **أمر جديد.** ينتهي رمز الاقتران بعد 15 دقيقة من إنشاء Techstack له.

## تشغيل الأمر

1. أنهِ معالج Add Node. يفتح Techstack صفحة التقدم للعقدة الجديدة، وتعرض **Not connected yet**.
2. تحقق من الحقل **Techstack URL reachable from the server** وصححه إذا كان الخادم يستخدم
   عنواناً مختلفاً للوصول إلى Techstack.
3. اختر **Copy pairing command**.
4. افتح طرفية على الخادم، مباشرة أو عبر SSH، والصق الأمر ثم اضغط Enter. لا تغيّر الأمر.
   فهو يحتوي رمزك الشخصي.
5. انتظر انتهاء المثبّت. فهو يطبع كل خطوة.

إذا عرضت الصفحة **This pairing token has expired**، فاختر **Generate new command** وشغّل
الأمر الجديد بدلاً منه. لم يعد القديم يعمل.

<Warning>
  تعامل مع الأمر كأنه كلمة مرور تُستخدم مرة واحدة. أي شخص يشغّله قبل انتهاء صلاحيته يستطيع
  توصيل خادم بمختبرك المنزلي.
</Warning>

## عندما تتصل العقدة

عندما يرسل الـ Guard أول نبضة، يغيّر Techstack العقدة من **Not connected yet** إلى متصلة.
ثم تتابع صفحة التقدم نشر StackKit لهذه العقدة. ويمكنك إغلاق الطرفية.

للتحقق من الـ Guard على الخادم لاحقاً:

* يعرض `sudo systemctl status techstack-agent` ما إذا كانت الخدمة تعمل.
* يتابع `sudo journalctl -u techstack-agent -f` سجلها.

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


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