🔐 تثبيت step-ca — خادم إصدار وتجديد شهادات SSL الداخلية وأتمتة ACME على Docker

نشر خادم step-ca على Ubuntu باستخدام Docker — المرجع المصدق (CA) والبنية التحتية للمفاتيح العامة (PKI) مفتوحة المصدر لإصدار شهادات SSL/TLS المشفرة وشهادات SSH للشبكات الداخلية عبر بروتوكول ACME على المنفذ 9015.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت مؤتمت — أمر واحد ينشر step-ca على المنفذ 9015 مع توليد المفاتيح الجذرية وبروتوكول ACME وتخزين البيانات جاهزاً.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/step-ca/step-ca-ubuntu.sh
chmod +x step-ca-ubuntu.sh
sudo bash step-ca-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/step-ca/step-ca-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x step-ca-ubuntu.sh

3 تشغيل المثبت

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للمفاتيح (`./step`) وتوليد الشهادة الجذرية والوسيطة وتفعيل بروتوكول ACME وتشغيل حاوية step-ca على المنفذ 9015 (المحول من 9000 الداخلي).

sudo bash step-ca-ubuntu.sh

4 تثبيت الشهادة الجذرية وإصدار أول شهادة

قم بتنزيل الشهادة الجذرية (`./step/certs/root_ca.crt`) وتثبيتها بالأجهزة الموثوقة، وأصدر شهادات HTTPS مشفرة لخدماتك الداخلية عبر Certbot أو Caddy برابط ACME الداخلي (`https://ip-سيرفرك:9015/acme/acme/directory`).

docker exec step-ca step certificate fingerprint certs/root_ca.crt

المنافذ المستخدمة

المنفذالغرض
9015CA + ACME API over HTTPS (host → container 9000) — no web UI
./stepRoot and intermediate private keys — your entire PKI
DNS namesInitialised for localhost and your server IP only

نظرة عامة

تعد step-ca منصة مرجع مصدق (Certificate Authority) وبنية تحتية للمفاتيح العامة (PKI) متطورة ومفتوحة المصدر طورتها شركة Smallstep بلغة Go. تهدف المنصة إلى جلب قوة وأتمتة Let's Encrypt إلى الشبكات الداخلية المغلقة. تعمل المنصة عبر المنفذ 9015 (المحول من 9000 الداخلي)، وتوفر نقطة نهاية لبروتوكول ACME لإصدار وتجديد شهادات X.509 TLS/SSL وشهادات SSH للنطاقات الداخلية (`.local` و`.internal` و`.lan`) وعناوين IP الخاصة بدون الحاجة لنشر الخدمات على الإنترنت العام.

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

تشترط خدمات الشهادات العامة مثل Let's Encrypt وجود نطاق عام وسجلات DNS معلنة ولا يمكنها إصدار شهادات SSL لعناوين IP المحلية (مثل 192.168.x.x) أو النطاقات المغلقة. كما يسبب إنشاء الشهادات يدوياً ظهور تحذيرات الأمان المزعجة بالمتصفحات ومشاكل انتهاء الصلاحية. تمنحك step-ca مرجعاً مصدقاً خاصاً بك: ثبت الشهادة الجذرية مرة واحدة على أجهزتك، وستقوم خوادم Caddy وNginx بإصدار وتجديد شهادات HTTPS الخضراء الموثوقة لكافة خدماتك الداخلية تلقائياً.

متى تحتاجه

  • تريد شهادات HTTPS مشفرة وموثوقة (القفل الأخضر) للخدمات والأنظمة الداخلية دون كشفها للإنترنت العام
  • تحتاج إلى خادم ACME داخلي لبرامج Caddy وTraefik وNginx Proxy Manager وCertbot بالشبكة المحلية
  • تريد التخلص نهائياً من تحذيرات المتصفح الحمراء المزعجة 'Untrusted Certificate' للأنظمة الداخلية
  • تريد أتمتة إصدار شهادات TLS وSSH قصيرة الأجل (صلاحية 24 ساعة مثلاً) مع التجديد التلقائي لتعزيز الأمان
  • تحتاج إلى بنية PKI مؤسسية تدعم المصادقة المتبادلة (mTLS) والربط مع مزودي الهوية OIDC (مثل Keycloak)

من يحتاجه

  • مهندسو الـ DevOps لتطبيق معايير انعدام الثقة (Zero-Trust) وتشفير الاتصال الداخلي (mTLS) بين الخدمات المصغرة
  • أصحاب السيرفرات المنزلية لتأمين لوحات Proxmox وHome Assistant وVaultwarden بشهادات SSL موثوقة بالهواتف
  • مسؤولو الأمن السيبراني لأتمتة إصدار شهادات الدخول لـ SSH واستبدال مفاتيح `authorized_keys` الثابتة
  • مديرو البنية التحتية لإدارة شهادات المؤسسة الداخلية دون تعقيدات خوادم Active Directory Certificate Services
  • المطورون لاختبار سيناريوهات ACME وتشفير التطبيقات محلياً في بيئات معزولة تماماً

