Portainer: الحاويات عبر المتصفح

Portainer هي واجهة ويب لـ Docker: قائمة بالحاويات، والسجلات، وطرفية داخل الحاوية، والأحجام، والشبكات، وحزم Compose. إنها مفيدة عندما لا ترغب في الاتصال عبر SSH في كل مرة فقط لـ «رؤية ما الذي تعطّل».

التثبيت

docker volume create portainer_data
docker run -d \
  --name portainer \
  --restart unless-stopped \
  -p 127.0.0.1:9443:9443 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:2.21.4

المنفذ مرتبط بالواجهة المحلية. يمكنك فتح اللوحة عبر نفق SSH:

ssh -L 9443:127.0.0.1:9443 root@<machine-address>

ثم افتح https://localhost:9443 في متصفحك. الشهادة موقّعة ذاتيًا، لذا سينبّهك المتصفح — وهذا طبيعي عند الوصول إليها عبر نفق.

أول مسؤول يُنشئه من يفتح اللوحة أولًا. إذا كنت قد كشفت المنفذ للإنترنت وذهبت لتشرب الشاي، فلن يكون المسؤول أنت. يغلق Portainer التسجيل بعد بضع دقائق من بدء التشغيل، لكن لا ينبغي الاعتماد على ذلك — أنشئ الحساب فورًا.

لماذا يُعدّ هذا خطيرًا وما الذي يجب فعله

تُركّب اللوحة /var/run/docker.sock. الوصول إلى هذا المقبس يعادل صلاحيات root على الجهاز: من خلاله يمكنك تشغيل حاوية مع تركيب root الخاص بالمضيف. ومن هنا القواعد:

• لا تكشف المنفذ للإنترنت. استخدم نفق SSH أو خادم ويب مع شهادة ومصادقة ثنائية العوامل.
• اجعل كلمة مرور المسؤول طويلة وفريدة، وليست نفس كلمة مرور root الخاصة بالجهاز.
• امنح كل شخص حسابًا منفصلًا بصلاحيات محدودة، لا تسجيل دخول مشتركًا.
• إذا كنت نادرًا ما تحتاج اللوحة، فأبقِ الحاوية متوقفة وشغّلها عند الحاجة: docker start portainer.

ما الذي يجعلها مريحة

• السجلات مع البحث والتمييز — أسرع من docker logs في طرفية نصية بحجم 80×24.
• طرفية داخل الحاوية مباشرة في المتصفح.
• الحزم — الصق محتوى compose.yaml، وانقر على النشر. جيدة للخدمات المؤقتة، لكن بالنسبة للدائمة يُفضّل الاحتفاظ بالملف على القرص تحت نظام إدارة الإصدارات: الحزمة المُنشأة في اللوحة يسهل فقدانها عند إعادة التثبيت.
• الأحجام والصور — يمكنك رؤية ما الذي يستهلك كم من المساحة؛ وهذا يساعد عند استكشاف مشكلة نفاد المساحة.

ما الذي لا ينبغي فعله فيها

• الاحتفاظ بالنسخة الوحيدة من تعريفات خدماتك فيها. ملفات compose.yaml في مجلد على القرص ستعيش أطول من اللوحة.
• تحديث الحاويات بزر «إعادة الإنشاء» دون فهم ما سيحدث للأحجام. راجع تحديث الحاويات.
• التعامل معها كبديل عن المراقبة. يعرض Portainer الحالة الحالية، لا السجل، ولا يرسل تنبيهات — لذلك تحتاج إلى Uptime Kuma.

الموارد

تستهلك الحاوية نحو 100 ميغابايت من الذاكرة وتعمل على أي مستوى. تُخزَّن البيانات في حجم portainer_data: الحسابات، والإعدادات، والحزم. أدرجه في النسخ الاحتياطي أو كن مستعدًا لإعداد اللوحة من جديد.

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

• نسيان أن اللوحة تدير هذا الجهاز فقط. يمكنها إدارة جهاز ثانٍ أيضًا، لكن ذلك يتطلب وكيلًا عليه ومنفذًا مفتوحًا بينهما.
• استخدام وسم latest للوحة نفسها. التحديث الرئيسي يغيّر صيغة البيانات. ثبّت الإصدار.
• حذف حجم «غير مستخدم» عبر التنظيف. يحذّرك Portainer بالفعل، لكن الناس ينقرون الزر دون قراءة. تبدو الأحجام التي تحتوي على قواعد بيانات غير مستخدمة بينما الحاوية متوقفة — راجع الأحجام.