Link to this sectionعلى الجهاز (On Premise)#

يعمل On Premise على ربط وحدات معالجة المركز (CPU) ووحدات معالجة الرسومات (GPU) الاختيارية من NVIDIA على مضيفك الذي يعمل بنظام Linux أو Apple Silicon macOS أو Windows بمنصة Ultralytics. تظل المنصة هي مستوى التحكم المستضاف لواجهة المستخدم والمصادقة والبيانات الوصفية والتعليقات التوضيحية وتنسيق المهام، بينما تبقى كل بكسل ونواتج النماذج المدربة في موقعك.

يحتاج مضيفك إلى Docker ووصول HTTPS خارجي إلى المنصة. يقوم المثبت بإضافة Docker تلقائيًا في حال عدم وجوده، لذا فإن الإعداد العادي يتم بأمر واحد.

Link to this sectionمتطلبات النظام#

تعمل عمليات استيعاب وتدريب CPU على أنظمة التشغيل الثلاثة جميعها. يختار المثبت صورة arm64 الأصلية الرسمية على Apple Silicon وARM Linux، بحيث تعمل المهام الصغيرة مثل YOLO26n على COCO8 دون الحاجة لمحاكاة x86. تسريع NVIDIA اختياري؛ وعند عدم توفره، يتم التدريب على CPU.

Link to this sectionحدود البيانات#

يتم تثبيت مجلدات مجموعة البيانات للقراءة فقط. لا تستقبل المنصة والعاملون المستضافون لديها مطلقًا وحدات البكسل المصدرية أو المشتقة، ولا تعتمد مهام On Premise أبدًا على وحدات الحوسبة الخاصة بـ Ultralytics أو RunPod.

Link to this sectionربط مضيف#

1. افتح Ultralytics Platform على مضيف Linux أو Apple Silicon macOS أو Windows الذي يمكنه الوصول إلى مجموعات البيانات الخاصة بك.
2. انتقل إلى Settings > Integrations وحدد Connect على بطاقة On Premise.
3. تختار المنصة الأمر المكتشف لنظام Linux أو macOS أو Windows. يلزم استخدام Apple Silicon على نظام macOS. احتفظ بالقيم المعينة مسبقًا أو قم بتغييرها:
   • اسم الجهاز: On Premise host
   • مجلد مجموعة البيانات: /datasets على Linux أو ~/Ultralytics/datasets على macOS وWindows
   • مجلد النماذج: /models على Linux أو ~/Ultralytics/models على macOS وWindows
4. حدد Create install command. يخبرك مربع الحوار بالطرفية (terminal) التي يجب فتحها لنظام التشغيل المحدد.
5. انسخ الأمر الكامل، وألصقه في تلك الطرفية، وقم بتشغيله. يتضمن الأمر رمز التسجيل لمرة واحدة، ويقوم بتثبيت وبدء تشغيل Docker عند الحاجة، وينشئ المجلدات المحددة.
6. اترك مربع الحوار مفتوحًا. تتحقق المنصة كل 500 مللي ثانية وتُظهر المضيف كمتصل بمجرد بدء عامل CPU. يبدأ عامل GPU تلقائيًا عندما يكشف Docker عن بيئة تشغيل NVIDIA مدعومة.

تنتهي صلاحية رمز التسجيل بعد 10 دقائق ولا يمكن استخدامه إلا مرة واحدة. يخزن العامل المثبت مفتاح العامل القابل للإبطال الناتج في ملف بيئة بوضع 0600. لا يستقبل العامل أبدًا بيانات اعتماد MongoDB الخاصة بالمنصة أو التخزين السحابي. تعيد Compose تشغيل العاملين تلقائيًا، ويقوم الإعداد بضبط Docker ليبدأ عند التشغيل على Linux أو عند تسجيل الدخول على macOS وWindows.

Link to this sectionإنشاء مجموعة بيانات On Premise#

1. ضع مجموعة البيانات أسفل مجلد مجموعة البيانات المتصل. على سبيل المثال، /datasets/warehouse هي warehouse داخل الجذر الافتراضي.
2. في المنصة، حدد New Dataset > On Premise.
3. تصفح المضيف المتصل باستخدام نفس مستعرض المجلدات المستخدم لـ Google Cloud Storage وAmazon S3 وAzure Blob Storage، وحدد مجلدًا، واختر المهمة، وأنشئ مجموعة البيانات الخاصة.
4. يقوم المضيف بفهرسة مجموعة البيانات والإبلاغ عن البيانات الوصفية. لا تقوم المنصة أبدًا بتحميل الصور.