حالات الاستخدام الشائعة

  • إصدار شهادات SSL داخلية مؤتمتة لخوادم Caddy على نطاقات `.home.arpa` و`.local` المغلقة
  • تأمين واجهات Home Assistant وVaultwarden وProxmox بشهادات HTTPS موثوقة بالكامل على الهواتف
  • أتمتة المصادقة المتبادلة بالشهادات (Mutual TLS / mTLS) بين الخدمات المصغرة وواجهات الـ REST API
  • استبدال كلمات المرور والمفاتيح الثابتة في SSH بشهادات SSH قصيرة الأجل تُجدد تلقائياً
  • تشغيل خادم PKI معزول تماماً عن الإنترنت للشبكات الصناعية والطبية الحساسة

الميزات الرئيسية

  • خادم بروتوكول ACME مدمج: توافق كامل مع كافة عملاء ACME (مثل Certbot وCaddy وLego وTraefik)
  • مرجع مصدق لـ X.509 وSSH: إصدار شهادات الويب HTTPS وشهادات تسجيل الدخول بخوادم SSH
  • فلسفة الشهادات قصيرة الأجل: دعم الشهادات ذات الصلاحية المؤقتة (24 ساعة) لأقصى حماية أمنية وتجديد آلي
  • أنواع متعددة لمزودي الهوية: دعم ACME وJWK وOIDC / OAuth وشهادات بيئات السحابة (AWS وGCP)
  • أتمتة شاملة عبر الطرفية: أداة `step` CLI القوية لإصدار وفحص وإدارة الشهادات برمجياً
  • قواعد بيانات مدمجة بـ BadgerDB: قاعدة بيانات محلية سريعة بدون أي متطلبات لقواعد بيانات خارجية
  • دعم وحدات الأمان العتادية (HSM): إمكانية حماية المفاتيح الجذرية بوحدات YubiKey وخزائن السحابة
  • معمارية Docker Compose تجمع step-ca مع ربط مجلد `./step` لحفظ المفاتيح الجذرية والسرية

كيفية الاستخدام بعد التثبيت

  • استخرج الشهادة الجذرية من مسار السيرفر: `./step/certs/root_ca.crt`
  • ثبت الشهادة الجذرية `root_ca.crt` في قائمة المراجع المصدقة الموثوقة بأجهزتك (Windows وmacOS وiOS وأندرويد)
  • افحص مسار دليل الـ ACME عبر المتصفح: `https://ip-سيرفرك:9015/acme/acme/directory`
  • في خادم Caddy أو Nginx Proxy Manager، اضبط رابط خادم الـ ACME إلى `https://ip-سيرفرك:9015/acme/acme/directory`
  • أصدر شهادة تجريبية عبر Certbot بأمر: `certbot certonly --standalone --server https://ip-سيرفرك:9015/acme/acme/directory -d myapp.internal`
  • ضع خادم step-ca على شبكة إدارة داخلية معزولة وأعد سكريبت نسخ احتياطي دوري

أفضل ممارسات الأمان

  • تنبيه أمني حاسم: احمِ مجلد المفاتيح السرية `./step/secrets` والمفتاح الجذري بأعلى صلاحيات حماية صارمة (`chmod 600`)
  • لا تشارك أو تكشف المفتاح الجذري الخاص (`root_ca_key`) نهائياً؛ فمن يمتلك هذا المفتاح يمكنه تزوير شهادات لأي موقع
  • عيّن كلمة مرور معقدة لفك تشفير مفاتيح الـ CA في ملف `password.txt`
  • أبقِ منفذ ACME 9015 مقصوراً على الشبكة المحلية أو شبكة الـ VPN ولا تكشفه للإنترنت العام نهائياً
  • اعتمد دائماً فترات صلاحية قصيرة للشهادات (مثل 24 ساعة إلى 7 أيام) واعتمد على التجديد التلقائي
  • حدّث صورة الحاوية دورياً للحصول على أحدث التحسينات ومكتبات التشفير

المنافذ وإعدادات جدار الحماية

يقدم step-ca واجهة الـ CA وبروتوكول ACME عبر منفذ TCP 9015 (المحول من 9000 الداخلي). يجب قصر السماح بالمنفذ 9015 في جدار الحماية على نطاق الشبكة المحلية أو الـ VPN (`ufw allow from 192.168.1.0/24 to any port 9015 proto tcp`). وأبقِ المنفذ 9015 مغلقاً تماماً في جدار الحماية الخارجي للإنترنت.

