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

نظرة عامة

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

التثبيت

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

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

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

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

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

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

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

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

1.1 capabilities

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

rdc agent capabilities

1.2 schema

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

rdc agent schema [options]

العلامة	الوصف	مطلوب	افتراضي
`--command <path>`	تنفيذ أمر بدلاً من الصدفة التفاعلية	نعم	-

1.3 exec

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

rdc agent exec [options]

العلامة	الوصف	مطلوب	افتراضي
`--command <path>`	تنفيذ أمر بدلاً من الصدفة التفاعلية	نعم	-

1.4 generate-reference

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

rdc agent generate-reference

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

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

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

2.1 prune

إزالة الأوزان الميتة من ملف التكوين المحلي في ~/.config/rediacc/<config>.json. يتم تنظيف ثلاث مجموعات، جميعها محلية بحتة (بدون مكالمات SSH/renet): (1) إدخالات ذاكرة التخزين المؤقت لشهادات ACME التي لم يعد المرسى GUID/repo/machine الخاص بها موجوداً في التكوين النشط؛ (2) المستودعات المؤرشفة التي انتهت فترة سماحها (افتراضياً 7 أيام، انظر defaults.pruneGraceDays)؛ (3) المراجع المتقاطعة المعلقة (machine→strategy، strategy→repo). الموارد المستخدمة وبيانات الاعتماد ورموز التخزين والمضيفات المعروفة لا تُلمس أبداً. السلوك الافتراضي هو تطبيق التغييرات؛ مرر --dry-run للمعاينة فقط.

rdc config prune [options]

العلامة	الوصف	مطلوب	افتراضي
`--dry-run`	معاينة ما سيتم إزالته دون تعديل ملف التكوين. يعكس دلالات الإيقاف الافتراضية لأوامر التنظيف الأخرى.	لا	-
`--certs-only`	تقييد ذاكرة التخزين المؤقت لشهادات ACME. يتخطى تطهير الأرشيف وتنظيف المراجع المتقاطعة. حصري بشكل متبادل مع --archives-only و --refs-only.	لا	-
`--archives-only`	تقييد لتطهير الأرشيف المنتهي. يتخطى ذاكرة التخزين المؤقت للشهادات وتنظيف المراجع المتقاطعة. حصري مع --certs-only و --refs-only.	لا	-
`--refs-only`	تقييد للمراجع المتقاطعة المعلقة (machine→strategy، استثناءات/تضمينات strategy→repo). يتخطى ذاكرة التخزين المؤقت للشهادات والأرشيف. حصري مع --certs-only و --archives-only.	لا	-
`--purge-archived`	إسقاط جميع المستودعات المؤرشفة بغض النظر عن العمر، ليس فقط تلك التي تجاوزت السماح. مكافئ لتشغيل 'rdc config repository purge-archived'. استخدم فقط عندما تكون متأكداً من أنك لا تحتاج إلى أي من بيانات الاعتماد المخزنة للاستعادة.	لا	-
`--grace-days <days>`	تجاوز نافذة سماح الأرشيف (بالأيام) لهذا الاستدعاء. يعود إلى defaults.pruneGraceDays في التكوين، ثم إلى 7 إذا لم يتم تعيين أي منهما.	لا	-

2.2 init

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

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

rdc config init [options]

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

2.3 list

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

rdc config list

2.4 show

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

rdc config show [options]

العلامة	الوصف	مطلوب	افتراضي
`--reveal`	عرض النص الصريح للقيم الحساسة (الوضع التفاعلي فقط)	لا	-

2.5 delete

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

rdc config delete [options]

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

2.6 set

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

rdc config set [options]

العلامة	الوصف	مطلوب	افتراضي
`--key <key>`	مفتاح الإعداد	نعم	-
`--value <value>`	قيمة الإعداد	نعم	-

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

2.7 clear

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

rdc config clear [options]

العلامة	الوصف	مطلوب	افتراضي
`--key <key>`	مفتاح الإعداد	لا	-

2.8 recover

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

rdc config recover [options]

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

2.9 set-ssh

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

rdc config set-ssh

2.10 set-renet

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

rdc config set-renet

2.11 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.12 remote

