CLI commands

الخدمة الخلفية

`OmeniaClaw daemon`

اسم مستعار قديم لأوامر إدارة خدمة Gateway.

يُطابق OmeniaClaw daemon ... سطح التحكم في الخدمة نفسه الذي تستخدمه أوامر خدمة OmeniaClaw gateway ....

الاستخدام

bash

OmeniaClaw daemon statusOmeniaClaw daemon installOmeniaClaw daemon startOmeniaClaw daemon stopOmeniaClaw daemon restartOmeniaClaw daemon uninstall

الأوامر الفرعية

status: عرض حالة تثبيت الخدمة وفحص سلامة Gateway
install: تثبيت الخدمة (launchd/systemd/schtasks)
uninstall: إزالة الخدمة
start: بدء الخدمة
stop: إيقاف الخدمة
restart: إعادة تشغيل الخدمة

الخيارات الشائعة

status: --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
install: --port, --runtime <node|bun>, --token, --force, --json
restart: --safe, --skip-deferral, --force, --wait <duration>, --json
دورة الحياة (uninstall|start|stop): --json

ملاحظات:

يحلّ status مراجع الأسرار المكوّنة للمصادقة من أجل مصادقة الفحص عندما يكون ذلك ممكنًا.
إذا تعذّر حل مرجع سر مطلوب في مسار هذا الأمر، فإن daemon status --json يبلّغ عن rpc.authWarning عند فشل اتصال الفحص أو المصادقة؛ مرّر --token/--password صراحةً أو حلّ مصدر السر أولًا.
إذا نجح الفحص، تُخفى تحذيرات مراجع المصادقة غير المحلولة لتجنّب النتائج الإيجابية الكاذبة.
يضيف status --deep فحصًا على مستوى النظام للخدمة بأفضل جهد. عندما يعثر على خدمات أخرى شبيهة بالبوابة، تطبع المخرجات البشرية تلميحات تنظيف وتحذّر بأن بوابة واحدة لكل جهاز لا تزال هي التوصية المعتادة.
يشغّل status --deep أيضًا التحقق من صحة التكوين في وضع واعٍ بـ Plugin ويعرض تحذيرات بيان Plugin المكوّنة (مثل بيانات تعريف تكوين القناة المفقودة) حتى تلتقطها فحوصات التثبيت والتحديث السريعة. يحافظ status الافتراضي على المسار السريع للقراءة فقط الذي يتخطى التحقق من Plugin.
في تثبيتات Linux systemd، تتضمن فحوصات انحراف الرمز المميز في status مصادر الوحدة Environment= وEnvironmentFile= كليهما.
تحلّ فحوصات الانحراف مراجع أسرار gateway.auth.token باستخدام بيئة التشغيل المدمجة (بيئة أمر الخدمة أولًا، ثم بيئة العملية كخيار احتياطي).
إذا لم تكن مصادقة الرمز المميز نشطة فعليًا (قيمة gateway.auth.mode صريحة هي password/none/trusted-proxy، أو كان الوضع غير مضبوط بحيث يمكن أن تنتصر كلمة المرور ولا يمكن لأي مرشح رمز مميز أن ينتصر)، تتخطى فحوصات انحراف الرمز المميز حل رمز التكوين.
عندما تتطلب مصادقة الرمز المميز رمزًا ويكون gateway.auth.token مُدارًا بمرجع سر، يتحقق install من أن مرجع السر قابل للحل لكنه لا يحفظ الرمز المحلول في بيانات تعريف بيئة الخدمة.
إذا تطلبت مصادقة الرمز المميز رمزًا وكان مرجع سر الرمز المكوّن غير محلول، يفشل التثبيت بطريقة مغلقة.
إذا كان كل من gateway.auth.token وgateway.auth.password مكوّنين وكان gateway.auth.mode غير مضبوط، يُحظر التثبيت إلى أن يُضبط الوضع صراحةً.
على macOS، يحافظ install على ملفات plist الخاصة بـ LaunchAgent مقصورة على المالك فقط، ويحمّل قيم بيئة الخدمة المُدارة عبر ملف وغلاف مقصورين على المالك بدلًا من تسلسل مفاتيح API أو مراجع بيئة ملفات تعريف المصادقة داخل EnvironmentVariables.
إذا كنت تشغّل عمدًا بوابات متعددة على مضيف واحد، فاعزل المنافذ والتكوين/الحالة ومساحات العمل؛ راجع /gateway#multiple-gateways-same-host.
يطلب restart --safe من Gateway الجاري تشغيله إجراء فحص تمهيدي للعمل النشط وجدولة إعادة تشغيل واحدة مدمجة بعد انتهاء العمل النشط. يحافظ restart العادي على سلوك مدير الخدمة الحالي؛ ويبقى --force مسار التجاوز الفوري.
يشغّل restart --safe --skip-deferral إعادة التشغيل الآمنة الواعية بـ OmeniaClaw لكنه يتجاوز بوابة تأجيل العمل النشط بحيث يصدر Gateway إعادة التشغيل فورًا حتى عند الإبلاغ عن عوائق. هذا منفذ خروج للمشغّل عندما يثبت تشغيل مهمة عالق إعادة التشغيل الآمنة؛ ويتطلب --safe.

المفضّل

استخدم OmeniaClaw gateway للاطلاع على الوثائق والأمثلة الحالية.

ذو صلة

Was this useful?