تثبيت الوكيل على macOS
تجهيز حزمة الوكيل لبنية الجهاز، وتثبيتها بحساب مخصص وخدمة launchd، ومعرفة مسارات الملفات وكيفية إلغاء التثبيت.
تتضمن حزمة الوكيل بيئة التشغيل نفسها المستخدمة على Linux: بيئة Node ومصدر وكيل الخادم. تستخدم الحزمة ملفاً مضغوطاً ونص تثبيت بدلاً من حزمة تثبيت أصلية لنظام macOS. جهّزوا الملف المضغوط لبنية الجهاز المستهدف، ثم استخدموا نص التثبيت المرفق.
تجهيز الحزمة المضغوطة
على جهاز Mac تتوفر فيه بيئة Node بالإصدار 24.15 أو أحدث:
scripts/build-agent-tarball.sh <out-dir> --os macos --arch aarch64
استخدموا --arch x86_64 لأجهزة Mac بمعالج Intel. يرفض النص تضمين ملف Node مخصص لمعالج أو نظام تشغيل مختلف عن الجهاز الذي يعمل عليه، إلا عند تحديد --node صراحةً. لا تعمل الحزمة إذا كان ملف التشغيل داخلها لا يطابق الجهاز المستهدف.
التثبيت
فكّوا ضغط الحزمة، ثم شغّلوا نص التثبيت مع ملف التسجيل الذي نُزّل من لوحة الإدارة:
sudo ./install.sh --enrollment-file enrollment.json
ينشئ المثبّت حساب نظام مخصصاً ومخفياً باسم _dsh-agent لتشغيل الخدمة، ويسجّلها في launchd. لا يُضاف هذا الحساب إلى مجموعة admin حتى لا يكتسب صلاحيات حساب المدير. إذا تعذر إنشاء الحساب، يُكمل المثبّت التشغيل بحساب المستخدم الجذر مع تحذير واضح. راجعوا هذا التحذير؛ فصلاحيات الحساب تحدد نطاق الوصول الفعلي.
سياسة التنفيذ للقراءة فقط هي الافتراضية على كل خادم مسجّل، والسياسة الكاملة خيار صريح لكل خادم.
مسارات الملفات
- مجلد التثبيت:
/opt/dsh-host-agent. - مجلد الحالة:
/var/lib/dsh-host-agent، بصلاحيات 700، ويملكه حساب_dsh-agent. - ملف تعريف الخدمة:
/Library/LaunchDaemons/com.dsh.host-agent.plist.
إلغاء التثبيت
يزيل الأمر التالي خدمة الخلفية، ويُبقي ملفات الحالة المحلية:
dsh-host-agent uninstall