---
title: شغّل Human Plugin في بنيتك التحتية
description: ما الذي يتضمنه تشغيل Human Plugin، أي حاوية واحدة وقاعدة بيانات PostgreSQL خاصة بك، وترتيب خطوات النشر.
canonical: https://developer.unico.io/ar/human-plugin/self-hosting/overview
locale: ar
generated_by: markdown-export
---

# شغّل Human Plugin في بنيتك التحتية

حاوية واحدة وقاعدة بيانات PostgreSQL واحدة في شبكتك، وتصبح متصلًا بـ Unico.

```mermaid
flowchart LR
  A[Your back-end] --> B[Human Plugin container]
  B --> C[(Your PostgreSQL, dedicated)]
```

## المتطلبات

| المتطلب | التفاصيل |
| --- | --- |
| بيئة تشغيل الحاويات | Docker أو Docker Compose أو Kubernetes. الصورة مبنية لـ `linux/amd64` و`linux/arm64` وتعمل بمستخدم غير جذر (non-root) |
| PostgreSQL | الإصدار 16 أو أحدث. قاعدة بيانات يستخدمها Human Plugin فقط، ويمكن الوصول إليها باسم مستخدم وكلمة مرور. SSL مطلوب افتراضيًا |
| HTTPS الصادر | إلى Unico. راجع [الشبكة والأمان](/ar/human-plugin/self-hosting/networking-and-security) |
| الوارد | المنفذ `8080`، HTTP عادي، من خادمك الخلفي فقط |
| الأسرار | مفتاح الوصول الخاص بك وكلمة مرور قاعدة البيانات |

<a id="hardware-requirements"></a>

## متطلبات العتاد

الحد الأدنى لتشغيل Human Plugin بما يصل إلى **1,500 معاملة في الدقيقة**، مع صور سيلفي بحجم يصل إلى 800 KB.

### Human Plugin

| المورد | الحد الأدنى |
| --- | --- |
| وحدة المعالجة المركزية | 1 vCPU لكل نسخة (replica) |
| الذاكرة | 1 GB لكل نسخة (replica) |

لحجم أكبر، أضف نسخة واحدة لكل 1,500 معاملة في الدقيقة. ونقترح أيضًا تشغيل أكثر من نسخة، حتى يظل Human Plugin متاحًا أثناء إعادة تشغيل إحداها.

### PostgreSQL

| المورد | الحد الأدنى |
| --- | --- |
| الإصدار | 16 |
| وحدة المعالجة المركزية | 2 vCPU |
| الذاكرة | 4 GB |
| القرص | SSD |

لتقدير مساحة القرص، احسب نحو 1.7 KB لكل عملية (process) × عدد العمليات في اليوم × عدد الأيام التي تحتفظ بها، ثم أضف 30%.

### الشبكة

HTTPS صادر (المنفذ 443) إلى Unico. راجع [الشبكة والأمان](/ar/human-plugin/self-hosting/networking-and-security).

## الصورة

يُنشر Human Plugin باسم `pkg.unico.run/human-plugin-api:latest`. شغّل دائمًا الوسم `latest`، وهو الإصدار الحالي. اسحبه ببيانات اعتماد السجل (اسم المستخدم والرمز) التي تعطيك إياها Unico. راجع [المتطلبات المسبقة والوصول](/ar/human-plugin/get-started/prerequisites).

## ترتيب النشر

1. أنشئ قاعدة البيانات المخصصة ودورًا (role) لـ Human Plugin.
2. اضبط [التهيئة](/ar/human-plugin/self-hosting/configuration)، مع الأسرار من مخزن الأسرار لديك.
3. شغّل الحاوية باستخدام [Docker Compose](/ar/human-plugin/self-hosting/docker-compose) أو [Kubernetes](/ar/human-plugin/self-hosting/kubernetes)، مع مهلة إيقاف لا تقل عن 60 ثانية.
4. انتظر حتى يردّ `GET /health/ready` بـ `200` قبل توجيه الحركة. راجع [الصحة والمراقبة](/ar/human-plugin/self-hosting/health-and-monitoring).
5. قيّد الوصول إلى خادمك الخلفي فقط. راجع [الشبكة والأمان](/ar/human-plugin/self-hosting/networking-and-security).
6. نفّذ عليه طلب الإنشاء من [البدء السريع](/ar/human-plugin/get-started/quickstart#3-create-a-process).

## ما يحدث عند البدء

ينزّل Human Plugin [كتالوج السمات](/ar/human-plugin/additional-resources/attribute-catalog)، ويتصل بـ PostgreSQL ويجهّز جداوله، ثم يفتح المنفذ. ويتوقف مع خطأ، قبل أن يبدأ الاستماع، عندما:

- يكون إعداد مطلوب مفقودًا أو غير صالح؛
- يتعذر تنزيل كتالوج السمات؛
- يتعذر الوصول إلى PostgreSQL، أو لا يستطيع الدور (role) إنشاء الجداول.

يذكر السجل السبب. راجع [استكشاف الأخطاء وإصلاحها](/ar/human-plugin/additional-resources/troubleshooting).

## عدة نسخ

لا يحتفظ Human Plugin بأي حالة للطلبات في الذاكرة، لذلك يمكن لعدة حاويات مشاركة قاعدة بيانات واحدة. الحاويات التي تبدأ في الوقت نفسه تتنسق عبر قاعدة البيانات، لذا يمكنك نشر النسخ معًا.

## الانتقال إلى الإنتاج

- أبقِ مهلة الإيقاف عند 60 ثانية أو أكثر.
- وجّه الحركة إلى الحاوية فقط بعد أن يردّ `/health/ready` بـ `200`.
- لا تعرّض Human Plugin أبدًا خارج شبكتك الخاصة.
- انسخ قاعدة البيانات احتياطيًا: فهي تحتفظ بالـ intelligence الخاصة بك. راجع [العمليات](/ar/human-plugin/self-hosting/operations).