النسخ الاحتياطي والصيانة

  • انسخ كامل مجلد `./step` احتياطياً، والذي يحتوي على المفاتيح السرية والشهادات وملف الإعدادات `config/ca.json`
  • احتفظ بنسخة مشفرة ومعزولة (Cold Storage) من المفتاح الجذري `./step/secrets/root_ca_key` في وحدة تخزين خارجية آمنة
  • احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على متغيرات البيئة ومسارات التخزين
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية مشفرة عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية والتأكد من استجابة نقطة نهاية الـ ACME بنجاح

الأخطاء الشائعة

  • فقدان كلمة مرور المفتاح الجذري في ملف `password.txt` مما يعطل إقلاع وتشغيل حاوية step-ca
  • نسيان تثبيت الشهادة الجذرية `root_ca.crt` على الأجهزة مما يبقي تحذيرات الأمان الحمراء بالمتصفح
  • كشف المنفذ 9015 للإنترنت العام بدون حماية مما يتيح للغرباء طلب شهادات من المرجع المصدق
  • عدم ربط مجلد التخزين الدائم `./step`، مما يسبب فقدان المفاتيح الجذرية وانهيار المنظومة عند تحديث الحاوية
  • تحديد فترات صلاحية طويلة جداً للشهادات (مثل 10 سنوات) مما يتعارض مع مبدأ الأمان والأتمتة

استكشاف الأخطاء وإصلاحها

  • عميل ACME يظهر خطأ 'Certificate Signed by Unknown Authority' — تأكد من تثبيت وثقة الجهاز بالشهادة الجذرية `root_ca.crt`
  • فشل إقلاع الحاوية — راجع صلاحيات ملف كلمة المرور: `ls -la ./step/secrets/password.txt`
  • فشل فحص التحدي في Certbot — تأكد من إمكانية وصول خادم step-ca لمنفذ 80 أو 443 بالسيرفر الهدف
  • واجهة الـ API لا تفتح على المنفذ 9015 — افحص سجلات الحاوية بالأمر: `docker logs step-ca -f`
  • تعذر استدعاء مسار الـ ACME — تأكد من كتابة بروتوكول HTTPS في الرابط (`https://ip-سيرفرك:9015/acme/acme/directory`)

البدائل

منظومة HashiCorp Vault للشهادات والـ PKI. أداة Easy-RSA / OpenSSL لإدارة المفاتيح يدوياً. مشروع Boulder الرسمي لـ Let's Encrypt. منصة Lemur من Netflix. خوادم Microsoft AD CS للبيئات المؤسسية.

متى لا تستخدمه

تجنب استخدام step-ca إذا كانت كافة خدماتك ومواقعك تعمل على نطاقات إنترنت عامة تمتلك سجلات DNS معلنة (حيث تعد خدمة Let's Encrypt العامة عبر Certbot أسهل دون الحاجة لتثبيت شهادات جذرية على الأجهزة). وإذا كنت تريد فقط شهادة ذاتية واحدة لاختبار حاوية محلية لمرة واحدة، فإن أمر `openssl req` أسرع.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما الفرق بين step-ca وLet's Encrypt؟

Let's Encrypt هو مرجع مصدق عام يصدر شهادات للنطاقات العامة المعلنة على الإنترنت فقط، بينما step-ca هو مرجع مصدق خاص ومستضاف ذاتياً يصدر شهادات ACME مؤتمتة للنطاقات الداخلية (`.local` و`.internal`) وعناوين IP المحلية.

كيف تثق الأجهزة بالشهادات الصادرة من خادم step-ca؟

تقوم بنسخ الشهادة الجذرية الخاصة بسيرفرك (`./step/certs/root_ca.crt`) وتثبيتها مرة واحدة في قائمة المراجع المصدقة الموثوقة بحواسيبك وهواتفك، لتظهر كافة شهادات خدماتك الداخلية بعد ذلك بالقفل الأخضر الموثوق بدون أي تحذيرات.

هل يمكن استخدام step-ca مع خوادم Caddy أو Traefik؟

نعم! في خادم Caddy، يمكنك ببساطة ضبط `acme_ca https://ip-سيرفرك:9015/acme/acme/directory` في ملف Caddyfile، ليقوم Caddy بطلب وتجديد الشهادات الداخلية تلقائياً من step-ca.

هل يدعم step-ca إصدار شهادات تسجيل الدخول لـ SSH؟

نعم! بالإضافة لشهادات الويب X.509 TLS، يستطيع step-ca إصدار شهادات SSH قصيرة الأجل للمستخدمين والسيرفرات، مما يلغي الحاجة لإدارة وتوزيع مفاتيح `authorized_keys` الثابتة.

كم يستهلك step-ca من الذاكرة العشوائية (RAM)؟

تم تطوير step-ca بلغة Go وهو فائق الخفة، حيث يستهلك عادة ما بين 20 إلى 50 ميجابايت فقط من الذاكرة العشوائية داخل Docker.