🔐 تثبيت OpenBao — خزنة إدارة الأسرار والتشفير مفتوحة المصدر على Docker

نشر منصة OpenBao على Ubuntu باستخدام Docker — الخزنة المركزية مفتوحة المصدر لإدارة الأسرار، وتشفير البيانات، وتوليد الشهادات الرقمية، والبديل المعتمد من مؤسسة لينكس لـ HashiCorp Vault.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر OpenBao على المنفذ 8245 مع حماية قفل الذاكرة (IPC_LOCK) والتخزين الدائم المشفر.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/openbao/openbao-ubuntu.sh
chmod +x openbao-ubuntu.sh
./openbao-ubuntu.sh

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

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

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

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

chmod +x openbao-ubuntu.sh

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

./openbao-ubuntu.sh

4 تهيئة وفتح قفل الخزنة

http://your-server-ip:8245

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

المنفذالغرض
8245OpenBao API and web UI (mapped from container port 8200)

نظرة عامة

تعد OpenBao منصة مفتوحة المصدر ومستقلة لإدارة الأسرار والتشفير كخدمة (Secrets Management & Encryption Engine)، تم إطلاقها تحت مظلة مؤسسة لينكس (Linux Foundation) كبديل مفتوح بالكامل لمنصة HashiCorp Vault بعد تغيير ترخيصها. تعمل المنصة على المنفذ 8245 (المحول من 8200 الداخلي) مع ميزة حظر قراءة الذاكرة (`IPC_LOCK`)، وتوفر نظاماً مركزياً لحفظ مفاتيح APIs، وكلمات مرور قواعد البيانات، وتوليد بيانات اعتماد ديناميكية مؤقتة تنتهي صلاحيتها آلياً، وإدارة البنية التحتية للمفاتيح العامة (PKI) لإصدار شهادات TLS، وتشفير بيانات التطبيقات الحساسة برمجياً.

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

كتابة كلمات مرور قواعد البيانات ومفاتيح API السرية داخل ملفات الكود أو مستودعات Git أو متغيرات البيئة النصية يمثل خطراً أمنياً فادحاً يهدد باختراق المنظومة بأكملها. تحل OpenBao هذه المشكلة بتوفير خزنة تشفير مركزية وآمنة وخاضعة لسجلات تدقيق صارمة؛ حيث تطلب التطبيقات الأسرار اللحظية برموز مؤقتة بصلاحيات محددة، ويتم تدوير كلمات المرور وإلغاؤها آلياً دون الحاجة لتعديل الكود المصدري.

متى تحتاجه

  • تحتاج إلى خزنة مركزية آمنة ومشفرة لتخزين وتدوير مفاتيح API وكلمات مرور قواعد البيانات ومفاتيح SSH
  • تبحث عن بديل مجاني ومفتوح المصدر بالكامل لمنصة HashiCorp Vault تديره مؤسسة لينكس
  • تحتاج تطبيقاتك إلى بيانات اعتماد ديناميكية مؤقتة لقواعد البيانات (Dynamic Credentials) تُنشأ وتُحذف آلياً
  • تريد إنشاء هيئة شهادات رقمية داخلية (Internal PKI / CA) لإصدار وتجديد شهادات TLS/SSL للخوادم تلقائياً
  • تحتاج إلى محرك تشفير كخدمة (Transit Engine) لتشفير بيانات العملاء الحساسة قبل تخزينها في قواعد البيانات

