العودة إلى المدونة

تثبيت Docker Engine على خادم Ubuntu VPS بالطريقة الصحيحة (المستودع الرسمي)

فريق تحرير IM Host25 أكتوبر 20267 دقائق قراءة
تثبيت Docker Engine على خادم Ubuntu VPS بالطريقة الصحيحة (المستودع الرسمي)

هناك ثلاث طرق شائعة لتثبيت Docker على Ubuntu: حزمة docker.io من Ubuntu، وحزمة snap، والمستودع الرسمي لـ Docker. يستخدم هذا الدليل المستودع الرسمي، الذي يمنحك أحدث إصدارات Docker Engine وإضافة Compose وBuildx، مع تحديثها عبر apt upgrade المعتاد. التثبيت هو الجزء القصير، أما بقية الدليل فتشرح ثلاثة أمور تسبب حوادث حقيقية على خوادم Docker: مجموعة docker، والمنافذ المنشورة التي تتجاوز الجدار الناري، والسجلات التي تملأ القرص.

أي حزمة، ولماذا

المصدرما تحصل عليهقاعدة تقريبية
مستودع Docker الرسميأحدث Docker Engine وإضافة Compose v2 وBuildxمعظم الخوادم، خاصة إذا كنت تتبع توثيق Docker الحالي
حزمة docker.io من Ubuntuإصدار أقدم تصونه Ubuntuمناسبة إذا كنت تفضل سياسة تحديث Ubuntu ولا تحتاج إلى الميزات الجديدة
Snapحزمة معزولة بمسارات خاصةتجنبها على الخوادم، فمسارات الـ volumes وإعداد الخدمة يتصرفان بشكل مختلف

القاعدة الثابتة الوحيدة: لا تخلط بينها. وجود تثبيتين لـ Docker على خادم واحد يسبب أخطاء مربكة تتعلق بالـ socket وإصدارات containerd والصور المفقودة.

الخطوة 1: إزالة الحزم المتعارضة

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do
  sudo apt-get remove -y $pkg
done

على خادم جديد سيخبرك apt أن أيًا من هذه الحزم غير مثبت، وهذا طبيعي. ولا تحذف هذه الخطوة الصور والـ volumes الموجودة في /var/lib/docker.

الخطوة 2: إضافة مفتاح التوقيع والمستودع

sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

يسمح المفتاح لـ apt بالتحقق من أن الحزم تأتي فعلًا من Docker. يُحفظ في /etc/apt/keyrings ويُربط بهذا المستودع وحده، فلا يمكن استخدامه لتوقيع حزم من مصادر أخرى.

sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt-get update

سطر Suites يقرأ الاسم الرمزي لإصدار Ubuntu من النظام، وهو noble في 24.04. بعد apt-get update يجب أن ترى أسطرًا من download.docker.com دون أخطاء.

الخطوة 3: تثبيت Docker Engine

sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo docker run --rm hello-world
docker --version
docker compose version

حاوية hello-world تنزّل صورة صغيرة جدًا وتطبع رسالة ثم تخرج. إذا رأيت "Hello from Docker!" فهذا يعني أن الخدمة وتنزيل الصور وتشغيل الحاويات تعمل كلها. ويُفعَّل Docker تلقائيًا عند الإقلاع.

ملاحظة: لا تثبّت unattended-upgrades في Ubuntu افتراضيًا إلا التحديثات القادمة من مصادر Ubuntu نفسها. تحديثات Docker من هذا المستودع تصل عندما تشغّل apt upgrade بنفسك. خطط لها، لأن ترقية الخدمة تعيد تشغيلها.

مجموعة docker تعني صلاحيات root

تنصحك معظم الأدلة بإضافة مستخدمك إلى مجموعة docker لتستغني عن sudo:

sudo usermod -aG docker $USER
# log out and back in, then:
docker ps

افهم ما الذي تمنحه هنا. أي شخص يستطيع التحدث مع خدمة Docker يستطيع تشغيل حاوية تربط نظام ملفات الخادم بالكامل:

docker run --rm -v /:/host -it ubuntu chroot /host
# you are now root on the host

إذن العضوية في مجموعة docker تساوي صلاحيات root على الخادم، دون كلمة مرور ودون أي أثر في سجل sudo. قواعد عملية:

  • لا تضف إلا من يملكون صلاحية sudo على هذا الخادم أصلًا.

  • لا تضف أبدًا المستخدم الذي يعمل به تطبيق ويب أو مهمة CI، ولا تربط /var/run/docker.sock داخل حاوية لا تثق بها تمامًا.

  • إذا احتجت إلى أن يشغّل مستخدمون عاديون حاويات، فاطّلع على وضع rootless في Docker، الذي يشغّل الخدمة كمستخدم عادي مع بعض القيود على الشبكة والمنافذ الأقل من 1024.

المنافذ المنشورة تتجاوز UFW

هذه المشكلة توقع حتى مديري الأنظمة ذوي الخبرة. تشغّل حاوية وتنشر منفذًا ثم تحظره بـ UFW:

docker run -d --name web -p 8080:80 nginx:stable-alpine
sudo ufw deny 8080
# port 8080 is still reachable from the internet

يبقى المنفذ مفتوحًا. يكتب Docker قواعد الجدار الناري الخاصة به لتوجيه الحركة إلى الحاويات، وتُعالج المنافذ المنشورة في مساري NAT وFORWARD قبل أن تصل الحزمة إلى قواعد INPUT الخاصة بـ UFW. يُظهر UFW أن المنفذ محظور، بينما يصل إليه الإنترنت كله. بهذه الطريقة بالضبط انكشفت قواعد بيانات ولوحات إدارة وخوادم تطوير.

تحقق مما يستمع فعلًا:

sudo ss -tlnp | grep docker-proxy
# LISTEN 0 4096 0.0.0.0:8080 ... users:(("docker-proxy",...))

0.0.0.0 تعني كل الواجهات، بما فيها الواجهة العامة. الحلول بترتيب الأفضلية:

  1. لا تنشر المنافذ التي لا تحتاجها إلا الحاويات الأخرى. الحاويات في مشروع Compose واحد تشترك في شبكة وتصل إلى بعضها باسم الخدمة.

  2. اربط المنافذ المنشورة بـ localhost وضع أمامها وكيلًا عكسيًا مثل Nginx مع HTTPS:

# docker run
docker run -d --name web -p 127.0.0.1:8080:80 nginx:stable-alpine

# compose.yaml
services:
  web:
    image: nginx:stable-alpine
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:80"

وهكذا يبدو تطبيق معتاد مع قاعدة بيانات: التطبيق وحده منشور، وعلى localhost فقط:

services:
  app:
    image: my-app:latest
    environment:
      DATABASE_URL: postgres://app:secret@db:5432/app
    ports:
      - "127.0.0.1:3000:3000"
  db:
    image: postgres:16
    volumes:
      - dbdata:/var/lib/postgresql/data
    # no "ports:" section: only "app" can reach it

volumes:
  dbdata:
  1. إذا كان لا بد أن يكون المنفذ عامًا مع تقييده (مثلًا على عنوان IP المكتب)، فضع القاعدة في سلسلة iptables المسماة DOCKER-USER. يقيّم Docker هذه السلسلة قبل قواعده ولا يكتب فوقها أبدًا.

لا تحل المشكلة بضبط "iptables": false في إعداد الخدمة، فهذا يكسر شبكة الحاويات بطرق يصعب تتبعها أكثر من المشكلة الأصلية. وتحقق دائمًا من جهاز آخر، مثلًا بالأمر nc -zv على عنوان IP العام للخادم والمنفذ.

تدوير سجلات الحاويات

يستخدم Docker افتراضيًا مشغّل السجلات json-file دون حد للحجم. كل ما تطبعه الحاوية على stdout وstderr يُحفظ في /var/lib/docker/containers/ إلى الأبد. تطبيق كثير الطباعة قد يملأ القرص خلال أسابيع، وعندما يمتلئ القرص تتوقف قواعد البيانات عن الكتابة وتفشل الحاويات بطرق غريبة.

اضبط الحدود للخدمة كلها في /etc/docker/daemon.json:

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  },
  "live-restore": true
}
sudo nano /etc/docker/daemon.json
sudo dockerd --validate --config-file=/etc/docker/daemon.json
sudo systemctl restart docker
docker compose up -d --force-recreate
  • max-size وmax-file يحتفظان بثلاثة ملفات على الأكثر بحجم 10 ميجابايت لكل حاوية. عدّلها حسب حجم القرص ومقدار السجل الذي تحتاجه.

  • الإعدادات الجديدة لا تنطبق إلا على الحاويات المنشأة بعد التغيير. تحتفظ الحاويات الحالية بإعداداتها القديمة حتى تعيد إنشاءها، ولهذا يستخدم الأمر الأخير --force-recreate.

  • live-restore يُبقي الحاويات تعمل أثناء إعادة تشغيل الخدمة، مثلًا أثناء ترقية Docker. وهو غير مدعوم مع وضع Swarm.

  • يوفر Docker أيضًا مشغّل السجلات local الذي يدوّر السجلات ويضغطها افتراضيًا. استخدمه ما لم تكن هناك أداة لجمع السجلات تحتاج إلى قراءة ملفات JSON مباشرة.

لمعرفة أين تذهب مساحة القرص:

docker system df
sudo du -sh /var/lib/docker/containers/*/*-json.log | sort -h | tail
docker image prune -a

الأمر docker image prune -a يحذف كل صورة لا تستخدمها حاوية. هذا آمن على معظم الخوادم، لكن النشر التالي سيضطر إلى تنزيل الصور من جديد. ولا تشغّل أبدًا docker system prune --volumes إلا إذا كنت متأكدًا، فهو يحذف الـ volumes غير المستخدمة، والـ volume هو المكان الذي تعيش فيه بيانات قاعدة بياناتك.

قائمة تحقق قصيرة

  • التثبيت من مصدر واحد فقط، وهو مستودع Docker.

  • مجموعة docker مقصورة على من يملكون root أصلًا.

  • لا منافذ منشورة لقواعد البيانات، ومنافذ التطبيقات مربوطة بـ 127.0.0.1 خلف وكيل عكسي.

  • التحقق من الانكشاف من خارج الخادم، لا من حالة UFW.

  • تدوير السجلات في daemon.json، وإعادة إنشاء الحاويات بعد التغيير.

شغّلها على IM HOST

يحتاج Docker إلى آلة افتراضية KVM مع صلاحيات root كاملة، وليس إلى خطة قائمة على الحاويات. تمنحك خطط Linux VPS من IM HOST صلاحيات root كاملة على KVM، وعنوان IPv4 مخصصًا مع IPv6 /64، وحماية من هجمات DDoS، بدءًا من 5 دولارات شهريًا. وإذا كنت تنشر وكلاء ذكاء اصطناعي أو روبوتات، فإن استضافة وكلاء الذكاء الاصطناعي تأتي جاهزة مع Docker وNode.js وPython وPostgreSQL مع pgvector. لا توجد رسوم إعداد، ومهندسو الدعم متاحون على مدار الساعة، وكل خطة تشمل ضمان استرداد المبلغ خلال 30 يومًا.

المزيد من مدونتنا

اكتشف المزيد من الأدلة العملية ورؤى الخدمات من فريق IM Host.

عرض كل المقالات