ثبت Docker على جهازك أو سيرفرك، وكتبت docker run hello-world فظهرت الرسالة الترحيبية، والآن تريد أن تشغل شيئاً حقيقياً: خدمة ويب صغيرة تستمع على منفذ، تقرأ سجلاتها عندما يشتكي أحد، تدخل إليها لتفحص ملفاً، وتوقفها دون أن تقطع طلباً في منتصفه. وهنا تبدأ الأسئلة التي لا يجيب عنها مثال hello-world: لماذا يقول docker ps إن ال Container يعمل ثم لا يجيب؟ لماذا يأخذ docker stop عشر ثوان مع تطبيق وثانية مع آخر؟ ماذا يعني Exited (137)؟ ولماذا لا يجد ال Container الآخر باسمه؟
في مقال ما هي ال Containers رأينا أن ال Container عملية عادية في مساحات أسماء خاصة مع حدود من cgroups، وفي هذا المقال سوف نستخدم هذه المعرفة مع الأوامر اليومية. سوف نشغل خدمة ويب صغيرة ونتابعها بأوامر Docker الأساسية، ثم ننتقل إلى الموضوع الذي يسبب أكثر المشاكل في الإنتاج: الإشارات Signals والعملية رقم 1 ورموز الخروج، وكل رقم وكل مخرج هنا من تشغيل حقيقي على Docker Engine 29.8، بما في ذلك مشكلتان لم نتوقعهما. وإذا لم تثبت Docker بعد فابدأ بدليل تثبيت Docker Engine وCompose على Ubuntu.
وسوف نناقش في هذا المقال ما يلي:
- تشغيل أول Container في الخلفية، ونشر منفذ، ومشكلة Container يقول «Up» ثم يختفي.
- الأوامر اليومية:
psوlogsوexecوtopوportوstatsوcpوinspect. - دورة حياة ال Container وحالاته، والفرق بين
stopوkillوrm. - رموز الخروج 0 و1 و127 و137 و143، وكيف أعدنا إنتاج كل واحد منها.
- العملية رقم 1 والإشارات: لماذا ينتظر
docker stopثم يقتل، وما الذي يصلحه--initوما لا يصلحه. - سياسات الإعادة Restart Policies، ومتغيرات البيئة Environment Variables، وأساسيات الشبكة.
- أوامر التنظيف Prune وما يحذفه كل منها، والأخطاء الشائعة، وقائمة تحقق.
أول Container في الخلفية: docker run
الأمر docker run هو أكثر أمر سوف تكتبه، وهو في الحقيقة أمران: docker create الذي يجهز طبقة الكتابة والإعداد، ثم docker start الذي يشغل العملية. وأردنا خدمة ويب صغيرة دون أن نكتب تطبيقاً، فاخترنا خادم httpd الموجود في BusyBox، وكتبنا الأمر التالي على Image من Alpine لأنها صغيرة ومعروفة:
docker run -d --name ct1-api -p 127.0.0.1:9566:8080 alpine:3.24 \
sh -c 'mkdir -p /www && echo "<h1>ct1 api</h1>" > /www/index.html && exec httpd -f -v -p 8080 -h /www'
docker ps
curl -s 127.0.0.1:9566/وفي الأمر أعلاه لاحظ التالي:
- الخيار
-dيشغل ال Container في الخلفية Detached ويعيد لك الطرفية مع رقمه الطويل، وبدونه يبقى مخرج ال Container على شاشتك ويتوقف إذا ضغطت Ctrl+C. --nameيعطيه اسماً تستخدمه في كل الأوامر بعد ذلك، وبدونه يختار Docker اسماً عشوائياً من كلمتين.-p 127.0.0.1:9566:8080ينشر المنفذ 8080 داخل ال Container على المنفذ 9566 في المضيف، وعلى العنوان المحلي فقط. ولو كتبت-p 9566:8080لفتح المنفذ على كل عناوين السيرفر وتجاوز جدار الحماية ufw كما شرحنا في دليل شبكات Docker.exec httpdيجعلhttpdيحل مكان الـ Shell كعملية رقم 1، وسوف نرى بعد قليل لماذا يهمنا ذلك.
وكان المخرج كما يلي:
6818ecf2fe375a1c352f2085e69055f4cad52cc6c49056a005c825215efc503e
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
6818ecf2fe37 alpine:3.24 "sh -c 'mkdir -p /ww…" 3 seconds ago Up 1 second 127.0.0.1:9566->8080/tcp ct1-apiال Container في حالة Up، والمنفذ منشور، ولكن curl لم يطبع شيئاً، وعندما كررنا docker ps بعد ثوان لم يكن ال Container في القائمة أصلاً. وهذه أول مشكلة حقيقية في المقال، وهي من أكثر ما يربك المبتدئ: docker ps يعرض ال Containers التي تعمل الآن فقط، فإذا مات ال Container اختفى من القائمة دون أي رسالة. والأمر الصحيح للبحث عنه هو docker ps -a الذي يعرض كل ال Containers بما فيها المتوقفة، ثم docker logs لنعرف لماذا توقف:
docker ps -a --filter name=ct1-api
docker logs ct1-apiوالمخرج سوف يكون كما يلي:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
6818ecf2fe37 alpine:3.24 "sh -c 'mkdir -p /ww…" 39 seconds ago Exited (127) 36 seconds ago ct1-api
sh: exec: line 0: httpd: not foundال Container بدأ فعلاً، ونفذ الـ Shell أول أمرين، ثم لم يجد httpd فخرج برمز 127 بعد أقل من ثانية، وكان docker ps الأول قد التقطه في تلك اللحظة. والسبب أن BusyBox في Alpine 3.24 لم يعد يحتوي على httpd، فقد نقلته Alpine إلى حزمة منفصلة اسمها busybox-extras. والدرس هنا أكبر من httpd: حالة Up لا تعني أن التطبيق يعمل، وإنما أن العملية رقم 1 لم تخرج بعد، ولذلك تحتاج فحص صحة Health Check حقيقي يسأل التطبيق نفسه، وهذا موضوع مقال أفضل الممارسات في Compose. وحللنا المشكلة باستخدام Image الرسمية busybox:1.37 التي ما زال httpd فيها:
docker rm ct1-api
docker run -d --name ct1-api -p 127.0.0.1:9566:8080 busybox:1.37 \
sh -c 'mkdir -p /www && echo "<h1>ct1 api</h1>" > /www/index.html && exec httpd -f -v -p 8080 -h /www'
curl -s -i 127.0.0.1:9566/ | head -4
curl -s -o /dev/null -w '%{http_code}\n' 127.0.0.1:9566/missingوالمخرج سوف يكون كما يلي:
bf8538fac28ba9282770a251bdd9d0c0f4f65210b4915da2bf2edf3e84d5d697
HTTP/1.1 200 OK
Date: Wed, 18 Nov 2026 15:53:41 GMT
Connection: close
Content-type: text/html
404وقبل أن نكمل، هناك شكل آخر لـ docker run سوف تستخدمه كثيراً في التجارب، وهو docker run --rm -it alpine:3.24 sh: الخيار -it يربط طرفيتك بال Container فتكتب فيه كأنه جهاز، و--rm يحذفه تلقائياً عندما تخرج منه بالأمر exit، فلا يترك خلفه Container متوقفاً. وإذا شغلت Container بالخيار -it وأردت أن تتركه يعمل وتعود إلى طرفيتك دون إيقافه، فاضغط Ctrl+P ثم Ctrl+Q، أما Ctrl+C أو exit فتنهي العملية رقم 1 فيتوقف ال Container كله. وهذا الشكل مفيد لتجربة أمر أو فحص Image، أما الخدمات فمكانها دائماً الخيار -d.
والآن عندنا خدمة تعمل: الصفحة الرئيسية ترجع 200، والمسار غير الموجود يرجع 404. ولاحظ أننا احتجنا docker rm قبل التشغيل الثاني، لأن ال Container المتوقف ما زال موجوداً باسمه، ولا يقبل Docker اسمين متماثلين.
الأوامر اليومية: ps وlogs وexec وغيرها
الآن سوف نمر على الأوامر التي تحتاجها كل يوم مع ال Container الذي يعمل، كل أمر مع مخرجه الحقيقي.
قراءة السجلات Logs: docker logs
كل ما يكتبه التطبيق على المخرج القياسي stdout ومخرج الأخطاء stderr يجمعه Docker في سجل ال Container، وتقرؤه بالأمر docker logs:
docker logs ct1-api
docker logs --timestamps --tail 1 ct1-apiوالمخرج سوف يكون كما يلي:
[::ffff:172.17.0.1]:45320: response:200
[::ffff:172.17.0.1]:45336: response:404
2026-11-18T15:53:42.062547560Z [::ffff:172.17.0.1]:45336: response:404الطلبان اللذان أرسلناهما يظهران بالترتيب، والخيار -v في httpd هو الذي جعله يكتب كل طلب. ولاحظ أن العنوان المرسل هو 172.17.0.1 وليس عنوان جهازك، لأن الطلب وصل عبر جسر Docker، وهذا يعني أن التطبيق خلف -p لا يرى العنوان الحقيقي للعميل إلا عبر Reverse Proxy يمرره في ترويسة. والخيار --timestamps يضيف وقت استلام Docker لكل سطر بتوقيت UTC، وهو مفيد عندما لا يكتب التطبيق وقتاً بنفسه، و--tail 1 يعرض آخر سطر فقط. وأكثر خيار سوف تستخدمه هو -f الذي يتابع السجل كما يفعل tail -f، ومعه --since 10m لتبدأ من آخر عشر دقائق بدلاً من أول يوم.
وهنا قاعدة مهمة: التطبيق داخل Container يجب أن يكتب سجلاته على stdout وstderr، لا في ملف داخل ال Container. والسبب أن الملف الداخلي لا يراه docker logs، ويكبر داخل الطبقة القابلة للكتابة حتى يملأ القرص، ويضيع مع حذف ال Container. أما سجل Docker نفسه فيكبر أيضاً بلا حد إذا لم تضبط تدوير السجلات Log Rotation، وقد شرحنا ضبطه في دليل التثبيت، وتفاصيل محركات السجلات في توثيق Docker.
الدخول إلى ال Container: docker exec
الأمر docker exec يشغل عملية جديدة داخل Container يعمل، في نفس مساحات أسمائه ونفس مجموعة التحكم. والاستخدام الأشهر docker exec -it ct1-api sh لتفتح Shell تفاعلياً، حيث -i يبقي المدخل مفتوحاً و-t يعطيك طرفية. وهنا شغلنا أمراً واحداً دون طرفية:
docker exec ct1-api psوالمخرج سوف يكون كما يلي:
PID USER TIME COMMAND
1 root 0:00 httpd -f -v -p 8080 -h /www
9 root 0:00 pshttpd هو العملية رقم 1 لأننا استخدمنا exec في الأمر، وps الذي شغلناه ظهر بالرقم 9 داخل نفس المساحة. ولاحظ أن exec يعمل فقط مع Container يعمل، فقد رأينا في محاولتنا الأولى الخطأ container ... is not running عندما حاولنا الدخول إلى ال Container الذي مات. وإذا كانت ال Image لا تحتوي على Shell أصلاً، كما في Images من نوع Distroless، فلن يعمل sh، وتحتاج حينها docker debug أو Container مساعداً يشارك مساحة العمليات بالخيار --pid=container:ct1-api.
docker exec يضيع عند إعادة إنشائه من ال Image، لأنه في الطبقة القابلة للكتابة فقط. استخدم exec للفحص والتشخيص، أما التغييرات الدائمة فمكانها ال Image أو Volume أو متغيرات البيئة.ماذا يعمل وكم يأخذ؟ top وport وstats
ثلاثة أوامر قصيرة تجيب عن ثلاثة أسئلة: ما العمليات داخل ال Container كما يراها المضيف؟ وأين نشرت منافذه؟ وكم يستهلك الآن؟
docker top ct1-api
docker port ct1-api
docker stats --no-stream ct1-apiوالمخرج سوف يكون كما يلي:
UID PID PPID C STIME TTY TIME CMD
root 11071 11031 1 15:53 ? 00:00:00 httpd -f -v -p 8080 -h /www
8080/tcp -> 127.0.0.1:9566
CONTAINER ID NAME CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS
bf8538fac28b ct1-api 0.00% 444KiB / 31.29GiB 0.00% 1.92kB / 1.3kB 0B / 0B 1في المخرج أعلاه لاحظ التالي:
- docker top يعرض نفس
httpdبرقمه عند المضيف 11071، وأبوه 11031 هوcontainerd-shim، وهو مفيد عندما لا يوجدpsداخل ال Image. - docker port يؤكد أن المنفذ منشور على 127.0.0.1 فقط، وهو أسرع طريقة لتتأكد أنك لم تفتح منفذاً للعالم بالخطأ.
- docker stats يقرأ أرقامه من مجموعة التحكم الخاصة بال Container: الذاكرة 444 KiB، والحد هو ذاكرة الجهاز كلها 31.29 GiB لأننا لم نضع حداً بالخيار
-m، وعمودPIDSيقول إن فيه عملية واحدة. وبدون--no-streamيبقى الأمر يحدث الأرقام كل ثانية مثلtop.
نقل الملفات: docker cp
الأمر docker cp ينسخ ملفات بين المضيف وال Container في الاتجاهين، ويعمل حتى مع Container متوقف لأنه يقرأ نظام ملفاته مباشرة:
docker cp ct1-api:/www/index.html ./index-from-container.html
cat index-from-container.html
echo '<p>page 2</p>' > page2.html
docker cp page2.html ct1-api:/www/page2.html
curl -s 127.0.0.1:9566/page2.htmlوالمخرج سوف يكون كما يلي:
<h1>ct1 api</h1>
<p>page 2</p>الصفحة الجديدة صارت متاحة فوراً دون إعادة تشغيل. وفي محاولتنا الأولى على Windows نسخنا الملف /etc/os-release من Alpine فظهر الخطأ symlinkat ../usr/lib/os-release os-release.txt: A required privilege is not held by the client، لأن هذا الملف في Alpine رابط رمزي Symbolic Link، وdocker cp ينسخ الرابط كما هو، وإنشاء الروابط الرمزية في Windows يحتاج صلاحية خاصة. فإذا رأيت هذا الخطأ فانسخ الملف الذي يشير إليه الرابط بدلاً منه. واستخدم docker cp للتشخيص وللنسخ لمرة واحدة، أما الملفات التي يحتاجها التطبيق دائماً فمكانها Volume أو Bind Mount كما في مقال بيانات ال Containers.
كل شيء عن ال Container: docker inspect
الأمر docker inspect يطبع كل ما يعرفه Docker عن ال Container بصيغة JSON، وهو كثير: 221 سطراً لهذا ال Container الصغير. ولذلك تستخدمه مع --format لتختار الحقول التي تريدها:
docker inspect ct1-api --format 'Status={{.State.Status}} Pid={{.State.Pid}} StartedAt={{.State.StartedAt}} Restart={{.HostConfig.RestartPolicy.Name}} IP={{.NetworkSettings.Networks.bridge.IPAddress}} Image={{.Config.Image}}'والمخرج سوف يكون كما يلي:
Status=running Pid=11071 StartedAt=2026-11-18T15:53:35.772097986Z Restart=no IP=172.17.0.12 Image=busybox:1.37وأكثر الحقول التي سوف تحتاجها: .State.ExitCode و.State.OOMKilled عند التشخيص، و.RestartCount لتعرف كم مرة أعيد، و.Mounts لتعرف أين بياناته، و.Config.Env لمتغيرات البيئة، وسوف نرى أن الأخير يكشف أكثر مما تتوقع.
دورة حياة ال Container: من create إلى rm
قبل أن نصل إلى الإيقاف والإشارات، لنرتب الحالات التي يمر بها ال Container، لأن كل أمر من الأوامر السابقة يعمل في حالات معينة فقط. والرسم التالي يجمعها مع الأوامر التي تنقل بينها:

وفي الرسم أعلاه لاحظ التالي:
- الحالة
Createdتعني أن الطبقة والإعداد جاهزة ولكن لا توجد عملية، وقد وصلنا إليها دون قصد عندما طلبنا أمراً غير موجود، كما سوف نرى في رموز الخروج. - ال Container يخرج من
Runningفي حالة واحدة فقط: خروج العملية رقم 1، سواء خرجت بنفسها أو بإشارة منstopأوkill. ولا يهم إن كانت هناك عمليات أخرى تعمل داخله، فهي تموت معها. pauseلا يرسل أي إشارة، وإنما يجمد كل العمليات بمتحكم freezer في cgroups، فلا تشعر به العمليات أصلاً، وتستخدم لنسخة احتياطية متسقة كما في دليل نسخ قواعد البيانات بشكل متسق.- ال Container في حالة
Exitedيحتفظ بطبقته القابلة للكتابة وسجلاته ورمز خروجه حتى تحذفه بالأمر docker rm، وهذا مفيد للتشخيص بعد التوقف، ومزعج عندما تتراكم المئات منها. ولذلك تستخدم--rmمع ال Containers قصيرة العمر ليحذفها Docker تلقائياً عند خروجها.
رموز الخروج Exit Codes: ماذا يقول الرقم؟
رمز الخروج هو الرقم الذي تتركه العملية رقم 1 عندما تنتهي، ويحفظه Docker في .State.ExitCode ويعرضه في docker ps -a. والقاعدة التي تحكمه موجودة في كل أنظمة Unix: الأرقام من 0 إلى 127 يختارها البرنامج نفسه أو الـ Shell، أما إذا ماتت العملية بإشارة فالرمز 128 مضافاً إليه رقم الإشارة، كما يشرح توثيق Docker لتشغيل ال Containers. ولنعيد إنتاج كل رمز شائع:
docker run --name ct1-ex0 busybox:1.37 true; echo "exit=$?"
docker run --name ct1-ex1 busybox:1.37 ls /nope; echo "exit=$?"
docker run --name ct1-ex127 busybox:1.37 nosuchcmd; echo "exit=$?"
docker run -d --name ct1-kill busybox:1.37 sleep 300
docker kill ct1-kill
docker inspect ct1-kill --format 'ExitCode={{.State.ExitCode}}'والمخرج سوف يكون كما يلي:
exit=0
ls: /nope: No such file or directory
exit=1
docker: Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: exec: "nosuchcmd": executable file not found in $PATH
exit=127
ct1-kill
ExitCode=137في المخرج أعلاه لاحظ التالي:
- الرمز 0 نجاح، والرمز 1 خطأ عام اختاره
lsلأن الملف غير موجود. ومعنى الأرقام من 1 إلى 125 يحدده كل برنامج في توثيقه، فالرمز 2 فيgrepمثلاً يعني خطأ وليس «لم أجد». - الرمز 127 هنا جاء من Docker وليس من داخل ال Container: runc لم يجد البرنامج فلم يبدأ ال Container أصلاً، وبقي في حالة
Createdكما ظهر فيdocker ps -a. ويستخدم Docker الرمز 125 عندما يفشل الأمر نفسه (خيار خاطئ مثلاً)، و126 عندما يوجد البرنامج ولا يمكن تنفيذه، و127 عندما لا يوجد. - وتذكر أن 127 ظهر أيضاً مع
httpdفي بداية المقال، ولكن من داخل ال Container: الـ Shell بدأ وعمل ثم لم يجد البرنامج، فالحالةExited (127)وفي السجلnot found. والفرق بينهما يخبرك أين تبحث: في الأول الأمر في ال Image نفسها خاطئ، وفي الثاني ما يفعله سكربت البدء. - الرمز 137 هو 128 + 9، أي SIGKILL، وهو ما يرسله
docker killافتراضياً. ونفس الرمز يظهر عندما تقتل النواة ال Container لتجاوزه حد الذاكرة، والطريقة الوحيدة للتفريق بينهما الحقلOOMKilled.