من يحتاجه

  • مهندسو DevSecOps ومسؤولو الأمان السيبراني لتوحيد سياسات الهوية وإدارة الأسرار والتشفير
  • مطور الواجهات الخلفية للتخلص من كتابة الأسرار النصية في الأكواد وملفات الإعداد
  • مديرو الأنظمة لأتمتة إصدار وتجديد شهادات الأمان وإدارة مفاتيح الدخول لخوادم SSH
  • الشركات والمؤسسات الملتزمة بمعايير الأمان الدولية (مثل PCI-DSS وSOC 2 وISO 27001)
  • أصحاب السيرفرات المنزلية لتأمين سيناريوهات النشر التلقائي عبر Ansible وDocker

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

  • تخزين الأسرار والمفاتيح في محرك Key-Value (KV v2) مع ميزات الإصدارات والرجوع للإصدارات السابقة
  • توليد مستخدمين وكلمات مرور مؤقتة لقواعد بيانات PostgreSQL وMySQL تنتهي صلاحيتها بعد دقائق
  • تشغيل هيئة إصدار شهادات داخلية (PKI) لتوقيع وتجديد شهادات HTTPS للخدمات الداخلية
  • تشفير أرقام بطاقات الائتمان والبيانات الحساسة عبر محرك Transit قبل حفظها في قواعد بيانات التطبيق
  • حقن الأسرار المشفرة بأمان داخل خطوط البناء والتشغيل CI/CD (مثل GitHub Actions وOneDev)

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

  • محرك أسرار Key-Value متقدم (KV v2) يدعم حفظ الإصدارات، الحذف الآمن، واستعادة النسخ السابقة
  • توليد آلي للأسرار الديناميكية مع تجديد الإيجارات وإلغاء الصلاحيات الفوري لقواعد البيانات والسحابة
  • محرك شهادات PKI مدمج لإصدار شهادات X.509 TLS/SSL وتجديدها تلقائياً للخدمات الداخلية
  • محرك تشفير متقدم (Transit Engine) ينفذ تشفير وفك تشفير البيانات عبر AES-GCM دون كشف المفاتيح للتطبيق
  • واجهة تحكم ويب متجاوبة على المنفذ 8245 وواجهة REST API متوافقة بنسبة 100% مع بيئة أدوات Vault
  • طرق مصادقة متعددة: AppRole للتطبيقات، Tokens، Userpass، LDAP، OIDC/OAuth2، ومصادقة Kubernetes
  • اعتماد خوارزمية Shamir's Secret Sharing لتقسيم مفاتيح فتح الخزنة وتوزيعها على المسؤولين
  • نشر منظم عبر Docker مع تفعيل ميزة IPC_LOCK لمنع تسريب المفاتيح إلى ذاكرة التبادل (Swap)

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8245 للوصول لشاشة التهيئة الأولية لـ OpenBao
  • قم بتهيئة الخزنة: حدد عدد مفاتيح الفتح (Key Shares مثل 5) والحد الأدنى للفتح (Key Threshold مثل 3) واضغط Initialize
  • تنبيه بالغ الأهمية: احفظ مفاتيح فك القفل (Unseal Keys) ورمز المشرف الأساسي (Initial Root Token) فوراً في مدير كلمات مرور آمن
  • افتح قفل الخزنة (Unseal) بإدخال الحد الأدنى المطلوب من المفاتيح (مثل إدخال 3 مفاتيح من أصل 5)
  • سجل الدخول باستخدام رمز Root Token للوصول للوحة التحكم الإدارية
  • فعل محرك الأسرار من Secrets ← Enable New Engine ← KV (v2) للبدء في حفظ وتخزين الأسرار المشفرة
  • ضع OpenBao خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx أو Caddy) مع شهادة SSL لحماية الاتصال في الإنتاج

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

  • تحذير شديد الأهمية: لا تفقد مفاتيح فك القفل (Unseal Keys) أو رمز Root Token أبداً — فقدانها يعني ضياع البيانات المشفرة نهائياً دون إمكانية للاسترجاع
  • قم بإلغاء وحذف رمز Root Token بعد إنشاء حسابات المشرفين وتعيين أدوار AppRole بسياسات الصلاحيات الدنيا
  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي — حيث يُحظر تماماً نقل رموز وأسرار المصادقة عبر HTTP غير المشفر
  • تأكد من بقاء ميزة IPC_LOCK مفعلة للحاوية لمنع كتابة مفاتيح التشفير في ملف التبادل (Swap) على القرص
  • لا تحفظ مفاتيح فك القفل على نفس السيرفر، بل وزعها على مسؤولي الأمان في شركتك
  • حدّث حاوية openbao/openbao دورياً للحصول على التحديثات الأمنية من مؤسسة لينكس

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