يستخدم On Premise نفس كود استيعاب CPU المستخدم في التحميلات المستضافة. وهو يدعم:

• الصور ومقاطع الفيديو المنفردة؛
• أرشيفات ZIP وTAR وTAR.GZ وTGZ؛
• صيغ Ultralytics NDJSON وCOCO JSON؛
• مجموعات بيانات YOLO وتخطيطات مجلدات التصنيف؛ و
• مهام الكشف (detect)، والتجزئة (segment)، وتحديد الوضع (pose)، وOBB، والتصنيف (classify)، بما في ذلك نفس تعيين الفئات، واستنتاج المهام، والتحقق من الصحة، ومعالجة التقسيم.

مخرج التخزين هو الفرق الوحيد. قد تقوم الاستضافة المستضافة بتغيير حجم الصور أو تطبيعها وإنشاء صور مصغرة في تخزين المنصة. لا يقوم On Premise أبدًا بتغيير حجم أو إعادة ترميز أو تحرير أو حذف الملفات الأصلية المثبتة. يتم كتابة محتويات الأرشيف وأصول NDJSON البعيدة وإطارات الفيديو المأخوذة بعينات بمعدل 1 إطار في الثانية حتى 100 إطار، ثم بشكل متساوٍ عبر مقاطع الفيديو الأطول، فقط في وحدة تخزين Docker على المضيف.

Link to this sectionالمعاينة والتعليق التوضيحي#

تصرح المنصة لكل معاينة، ثم يقوم متصفحك بتحميل الملف المرتبط بالمراجعة مباشرة من http://localhost:8765 على نفس الجهاز. لا يلزم وجود اسم مضيف أو شهادة أو VPN أو وكيل أو إعداد معاينة.

يتم تخزين التعليقات التوضيحية كبيانات وصفية للمنصة. يؤدي تحرير أو حذف صورة في المنصة إلى تغيير مرجع المنصة والتعليقات التوضيحية فقط؛ ولا يغير أبدًا ملف المصدر أو ملف التسميات المصاحب.

Link to this sectionالتدريب محليًا#

ابدأ التدريب من مربع حوار تدريب المشروع العادي. لا يمكن المطالبة بمجموعة بيانات مرتبطة بمضيف On Premise إلا بواسطة ذلك المضيف. تستخدم المنصة عامل GPU الخاص بها عند توفره، وبخلاف ذلك تقوم بتشغيل نفس كود التدريب على عامل CPU الخاص بها. يقرأ التدريب الملفات المثبتة، ويكتب نقاط التحقق والأوزان أسفل مجلد النماذج المكون، ويعيد حالة المهمة والمقاييس العددية ومرجع نقطة التحقق غير القابل للتغيير إلى المنصة. تستخدم تنزيلات النماذج نفس اتصال localhost الموقع كما في المعاينات، لذا تنتقل الأوزان مباشرة من مضيفك إلى متصفحك.

لا يستهلك تدريب On Premise أرصدة حوسبة المنصة. لا يمكن للعاملين المستضافين من Ultralytics أو RunPod المطالبة بالمهمة أو قراءة البكسلات أو النواتج الخاصة بها.

Link to this sectionإدارة العامل (Worker)#

استخدم بطاقة On Premise في Settings > Integrations لعرض توافر CPU/GPU، أو إعادة توصيل مضيف، أو فصله. تؤدي إعادة التوصيل إلى تدوير مفتاح العامل السري دون تغيير هوية مجموعة البيانات الموجودة. يؤدي الفصل إلى إبطال المطالبات المستقبلية ووصول المعاينة؛ ولا يؤدي إلى حذف مجموعات البيانات أو ملفات المصدر أو البكسلات المخزنة مؤقتًا أو نواتج النماذج من المضيف.

لفحص أو إيقاف التثبيت على نظام Linux:

cd /opt/ultralytics-worker
docker compose logs -f
docker compose down

على نظامي macOS وWindows، يطبع المثبت الأمر المكافئ باستخدام ~/.ultralytics/worker.

راجع أيضًا مجموعات البيانات، والتعليقات التوضيحية، والتدريب السحابي.