وبقي الرمز 143، وهو 128 + 15 أي SIGTERM، وهو الرمز الذي تتوقعه من docker stop، ولكنه لم يظهر في أول تجربة لنا، وهذا ما يقودنا إلى أهم قسم في المقال.
docker stop والإشارات Signals: لماذا ينتظر ثم يقتل؟
عندما تكتب docker stop لا يقتل Docker ال Container مباشرة، وإنما يرسل إلى العملية رقم 1 إشارة SIGTERM، وهي طلب مهذب معناه «أكمل ما في يدك واخرج». ثم ينتظر مهلة، فإذا خرجت العملية خلالها انتهى الأمر، وإذا بقيت أرسل SIGKILL التي لا يمكن تجاهلها ولا معالجتها. والفكرة أن التطبيق الجيد يستقبل SIGTERM فيتوقف عن قبول طلبات جديدة، ويكمل الطلبات التي في منتصفها، ويغلق اتصالات قاعدة البيانات، ويكتب ما في ذاكرته، ثم يخرج برمز 0. وقائمة الإشارات وأرقامها في صفحة signal(7).
المشكلة الثانية: المهلة لم تكن عشر ثوان
شغلنا sleep 300 كعملية رقم 1 وأوقفناه، ونحن نتوقع انتظار عشر ثوان، وهي المهلة الافتراضية المكتوبة في التوثيق، ثم الرمز 137. فجاء الرمز كما توقعنا، ولكن الأمر انتهى في 4.5 ثانية فقط. ولنعرف ما حدث بالضبط سجلنا أحداث Docker أثناء الإيقاف:
docker run -d --name ct1-sleep busybox:1.37 sleep 300
docker events --filter container=ct1-sleep --format '{{.TimeNano}} {{.Action}} signal={{index .Actor.Attributes "signal"}} exit={{index .Actor.Attributes "exitCode"}}' &
docker stop ct1-sleepوالمخرج سوف يكون كما يلي:
1795017774194283211 kill signal=15 exit=
1795017777282645323 kill signal=9 exit=
1795017778794961425 stop signal= exit=
1795017778826452442 die signal= exit=137الحدث الأول SIGTERM (15)، والثاني SIGKILL (9) بعد 3.09 ثانية بالضبط من الأول، ثم مات ال Container برمز 137. فالمهلة على جهازنا كانت 3 ثوان وليست 10. وبحثنا عن السبب في إعدادات المحرك، فوجدنا في ملف daemon.json الذي يستخدمه Docker Desktop على هذا الجهاز السطر "default-stop-timeout": 3، وهو الإعداد الذي يقابل الخيار --stop-timeout في مرجع dockerd وقيمته الافتراضية 10. والدرس أن المهلة ليست ثابتة: يحددها المحرك، ويغيرها --stop-timeout عند تشغيل ال Container، أو stop_grace_period في Compose، أو -t عند الإيقاف. ولذلك أعدنا كل التجارب التالية بالخيار -t 10 لتطابق ما سوف تراه على سيرفر Linux عادي.
لماذا لم يصل SIGTERM؟ العملية رقم 1
بقي السؤال: لماذا لم يمت sleep بإشارة SIGTERM؟ فالإجراء الافتراضي لهذه الإشارة هو إنهاء العملية، وsleep لا يعالجها بنفسه. والإجابة في قاعدة خاصة بالعملية رقم 1 تشرحها صفحة pid_namespaces(7): النواة لا توصل إلى init في أي مساحة أسماء إلا الإشارات التي كتبت لها معالجاً Handler، والإجراء الافتراضي لا ينطبق عليها. والسبب منطقي في نظام كامل، فموت init يعني توقف النظام كله، فلا يجوز أن تقتلها إشارة عابرة. ولكن داخل ال Container يصبح أي برنامج تشغله هو init، فيرث هذه الحماية دون أن يعرف، ويتجاهل SIGTERM ما لم يكتب مبرمجه معالجاً لها صراحة. وقد رأينا نفس الظاهرة في مقال ما هي ال Containers، عندما صارت حلقة while هي العملية رقم 1 فلم يستطع timeout إيقافها.
والحل الأول الخيار --init، الذي يجعل Docker يضع برنامجاً صغيراً اسمه tini كعملية رقم 1، ويشغل برنامجك ابناً له. وtini تفعل شيئين فقط: تمرر كل إشارة تصلها إلى ابنها، وتجمع العمليات اليتيمة Zombies التي تموت داخل ال Container ولا يجمعها أحد. ولنقارن بين أربع حالات في وقت واحد، مع سكربتين صغيرين: graceful.sh يعالج SIGTERM، وstubborn.sh يتجاهلها عمداً:
#!/bin/sh
# graceful.sh: a worker that finishes its current job when asked to stop
trap 'echo "SIGTERM received, finishing current job"; sleep 1; echo "bye"; exit 0' TERM
echo "worker started as PID $$"
while true; do sleep 1 & wait $!; done#!/bin/sh
# stubborn.sh: ignores SIGTERM completely
trap '' TERM
echo "stubborn started as PID $$"
while true; do sleep 1; doneوفي graceful.sh لاحظ السطر الأخير: sleep 1 & wait $! بدلاً من sleep 1، لأن الـ Shell لا ينفذ معالج الإشارة إلا بعد أن ينتهي الأمر الذي يعمل في المقدمة، أما wait فتقطعها الإشارة فوراً. ثم شغلنا الأربعة وأوقفناها بمهلة 10 ثوان وقسنا الوقت:
docker run -d --name ct1-sleep busybox:1.37 sleep 300
docker run -d --init --name ct1-sleep-init busybox:1.37 sleep 300
docker run -d --name ct1-graceful -v "$PWD/graceful.sh:/graceful.sh:ro" busybox:1.37 sh /graceful.sh
docker run -d --init --name ct1-stubborn -v "$PWD/stubborn.sh:/stubborn.sh:ro" busybox:1.37 sh /stubborn.sh
docker exec ct1-sleep-init ps
for c in ct1-sleep ct1-sleep-init ct1-graceful ct1-stubborn; do
s=$(date +%s%N); docker stop -t 10 $c >/dev/null; e=$(date +%s%N)
echo "docker stop -t 10 $c: $(( (e - s) / 1000000 )) ms, ExitCode=$(docker inspect $c --format '{{.State.ExitCode}}')"
done
docker logs ct1-graceful
docker logs ct1-stubbornوالمخرج سوف يكون كما يلي:
PID USER TIME COMMAND
1 root 0:00 /sbin/docker-init -- sleep 300
7 root 0:00 sleep 300
8 root 0:00 ps
docker stop -t 10 ct1-sleep: 12270 ms, ExitCode=137
docker stop -t 10 ct1-sleep-init: 1214 ms, ExitCode=143
docker stop -t 10 ct1-graceful: 2522 ms, ExitCode=0
docker stop -t 10 ct1-stubborn: 12590 ms, ExitCode=137
worker started as PID 1
SIGTERM received, finishing current job
bye
stubborn started as PID 7وهذه أوضح تجربة في المقال، وفي المخرج أعلاه لاحظ التالي:
- مع
--initصارت العملية رقم 1 هي/sbin/docker-init، وهو اسم tini داخل Docker، وsleepابنها برقم 7. sleepكعملية رقم 1 احتاجت 12.3 ثانية: عشر ثوان انتظار، والباقي بطء الجهاز الذي كان مشغولاً بأعمال أخرى، ثم ماتت بـ SIGKILL برمز 137.- نفس
sleepمع--initانتهت في 1.2 ثانية برمز 143: وصلتها SIGTERM من tini فماتت بالإجراء الافتراضي، لأنها لم تعد العملية رقم 1، ثم خرجت tini برمز ابنها. graceful.shهو العملية رقم 1 بدون--init، ومع ذلك وصلته الإشارة، لأنه كتب لها معالجاً بالأمرtrap، فطبع رسالته وأكمل ثانية من العمل ثم خرج برمز 0 في 2.5 ثانية. وهذا ما يجب أن يفعله كل تطبيق.stubborn.shمع--initاحتاج 12.6 ثانية ومات برمز 137، لأن tini مررت الإشارة فعلاً، ولكن البرنامج نفسه قرر تجاهلها. فـ--initيصلح مشكلة العملية رقم 1، ولا يصلح برنامجاً لا يريد أن يتوقف.


