أول حاوية Docker: تشغيل Nginx ونشر المنفذ وربط ملفات موقعك

أول حاوية Docker: تشغيل Nginx ونشر المنفذ وربط ملفات موقعك

أول حاوية Docker يشغلها أغلب الناس هي خادم الويب Nginx، لأنها تجمع في أمر واحد كل ما تحتاج فهمه: تشغيل الحاوية في الخلفية، ونشر منفذها على المضيف، وربط ملفات موقعك بها، وقراءة سجلاتها، وإيقافها دون أن تضيع بياناتك. وفي هذا الدليل نفعل ذلك خطوة بخطوة على Docker 29.9 في المختبر، ونقيس كل شيء: زمن بدء الحاوية، ورد الخادم بترويساته، وما يحدث حين يكون المنفذ مستخدماً، وتعديل الموقع دون إعادة تشغيل، وعدد الطلبات في الثانية عبر المنفذ المنشور مقابل عنوان الحاوية مباشرة. وتنبيه من البداية: السجل Docker Hub محجوب عن المختبر، فلم نسحب صورة nginx الرسمية، بل بنينا صورة صغيرة بحجم 13.8 ميغابايت من Nginx 1.24 الموجود على المضيف، والأوامر بعدها هي نفسها.

نمر بالصورة، وتشغيل الحاوية ونشر المنفذ، وربط ملفات الموقع، والسجلات والأوامر داخل الحاوية، والمنفذ المستخدم والأداء، ثم الإيقاف والحذف.

الصورة

# normal way (documented, registry blocked in this lab):
docker pull nginx:1.27-alpine
# what we did instead: same nginx the host runs, packed into an image
FROM lab/base:1.0                 # busybox + glibc libs, 12.5 MB
COPY rootfs/ /                    # /usr/sbin/nginx 1.24.0 + nginx.conf + index.html
EXPOSE 80
STOPSIGNAL SIGQUIT
CMD ["nginx", "-g", "daemon off;"]
صورة Nginx
صورة Nginx

الصورة الرسمية فيها Nginx مع إعداد جاهز يقدم الملفات من المجلد /usr/share/nginx/html، وصورتنا تفعل الشيء نفسه بالمسارات نفسها. والسطر المهم فيها الأخير: daemon off يجعل Nginx يعمل في المقدمة، لأن الحاوية تعيش ما دامت عمليتها الأولى تعيش، ولو ذهب Nginx إلى الخلفية كعادته على السيرفر لانتهت الحاوية فوراً. وSTOPSIGNAL SIGQUIT يجعل الإيقاف لطيفاً، فيكمل الطلبات الجارية قبل أن يخرج.

تشغيل الحاوية ونشر المنفذ

$ time docker run -d --name web -p 9650:80 lab/nginx:1.24
362d355dd3dc...
real 0.205 s
$ docker ps
NAMES   IMAGE            STATUS                  PORTS
web     lab/nginx:1.24   Up Less than a second   0.0.0.0:9650->80/tcp
$ curl -i http://127.0.0.1:9650/
HTTP/1.1 200 OK
Server: nginx/1.24.0 (Ubuntu)
Content-Length: 113
تشغيل الحاوية ونشر المنفذ
تشغيل الحاوية ونشر المنفذ

الخيار -d يشغل الحاوية في الخلفية ويطبع معرفها، و--name يعطيها اسماً تستخدمه بدل المعرف، و-p 9650:80 يعني: ما يصل إلى المنفذ 9650 على المضيف يذهب إلى المنفذ 80 داخل الحاوية. وبدأت الحاوية في 0.2 ثانية، ورد الخادم برمز 200 والصفحة بحجم 113 بايت. وداخل الحاوية يعمل Nginx بعمليتين ظهرتا في docker top: العملية الرئيسية بمستخدم root، والعامل بالمستخدم www-data.

ربط ملفات موقعك

$ docker run -d --name site -p 9651:80 -v $PWD/site:/usr/share/nginx/html:ro lab/nginx:1.24
$ curl -s http://127.0.0.1:9651/
<h1>my site v1</h1>
$ echo '<h1>my site v2</h1>' > site/index.html      # edit on the host, no restart
$ curl -s http://127.0.0.1:9651/
<h1>my site v2</h1>
$ docker exec site sh -c "echo x > /usr/share/nginx/html/a.html"
sh: can't create /usr/share/nginx/html/a.html: Read-only file system
ربط ملفات الموقع
ربط ملفات الموقع

الخيار -v يربط مجلداً من المضيف مكان مجلد في الحاوية، فيقدم Nginx ملفاتك أنت. وعدلنا الملف على المضيف فظهر التعديل في الطلب التالي دون إعادة تشغيل. واللاحقة ro تجعل الربط للقراءة فقط، فحين حاولنا الكتابة من داخل الحاوية رفض النظام. وهذا ما تريده لخادم ويب: حتى لو اختُرق Nginx فلا يستطيع تعديل ملفات موقعك. وبعد حذف الحاويات كلها بقي الملف على المضيف كما هو، لأنه لم يكن داخل الحاوية أصلاً.

