Bir uygulama ana bilgisayarda çalışırken veritabanına localhost ile bağlanıyor, container içinde çalıştırıldığında bağlantı hatası veriyor olabilir. Container ağında localhost çoğunlukla o container'ın kendi bağlamını ifade eder. Aynı metin farklı çalışma yerlerinde farklı hedef anlamına gelir. Sorunun başlangıcı adresin doğru görünmesi değil, bağlantıyı başlatan işlemin nerede çalıştığını belirlemektir.

Çalışma bağlamını çıkarın

Uygulama, veritabanı ve proxy'nin host üzerinde mi yoksa ayrı container'larda mı olduğunu yazın. Docker ağ ve yayınlanan port bilgilerini salt okunur inceleyin. docker container port ilgili container'ın port eşlemelerini gösterir. Container içindeki hizmet portu ile host tarafında yayınlanan port aynı olmak zorunda değildir. Kullanılan Docker modu ve işletim sistemi davranışı etkileyebilir.

Örnek: ayrı iki hizmet

Web uygulaması ve veritabanı farklı container'larda olsun. Web uygulamasındaki localhost bağlantısı kendi içine gider; diğer container'a otomatik yönlenmez. Desteklenen ortak ağ ve hizmet adı çözümlemesi kullanılabilir. Buna karşılık veritabanını bütün yerel ağa yayınlamak gerekmeyebilir. Çözüm hedefi düzeltirken erişim yüzeyini gereksiz büyütmemelidir. Bağlantı bilgisindeki gizli değerler günlükte görünmemelidir.

Ayrıştırıcı test

Önce hedef hizmetin kendi ortamında dinlediğini doğrulayın. Ardından bağlantıyı gerçekten sorun yaşayan container bağlamından deneyin. Host tarayıcısından başarılı sonuç almak bu ikinci yolu doğrulamaz. DNS, ağ üyeliği ve portu ayrı kontrol edin. Hizmetin hazır olmadan istemcinin başlaması da aynı bağlantı hatasını verebilir; zaman ilişkisini inceleyin. Başlatma sırası ile kalıcı ağ sorunu karıştırılmamalıdır.

Düzeltme ve geri dönüş

Yapılandırmayı sürüm kontrollü biçimde değiştirin; çalışan örneklerin gizli değerlerini kopyalamayın. Gereksiz geçici port yayını açıldıysa kapatın. Kabul testi normal uygulama başlangıcı ve gerçek sorguyla yapılmalıdır. Rapor kaynak çalışma bağlamını, hedef hizmet adını ve portu açıkça gösterdiğinde aynı localhost yanılgısı başka ortama taşınmaz.

Kaynak ve ilgili okuma

Birincil kaynak: Docker Docs — Networking overview. Kontrol tarihi: 11 Ekim 2026. Senaryolar açıklayıcı örneklerdir; gerçek test sonucu olarak sunulmaz.

Başlangıç için Windows ağ teşhisi rehberine, düzenli kontrol için ağ bakım listesine bakın.