# كيفية إعداد جهاز باستخدام Rediacc

يبدأ كل نشر Rediacc بملف تعريف تكوين وجهاز مسجل. في هذا الدرس التعليمي، ستقوم بإنشاء تكوين، وتسجيل خادم بعيد، والتحقق من اتصال SSH، وتشغيل تشخيصات البيئة، وتكوين شبكة البنية التحتية. عند الانتهاء، سيكون جهازك جاهزاً لنشر المستودعات.

## المتطلبات الأساسية

- تثبيت أداة `rdc` CLI
- خادم بعيد (أو جهاز افتراضي محلي) يمكن الوصول إليه عبر SSH
- مفتاح SSH خاص يمكنه المصادقة على الخادم

## التسجيل التفاعلي

![درس تعليمي: إعداد الجهاز والتكوين](/assets/tutorials/setup-tutorial.cast)

### الخطوة 1: إنشاء تكوين جديد

يخزّن ملف تعريف التكوين تعريفات الأجهزة وبيانات اعتماد SSH وإعدادات البنية التحتية. أنشئ واحداً لهذه البيئة.

```bash
rdc config init --name tutorial-demo --ssh-key ~/.ssh/id_ed25519
```

ينشئ هذا ملف تكوين مسمى في `~/.config/rediacc/tutorial-demo.json`.

### الخطوة 2: عرض التكوينات

تحقق من ظهور الملف التعريفي الجديد في قائمة التكوينات.

```bash
rdc config list
```

يعرض جميع التكوينات المتاحة مع نوع المحول (محلي أو سحابي) وعدد الأجهزة.

### الخطوة 3: إضافة جهاز

سجّل جهازاً بعنوان IP الخاص به ومستخدم SSH. يقوم CLI تلقائياً بجلب وتخزين مفاتيح المضيف للخادم عبر `ssh-keyscan`.

```bash
rdc config machine add --name bridge-vm --ip 192.168.111.1 --user muhammed --config tutorial-demo
```

### الخطوة 4: عرض الأجهزة

تأكد من تسجيل الجهاز بشكل صحيح.

```bash
rdc config machine list --config tutorial-demo
```

يعرض جميع الأجهزة في التكوين الحالي مع تفاصيل الاتصال الخاصة بها.

### الخطوة 5: تعيين الجهاز الافتراضي

تعيين جهاز افتراضي يغنيك عن تكرار `-m bridge-vm` في كل أمر.

```bash
rdc config set --key machine --value bridge-vm --config tutorial-demo
```

### الخطوة 6: اختبار الاتصال

قبل نشر أي شيء، تحقق من إمكانية الوصول إلى الجهاز عبر SSH.

```bash
rdc term connect -m bridge-vm -c "hostname"
rdc term connect -m bridge-vm -c "uptime"
```

يعمل كلا الأمرين على الجهاز البعيد ويعيدان النتيجة فوراً. إذا فشل أي منهما، تحقق من صحة مفتاح SSH وإمكانية الوصول إلى الخادم.

### الخطوة 7: تشغيل التشخيصات

```bash
rdc doctor
```

يفحص بيئتك المحلية: إصدار CLI، وDocker، وملف renet الثنائي، وحالة التكوين، ومفتاح SSH، ومتطلبات المحاكاة الافتراضية. يُبلغ كل فحص عن **OK** أو **Warning** أو **Error**.

### الخطوة 8: تكوين البنية التحتية

للخدمات العامة، يحتاج الجهاز إلى تكوين الشبكة, عنوان IP الخارجي، ونطاق أساسي، وبريد إلكتروني للشهادة لـ TLS.

```bash
rdc config infra set -m bridge-vm \
  --public-ipv4 192.168.111.1 \
  --base-domain test.local \
  --cert-email admin@test.local
```

تحقق من التكوين:

```bash
rdc config infra show -m bridge-vm
```

انشر تكوين وكيل Traefik المُنشأ إلى الخادم باستخدام `rdc config infra push bridge-vm`.

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

**"SSH key not found" أو "Permission denied (publickey)"**
تحقق من وجود مسار المفتاح الذي تم تمريره إلى `config init` ومطابقته لـ `authorized_keys` على الخادم. تحقق من الأذونات: يجب أن يكون ملف المفتاح الخاص `600` (`chmod 600 ~/.ssh/id_ed25519`).

**"Connection refused" عند أوامر SSH**
تأكد من تشغيل الخادم وصحة عنوان IP. تحقق من أن المنفذ 22 مفتوح: `nc -zv <ip> 22`. إذا كنت تستخدم منفذاً غير قياسي، مرّر `--port` عند إضافة الجهاز.

**"Host key verification failed"**
المفتاح المخزن لا يتطابق مع مفتاح الخادم الحالي. يحدث هذا بعد إعادة بناء الخادم أو إعادة تعيين عنوان IP. شغّل `rdc config machine scan-keys <machine>` لتحديث المفتاح.

## الخطوات التالية

لقد أنشأت ملف تعريف تكوين، وسجلت جهازاً، وتحققت من الاتصال، وقمت بتكوين شبكة البنية التحتية. لنشر التطبيقات:

- [إعداد الجهاز](/ar/docs/setup), المرجع الكامل لجميع أوامر التكوين والإعداد
- [درس تعليمي: دورة حياة المستودع](/ar/docs/tutorial-repos), إنشاء المستودعات ونشرها وإدارتها
- [البدء السريع](/ar/docs/quick-start), نشر تطبيق محتوى من البداية إلى النهاية