إدارة اتصال تخزين الإعدادات عن بُعد

enable

ربط هذه الإعدادات بالتخزين المشفر عن بُعد

rdc config remote enable [options]

العلامة	الوصف	مطلوب	افتراضي
`--headless`	استخدام تدفق رمز الجهاز (للخوادم بدون واجهة)	لا	-
`--api-url <url>`	عنوان خادم الحساب	لا	-

disable

قطع الاتصال بالتخزين عن بُعد وحفظ الإعدادات محلياً

rdc config remote disable

status

عرض حالة الاتصال عن بُعد

rdc config remote status

refresh

إعادة جلب الإعدادات من التخزين عن بُعد

rdc config remote refresh

2.13 machine

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

add

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

rdc config machine add [options]

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

remove

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

rdc config machine remove [options]

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

list

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

rdc config machine list

scan-keys

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

rdc config machine scan-keys [options]

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

setup

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

rdc config machine setup [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`--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.14 repository

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

add

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

rdc config repository add [options]

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

remove

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

rdc config repository remove [options]

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

list

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

rdc config repository list

list-archived

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

rdc config repository list-archived

restore-archived

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

rdc config repository restore-archived [options]

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

purge-archived

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

rdc config repository purge-archived

2.15 provider

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

add

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

rdc config provider add [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`--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 [options]

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

list

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

rdc config provider list

2.16 storage

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

import

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

rdc config storage import [options]

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

remove

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

rdc config storage remove [options]

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

list

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

rdc config storage list

2.17 infra

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

set

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

rdc config infra set [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-
`--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 [options]

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

push

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

rdc config infra push [options]

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

2.18 cert-cache

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

pull

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

rdc config cert-cache pull [options]

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

push

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

rdc config cert-cache push [options]

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

status

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

rdc config cert-cache status

clear

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

rdc config cert-cache clear

2.19 field

عمليات حقول التكوين المعنونة بالمؤشرات (get/set/unset/rotate/list). مؤشرات JSON (RFC 6901) مثل /credentials/cfDnsApiToken.

get

قراءة قيمة تكوين واحدة بواسطة مؤشر JSON. تُخفى الحقول الحساسة إلا باستخدام --reveal (للمستخدمين البشريين فقط).

rdc config field get [options]

العلامة	الوصف	مطلوب	افتراضي
`--pointer <pointer>`	مؤشر JSON إلى الحقل (مثال: /credentials/cfDnsApiToken)	نعم	-
`--reveal`	إظهار النص الصريح للقيم الحساسة (طرفية تفاعلية فقط؛ يُسجَّل في التدقيق)	لا	-
`--digest`	طباعة تلخيص SHA-256 بدلاً من القيمة (آمن للمشاركة مع العملاء الذكيين)	لا	-

set

كتابة قيمة تكوين عند مؤشر JSON. المسارات الحساسة تتطلب --current (بوابة المعرفة).

rdc config field set [options]

العلامة	الوصف	مطلوب	افتراضي
`--pointer <pointer>`	مؤشر JSON إلى الحقل (مثال: /credentials/cfDnsApiToken)	نعم	-
`--new <value>`	القيمة الجديدة (تُفسَّر كـ JSON إذا بدأت بـ { [ " أو true/false/null/رقم)	نعم	-
`--current <value>`	القيمة الصريحة الحالية - مطلوبة لتعديل المسارات الحساسة (إثبات بوابة المعرفة)	لا	-

unset

حذف قيمة تكوين عند مؤشر JSON. المسارات الحساسة تتطلب --current.

rdc config field unset [options]

العلامة	الوصف	مطلوب	افتراضي
`--pointer <pointer>`	مؤشر JSON إلى الحقل (مثال: /credentials/cfDnsApiToken)	نعم	-
`--current <value>`	القيمة الصريحة الحالية - مطلوبة لحذف المسارات الحساسة	لا	-

rotate

تدوير قيمة حساسة دون --current. طرفية تفاعلية فقط؛ يُسجَّل بشكل بارز.

rdc config field rotate [options]

العلامة	الوصف	مطلوب	افتراضي
`--pointer <pointer>`	مؤشر JSON إلى الحقل الحساس (مثال: /credentials/cfDnsApiToken)	نعم	-
`--new <value>`	قيمة جديدة	نعم	-

list

سرد كل قالب مؤشر مسجّل مع نوعه وسياسة الالتزام/التشفير.

rdc config field list [options]

العلامة	الوصف	مطلوب	افتراضي
`--sensitive`	عرض القوالب الحساسة فقط (غير العامة)	لا	-

2.20 edit

فتح التكوين الحالي في $EDITOR كإسقاط JSONC مُخفى. للمستخدمين البشريين فقط؛ يُرفض العملاء.

rdc config edit [options]

العلامة	الوصف	مطلوب	افتراضي
`--reveal`	إظهار النص الصريح للقيم الحساسة (طرفية تفاعلية فقط؛ يُسجَّل في التدقيق)	لا	-
`--dump`	طباعة التكوين الحالي كـ JSONC إلى stdout بدلاً من فتح المحرر (للقراءة فقط؛ آمن للعملاء عند الإخفاء)	لا	-
`--apply <file>`	تطبيق ملف JSONC معدّل (يتخطى إطلاق $EDITOR)	لا	-
`--current-secrets <file>`	ملف JSON يربط المؤشر → النص الصريح القديم لبوابة المعرفة عند --apply	لا	-
`--editor <cmd>`	أمر المحرر البديل (يتبع تسلسل git: --editor > $GIT_EDITOR > git config core.editor > $VISUAL > $EDITOR)	لا	-

2.21 audit

فحص سجل تدقيق التكوين (JSONL متسلسل التجزئة في ~/.config/rediacc/audit.log.jsonl)

log

طباعة أحدث إدخالات التدقيق بصيغة JSON

rdc config audit log [options]

العلامة	الوصف	مطلوب	افتراضي
`--since <spec>`	إظهار الإدخالات الأحدث من (مثال: '24h', '7d', طابع زمني ISO)	لا	-
`--path <glob>`	تصفية حسب نمط مؤشر JSON (مثال: /credentials/*)	لا	-
`--actor <kind>`	تصفية حسب نوع الفاعل (human\|agent)	لا	-

tail

بث الإدخالات الجديدة أثناء كتابتها (Ctrl+C للإيقاف)

rdc config audit tail

verify

التحقق من سلامة سلسلة تجزئة SHA-256 عبر جميع إدخالات التدقيق

rdc config audit verify

2.22 backup-strategy

إدارة استراتيجيات النسخ الاحتياطي المسماة (أوضاع ساخنة/باردة، وجهات، جدولة)

set

إنشاء أو تحديث استراتيجية نسخ احتياطي

rdc config backup-strategy set [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم الاستراتيجية (مطلوب)	نعم	-
`--destination <name>`	اسم الوجهة ضمن الاستراتيجية	لا	-
`--storage <name>`	اسم تكوين التخزين (بيانات اعتماد rclone)	لا	-
`--cron <expression>`	جدول cron (مثلاً "0 * * * *" للتشغيل كل ساعة)	لا	-
`--mode <mode>`	وضع النسخ الاحتياطي: "hot" (بدون توقف) أو "cold" (إيقاف، لقطة، إعادة تشغيل)	لا	-
`--bwlimit <limit>`	حد عرض النطاق الترددي لـ rclone (مثلاً "6M"، "10M:off"، "08:00,3M;22:00,10M")	لا	-
`--include <repos>`	نسخ هذه المستودعات فقط (أسماء مفصولة بفواصل)	لا	-
`--exclude <repos>`	استبعاد هذه المستودعات من النسخ الاحتياطي (أسماء مفصولة بفواصل)	لا	-
`--folder <path>`	المجلد الفرعي في حاوية التخزين لهذه الوجهة (مثال: hot, cold)	لا	-
`--enable`	تفعيل الاستراتيجية أو الوجهة	لا	-
`--disable`	تعطيل الاستراتيجية أو الوجهة	لا	-

remove

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

rdc config backup-strategy remove [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم الاستراتيجية (مطلوب)	نعم	-
`--destination <name>`	إزالة هذه الوجهة فقط (الاحتفاظ بالوجهات الأخرى)	لا	-

list

عرض قائمة جميع استراتيجيات النسخ الاحتياطي

rdc config backup-strategy list

show

عرض تفاصيل استراتيجية النسخ الاحتياطي

rdc config backup-strategy show [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم الاستراتيجية (يعرض الكل إذا لم يُحدد)	لا	-

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 [options]

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

4.3 rename

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

rdc machine rename [options]

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

4.4 delete

حذف آلة

rdc machine delete [options]

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

4.5 vault

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

rdc machine vault

4.6 vault-status

rdc machine vault-status [options]

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

4.7 update

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

rdc machine update

4.8 health

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

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

rdc machine health [options]

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

4.9 containers

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

rdc machine containers [options]

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

4.10 services

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

rdc machine services [options]

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

4.11 query

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

rdc machine query [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--system`	تضمين معلومات النظام فقط	لا	-
`--repositories`	تضمين المستودعات فقط	لا	-
`--containers`	تضمين الحاويات فقط	لا	-
`--services`	تضمين الخدمات فقط	لا	-
`--network`	تضمين واجهات الشبكة فقط	لا	-
`--block-devices`	تضمين أجهزة التخزين فقط	لا	-
`--licenses`	تضمين حالات تراخيص المستودعات	لا	-
`--storage-health`	عرض تجزئة BTRFS ووفورات reflink لكل مستودع	لا	-
`--sync-certs`	اسحب أيضًا ذاكرة التخزين المؤقت لشهادات ACME من الجهاز بعد الاستعلام	لا	-
`--strict`	الخروج بقيمة غير صفرية (الكود 2) إذا تجاوزت أي حاوية عتبة انحراف الصحة	لا	-

4.12 vault-status

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

rdc machine vault-status [options]

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

4.13 repos

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

rdc machine repos [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`-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 [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`--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 [options]

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

4.17 backup

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

list

عرض استراتيجيات النسخ الاحتياطي المرتبطة بجميع الأجهزة

rdc machine backup list

schedule

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

rdc machine backup schedule [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-
`--dry-run`	معاينة الوحدات المُولَّدة دون نشرها	لا	-
`--force`	المتابعة حتى إن كانت هناك نسخة احتياطية قيد التشغيل (تنطبق الوحدة الجديدة عند النبضة التالية للمؤقت؛ يحتفظ التنفيذ الجاري بوحدته القديمة)	لا	-
`--reset-failed`	مسح حالة الفشل للخدمات المُعدَّلة بعد نشر ناجح (معطّل افتراضيًا، يحافظ على إشارة الفشل)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

now

تشغيل نسخة احتياطية فورية على جهاز بعيد

rdc machine backup now [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-
`--strategy <name>`	اسم الاستراتيجية (يشغّل الكل إذا لم يُحدَّد)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

status

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

rdc machine backup status [options]

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

cancel

إلغاء نسخة احتياطية قيد التشغيل على جهاز بعيد

rdc machine backup cancel [options]

العلامة	الوصف	مطلوب	افتراضي
`-m, --machine <name>`	اسم الآلة	نعم	-
`--strategy <name>`	اسم الاستراتيجية (يلغي الكل إذا لم يُحدَّد)	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

4.18 prune

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

rdc machine prune [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`--dry-run`	عرض ما سيتم إزالته دون إجراء تغييرات	لا	-
`--orphaned-repos`	تنظيف صور المستودعات غير الموجودة في أي تكوين أيضًا	لا	-
`--prune-unknown`	حذف فقط المستودعات التي لا يستطيع مرآة renet .interim/state تصنيفها (ليست في التكوين المحلي ولا تحتوي على مرآة موسومة بالشوكة). أضيق بشكل صارم من --orphaned-repos: تتم المحافظة على الشوكات بدون تكوين عندما تحددها المرآة. المتبقيات القديمة قبل المرآة والأجداد القدامى الذين تم حذف إدخال التكوين الخاص بهم يقعون كلاهما في هذه الفئة.	لا	-
`--force-delete-mounted`	تجاوز فحص أمان التركيب وحذف المستودعات حتى لو كانت مركبة حالياً أو تحتوي على حاويات Docker قيد التشغيل. مختلف عن --force (الذي يتجاوز فترة السماح للأرشيف فقط). ينطبق على كل من --orphaned-repos و --prune-unknown.	لا	-
`--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 [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	لا	-
`-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 [options]

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

6.3 up

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

rdc repo up [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	لا	-
`-m, --machine <name>`	اسم الجهاز المستهدف	نعم	-
`--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 [options]

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

6.6 status

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

rdc repo status [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`-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 [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`-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 [options]

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

6.10 fork

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

rdc repo fork [options]

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

6.11 takeover

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

rdc repo takeover [options]

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

6.12 resize

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

rdc repo resize [options]

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

6.13 expand

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

rdc repo expand [options]

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

6.14 validate

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

rdc repo validate [options]

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

6.15 autostart

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

enable

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

rdc repo autostart enable [options]

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

disable

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

rdc repo autostart disable [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	لا	-
`-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 [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`-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 [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`-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 [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	لا	-
`--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`	تخطي التأكيد للعمليات الجماعية	لا	-
`--bwlimit <limit>`	حد عرض النطاق لنقل rsync (مثال: "6M"، "10M")	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-
`--skip-router-restart`	تخطي إعادة تشغيل خادم التوجيه بعد تحديث الملف التنفيذي	لا	-

6.19 pull

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

rdc repo pull [options]

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

6.20 migrate

ترحيل مباشر لمستودع من جهاز إلى آخر مع أقل وقت توقف. rsync على مرحلتين: نقل بالجملة أثناء التشغيل، ثم توقف قصير لمزامنة الفرق. يدعم نقطة فحص CRIU لترحيل ذاكرة العمليات والتوفير التلقائي للأجهزة الهدف

rdc repo migrate [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`--from <machine>`	اسم الجهاز المصدر	نعم	-
`--to <machine>`	اسم الجهاز المستهدف	نعم	-
`--provision <provider>`	توفير تلقائي للهدف عبر مزود السحابة (مثال: hetzner، linode)	لا	-
`--bwlimit <limit>`	حد عرض النطاق لنقل rsync (مثال: 10M)	لا	-
`--checkpoint`	ترحيل مباشر عبر CRIU: التقاط واستعادة حالة ذاكرة العمليات	لا	-
`--skip-dns`	تخطي تبديل سجلات DNS بعد الترحيل	لا	-
`--debug`	تفعيل مخرجات التصحيح (الوضع المحلي)	لا	-

6.21 backup

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

list

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

rdc repo backup list [options]

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

6.22 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 <paths...>`	مسار واحد أو أكثر لملف أو مجلد محلي (الافتراضي: المجلد الحالي)	لا	-
`--remote <path>`	مسار المجلد الفرعي البعيد ضمن المستودع	لا	-
`--remote-file <path>`	‫مسار ملف بعيد واحد (نسبي إلى جذر المستودع) للرفع إليه. لا يمكن استخدامه مع --remote.	لا	-
`--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>`	مسار المجلد الفرعي البعيد ضمن المستودع	لا	-
`--remote-file <path>`	مسار الملف البعيد داخل المستودع (بديل لـ --remote لنقل ملف واحد)	لا	-
`--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>`	مسار المجلد الفرعي البعيد ضمن المستودع	لا	-
`--remote-file <path>`	مسار الملف البعيد داخل المستودع (بديل لـ --remote لنقل ملف واحد)	لا	-

6.23 snapshot

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

create

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

rdc repo snapshot create

list

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

rdc repo snapshot list

delete

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

rdc repo snapshot delete

6.24 tunnel

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

rdc repo tunnel [options]

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

6.25 secret

Manage per-repo secrets injected at deploy time. Two modes: env (REDIACC_SECRET_<KEY> via compose ${VAR} interpolation) and file (host tmpfs at /var/run/rediacc/secrets/<networkId>/<KEY>, mounted via Docker compose `secrets:` block). Secrets never enter the encrypted LUKS image, so forks inherit none — externals see the fork as a different principal.

get

Read a single secret. Returns a redacted stub (`<redacted:secret>:<digest8>`) under agent context regardless of policy.

rdc repo secret get [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <repository>`	اسم المستودع (مثل mail، mail:staging). بدون علامة، الافتراضي :latest.	نعم	-
`--key <KEY>`	مفتاح السر بصيغة UPPER_SNAKE_CASE (بحد أقصى 64 حرفاً). سيتم عرضه كـ REDIACC_SECRET_<KEY> لوضع env أو /run/secrets/<key> في الحاويات لوضع file.	نعم	-

list

سرد مفاتيح وأوضاع السر (لا قيم أبداً، ولا ملخصات).

rdc repo secret list [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <repository>`	اسم المستودع (مثل mail، mail:staging). بدون علامة، الافتراضي :latest.	نعم	-

set

تعيين أو الكتابة فوق سر. الشوكات لا ترث؛ عيّن على الشوكة بشكل صريح. تحت سياق الوكيل، يتطلب تطابق ملخص --current (نمط passwd).

rdc repo secret set [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <repository>`	اسم المستودع (مثل mail، mail:staging). بدون علامة، الافتراضي :latest.	نعم	-
`--key <KEY>`	مفتاح السر بصيغة UPPER_SNAKE_CASE (بحد أقصى 64 حرفاً). سيتم عرضه كـ REDIACC_SECRET_<KEY> لوضع env أو /run/secrets/<key> في الحاويات لوضع file.	نعم	-
`--value <value>`	قيمة السر. مرر `-` للقراءة من stdin (يتجنب التعرض في سجل الصدفة).	نعم	-
`--mode <mode>`	وضع التسليم: 'env' (مرئي في بيئة الحاوية، docker inspect) أو 'file' (ملف tmpfs، ليس في البيئة أبداً). الافتراضي: file.	لا	`file`
`--current <value>`	SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write.	لا	-
`--rotate-secret`	الإقرار بالتدوير؛ تخطي شرط --current المسبق (مدقق كتدوير). استخدم عند التدوير المتعمد دون التحقق من القيمة السابقة.	لا	-

unset

حذف سر. تحت سياق الوكيل، يتطلب تطابق ملخص --current.

rdc repo secret unset [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <repository>`	اسم المستودع (مثل mail، mail:staging). بدون علامة، الافتراضي :latest.	نعم	-
`--key <KEY>`	مفتاح السر بصيغة UPPER_SNAKE_CASE (بحد أقصى 64 حرفاً). سيتم عرضه كـ REDIACC_SECRET_<KEY> لوضع env أو /run/secrets/<key> في الحاويات لوضع file.	نعم	-
`--current <value>`	SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write.	لا	-
`--rotate-secret`	الإقرار بالتدوير؛ تخطي شرط --current المسبق (مدقق كتدوير). استخدم عند التدوير المتعمد دون التحقق من القيمة السابقة.	لا	-

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

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

7.1 list

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

rdc storage list [options]

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

7.2 create

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

rdc storage create [options]

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

7.3 rename

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

rdc storage rename [options]

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

7.4 delete

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

rdc storage delete [options]

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

7.5 vault

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

rdc storage vault

7.6 browse

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

rdc storage browse [options]

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

7.7 prune

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

rdc storage prune [options]

العلامة	الوصف	مطلوب	افتراضي
`--name <name>`	اسم المورد	نعم	-
`-m, --machine <name>`	آلة المنفذ، تشغل مكالمات قائمة/حذف rclone مقابل التخزين. مطلوبة لأن العملاء لا يُتوقع منهم تثبيت rclone محلياً؛ بيانات اعتماد التخزين لا تزال تأتي من تكوينك المحلي.	نعم	-
`--dry-run`	عرض ما سيتم تنفيذه دون إجراء تغييرات	لا	-
`--force`	تخطي نوافذ التأكيد	لا	-
`--force-delete-mounted`	تجاوز فحص أمان التركيب وحذف النسخ الاحتياطية السحابية حتى لو كان GUID المصدر مركباً حالياً أو لديه حاوية قيد التشغيل على آلة المنفذ. مختلف عن --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 [options]

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

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

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

rdc update [options]

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

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 [options]

العلامة	الوصف	مطلوب	افتراضي
`--vm-id <id>`	معرّف الآلة الافتراضية	نعم	-
`-c, --command <cmd>`	تنفيذ أمر بدلاً من الصدفة التفاعلية	لا	-
`--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 <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 وسير عمل الأتمتة.