السجلات والأوامر داخل الحاوية

$ docker logs --tail 3 site
10.96.50.1 - - [15/Nov/2026:19:06:41 +0000] "GET / HTTP/1.1" 200 20 "-" "curl/8.5.0"
2026/11/15 19:06:42 [error] 7#7: *3 open() "/usr/share/nginx/html/missing" failed (2: No such file or directory)
10.96.50.1 - - [15/Nov/2026:19:06:42 +0000] "GET /missing HTTP/1.1" 404 162 "-" "curl/8.5.0"
$ docker exec site nginx -t
nginx: configuration file /etc/nginx/nginx.conf test is successful

في الحاوية لا تكتب السجلات في /var/log، بل في المخرج القياسي، وDocker يجمعها لك. وجعلنا سجل الوصول يكتب إلى stdout وسجل الأخطاء إلى stderr، فظهر في docker logs طلب ناجح ثم خطأ ملف غير موجود ثم الطلب نفسه برمز 404. وعنوان العميل 10.96.50.1 هو عنوان الجسر على المضيف، لا عنوان المستخدم الحقيقي، وهذا يتغير خلف وكيل عكسي. وdocker exec يشغل أمراً داخل حاوية تعمل، كفحص الإعداد بـ nginx -t قبل إعادة التحميل.

المنفذ المستخدم والأداء

$ docker run -d --name web2 -p 9650:80 lab/nginx:1.24
docker: Error response from daemon: ... Bind for 0.0.0.0:9650 failed: port is already allocated
rc=125      (container web2 left in state "Created")

wrk -t2 -c20 -d5s
http://127.0.0.1:9650/   (published port, docker-proxy)   11,298 req/s   latency avg 1.94 ms
http://10.96.50.2/       (container IP directly)          27,799 req/s   latency avg 0.79 ms
docker stats: web mem 1.902 MiB
المنفذ المستخدم والأداء
المنفذ المستخدم والأداء

منفذ المضيف لا يأخذه إلا برنامج واحد، فرفض Docker الحاوية الثانية على 9650 برمز 125، لكنه أنشأها وتركها في حالة Created، فاحذفها بنفسك. وفي الأداء فرق كبير يحتاج شرحاً: في مختبرنا عطلنا تعديل iptables حتى لا نمس جدار الحماية المشترك، فمر المنفذ المنشور عبر برنامج docker-proxy في مساحة المستخدم، فأعطى 11,298 طلباً في الثانية مقابل 27,799 للعنوان المباشر. وفي التثبيت العادي يحول iptables الحزم في النواة، فيقل هذا الفرق. واستهلكت الحاوية أقل من 2 ميغابايت من الذاكرة. وضبط Nginx كوكيل عكسي أمام الحاويات في الوكيل العكسي وضبط أداء Nginx.

الإيقاف والحذف

$ time docker stop web          real 0.203 s   (SIGQUIT, graceful)
$ time docker rm -f web site    real 0.145 s
$ cat site/index.html
<h1>my site v2</h1>

docker stop يرسل إشارة الإيقاف المحددة في الصورة وينتظر عشر ثوانٍ قبل القتل، وNginx خرج في 0.2 ثانية. وdocker rm يحذف الحاوية وطبقة الكتابة الخاصة بها، والخيار -f يوقفها أولاً إن كانت تعمل. وحالات الحاوية كلها وأوامرها في أوامر الحاويات ودورة حياتها.

أخطاء شائعة

تشغيل Nginx في الخلفية داخل الحاوية

تنتهي الحاوية فوراً، والحل daemon off.

نسخ الموقع إلى داخل حاوية تعمل

يضيع مع حذفها، فاربط مجلداً أو ابن صورة.

نسيان ro في ربط الملفات

خادم مخترق يستطيع تعديل موقعك.

نشر المنفذ على كل العناوين

استخدم -p 127.0.0.1:9650:80 إن كان خلف وكيل على الجهاز نفسه.

أسئلة يطرحها الناس

كيف أضيف HTTPS؟

بوكيل عكسي على المضيف يحمل الشهادة ويمرر إلى الحاوية، أو بربط الشهادة وإعداد Nginx داخلها.

أي صورة رسمية أختار؟

نسخة alpine أصغر، والعادية مبنية على Debian وأسهل في تثبيت الإضافات.

الخلاصة

شغلنا Nginx في حاوية بحجم 13.8 ميغابايت بدأت في 0.2 ثانية وردت برمز 200، وقدمت ملفات مربوطة للقراءة فقط تغيرت دون إعادة تشغيل ورفضت الكتابة. والمنفذ المستخدم أعاد الخطأ 125، والمنفذ المنشور عبر docker-proxy أعطى 11,298 طلباً في الثانية مقابل 27,799 للعنوان المباشر، والحاوية خرجت في 0.2 ثانية وبقيت ملفات الموقع على المضيف.