نام سرویس، شبکه مشترک، پورت داخلی و resolver کانتینر باید جدا بررسی شوند. این راهنما عیبیابی را از lookup تا اتصال TCP و پاسخ برنامه پیش میبرد.
دامنه و پیشنیازها
در Compose معمولاً نام service روی شبکه پروژه قابل resolve است. شبکه bridge پیشفرض با شبکه user-defined رفتار یکسانی ندارد. مثال web و db فرضیاند؛ دیتابیس را برای ارتباط داخلی روی اینترنت publish نکنید. ابزارهای تشخیص ممکن است در image مینیمال موجود نباشند.
۱. شواهد را جمعآوری کنید
شبکههای هر دو کانتینر را با inspect مقایسه کنید؛ وجود alias بدون شبکه مشترک کافی نیست. /etc/resolv.conf را از داخل کانتینر بخوانید. در شبکه سفارشی، resolver داخلی Docker معمولاً 127.0.0.11 است. DNS نامهای بیرونی به resolverهای میزبان forward میشود و مسیر جداگانهای دارد.
docker inspect --format "{{json .NetworkSettings.Networks}}" web
docker inspect --format "{{json .NetworkSettings.Networks}}" db
docker exec web cat /etc/resolv.conf
۲. تغییر کنترلشده
شبکه مشترک را در فایل declarative پروژه اصلاح کنید، نه با اتصال موقت و فراموششدنی. برنامه باید به db:3306 وصل شود، نه localhost یا پورت publishشده میزبان. localhost داخل web به خود web اشاره دارد. /etc/hosts با IP ثابت کانتینر راهحل پایدار نیست؛ IP پس از recreate تغییر میکند.
# Merge network membership into the existing compose file.
services:
web:
networks: [backend]
db:
networks: [backend]
networks:
backend: {}
۳. نتیجه را آزمایش کنید
lookup موفق فقط IP میدهد؛ با nc یا ابزار موجود، TCP را جدا آزمایش کنید. اگر TCP باز است ولی برنامه خطا میدهد، سراغ TLS، credential و مجوز دیتابیس بروید. آزمون بیرونی مانند example.com را جدا اجرا کنید؛ موفقیت DNS عمومی سلامت discovery داخلی را ثابت نمیکند.
# Commands require getent/nc in the diagnostic environment.
docker exec web getent hosts db
docker exec web nc -vz -w 3 db 3306
docker exec web getent hosts example.com
بازگشت و پیشگیری
برای بازگشت، تغییر فایل Compose را برگردانید و فقط سرویس متأثر را rollout کنید. شبکه مورد استفاده سرویسهای دیگر را حذف نکنید. در عیبیابی Resolver عمومی، 127.0.0.1 داخل کانتینر Resolver میزبان نیست. DNS timeout، پاسخ NXDOMAIN و Connection Refused را در لاگ به خطاهای جدا تبدیل کنید.
برای بررسی بخشهای مرتبط این مسیر، راهنماهای Healthcheck در Docker؛ تفاوت Running و Healthy و Split DNS با BIND؛ پاسخ داخلی و عمومی برای یک دامنه را نیز ببینید.