لماذا يهمك هذا في الإنتاج؟
قد يتساءل البعض: وما المشكلة في عشر ثوان؟ والإجابة أن هذه الثواني العشر تتكرر في كل مكان: في كل نشر لإصدار جديد، وفي كل docker compose down، وفي كل تحديث للسيرفر. والأهم أن نهايتها SIGKILL، أي أن التطبيق لا يكمل الطلبات التي في منتصفها، ولا يحفظ ما في ذاكرته، ولا يعيد الرسائل التي أخذها من الطابور Queue ولم ينته منها. فإذا كان عندك عامل Worker يعالج طلبات الدفع، فكل نشر جديد قد يقطع عملية في منتصفها، ولن تعرف إلا من شكوى عميل. ولذلك هذه هي القواعد:
- اكتب في تطبيقك معالجاً لـ SIGTERM يغلق ما يجب إغلاقه ثم يخرج برمز 0، وكل اللغات الحديثة تسمح بذلك، والسبب أنه الطريقة الوحيدة لتوقف نظيف.
- استخدم الشكل Exec في Dockerfile:
CMD ["node", "app.js"]بدلاً منCMD node app.js، لأن الشكل الثاني يشغل/bin/sh -cكعملية رقم 1، والـ Shell قد لا يمرر الإشارة إلى تطبيقك، كما يشرح مرجع Dockerfile. وإذا احتجت سكربت بدء فاجعل آخر سطر فيهexec "$@"كما فعلنا معhttpd. - أضف
--init(أوinit: trueفي Compose) لأي تطبيق لا تتحكم في كوده، أو يشغل عمليات أبناء قد تترك Zombies. - اضبط المهلة بحسب التطبيق: عامل يحتاج 30 ثانية لينهي مهمته يحتاج
--stop-timeout 30، وإذا كان التطبيق يتوقف بإشارة أخرى مثل SIGQUIT في nginx فحددها بالخيار--stop-signalأو STOPSIGNAL في Dockerfile.
وقد واجهنا نفس المسألة من جهة systemd في دليل الخدمات والسجلات مع systemd، حيث يرسل systemd أيضاً SIGTERM ثم SIGKILL بعد مهلة، فالفكرة واحدة في كل مدير عمليات.
سياسات الإعادة Restart Policies
السؤال التالي بعد الإيقاف: من يعيد ال Container إذا مات وحده، أو بعد إعادة تشغيل السيرفر؟ والإجابة Docker نفسه، بحسب السياسة التي تعطيها بالخيار --restart، وتفاصيلها في توثيق Docker لسياسات الإعادة. وجربنا ثلاث حالات:
docker run -d --name ct1-flaky --restart on-failure:3 busybox:1.37 sh -c 'echo "start at $(date +%T)"; sleep 1; exit 1'
sleep 25
docker ps -a --filter name=ct1-flaky --format 'table {{.Names}}\t{{.Status}}'
docker inspect ct1-flaky --format 'RestartCount={{.RestartCount}} ExitCode={{.State.ExitCode}} Policy={{.HostConfig.RestartPolicy.Name}}:{{.HostConfig.RestartPolicy.MaximumRetryCount}}'
docker logs ct1-flakyوالمخرج سوف يكون كما يلي:
NAMES STATUS
ct1-flaky Exited (1) 18 seconds ago
RestartCount=3 ExitCode=1 Policy=on-failure:3
start at 16:06:56
start at 16:06:58
start at 16:07:00
start at 16:07:02ال Container خرج برمز 1، فأعاده Docker ثلاث مرات بالضبط ثم تركه متوقفاً، والسجل يحفظ البدايات الأربع كلها لأن ال Container نفسه لم يحذف. ولاحظ أن التوثيق يقول إن السياسة تبدأ عملها بعد أن يبقى ال Container يعمل عشر ثوان على الأقل، ومع ذلك أعاد Docker 29.8 عندنا Container يعيش ثانية واحدة فقط، فلا تعتمد على هذه الجملة لمنع حلقة الإعادة، وإنما على الحد :3. ثم جربنا always مع إيقاف يدوي، ثم مع قتل العملية من الخارج كما يحدث عند انهيار التطبيق:
docker run -d --name ct1-always --restart always busybox:1.37 sleep 300
docker stop -t 1 ct1-always; sleep 5
docker ps -a --filter name=ct1-always --format 'table {{.Names}}\t{{.Status}}'
docker start ct1-always
P=$(docker inspect -f '{{.State.Pid}}' ct1-always)
docker run --rm --privileged --pid=host busybox:1.37 kill -9 $P; sleep 4
docker inspect ct1-always --format 'Status={{.State.Status}} RestartCount={{.RestartCount}}'
docker update --restart unless-stopped ct1-alwaysوالمخرج سوف يكون كما يلي:
NAMES STATUS
ct1-always Exited (137) 7 seconds ago
Status=running RestartCount=1
ct1-alwaysبعد docker stop بقي ال Container متوقفاً رغم السياسة always، لأن Docker يحترم الإيقاف اليدوي ولا يعتبره انهياراً. أما عندما قتلنا العملية بالإشارة 9 من خارج Docker، كما يحدث عند انهيار التطبيق أو قتل النواة له، فأعاده Docker خلال ثوان وصار RestartCount=1. والأمر docker update غير السياسة دون حذف ال Container. والفرق الوحيد بين always وunless-stopped يظهر بعد إعادة تشغيل Docker أو السيرفر: always يعيد تشغيل ال Container حتى لو كنت أوقفته بيدك، وunless-stopped يتذكر أنك أوقفته فيتركه. ولم نعد تشغيل Docker في المختبر لأن الجهاز مشترك مع أعمال أخرى، والجدول التالي يجمع السلوك كما يصفه التوثيق مع ما رأيناه:

