الخدمات

لخدمة الوصفة ثلاثة حقول قانونية فقط: name وenabled وكائن config مفتوح. الشكل يتحقق بنيويا، لكن مفتاح إعداد يؤثر فقط عندما ينفّذه عامل البناء المختار أو خطاف الميزة. التحقق ليس إثباتا أن خدمة خلفية ثُبّتت أو ضُبطت.


{
  "services": [
    {
      "name": "ssh",
      "enabled": true,
      "config": {
        "port": 2222,
        "allow_root": false,
        "disable_password_auth": true,
        "authorized_keys": ["ssh-ed25519 AAAA... operator@example"]
      }
    }
  ]
}

إعداد SSH

مسار بناء Linux العام يتعرّف على إعدادات SSH هذه:

مفتاح الوصفة	الأثر
`port` أو `listen_port`	منفذ OpenSSH، 1–65,535
`allow_root`	يقابل `PermitRootLogin`
`disable_password_auth`	يُعكس إلى `PasswordAuthentication`
`password_authentication`	قيمة رمز OpenSSH مباشرة
`pubkey_authentication`	قيمة رمز OpenSSH مباشرة
`client_alive_interval`	`ClientAliveInterval` محدود
`client_alive_attempts`	`ClientAliveCountMax` محدود
`authentication_retries`	`MaxAuthTries` محدود
`timeout`	مهلة سماح تسجيل الدخول المحدودة
`x11_forwarding`، `allow_agent_forwarding`، `allow_tcp_forwarding`	قيم رموز OpenSSH مباشرة
`authorized_keys`	يثبّت المفاتيح العامة الموردة حيث يُدعم

يمكن أن تدعم المسارات الخاصة بالعامل مجموعة أصغر. على وجه الخصوص، لبنّائي العتاد وProxmox وRaspberry Pi محولات خاصة. افحص الوصفة المطبّعة وتحذيرات البناء للهدف المختار.

إذا عُطّلت مصادقة كلمة المرور، أدرج واختبر على نحو مستقل مفتاحا عاما صالحا واحدا على الأقل قبل النشر على العتاد. لا تضع مفاتيح خاصة أو كلمات مرور في إعداد خدمة الوصفة.

خدمات أخرى

أسماء مثل nginx وwireguard وDNS وDHCP أو مكونات جدار الحماية ليست واجهة إعداد عامة. حزمها وإعدادها تأتي من الميزة أو الخطاف أو قائمة الحزم أو سكربت بدء التشغيل المقابل للأساس المختار. كائن اعتباطي مثل config.sites قد يقبله المخطط ويُتجاهل مع ذلك.

استخدم هذا التسلسل:

اختر صورة أساس وفعّل الميزة أو الحزم الملموسة.
أضف فقط مفاتيح الإعداد المنفَّذة لتلك القدرة.
افحص الوصفة المطبّعة والتحذيرات المولَّدة.
أضف تحققات لوجود الحزمة، وتفعيل الخدمة، ومنافذ الاستماع، وملفات الإعداد، واستجابة على مستوى التطبيق.
أقلع المخرج واختبره قبل الترقية إلى العتاد أو الإنتاج.

انظر الميزات، وسكربتات بدء التشغيل، وأنواع التحقق.