يستمع OpenBao لواجهة الويب والواجهات البرمجية REST API على منفذ TCP 8245 (المحول من 8200 الداخلي). في الإنتاج، يجب تهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 وربطه بـ 8245، مع قصر الوصول على خوادم التطبيقات وشبكة الإدارة فقط عبر جدار الحماية UFW.

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

  • انسخ مجلد ./data (/openbao/file) احتياطياً، والذي يحتوي على ملفات الخزنة المشفرة بالكامل
  • تأكد من حفظ مفاتيح فك القفل (Unseal Keys) ورموز الاستعادة في مكان آمن ومشفر خارج السيرفر
  • أتمت النسخ الاحتياطي اليومي لمجلد البيانات وارفعه إلى مساحة تخزين سحابية آمنة عبر restic أو rsync
  • ملاحظة: نظراً لتشفير كافة البيانات المخزنة على القرص بمفتاح التشفير الرئيسي، فإن النسخ الاحتياطي للمجلد آمن تماماً
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية وفك قفلها بالمفاتيح للتأكد من استرجاع الأسرار بنجاح

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

  • فقدان مفاتيح فك القفل (Unseal Keys) أو رمز المشرف الأولي، مما يترك الخزنة مقفلة للأبد دون حل
  • حفظ مفاتيح فك القفل في ملفات نصية مكشوفة على السيرفر أو في مستودعات Git
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر، مما يعرض رموز التوثيق للاعتراض والتنصت
  • عدم ربط مجلد التخزين الدائم ./data، مما يسبب مسح كافة الأسرار والشهادات عند تحديث الحاوية
  • استخدام رمز Root Token لربط التطبيقات الروتينية بدلاً من إنشاء أدوار AppRole مخصصة ومحدودة الصلاحية

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

  • الخزنة في حالة مقفلة (Sealed) بعد إعادة تشغيل السيرفر — تبدأ الخزنة مقفلة تلقائياً لحماية المفاتيح؛ أدخل مفاتيح Unseal في الواجهة لفتحها
  • رفض طلبات API بخطأ 403 Forbidden — تأكد من تمرير ترويسة X-Vault-Token صحيحة وامتلاكها للصلاحيات المناسبة
  • واجهة الويب لا تفتح — افحص سجلات الحاوية بالأمر: docker logs openbao -f للتأكد من أذونات مجلد التخزين
  • تحذير IPC_LOCK عند الإقلاع — تأكد من وجود سطر `cap_add: - IPC_LOCK` في ملف docker-compose لتمكين قفل الذاكرة
  • انتهاء صلاحية الرمز (Token Expired) — تأكد من برمجة التطبيقات لتجديد الرموز دورياً أو استخدم طريقة AppRole

البدائل

منصة HashiCorp Vault هي المنصة الأصلية التجارية المغلقة حالياً بترخيص BSL. منصة Infisical خيار مفتوح المصدر وسهل الاستخدام لإدارة ومزامنة المتغيرات السرية. خدمة Doppler منصة سحابية تجارية للأسرار. خادم Bitwarden Secrets Manager أداة مخصصة للمطورين. خدمات AWS Secrets Manager وAzure Key Vault حلول سحابية مغلقة.

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

تجنب استخدام OpenBao إذا كنت تبحث فقط عن مدير كلمات مرور شخصي للمتصفحات والمواقع العادية (استخدم Vaultwarden بدلاً منه، حيث أن OpenBao مخصص للبنية التحتية والتطبيقات). وإذا كنت تبحث عن أداة سريعة وبسيطة لمزامنة متغيرات البيئة مع أجهزة المطورين الشخصية، فإن Infisical يقدم تجربة أسهل للمبتدئين.

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

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

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

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

ما الفرق بين OpenBao وHashiCorp Vault؟

منصة OpenBao هي تفرع مفتوح المصدر ومستقل من HashiCorp Vault تحت إدارة مؤسسة لينكس (Linux Foundation) بعد تحول Vault للترخيص التجاري، ويتميز بتوافقه البرمجي الكامل 100% مع كافة أدوات ومكتبات Vault القائمة.

ماذا يعني 'فك قفل الخزنة' (Unsealing)؟

عند تشغيل OpenBao، تكون كافة الأسرار مشفرة بمفتاح رئيسي مجزأ عبر خوارزمية Shamir. عملية Unsealing هي إدخال الحد الأدنى المطلوب من المفاتيح الموزعة لإعادة تجميع المفتاح في الذاكرة وفك تشفير الخزنة للعمل.

ما هو محرك التشفير كخدمة (Transit Engine)؟

يتيح محرك Transit للتطبيقات إرسال النصوص لـ OpenBao لتشفيرها وإرجاعها مشفرة لحفظها في قواعد البيانات، دون أن يخرج مفتاح التشفير الحقيقي من الخزنة أبداً، مما يحمي البيانات حتى لو سُرقت قاعدة البيانات.

كيف تتصل التطبيقات والحاويات بـ OpenBao بأمان؟

تتصل التطبيقات عادة عبر طريقة AppRole (باستخدام RoleID وSecretID) أو عبر شهادات TLS أو رموز Kubernetes، لتحصل على رمز مؤقت ومقيد بصلاحيات قراءة الأسرار المخصصة لها فقط.

كم يستهلك OpenBao من الذاكرة العشوائية؟

تمت برمجة OpenBao بلغة Go وهو فائق الخفة والكفاءة؛ حيث يستهلك ما بين 50 إلى 150 ميجابايت فقط من الذاكرة العشوائية أثناء التشغيل العادي.