والسياسة الأنسب لأغلب خدمات السيرفر هي unless-stopped، والسبب أنها تعيد التطبيق بعد الانهيار وبعد إعادة الإقلاع، وتحترم قرارك عندما توقف خدمة بنفسك للصيانة. أما on-failure فتناسب المهام التي يجب أن تنتهي، مثل ترحيل قاعدة البيانات Migration، حيث تريد إعادة المحاولة عند الفشل والتوقف عند النجاح. ولاحظ أن سياسات الإعادة لا تغني عن فحص الصحة: Docker يعيد ال Container عندما تموت عمليته، لا عندما يتوقف التطبيق عن الإجابة وهو حي.
متغيرات البيئة Environment Variables
الطريقة المعتادة لإعطاء التطبيق إعداداته داخل Container هي متغيرات البيئة، لأن نفس ال Image تعمل في التطوير والاختبار والإنتاج، والذي يتغير هو المتغيرات فقط، كما شرحنا في دليل متغيرات البيئة: تطبيق واحد لكل البيئات. ويعطيها Docker بطريقتين: -e لمتغير واحد، و--env-file لملف كامل:
printf 'APP_MODE=production\nDB_PASSWORD=s3cret-from-file\n' > app.env
docker run --rm -e TZ=UTC -e GREETING="hello world" --env-file app.env busybox:1.37 \
sh -c 'echo "$GREETING"; echo "mode=$APP_MODE"; env | sort | grep -vE "^(HOME|PATH|SHLVL|PWD|_)="'والمخرج سوف يكون كما يلي:
hello world
mode=production
APP_MODE=production
DB_PASSWORD=s3cret-from-file
GREETING=hello world
HOSTNAME=7712bc3db6ca
TZ=UTCكل المتغيرات وصلت، ومعها HOSTNAME الذي يضعه Docker تلقائياً وهو أول جزء من رقم ال Container. ولكن لنرى ما يحفظه Docker عن Container يعمل بنفس الملف:
docker run -d --name ct1-envleak --env-file app.env busybox:1.37 sleep 300
docker inspect ct1-envleak --format '{{json .Config.Env}}'والمخرج سوف يكون كما يلي:
["APP_MODE=production","DB_PASSWORD=s3cret-from-file","PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"]كلمة المرور مكتوبة كنص واضح في إعداد ال Container، ويراها كل من يستطيع تشغيل docker inspect، وتظهر في أي أداة مراقبة تقرأ إعدادات ال Containers، وفي /proc/1/environ داخل ال Container. وهذا لا يعني ألا تستخدم المتغيرات للأسرار أبداً، فأغلب ال Images الرسمية مثل PostgreSQL تطلب ذلك، ولكن اعرف أن من يملك الوصول إلى Docker يملك أسرارك، واجعل ملف .env بصلاحيات 600 وخارج Git. وللأسرار الحساسة استخدم ملفات تركبها للقراءة فقط وتقرؤها الصور الرسمية من المتغيرات المنتهية بـ _FILE مثل POSTGRES_PASSWORD_FILE، أو مدير أسرار كما في دليل إدارة الأسرار.
أساسيات الشبكة: لماذا لا يجد ال Container الآخر باسمه؟
شرحنا شبكات Docker بالتفصيل في دليل شبكات Docker وأفضل الممارسات، وهنا نكتفي بالمشكلة التي يقع فيها كل مبتدئ: تشغل قاعدة بيانات باسم db وتطبيقاً يتصل بـ db، فيفشل الاتصال. والسبب أن ال Containers التي تشغلها بلا --network تذهب إلى شبكة bridge الافتراضية، وهذه الشبكة لا تعرف أسماء ال Containers:
docker run -d --name ct1-db1 busybox:1.37 sleep 300
docker run --rm busybox:1.37 sh -c 'ping -c1 -W2 ct1-db1; echo "exit=$?"; grep nameserver /etc/resolv.conf'
docker network create ct1-net
docker run -d --name ct1-db2 --network ct1-net busybox:1.37 sleep 300
docker run --rm --network ct1-net busybox:1.37 sh -c 'ping -c1 -W2 ct1-db2; nslookup ct1-db2 | tail -3; grep nameserver /etc/resolv.conf'والمخرج سوف يكون كما يلي:
ping: bad address 'ct1-db1'
exit=1
nameserver 192.168.65.7
387dc972cf03801943fce41b82691f3ec75d496598efd0496ec9fccf3dfb805b
PING ct1-db2 (172.25.0.2): 56 data bytes
64 bytes from 172.25.0.2: seq=0 ttl=64 time=0.261 ms
Name: ct1-db2
Address: 172.25.0.2
nameserver 127.0.0.11في المخرج أعلاه لاحظ التالي:
- على الشبكة الافتراضية يسأل ال Container خادم DNS الخاص بالمضيف (هنا
192.168.65.7وهو عنوان Docker Desktop)، وهذا الخادم لا يعرف شيئاً اسمهct1-db1. - على الشبكة
ct1-netالتي أنشأناها صار عنوان DNS هو127.0.0.11، وهو خادم DNS داخلي يشغله Docker لكل شبكة يعرفها المستخدم، ويجيب باسم كل Container عليها، فوصلpingفي أقل من ثلث ملي ثانية. - هذا هو ما يفعله Compose لك تلقائياً: كل مشروع يأخذ شبكة خاصة، وكل خدمة تصل إلى الأخرى باسمها، كما يشرح توثيق شبكة bridge.

