مرجع سطر أوامر Rediacc

نظرة عامة

**Rediacc CLI** (`rdc`) هي واجهة سطر أوامر لإدارة جميع جوانب منصة Rediacc — المصادقة، البنية التحتية، المستودعات، قوائم الانتظار، التخزين والمزيد.

التثبيت

قم بتنزيل أحدث ملف تنفيذي لمنصتك من [صفحة إصدارات Rediacc](https://www.rediacc.com) أو قم بالتثبيت عبر مدير الحزم الخاص بك:

# macOS / Linux
curl -fsSL https://get.rediacc.com | sh

# Or use the packaged binary directly
./rdc --help

الخيارات العامة

يدعم كل أمر هذه العلامات العامة:

العلامة	الوصف
`--output`	صيغة المخرجات (table\|json\|yaml\|csv)
`--config`	استخدام إعدادات محددة لهذا الأمر
`--lang`	تجاوز اللغة ({{languages}})
`--force`	تخطي نوافذ التأكيد

1. أدوات الوكيل

أدوات مساعدة لوكلاء البرمجة بالذكاء الاصطناعي

1.1 capabilities

عرض جميع الأوامر المتاحة مع المعاملات والخيارات

rdc agent capabilities

1.2 schema

عرض المخطط التفصيلي لأمر معين

rdc agent schema <command>

1.3 exec

تنفيذ أمر بمدخلات JSON من stdin

rdc agent exec <command>

1.4 generate-reference

إنشاء مرجع الأوامر بتنسيق Markdown لمهارات Claude

rdc agent generate-reference

2. إدارة الإعدادات

إدارة ملفات الإعدادات والأجهزة واتصالات SSH

تخزن ملفات الإعدادات تفاصيل الاتصال (عنوان URL للـ API، بيانات الاعتماد، الفريق/المنطقة/الجسر الافتراضي) حتى تتمكن من التبديل بين البيئات بسرعة.

2.1 init

إنشاء ملف إعدادات مسمى جديد

في الوضع المحلي يمكنك إضافة الآلات مباشرة:

rdc config init [name] [options]

العلامة	الوصف	مطلوب	افتراضي
`--ssh-key <path>`	المسار إلى مفتاح SSH الخاص (مثال: ~/.ssh/id_rsa)	لا	-
`--renet-path <path>`	المسار إلى ثنائي renet (افتراضي: renet في PATH)	لا	-
`--master-password <password>`	تشفير الموارد بكلمة مرور رئيسية	لا	-
`-u, --api-url <url>`	عنوان URL للـ API	لا	-

2.2 list

عرض جميع ملفات الإعدادات

rdc config list

2.3 show

عرض تفاصيل الإعدادات الحالية

rdc config show

2.4 delete

حذف ملف إعدادات

rdc config delete <name>

2.5 set

تعيين قيمة افتراضية (فريق، منطقة، جسر)

rdc config set <key> <value>

نصيحة: يعني تعيين القيم الافتراضية أنك لن تحتاج إلى تمرير `--team` أو `--region` أو `--bridge` مع كل أمر.

2.6 clear

مسح القيم الافتراضية (الكل أو مفتاح معين)

rdc config clear [key]

2.7 recover

استعادة الإعدادات من ملف النسخة الاحتياطية (.bak)

rdc config recover [name] [options]

العلامة	الوصف	مطلوب	افتراضي
`-y, --yes`	تخطي نافذة التأكيد	لا	-

2.8 set-ssh

تحديث إعدادات SSH للإعدادات الحالية

rdc config set-ssh

2.9 set-renet

تعيين مسار الملف الثنائي renet للوضع المحلي

rdc config set-renet

2.10 ssh

إدارة إعدادات مفتاح SSH

set

تعيين مفتاح SSH للإعدادات الحالية

rdc config ssh set [options]

العلامة	الوصف	مطلوب	افتراضي
`--key <path>`	مسار ملف مفتاح SSH الخاص	نعم	-
`--embed`	تضمين محتوى المفتاح في الإعدادات بدلاً من تخزين المسار	لا	-

show

عرض إعدادات مفتاح SSH الحالية

rdc config ssh show

remove

إزالة مفتاح SSH من الإعدادات الحالية

rdc config ssh remove

2.11 machine

إدارة الأجهزة في التكوين الحالي

add

إضافة جهاز إلى الإعدادات الحالية

rdc config machine add <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--ip <address>`	عنوان IP للآلة أو اسم المضيف	نعم	-
`--user <username>`	اسم مستخدم SSH	نعم	-
`--port <port>`	منفذ SSH	لا	`22`
`--datastore <path>`	مسار التخزين على الآلة	لا	`/mnt/rediacc`

remove

إزالة جهاز من التكوين الحالي

rdc config machine remove <name>

list

عرض قائمة الأجهزة في التكوين الحالي

rdc config machine list

scan-keys

فحص مفاتيح SSH للأجهزة في التكوين الحالي

rdc config machine scan-keys [machine]

setup

تهيئة جهاز بعيد للمستودعات (تثبيت renet، إعداد Docker، مخزن بيانات BTRFS). قابل للتكرار. مطلوب بعد config machine add وقبل repo create

rdc config machine setup <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--datastore <path>`	مسار مخزن البيانات على الجهاز البعيد	لا	`/mnt/rediacc`
`--datastore-size <size>`	حجم مخزن البيانات (مثال: 95%، 100G)	لا	`95%`
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

set-ceph

تعيين تكوين Ceph RBD لجهاز

rdc config machine set-ceph [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-
`--pool <name>`	اسم مجمّع Ceph (مثال: rbd)	نعم	-
`--image <name>`	اسم صورة RBD (مثال: datastore-prod1)	نعم	-
`--cluster <name>`	اسم مجموعة Ceph	لا	`ceph`

2.12 repository

إدارة ربط المستودعات في التكوين الحالي

add

إضافة ربط GUID للمستودع إلى التكوين الحالي

rdc config repository add <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--guid <guid>`	GUID للمستودع (UUID من أسماء ملفات النسخ الاحتياطي)	نعم	-
`--tag <tag>`	علامة المستودع	لا	`latest`
`--credential <credential>`	بيانات اعتماد المستودع (عبارة مرور التشفير)	لا	-
`--network-id <id>`	معرّف الشبكة لعزل Docker (2816، 2880، ...). يُعيَّن تلقائيًا إن لم يُحدَّد	لا	-

remove

إزالة ربط مستودع من التكوين الحالي

rdc config repository remove <name>

list

عرض قائمة ربط GUID للمستودعات في التكوين الحالي

rdc config repository list

list-archived

عرض بيانات اعتماد المستودعات المؤرشفة

rdc config repository list-archived

restore-archived

استعادة بيانات اعتماد مستودع مؤرشف

rdc config repository restore-archived <guid> [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	الاستعادة باسم مختلف	لا	-

purge-archived

حذف جميع بيانات الاعتماد المؤرشفة نهائياً

rdc config repository purge-archived

2.13 provider

إدارة المزودين السحابيين لتوفير الأجهزة تلقائياً

add

إضافة مزود سحابي

rdc config provider add <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--provider <source>`	مصدر مزوّد معروف (مثال: linode/linode، hetznercloud/hcloud)	لا	-
`--source <source>`	مصدر مزوّد OpenTofu مخصص (مثال: vultr/vultr)	لا	-
`--token <token>`	رمز API للمزود السحابي	نعم	-
`--region <region>`	المنطقة الافتراضية للأجهزة الجديدة	لا	-
`--type <type>`	نوع/حجم النسخة الافتراضي	لا	-
`--image <image>`	صورة نظام التشغيل الافتراضية	لا	-
`--ssh-user <user>`	اسم مستخدم SSH للأجهزة الافتراضية الجديدة (الافتراضي: root)	لا	-
`--resource <type>`	مخصص: نوع مورد OpenTofu للأجهزة الافتراضية	لا	-
`--label-attr <attr>`	مخصص: اسم سمة تسمية الجهاز الافتراضي	لا	-
`--region-attr <attr>`	مخصص: اسم سمة المنطقة	لا	-
`--size-attr <attr>`	مخصص: اسم سمة نوع المثيل	لا	-
`--image-attr <attr>`	مخصص: اسم سمة صورة نظام التشغيل	لا	-
`--ipv4-output <attr>`	مخصص: سمة الإخراج لعنوان IPv4	لا	-
`--ipv6-output <attr>`	مخصص: سمة الإخراج لعنوان IPv6	لا	-
`--ssh-key-attr <attr>`	مخصص: اسم سمة مفاتيح SSH	لا	-
`--ssh-key-format <format>`	مخصص: تنسيق مفتاح SSH (inline_list أو resource_id)	لا	-
`--ssh-key-resource <type>`	مخصص: نوع مورد OpenTofu لمفاتيح SSH	لا	-

remove

إزالة تكوين مزود سحابي

rdc config provider remove <name>

list

عرض قائمة المزودين السحابيين المُعدّين

rdc config provider list

2.14 storage

إدارة واجهات التخزين في التكوين الحالي

import

استيراد التخزين من ملف تكوين rclone

rdc config storage import <file> [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	استيراد هذا القسم المسمى فقط	لا	-

remove

إزالة تخزين من التكوين الحالي

rdc config storage remove <name>

list

عرض قائمة التخزين في التكوين الحالي

rdc config storage list

2.15 infra

إدارة تكوين البنية التحتية (الوكيل، DNS، الشهادات)

set

تعيين إعدادات البنية التحتية لجهاز (خاصة بالجهاز: عناوين IP، النطاق، المنافذ؛ مشتركة: بريد الشهادة، رمز Cloudflare DNS)

rdc config infra set <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--public-ipv4 <ip>`	عنوان IPv4 العام (لكل جهاز)	لا	-
`--public-ipv6 <ip>`	عنوان IPv6 العام (لكل جهاز)	لا	-
`--base-domain <domain>`	النطاق الأساسي للتطبيقات (لكل جهاز)	لا	-
`--cert-email <email>`	البريد الإلكتروني لإشعارات شهادات TLS (مشترك بين الأجهزة)	لا	-
`--cf-dns-token <token>`	رمز Cloudflare DNS API لتحدي ACME DNS-01 (مشترك بين الأجهزة)	لا	-
`--tcp-ports <ports>`	منافذ TCP للتوجيه (مفصولة بفواصل، مثال: 25,143,465)	لا	-
`--udp-ports <ports>`	منافذ UDP للتوجيه (مفصولة بفواصل، مثال: 53)	لا	-

show

عرض تكوين البنية التحتية لجهاز

rdc config infra show <machine>

push

دفع إعدادات البنية التحتية إلى الجهاز (وكيل Traefik، الموجّه، Cloudflare DNS). شغّل 'config infra set <machine>' أولاً

rdc config infra push <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

2.16 cert-cache

إدارة شهادات TLS المخزنة مؤقتاً

pull

تنزيل وتخزين شهادات TLS مؤقتاً من جهاز

rdc config cert-cache pull <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--no-prune`	تخطي تنظيف شهادات معرّف الشبكة القديمة	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

push

رفع شهادات TLS المخزنة مؤقتاً إلى جهاز

rdc config cert-cache push <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

status

عرض مخزون الشهادات المخزنة مؤقتاً

rdc config cert-cache status

clear

إزالة ذاكرة تخزين الشهادات المؤقتة

rdc config cert-cache clear

2.17 backup-strategy

إدارة استراتيجية النسخ الاحتياطي متعددة الوجهات

set

تكوين إعدادات جدولة النسخ الاحتياطي

rdc config backup-strategy set [options]

العلامة	الوصف	مطلوب	افتراضي
`--destination <storage>`	اسم وجهة التخزين الافتراضي	لا	-
`--cron <expression>`	تعبير cron لجدولة النسخ الاحتياطي (مثلاً "0 2 * * *")	لا	-
`--enable`	تفعيل النسخ الاحتياطي المجدول	لا	-
`--disable`	تعطيل النسخ الاحتياطي المجدول	لا	-

show

عرض تكوين جدولة النسخ الاحتياطي الحالي

rdc config backup-strategy show

3. إدارة مخزن البيانات

إدارة دورة حياة مخزن بيانات Ceph RBD (تهيئة، تفريع، إلغاء تفريع، حالة)

3.1 init

تهيئة مخزن البيانات على جهاز (محلي أو Ceph RBD)

rdc datastore init [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز (حيث يستضاف مخزن بيانات Ceph)	نعم	-
`--size <size>`	حجم مخزن البيانات (مثال: 5G, 50G, 100G)	نعم	-
`--backend <type>`	نوع الخلفية: local (افتراضي) أو ceph	لا	`local`
`--pool <name>`	اسم مجمع Ceph (افتراضي: من إعدادات الجهاز، أو rbd)	لا	`rbd`
`--image <name>`	اسم صورة Ceph RBD (افتراضي: من إعدادات الجهاز عبر set-ceph)	لا	-
`--cluster <name>`	اسم مجموعة Ceph (افتراضي: ceph)	لا	`ceph`
`--force`	فرض التهيئة حتى لو كان مخزن البيانات موجوداً بالفعل (تحذير: يعيد تهيئة التخزين)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

3.2 fork

إنشاء نسخة COW محلية من مخزن بيانات Ceph عبر لقطة RBD + نسخ (أقل من ثانيتين). احفظ أسماء اللقطة/النسخة من المخرجات لإلغاء التفريع. تفريع واحد فقط لكل اسم هدف؛ قم بإلغاء التفريع قبل إعادة التفريع

rdc datastore fork [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز (حيث يستضاف مخزن بيانات Ceph)	نعم	-
`--to <name>`	لاحقة النسخة (تنشئ نسخة باسم <image>-fork-<name>). يبقى التفريع على الجهاز المصدر	نعم	-
`--cow-size <size>`	حجم ملف COW الداعم (افتراضي: تلقائي، ينمو حسب الطلب)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

3.3 unfork

تنظيف تفريع: فك تحميل COW، إزالة النسخة، إزالة اللقطة

rdc datastore unfork [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز (حيث يستضاف مخزن بيانات Ceph)	نعم	-
`--source <image>`	صورة RBD الأصلية التي تم تفريعها (من config set-ceph --image، مثال: ds-prod)	نعم	-
`--snapshot <name>`	اللقطة المراد إزالتها (قيمة "Snapshot:" من مخرجات fork، مثال: fork-<timestamp>)	نعم	-
`--dest <image>`	صورة النسخة المراد إزالتها (قيمة "Clone:" من مخرجات fork، مثال: ds-prod-fork-<machine>)	نعم	-
`--pool <name>`	اسم مجمع Ceph (افتراضي: من إعدادات الجهاز)	لا	-
`--mount-point <path>`	نقطة تحميل التفريع لفكها (افتراضي: /mnt/rediacc)	لا	-
`--force`	متابعة التنظيف حتى لو فشلت خطوات فردية (مثل فك التحميل، إزالة اللقطة)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

3.4 status

عرض خلفية مخزن البيانات والحجم والاستخدام وحالة التحميل ووضع cow_mode (إذا كان متفرعاً)

rdc datastore status [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز (حيث يستضاف مخزن بيانات Ceph)	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4. إدارة الأجهزة

إدارة الأجهزة البعيدة (الحالة، الحاويات، الخدمات، الصحة)

4.1 list

قائمة الآلات

rdc machine list [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`--search <text>`	البحث في {{field}}	لا	-
`--sort <field>`	الترتيب حسب الحقل	لا	-
`--desc`	ترتيب تنازلي	لا	-

4.2 create

إنشاء آلة جديدة

rdc machine create <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`-b, --bridge <name>`	اسم الجسر	لا	-
`--vault <json>`	بيانات خزينة الآلة كسلسلة JSON	لا	-

4.3 rename

إعادة تسمية جهاز

rdc machine rename <oldName> <newName> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-

4.4 delete

حذف آلة

rdc machine delete <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`-f, --force`	تخطي نوافذ التأكيد	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

4.5 vault

إدارة خزنة الجهاز (محول السحابة فقط)

rdc machine vault

4.6 vault-status

rdc machine vault-status <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-

4.7 update

تحديث إعدادات الآلة

rdc machine update

4.8 health

فحص صحة الآلة لأنابيب CI/CD

يُخرج أمر health مقاييس النظام وحالة الحاويات واستقرار الخدمات ومعلومات التخزين — مفيد لفحوصات خطوط أنابيب CI/CD.

rdc machine health <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-

4.9 containers

عرض الحاويات العاملة على جهاز

rdc machine containers <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`--health-check`	وضع فحص الصحة - الخروج برمز 2 إذا وُجدت حاويات غير سليمة	لا	-

4.10 services

قائمة خدمات systemd على آلة

rdc machine services <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`--stability-check`	وضع فحص الاستقرار - الخروج برمز 2 إذا وُجدت خدمات فاشلة/تعيد التشغيل	لا	-

4.11 query

عرض حالة الجهاز الكاملة (النظام، المستودعات، الحاويات، الخدمات)

rdc machine query <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--system`	تضمين معلومات النظام فقط	لا	-
`--repositories`	تضمين المستودعات فقط	لا	-
`--containers`	تضمين الحاويات فقط	لا	-
`--services`	تضمين الخدمات فقط	لا	-
`--network`	تضمين واجهات الشبكة فقط	لا	-
`--block-devices`	تضمين أجهزة التخزين فقط	لا	-

4.12 vault-status

عرض حالة الخزينة المحللة لآلة

rdc machine vault-status <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-

4.13 repos

قائمة المستودعات المنتشرة على آلة

rdc machine repos <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`--search <text>`	تصفية المستودعات حسب الاسم	لا	-

4.14 test-connection

اختبار اتصال SSH بآلة والتقاط مفتاح المضيف

rdc machine test-connection [options]

العلامة	الوصف	مطلوب	افتراضي
`--ip <address>`	عنوان IP للآلة أو اسم المضيف	نعم	-
`--user <name>`	اسم مستخدم SSH	نعم	-
`-t, --team <name>`	اسم الفريق	لا	-
`-b, --bridge <name>`	اسم الجسر	لا	-
`--port <number>`	منفذ SSH	لا	`22`
`--password <pwd>`	كلمة مرور SSH للمصادقة الأولية	لا	-
`--datastore <path>`	مسار التخزين على الآلة	لا	`/mnt/rediacc`
`-m, --machine <name>`	اسم الآلة (لتحديث الخزينة بعد الاختبار)	لا	-
`--save`	حفظ known_hosts في خزينة الآلة بعد الاختبار الناجح	لا	-

نصيحة: استخدم `--save-known-hosts` لحفظ مفتاح المضيف تلقائياً في خزنة الجهاز بعد اختبار ناجح.

4.15 provision

توفير جهاز جديد على مزود سحابي باستخدام OpenTofu

rdc machine provision <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--provider <name>`	اسم المزود السحابي (من config provider add)	نعم	-
`--region <region>`	تجاوز المنطقة الافتراضية	لا	-
`--type <type>`	تجاوز نوع المثيل الافتراضي	لا	-
`--image <image>`	تجاوز صورة نظام التشغيل الافتراضية	لا	-
`--ssh-user <user>`	اسم مستخدم SSH للجهاز الافتراضي الجديد (الافتراضي: root)	لا	-
`--base-domain <domain>`	النطاق الأساسي للبنية التحتية (مثال: example.com). يتضمن --infra	لا	-
`--no-infra`	تخطي تكوين البنية التحتية (الوكيل + DNS)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.16 deprovision

تدمير جهاز مُوفَّر سحابياً وإزالته من الإعدادات

rdc machine deprovision <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--force`	تخطي نافذة التأكيد	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.17 backup

إدارة النسخ الاحتياطي للجهاز

schedule

دفع جدول النسخ الاحتياطي إلى جهاز بعيد (مؤقت systemd)

rdc machine backup schedule <machine> [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.18 prune

إزالة موارد مخزن البيانات المعزولة واللقطات القديمة من جهاز

rdc machine prune <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--dry-run`	عرض ما سيتم إزالته دون إجراء تغييرات	لا	-
`--orphaned-repos`	تنظيف صور المستودعات غير الموجودة في أي تكوين أيضًا	لا	-
`--force`	تخطي نوافذ التأكيد	لا	-
`--grace-days <days>`	فترة السماح بالأيام للمستودعات المؤرشفة حديثًا (الافتراضي: 7)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

5. خادم MCP

خادم MCP للوكلاء الذكية

5.1 serve

تشغيل خادم MCP (نقل stdio)

rdc mcp serve [options]

العلامة	الوصف	مطلوب	افتراضي
`--config <name>`	اسم الإعدادات المستخدمة لجميع الأوامر	لا	-
`--timeout <ms>`	مهلة الأمر الافتراضية بالميلي ثانية	لا	`120000`
`--allow-grand`	السماح بالعمليات المدمرة على المستودعات الرئيسية (غير fork). الافتراضي: وضع fork فقط	لا	-

6. دورة حياة المستودعات

نشر وإدارة المستودعات المشفرة على الأجهزة

6.1 mount

تثبيت مستودع (فتح حاوية LUKS)

rdc repo mount [name] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--checkpoint`	الاستعادة من نقطة تفتيش بعد التثبيت	لا	-
`--no-docker`	تخطي تشغيل Docker daemon بعد التثبيت	لا	-
`--parallel`	بدء المستودعات بشكل متزامن	لا	-
`--concurrency <n>`	الحد الأقصى للمستودعات المتزامنة (افتراضي: 3)	لا	`3`
`-y, --yes`	تخطي التأكيد للعمليات الجماعية	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.2 unmount

إلغاء تثبيت مستودع

rdc repo unmount [name] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--checkpoint`	إنشاء نقطة تفتيش قبل إلغاء التثبيت	لا	-
`--parallel`	بدء المستودعات بشكل متزامن	لا	-
`--concurrency <n>`	الحد الأقصى للمستودعات المتزامنة (افتراضي: 3)	لا	`3`
`-y, --yes`	تخطي التأكيد للعمليات الجماعية	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.3 up

نشر أو تحديث مستودع (تحميل، بدء الخدمات)

rdc repo up [name] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--mount`	تثبيت المستودع أولاً	لا	-
`--skip-checkpoint`	تخطي استعادة نقطة تفتيش CRIU حتى لو كانت بيانات checkpoint موجودة (فرض بدء جديد)	لا	-
`--tls`	طلب شهادة TLS مخصصة لهذا المستودع (النسخ المتفرعة تستخدم شهادة الجهاز المشتركة افتراضيًا)	لا	-
`--include-forks`	تشغيل/بدء المستودعات المتشعبة أيضًا	لا	-
`--mount-only`	التحميل فقط، بدون بدء الخدمات	لا	-
`--parallel`	بدء المستودعات بشكل متزامن	لا	-
`--concurrency <n>`	الحد الأقصى للمستودعات المتزامنة (افتراضي: 3)	لا	`3`
`-y, --yes`	تخطي التأكيد للعمليات الجماعية	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

6.4 up-all

نشر جميع المستودعات على جهاز

rdc repo up-all

6.5 down

إيقاف خدمات المستودع

rdc repo down [name] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--unmount`	إلغاء تثبيت المستودع بعد الإيقاف	لا	-
`--checkpoint`	إنشاء نقطة تفتيش CRIU قبل الإيقاف (حفظ حالة ذاكرة العمليات للاستعادة لاحقًا عبر 'repo up')	لا	-
`-y, --yes`	تخطي التأكيد للعمليات الجماعية	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

6.6 status

الحصول على حالة المستودع

rdc repo status <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.7 list

عرض المستودعات على جهاز

rdc repo list [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.8 create

إنشاء مستودع مشفر جديد

rdc repo create <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--size <size>`	حجم المستودع (مثلاً 10G، 100G، 1T)	نعم	-
`--no-docker`	تخطي تشغيل Docker daemon بعد الإنشاء	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.9 delete

حذف مستودع (يدمّر الحاويات والأقراص والصورة المشفّرة). يتم الاحتفاظ بإدخال الإعدادات. استخدم --archive-config لنقل بيانات الاعتماد إلى deletedRepositories للاستعادة عبر 'config restore-archived'

rdc repo delete <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--archive-config`	نقل إدخال الإعدادات إلى deletedRepositories للاستعادة لاحقاً	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

6.10 fork

إنشاء نسخة CoW (نسخ عند الكتابة) من مستودع

rdc repo fork <parent> [tag] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--tag <name>`	وسم النسخة (ينشئ اسم:وسم)	لا	-
`--checkpoint`	إنشاء نقطة تفتيش CRIU على المصدر قبل التفريع (التقاط حالة ذاكرة العمليات للاستعادة عند fork)	لا	-
`--up`	تركيب وبدء الخدمات بعد التفريع (fork + mount + up في أمر واحد)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.11 takeover

استبدال بيانات المستودع الأصلي ببيانات النسخة المتفرعة. يحتفظ الأصلي بهويته (GUID، networkId، النطاقات، التشغيل التلقائي، سلسلة النسخ الاحتياطي) لكنه يحصل على البيانات المحدّثة من النسخة المتفرعة. يتم حفظ البيانات القديمة للإنتاج كنسخة احتياطية متفرعة. للاستخدام: اختبر الترقية على النسخة المتفرعة → تحقق → استحوذ على بيانات الإنتاج.

rdc repo takeover <fork> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--force`	تخطي تحذيرات التعديل	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.12 resize

تغيير حجم مستودع دون اتصال (يدعم التوسيع والتقليص)

rdc repo resize <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--size <size>`	حجم المستودع الجديد (مثلاً 10G، 100G، 1T)	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.13 expand

توسيع مستودع مُركّب أثناء التشغيل (بدون توقف)

rdc repo expand <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--size <size>`	حجم المستودع الجديد (مثلاً 10G، 100G، 1T)	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.14 validate

التحقق من سلامة المستودع

rdc repo validate <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.15 autostart

إدارة التشغيل التلقائي للمستودعات عند الإقلاع

enable

تمكين التشغيل التلقائي لمستودع

rdc repo autostart enable [name] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

disable

تعطيل التشغيل التلقائي لمستودع

rdc repo autostart disable [name] [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

list

عرض المستودعات ذات التشغيل التلقائي المفعّل

rdc repo autostart list [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.16 ownership

تغيير ملكية مجلد المستودع

rdc repo ownership <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--uid <uid>`	معرّف المالك UID (افتراضي: 7111)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.17 template

تطبيق قالب على مستودع

list

عرض جميع قوالب النشر المضمنة في واجهة سطر الأوامر

rdc repo template list

apply

Apply a template to a repository. Use a built-in template name (e.g. app-postgres) or --file for a custom JSON template. The template writes Rediaccfile, docker-compose.yml, and any additional files to the repository mount

rdc repo template apply <template> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`-r, --repository <name>`	اسم المستودع (يتصل ببيئة المستودع)	نعم	-
`--file <path>`	مسار ملف قالب JSON	لا	-
`--grand <name>`	اسم المستودع الرئيسي (يُحلّ تلقائيًا إلى GUID)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.18 push

دفع مستودع إلى جهاز بعيد (جهاز أو تخزين). احذف الاسم لدفع جميع المستودعات. يتم الكشف عن نوع الهدف تلقائياً من الإعدادات. للنقل بين الأجهزة، يتم نسخ صورة المستودع المشفرة بنفس GUID — هذا نسخ احتياطي/ترحيل، وليس fork. لإنشاء fork مستقل، استخدم 'repo fork' أولاً، ثم ادفع. استخدم --up للنشر بعد الدفع

rdc repo push [repo] [options]

العلامة	الوصف	مطلوب	افتراضي
`--to <remote>`	اسم الجهاز أو التخزين الوجهة (يتم الكشف تلقائياً من الإعدادات)	لا	-
`--to-machine <machine>`	—	لا	-
`--provision <provider>`	تزويد الجهاز الهدف تلقائياً عبر مزود السحابة إذا لم يكن موجوداً	لا	-
`--checkpoint`	إنشاء نقطة فحص CRIU قبل النسخ الاحتياطي (التقاط حالة ذاكرة العمليات للترحيل المباشر)	لا	-
`--force`	فرض الكتابة فوق النسخة الاحتياطية الموجودة	لا	-
`--up`	بعد الدفع، قم بتركيب ونشر المستودع على الجهاز الهدف	لا	-
`--tag <tag>`	علامة النشر للإصدارات	لا	-
`-m, --machine <name>`	اسم الآلة	نعم	-
`-w, --watch`	الانتظار للتغييرات	لا	-
`--parallel`	بدء المستودعات بشكل متزامن	لا	-
`--concurrency <n>`	الحد الأقصى للمستودعات المتزامنة (افتراضي: 3)	لا	`3`
`-y, --yes`	تخطي التأكيد للعمليات الجماعية	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.19 pull

سحب مستودع من جهاز بعيد (جهاز أو تخزين). احذف الاسم لسحب جميع المستودعات. يتم الكشف عن نوع المصدر تلقائياً من الإعدادات. استخدم --up للنشر بعد السحب

rdc repo pull [repo] [options]

العلامة	الوصف	مطلوب	افتراضي
`--from <remote>`	اسم الجهاز أو التخزين المصدر (يتم الكشف تلقائياً من الإعدادات)	لا	-
`--from-machine <machine>`	—	لا	-
`--force`	فرض الكتابة فوق المستودع الموجود	لا	-
`--up`	بعد السحب، قم بتركيب ونشر المستودع على هذا الجهاز	لا	-
`-m, --machine <name>`	اسم الآلة	نعم	-
`-w, --watch`	الانتظار للتغييرات	لا	-
`--parallel`	بدء المستودعات بشكل متزامن	لا	-
`--concurrency <n>`	الحد الأقصى للمستودعات المتزامنة (افتراضي: 3)	لا	`3`
`-y, --yes`	تخطي التأكيد للعمليات الجماعية	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.20 backup

إدارة النسخ الاحتياطي للمستودعات

list

عرض قائمة النسخ الاحتياطية المتاحة على جهاز بعيد (جهاز أو تخزين)

rdc repo backup list [options]

العلامة	الوصف	مطلوب	افتراضي
`--from <remote>`	اسم الجهاز أو التخزين المصدر (يتم الكشف تلقائياً من الإعدادات)	لا	-
`--from-machine <machine>`	—	لا	-
`-m, --machine <name>`	اسم الآلة	نعم	-
`-w, --watch`	الانتظار للتغييرات	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.21 sync

مزامنة المستودعات والملفات (دفع/سحب جماعي، نقل ملفات)

push

دفع المستودعات إلى التخزين السحابي (احذف الاسم لدفع الكل)

rdc repo sync push

pull

سحب المستودعات من التخزين السحابي (احذف الاسم لسحب الكل)

rdc repo sync pull

upload

رفع الملفات إلى مستودع

rdc repo sync upload [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`-m, --machine <name>`	اسم الآلة	نعم	-
`-r, --repository <name>`	اسم المستودع (يتصل ببيئة المستودع)	لا	-
`--local <path>`	مسار المجلد المحلي (افتراضي: المجلد الحالي)	لا	-
`--remote <path>`	مسار المجلد الفرعي البعيد ضمن المستودع	لا	-
`--mirror`	وضع الانعكاس - حذف الملفات البعيدة غير الموجودة محلياً	لا	-
`--verify`	التحقق من الملفات باستخدام المجاميع الاختبارية بعد المزامنة	لا	-
`--confirm`	معاينة التغييرات وطلب التأكيد قبل المزامنة	لا	-
`--exclude <patterns...>`	الأنماط التي يتم استبعادها من المزامنة	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

download

تنزيل الملفات من مستودع

rdc repo sync download [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`-m, --machine <name>`	اسم الآلة	نعم	-
`-r, --repository <name>`	اسم المستودع (يتصل ببيئة المستودع)	لا	-
`--local <path>`	مسار المجلد المحلي (افتراضي: المجلد الحالي)	لا	-
`--remote <path>`	مسار المجلد الفرعي البعيد ضمن المستودع	لا	-
`--mirror`	وضع الانعكاس - حذف الملفات المحلية غير الموجودة على البعيد	لا	-
`--verify`	التحقق من الملفات باستخدام المجاميع الاختبارية بعد المزامنة	لا	-
`--confirm`	معاينة التغييرات وطلب التأكيد قبل المزامنة	لا	-
`--exclude <patterns...>`	الأنماط التي يتم استبعادها من المزامنة	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

status

التحقق من حالة المزامنة ومقارنة الملفات المحلية/البعيدة

rdc repo sync status [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`-m, --machine <name>`	اسم الآلة	نعم	-
`-r, --repository <name>`	اسم المستودع (يتصل ببيئة المستودع)	لا	-
`--local <path>`	مسار المجلد المحلي (افتراضي: المجلد الحالي)	لا	-
`--remote <path>`	مسار المجلد الفرعي البعيد ضمن المستودع	لا	-

6.22 snapshot

إدارة لقطات BTRFS على الأجهزة البعيدة

create

إنشاء لقطة BTRFS لمستودع

rdc repo snapshot create

list

سرد اللقطات على جهاز بعيد

rdc repo snapshot list

delete

حذف لقطة من جهاز بعيد

rdc repo snapshot delete

6.23 tunnel

إنشاء نفق SSH لتوجيه المنافذ إلى منفذ حاوية على جهاز بعيد. يكتشف تلقائيًا الحاوية والمنفذ عندما لا يكون هناك غموض. يبقى النفق مفتوحًا حتى تضغط Ctrl+C

rdc repo tunnel [machine] [repository] [options]

العلامة	الوصف	مطلوب	افتراضي
`-c, --container <name>`	اسم الحاوية (يُكتشف تلقائيًا إذا كانت واحدة فقط قيد التشغيل)	لا	-
`--port <port>`	منفذ الحاوية البعيد للتوجيه	لا	-
`--local <port>`	المنفذ المحلي (الافتراضي نفس المنفذ البعيد)	لا	-

7. إدارة التخزين

إدارة مزودي التخزين وتصفح الملفات البعيدة

7.1 list

قائمة موفري التخزين

rdc storage list [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`--search <text>`	البحث في {{field}}	لا	-
`--sort <field>`	الترتيب حسب الحقل	لا	-
`--desc`	ترتيب تنازلي	لا	-

7.2 create

إنشاء مزود تخزين جديد

rdc storage create <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-

7.3 rename

إعادة تسمية مزود تخزين

rdc storage rename <oldName> <newName> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-

7.4 delete

حذف مزود تخزين

rdc storage delete <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`-f, --force`	تخطي نوافذ التأكيد	لا	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-

7.5 vault

إدارة خزنة التخزين (محول السحابة فقط)

rdc storage vault

7.6 browse

تصفّح الملفات في نظام تخزين

rdc storage browse <name> [options]

العلامة	الوصف	مطلوب	افتراضي
`--path <subpath>`	مسار الدليل الفرعي للعرض	لا	“

7.7 prune

حذف النسخ الاحتياطية المعزولة من التخزين غير الموجودة في أي تكوين. آمن مع التكوينات المتعددة مع حماية فترة السماح.

rdc storage prune <storageName> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-
`--force`	تخطي نوافذ التأكيد	لا	-
`--grace-days <days>`	فترة السماح بالأيام للمستودعات المؤرشفة حديثًا (الافتراضي: 7)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

7.8 pull

سحب نسخة احتياطية من التخزين السحابي إلى جهاز

rdc storage pull

8. تكامل VS Code

فتح VS Code Remote SSH للاتصال بجهاز أو مستودع

8.1 connect

الاتصال بآلة أو مستودع في VS Code

rdc vscode connect [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`-m, --machine <name>`	اسم الآلة	لا	-
`-r, --repository <name>`	اسم المستودع (يتصل ببيئة المستودع)	لا	-
`-f, --folder <path>`	مسار المجلد البعيد للفتح	لا	-
`--url-only`	طباعة عنوان VS Code URI بدلاً من تشغيله	لا	-
`-n, --new-window`	الفتح في نافذة VS Code جديدة	لا	-
`--skip-env-setup`	تخطي إعداد البيئة البعيدة	لا	-
`--insiders`	استخدام إعدادات VS Code Insiders	لا	-

8.2 list

قائمة اتصالات VS Code SSH المكونة

rdc vscode list

8.3 cleanup

إزالة إعدادات VS Code SSH

rdc vscode cleanup [options]

العلامة	الوصف	مطلوب	افتراضي
`--all`	إزالة جميع إعدادات SSH الخاصة بـ rediacc	لا	-
`-c, --connection <name>`	إزالة اتصال معين	لا	-

8.4 check

التحقق من تثبيت VS Code والإعدادات

rdc vscode check [options]

العلامة	الوصف	مطلوب	افتراضي
`--insiders`	استخدام إعدادات VS Code Insiders	لا	-

9. وصول طرفية SSH

وصول طرفية SSH إلى الآلات والمستودعات

9.1 connect

الاتصال بآلة أو مستودع عبر SSH

rdc term connect [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --team <name>`	اسم الفريق	لا	-
`-m, --machine <name>`	اسم الآلة	لا	-
`-r, --repository <name>`	اسم المستودع (يتصل ببيئة المستودع)	لا	-
`-c, --command <cmd>`	تنفيذ أمر بدلاً من الصدفة التفاعلية	لا	-
`--container <id>`	الاتصال بحاوية Docker معينة	لا	-
`--container-action <action>`	إجراء الحاوية: terminal أو logs أو stats أو exec	لا	-
`--log-lines <lines>`	عدد أسطر السجل المراد عرضها (افتراضي: 50)	لا	-
`--follow`	متابعة إخراج السجلات	لا	-
`--external`	فرض تشغيل في نافذة طرفية خارجية	لا	-
`--reset-home`	إعادة تعيين طبقة المنزل لكل مستودع للبدء من جديد	لا	-

10. معالج البروتوكول

تسجيل ومعالجة عناوين URL لبروتوكول {{scheme}}://

10.1 register

تسجيل معالج البروتوكول على النظام

rdc protocol register [options]

العلامة	الوصف	مطلوب	افتراضي
`--system`	تسجيل على مستوى النظام (يتطلب امتيازات المسؤول)	لا	-
`--force`	فرض إعادة التسجيل حتى لو كان مسجلاً بالفعل	لا	-

10.2 unregister

إلغاء تسجيل معالج البروتوكول من النظام

rdc protocol unregister [options]

العلامة	الوصف	مطلوب	افتراضي
`--system`	إلغاء تسجيل التسجيل على مستوى النظام (يتطلب امتيازات المسؤول)	لا	-

10.3 status

عرض حالة تسجيل معالج البروتوكول

rdc protocol status

10.4 open

فتح عنوان URL {{scheme}}:// وتنفيذ الإجراء

rdc protocol open <url>

10.5 build

إنشاء عنوان URL {{scheme}}:// من المكونات

rdc protocol build [options]

العلامة	الوصف	مطلوب	افتراضي
`--token <token>`	رمز المصادقة	نعم	-
`-t, --team <name>`	اسم الفريق	نعم	-
`-m, --machine <name>`	اسم الآلة	نعم	-
`-r, --repository <name>`	اسم المستودع (يتصل ببيئة المستودع)	لا	-
`-a, --action <action>`	الإجراء ({{actions}})	لا	`desktop`
`-p, --params <key=value...>`	معاملات إضافية	لا	-

10.6 parse

تحليل عنوان URL {{scheme}}:// وعرض المكونات

rdc protocol parse <url>

11. أوامر سريعة (اختصارات)

11.1 run

تنفيذ دالة (اختصار لـ: queue create)

rdc run

11.2 trace

تتبع مهمة (اختصار لـ: queue trace)

rdc trace

11.3 cancel

إلغاء مهمة (اختصار لـ: queue cancel)

rdc cancel

11.4 retry

إعادة محاولة مهمة فاشلة (اختصار لـ: queue retry)

rdc retry

12. إدارة الاشتراكات

إدارة تراخيص الجهاز والاشتراك

المصادقة باستخدام رمز API من بوابة الويب

rdc subscription login [options]

العلامة	الوصف	مطلوب	افتراضي
`-t, --token <token>`	رمز API (rdt_...)	لا	-
`--server <url>`	عنوان خادم الحساب	لا	-

12.2 logout

مسح رمز الاشتراك المحفوظ

rdc subscription logout

12.3 status

عرض حالة الاشتراك والترخيص

rdc subscription status

12.4 activation

إدارة تفعيل الجهاز

status

عرض حالة تفعيل جهاز واحد

rdc subscription activation status [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-

12.5 repo

إدارة تراخيص المستودعات

status

عرض تراخيص المستودعات المثبتة على جهاز

rdc subscription repo status [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-

12.6 refresh

تحديث ترخيص الجهاز

activation

تحديث تفعيل الجهاز على جهاز بعيد

rdc subscription refresh activation [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-

repos

تحديث تراخيص المستودعات دفعة واحدة على جهاز بعيد

rdc subscription refresh repos [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-

repo

تحديث ترخيص المستودع لمستودع محدد

rdc subscription refresh repo <repo> [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-

13. تحديثات سطر الأوامر

التحقق من تحديثات CLI وتطبيقها

rdc update [options]

العلامة	الوصف	مطلوب	افتراضي
`--force`	فرض التحديث حتى لو كان محدثاً	لا	-
`--check-only`	التحقق من التحديثات فقط دون التنزيل	لا	-
`--rollback`	التراجع إلى الإصدار السابق	لا	-
`--status`	عرض حالة التحديث التلقائي والتشخيصات	لا	-

14. تشخيص النظام

تشخيص بيئة CLI وتكامل renet

rdc doctor

15. عمليات VM التجريبية

عمليات VM التجريبية (إنشاء، إدارة، حذف)

15.1 up

إنشاء مجموعة VM محلياً

rdc ops up [options]

العلامة	الوصف	مطلوب	افتراضي
`--force`	فرض إعادة تشغيل جميع الآلات الافتراضية	لا	-
`--parallel`	إنشاء الآلات الافتراضية بالتوازي	لا	-
`--basic`	مجموعة بسيطة (جسر + عامل واحد)	لا	-
`--lite`	تخطي توفير VM (الحالة فقط)	لا	-
`--skip-orchestration`	تخطي تنسيق المجموعة	لا	-
`--backend <backend>`	واجهة المحاكاة الافتراضية (kvm\|qemu، يتم الكشف عنها تلقائياً)	لا	-
`--os <name>`	نظام تشغيل VM (مثلاً، ubuntu-24.04، debian-12)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

15.2 down

تدمير مجموعة VM

rdc ops down [options]

العلامة	الوصف	مطلوب	افتراضي
`--backend <backend>`	واجهة المحاكاة الافتراضية (kvm\|qemu، يتم الكشف عنها تلقائياً)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

15.3 status

عرض حالة مجموعة VM

rdc ops status [options]

العلامة	الوصف	مطلوب	افتراضي
`--backend <backend>`	واجهة المحاكاة الافتراضية (kvm\|qemu، يتم الكشف عنها تلقائياً)	لا	-

15.4 ssh

الاتصال بـ VM عبر SSH

rdc ops ssh <vmId> [command...] [options]

العلامة	الوصف	مطلوب	افتراضي
`--backend <backend>`	واجهة المحاكاة الافتراضية (kvm\|qemu، يتم الكشف عنها تلقائياً)	لا	-
`--user <user>`	اسم مستخدم SSH للاتصال بالآلة الافتراضية	لا	-

15.5 setup

تثبيت متطلبات المحاكاة الافتراضية

rdc ops setup [options]

العلامة	الوصف	مطلوب	افتراضي
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

15.6 check

التحقق من متطلبات المحاكاة الافتراضية

rdc ops check

رسائل الخطأ الشائعة

عندما يحدث خطأ ما، يوفر سطر الأوامر رسائل خطأ واضحة:

الخطأ	المعنى
المصادقة مطلوبة. قم بتشغيل: rdc auth login	تحتاج إلى تسجيل الدخول أولاً
لا توجد إعدادات نشطة. أنشئ واحدة باستخدام: rdc config init <name>	لا توجد إعدادات نشطة — أنشئ واحدة باستخدام `rdc config init`
تم رفض الإذن	حسابك لا يملك الصلاحيات المطلوبة
اسم الآلة مطلوب. استخدم --machine <name>	حدد جهازاً باستخدام `--machine` أو عيّن قيمة افتراضية للسياق
اسم الفريق مطلوب. استخدم --team أو اضبط السياق.	حدد فريقاً باستخدام `--team` أو عيّن قيمة افتراضية للسياق
اسم المنطقة مطلوب. استخدم --region أو اضبط السياق.	حدد منطقة باستخدام `--region` أو عيّن قيمة افتراضية للسياق

تنسيقات الإخراج

تدعم جميع أوامر القائمة/الحصول تنسيقات إخراج متعددة عبر `--output`:

rdc machine list --output json
rdc machine list --output yaml
rdc machine list --output csv
rdc machine list --output table   # default

هذا يسهّل دمج سطر أوامر Rediacc في البرامج النصية وخطوط أنابيب CI/CD وسير عمل الأتمتة.