أوامر التنظيف Prune: ماذا يحذف كل أمر؟
مع الوقت يمتلئ قرص أي سيرفر يعمل عليه Docker بأشياء لا يحتاجها: Containers متوقفة من تجارب قديمة، وImages قديمة بعد كل تحديث، وطبقات بناء مؤقتة، وVolumes يتيمة. ويعطيك Docker أوامر Prune لحذفها، ولكل أمر نطاق مختلف يجب أن تعرفه قبل أن تكتبه، لأن بعض ما تحذفه لا يعود. وقبل أي تنظيف ابدأ بالأمر docker system df لترى أين تذهب المساحة، ولكن انتبه إلى أنه يحسب حجم كل الطبقات ويحتاج وقتاً على سيرفر كبير.
| الأمر | ما يحذفه | ما لا يحذفه | الخطر |
|---|---|---|---|
| docker container prune | كل Container متوقف | ال Containers التي تعمل | تضيع سجلات ال Containers المتوقفة ورموز خروجها وطبقاتها القابلة للكتابة |
| docker image prune | ال Images المعلقة Dangling بلا Tag | أي Image لها Tag | قليل |
docker image prune -a | كل Image لا يستخدمها Container موجود | ال Images المستخدمة | تحتاج سحبها من جديد، وقد لا تجد Tag قديماً حذفه الناشر |
| docker builder prune | ذاكرة البناء المؤقتة Build Cache | ال Images | البناء التالي أبطأ فقط |
| docker volume prune | ال Volumes المجهولة Anonymous غير المستخدمة | ال Volumes المسماة إلا مع -a | عال جداً مع -a: بيانات قاعدة متوقفة تضيع نهائياً |
| docker system prune | ال Containers المتوقفة والشبكات غير المستخدمة وال Images المعلقة وذاكرة البناء | ال Volumes إلا مع --volumes | يجمع كل ما سبق في أمر واحد، ومع -a --volumes يحذف كل شيء غير مستخدم الآن |
والكلمة الخطيرة في هذا الجدول «غير مستخدم»: Docker يعتبر أي شيء لا يرتبط بـ Container موجود الآن غير مستخدم. فإذا أوقفت مشروع Compose بالأمر docker compose down لصيانة، ثم كتبت docker system prune -a --volumes، فقد حذفت Images المشروع وبيانات قاعدة بياناته معاً. ولذلك هذه هي القواعد:
- لا تكتب أي أمر Prune على سيرفر إنتاج قبل أن تعرف ما سوف يحذفه، وكل هذه الأوامر تسألك تأكيداً، فلا تضف
-fفي سكربتات لا تفهمها. - لا تستخدم
--volumesولاvolume prune -aفي التنظيف الدوري أبداً، والسبب أن ال Volume المحذوف لا يعود إلا من نسخة احتياطية. - على جهاز مشترك احذف ما صنعته أنت بالاسم أو بالفلتر، مثل
docker rm $(docker ps -aq --filter name=ct1-)، أو ضع على أشياءك Label واحذف بها--filter label=project=x. - للتنظيف الدوري الآمن يكفي غالباً
docker image pruneوdocker builder pruneمع فلتر عمر مثل--filter until=168h.
وفي مختبرنا لم نشغل أي أمر Prune، لأن الجهاز عليه أعمال أخرى، وحذفنا ما صنعناه بالاسم كما في قسم حذف المختبر.
تشخيص Container لا يعمل: الترتيب الذي نتبعه
كل الأوامر السابقة تجتمع عندما يأتيك أحد ويقول «الخدمة متوقفة». والخطأ الشائع أن تبدأ بإعادة التشغيل، فتضيع الأدلة التي تخبرك لماذا توقفت. والترتيب التالي هو ما استخدمناه طوال المقال، وكل خطوة فيه تجيب عن سؤال واحد قبل أن تنتقل إلى التالي:
- هل ال Container موجود وما حالته؟
docker ps -a --filter name=.... إذا كانCreatedفالمشكلة قبل أن يبدأ البرنامج أصلاً، وإذا كانRestartingفهو في حلقة إعادة، وإذا كانExitedفانظر إلى الرمز بين القوسين. - ماذا قال التطبيق قبل أن يموت؟
docker logs --tail 50 --timestamps. في أغلب الحالات تجد السبب في آخر سطرين، كما وجدناhttpd: not found. - كيف مات؟
docker inspect --format '{{.State.ExitCode}} {{.State.OOMKilled}} {{.RestartCount}} {{.State.FinishedAt}}'. الرمز معOOMKilledيفرق بين خطأ في التطبيق ونفاد ذاكرة وقتل من الخارج، وRestartCountالكبير يعني أن المشكلة تتكرر منذ مدة. - ماذا فعل Docker به؟
docker events --since 30m --filter container=.... هنا تظهر الإشارات وأوقاتها كما رأينا مع مهلة الثلاث ثوان، ويظهر حدثoomإذا قتلته النواة. - هل يعمل البرنامج إذا شغلته بيدك؟
docker run --rm -it --entrypoint sh نفس-ال-Image، ثم شغل أمر البدء بنفسك داخل الـ Shell وراقب الخطأ. وهذه الخطوة لا تلمس ال Container الأصلي، فتبقى أدلته كما هي. - بعد أن تعرف السبب فقط، أصلحه ثم أعد إنشاء ال Container، ولا تكتف بـ
docker start، لأن الإصلاح غالباً في ال Image أو المتغيرات أو ال Volume، وكلها تحتاج إنشاءً جديداً.
وقد يتساءل البعض: لماذا لا أدخل بـ docker exec مباشرة؟ والإجابة أن exec يحتاج Container يعمل، وال Container الذي تشخصه غالباً متوقف أو يعيد نفسه كل ثانيتين، فلا تجد وقتاً للدخول إليه. ولذلك الخطوة الخامسة تشغل نسخة جديدة من نفس ال Image بأمر بدء مختلف، فتفحص نظام الملفات والمتغيرات والأذونات على راحتك. وإذا كان ال Container يعيد نفسه في حلقة فأوقف الحلقة أولاً بالأمر docker update --restart no حتى لا يملأ السجل، ثم شخص بهدوء، وهذا أفضل من حذفه لأن حذفه يحذف سجله معه.
وهذه الخطوات نفسها تعمل مع Compose، فكل خدمة في Compose Container عادي له اسم مثل project-service-1، وكل الأوامر السابقة تعمل عليه، إضافة إلى docker compose ps -a وdocker compose logs service التي تجمع المشروع كله في أمر واحد. وإذا كنت تفضل واجهة رسومية للمراقبة اليومية فـ Portainer يعرض نفس المعلومات من نفس المصدر، كما في دليل تثبيت Portainer لإدارة Docker، ولكن اعرف الأوامر أولاً، لأنها ما سوف تجده على كل سيرفر عندما لا تعمل الواجهة.
أخطاء شائعة Common Mistakes
- الظن أن ال Container لم يبدأ لأنه غير موجود في
docker ps: استخدمdocker ps -aثمdocker logs. - الاعتماد على حالة
Upكدليل على أن التطبيق يعمل: هي تعني أن العملية رقم 1 حية فقط. - كتابة السجلات في ملف داخل ال Container بدلاً من stdout، فلا يراها
docker logsوتملأ الطبقة القابلة للكتابة. - تطبيق لا يعالج SIGTERM مع
CMDبالشكل Shell: كل نشر ينتظر المهلة ثم يقتل التطبيق في منتصف عمله. - زيادة الذاكرة عند كل رمز 137 دون النظر إلى
OOMKilled، والسبب قد يكون مهلة الإيقاف لا الذاكرة. - نشر المنافذ بالشكل
-p 5432:5432لقاعدة بيانات لا يحتاجها أحد من الخارج، فتصبح مفتوحة على كل عناوين السيرفر. - تعديل ملفات داخل Container بالأمر
execونسيان أنها تضيع عند إعادة إنشائه. - الاعتماد على الشبكة الافتراضية ثم الاستغراب من فشل الاتصال بالاسم.
- تشغيل
docker system prune -a --volumesلتوفير المساحة على سيرفر فيه بيانات مهمة.
قائمة تحقق Checklist لكل Container جديد
- اسم واضح بالخيار
--name، وTag بإصدار محدد وليسlatest. - المنافذ منشورة على
127.0.0.1إلا ما يجب أن يصل إليه العالم فعلاً، وتأكدت بالأمرdocker port. - التطبيق يكتب سجلاته على stdout وstderr، وتدوير سجلات Docker مضبوط.
- العملية رقم 1 هي التطبيق نفسه (الشكل Exec أو
exec "$@")، أو tini بالخيار--init. - جربت
docker stopوقست وقته ورمز خروجه: 0 أو 143 في ثوان قليلة، وليس 137 بعد المهلة. - سياسة إعادة مناسبة:
unless-stoppedللخدمات، وon-failure:Nللمهام. - حد ذاكرة بالخيار
-mعلى أي سيرفر مشترك. - الأسرار في ملف بصلاحيات محدودة أو في ملفات
_FILE، مع العلم أنdocker inspectيعرض المتغيرات. - ال Containers التي تتحدث معاً على شبكة أنشأتها أنت.
- البيانات المهمة في Volume، لا في الطبقة القابلة للكتابة.
حذف المختبر Cleanup
كل ما صنعناه يبدأ بالبادئة ct1-، فحذفناه بالاسم دون أن نلمس شيئاً آخر على الجهاز:
docker rm -f $(docker ps -aq --filter name=ct1-)
docker network rm ct1-net
rm -f app.env page2.html index-from-container.htmlالخلاصة
وصلنا لنهاية الموضوع، وأهم ما فيه:
docker runيساويcreateثمstart، وdocker psلا يعرض ال Containers المتوقفة، فابدأ أي تشخيص بـps -aثمlogs.- حالة
Upلا تعني أن التطبيق يعمل: Container من Alpine 3.24 ظهرUpثم خرج برمز 127 لأنhttpdلم يعد في BusyBox. - الرموز أقل من 128 من البرنامج، و137 تعني SIGKILL من نفاد الذاكرة أو انتهاء المهلة، و143 تعني SIGTERM.
- العملية رقم 1 لا تصلها SIGTERM إلا إذا عالجتها:
sleepاحتاجت 12.3 ثانية ورمز 137، ومع--initاحتاجت 1.2 ثانية ورمز 143، والسكربت الذي يعالج الإشارة خرج برمز 0 في 2.5 ثانية. --initلا يصلح برنامجاً يتجاهل الإشارة بنفسه، والحل الحقيقي معالج SIGTERM في كل تطبيق.- المهلة الافتراضية يحددها المحرك، وكانت على Docker Desktop عندنا 3 ثوان وليس 10.
unless-stoppedللخدمات وon-failure:Nللمهام، ومتغيرات البيئة تظهر كاملة فيdocker inspect.- الأسماء تعمل على الشبكات التي تنشئها أنت فقط، وأوامر Prune تحذف كل ما ليس له Container الآن، فلا تستخدم
--volumesفي التنظيف الدوري.
وفي المقال التالي بإذن الله سوف نتحدث عن البيانات: أين تذهب ملفات ال Container، والفرق بين Volumes وBind Mounts، والنسخ الاحتياطي. وهذه مقالات مرتبطة:
دليلما هي ال Containers؟ الفرق بينها وبين الأجهزة الافتراضيةنفتح Container حقيقياً من الخارج ثم نبني واحداً بأيدينا بـ unshare وchroot وcgroup v2، لنفهم ما الذي يعزله فعلاً وأين تقف حدوده أمام الجهاز الافتراضي.
دليلتثبيت Docker Engine وCompose على Ubuntuكيف تثبت Docker على Ubuntu من المستودع الرسمي، وتضبطه من البداية حتى لا يمتلئ القرص أو تنكشف منافذك للإنترنت.
دليلبيانات ال Containers: Volumes وBind Mounts والنسخ الاحتياطيأين تذهب ملفات ال Container وما الذي يحذفها، مع قياس حقيقي لسرعة مسارات Windows وLinux ونسخة احتياطية مستعادة لملفات Volume وقاعدة PostgreSQL.
دليلشبكات Docker وأفضل الممارسات مع Docker Composeلماذا يبقى المنفذ الذي تنشره في Compose مفتوحاً للإنترنت رغم ufw، وكيف تصل التطبيقات إلى بعضها عبر شبكات Docker دون نشر منافذ.
دليلكتابة Dockerfile صحيح: Multi-stage وLayer Cachingخمس نسخ من Dockerfile للتطبيق نفسه نزلت بال Image من 641 ميجابايت إلى 66 وبالبناء بعد تعديل سطر من خمس دقائق إلى أقل من أربع ثوان، مع شرح كل سطر والأرقام المقاسة.
دليلأفضل الممارسات Best Practices في ملفات Docker Composeكيف تكتب ملف Compose يبدأ خدماته بالترتيب الصحيح ويحمي كلمات المرور ويضبط الذاكرة ويفصل التطوير عن الإنتاج، مع تجربة أظهرت أين يخدعك كل إعداد افتراضي.
دليلإدارة الخدمات Services والسجلات Logs مع systemdننقل واجهة برمجية من nohup إلى خدمة systemd تعود وحدها بعد التوقف والإقلاع، ونقرأ سجلاتها مع journalctl، ونرى ثلاث مشاكل حقيقية واجهتنا في الطريق.
دليلتثبيت Portainer لإدارة Docker من المتصفحكيف تدير ال Containers على سيرفر واحد أو عدة سيرفرات من المتصفح مع Portainer، بدل كتابة الأوامر في كل مرة.سجل التحديثات
- 18 نوفمبر 2026: كتابة الدليل، وتنفيذ التجارب على Docker Engine 29.8.0 (Docker Desktop على WSL2، containerd v2.3.5، runc 1.5.1، docker-init 0.19.0) مع busybox:1.37 وalpine:3.24.