0
DockerResmî

Docker Container'a Port Nasıl Açılır ve Yönlendirilir?

Mustafa G.·18 Kasım 20263

VPS üzerinde Docker ile çalışmaya başlayan hemen herkesin karşılaştığı ilk sorun aynıdır: container içinde sorunsuz çalışan uygulama, dışarıdan erişilemiyor. Uygulamanız 8080 portunu dinliyor olabilir ama tarayıcıdan sunucu IP'sine gittiğinizde sayfa açılmıyorsa, suçlu genellikle eksik port yönlendirmesidir. Docker container'lar varsayılan olarak kendi izole ağlarında yaşar; dış dünyaya ancak siz köprü kurduğunuzda açılır.

Bu yazıda container'lara port açmanın tüm yollarını, -p ve -P parametrelerinin farkını, docker-compose tarafındaki eşdeğerini ve en sık yapılan hataları örnek komutlarla anlatacağım.

Container ağı ve port yönlendirme mantığı

Docker her container'ı varsayılan olarak bridge adlı sanal ağa yerleştirir. Container kendi IP'sini alır (örneğin 172.17.0.2) ama bu IP yalnızca sunucunun içinden erişilebilir. Dışarıdan bir istemcinin uygulamaya ulaşabilmesi için, sunucunun fiziksel arayüzündeki bir portun container içindeki porta yönlendirilmesi gerekir. Bunu yapan katman Docker'ın NAT (DNAT) kurallarıdır — yani aslında arka planda iptables kuralları otomatik eklenir.

Bu detay önemli, çünkü "portu açtım ama hâlâ erişemiyorum" sorunlarının bir kısmının sebebi, sunucu tarafındaki firewall'un (firewalld, ufw, cloud security group) bu yönlendirmeyi engellemesidir. Buna ileride ayrıca değineceğim.

docker run ile port yayınlama: -p parametresi

Container'ı başlatırken -p (publish) parametresiyle yönlendirme tanımlarsınız. Temel kalıp şöyledir:

docker run -d -p 8080:80 nginx

Bu komut, sunucunun 8080 portuna gelen tüm istekleri container'ın 80 portuna iletir. Artık http://SUNUCU_IP:8080 adresinden nginx'e erişebilirsiniz.

-p parametresinin yazım biçimleri

  1. hostPort:containerPort — en yaygın kullanım: -p 8080:80
  2. containerPort — -p 80: Docker host üzerinde rastgele (ephemeral) bir port seçer ve o porta yönlendirir. docker ps çıktısından hangi port atandığını görürsünüz.
  3. IP:hostPort:containerPort — yönlendirmeyi belirli bir arayüze kısıtlar: -p 127.0.0.1:8080:80 yalnızca sunucu üzerindeki yerel erişime açar. Ters proxy arkasında çalışan uygulamalar için idealdir.
  4. hostPort:containerPort/udp — UDP servisleri için: -p 53:53/udp
  5. Port aralığı — -p 7000-7005:7000-7005 gibi birden fazla portu tek seferde açar.

Birden fazla port için parametreyi tekrarlayabilirsiniz:

docker run -d -p 80:80 -p 443:443 -p 22:2222 myapp

-p ve -P arasındaki fark

-P (büyük harf) container imajında EXPOSE ile tanımlanmış tüm portları host üzerinde rastgele portlara yayınlar. Hızlı test için pratiktir ama üretimde hangi uygulamanın hangi portta olduğunu takip etmek zorlaştığı için genellikle açık -p tanımlaması tercih edilir.

Çalışan bir container'ın port durumunu görmek için:

docker port KONTAINER_ADI

veya daha genel bakış için:

docker ps — çıktıda 0.0.0.0:8080->80/tcp gibi bir satır görüyorsanız yönlendirme aktif demektir.

docker-compose ile port yönlendirme

Üretimde çoğu kurulum docker-compose ile yönetilir. docker-compose.yml dosyasında ports bölümü, komut satırındaki -p ile birebir aynı işi yapar:

services: web: image: nginx ports: - "8080:80" - "127.0.0.1:5432:5432" restart: unless-stopped

Küçük bir dikkat noktası: YAML'da "3306:3306" gibi port eşlemelerini tırnak içine almak iyi bir alışkanlıktır; tırnaksız yazılan bazı sayı biçimleri (örneğin dakika:saniye görünümüne benzeyen değerler) YAML tarafından başka bir formata çevrilebilir ve garip hatalara yol açar.

Dosyayı düzenledikten sonra değişikliği uygulamak için:

docker compose up -d

Çalışan bir container'a sonradan port ekleme

Docker'da çalışan bir container'a sonradan -p eklemenin doğrudan bir yolu yoktur — port yönlendirmeleri container başlatılırken atanır. Üç seçeneğiniz var:

  1. Container'ı yeniden oluşturun (önerilen): Veri kaybını önlemek için volume kullanın, sonra container'ı doğru parametrelerle yeniden başlatın. Compose kullanıyorsanız ports satırını ekleyip up -d yapmak yeterlidir.
  2. İptables ile manuel yönlendirme: Acil müdahale için host'ta kural ekleyebilirsiniz, ancak bu kurallar Docker'ın kendi yönetimiyle karışabilir ve restart sonrası kaybolur. Kalıcı çözüm olarak önerilmez.
  3. Socat ile köprü: socat TCP-LISTEN:8080,fork TCP:172.17.0.2:80 gibi bir komutla geçici bir tünel açabilirsiniz. Yine geçici bir önlem.

Deneyimli kullanıcının önerisi basit: veriyi volume'da tutun, container'ı yeniden yaratmaktan korkmayın.

"Portu açtım ama erişemiyorum": sık yapılan hatalar

Sahada en çok gördüğümüz sorunlar ve kontroller:

  • Firewall engeli: Docker NAT kuralları eklese de ufw veya firewalld bazen trafiği yine engeller. ufw allow 8080/tcp ile portu açın. Cloud paneli olan VPS'lerde güvenlik duvarı (security group / firewall) kuralını panel tarafında da eklemeyi teyit edin.
  • Uygulama 0.0.0.0 yerine 127.0.0.1 dinliyor: Container içindeki uygulama 127.0.0.1 adresini dinliyorsa dış yönlendirme çalışmaz. Uygulamayı 0.0.0.0 dinlemeye zorlayın (çoğu framework'te host parametresiyle yapılır).
  • Port zaten kullanımda: Host'ta aynı portu başka bir servis tutuyorsa container başlamaz: "bind: address already in use". ss -tulpn | grep 8080 ile portu kimin kullandığını bulun.
  • Yanlış port yönü: -p 80:8080 ile -p 8080:80 birbirinin tersidir. Sıra daima host:container şeklindedir — bu karışıklık saatlerce vakit kaybına yol açar.
  • Conflicting ayarlar: network_mode: host kullanan container'larda -p yok sayılır; host ağında port yayınlama kavramı yoktur, uygulama doğrudan host portlarını kullanır.

Port yayınlamadan erişim: reverse proxy yaklaşımı

Birden fazla container çalıştıran sunucularda her uygulamayı ayrı bir host portuna açmak yerine, tek bir reverse proxy (nginx veya Traefik) üzerinden alan adına göre yönlendirme yapmak daha temiz bir mimaridir. Bu senaryoda container'ları hiç host portuna yayınlamayabilirsiniz; yalnızca proxy'i container'larla aynı Docker ağına ekleyip iç ağdan erişirsiniz:

docker network create webnet docker run -d --network webnet --name myapp myimage docker run -d --network webnet -p 80:80 -p 443:443 nginx

Proxy'nin nginx yapılandırmasında proxy_pass http://myapp:3000; gibi container adıyla iç ağ üzerinden yönlendirme yaparsınız. Bu yöntem hem port karmaşasını önler hem de TLS sonlandırmasını tek noktada toplar.

Kapatma ve doğrulama kontrol listesi

Port açma işlemini tamamladıktan sonra şu hızlı kontrolleri yapın:

  • docker ps çıktısında yönlendirme satırını görün: 0.0.0.0:8080->80/tcp
  • Sunucu üzerinde: curl localhost:8080 — çalışıyorsa sorun ağ tarafındadır.
  • Dışarıdan: curl -I http://SUNUCU_IP:8080 veya tarayıcıdan test edin; erişilemiyorsa firewall/güvenlik grubunu kontrol edin.
  • iptables -t nat -L DOCKER -n ile Docker'ın DNAT kurallarının eklendiğini teyit edebilirsiniz.
  • Gereksiz portları açık bırakmayın; özellikle veritabanı container'larını yalnızca 127.0.0.1 üzerinden veya Docker ağı içinde yayınlayın.

Kısacası doğru formül üç parçadan oluşur: uygulama 0.0.0.0 dinlesin, container doğru -p veya compose ports tanımıyla başlatılsın, sunucu ve panel firewall'unda ilgili port açık olsun. Bu üçünü sırayla doğruladığınızda port sorunlarının neredeyse tamamı çözülür.

0 cevap

Henüz cevap yok — ilk cevabı siz verin

Cevap yazmak için giriş yapmalısınız

Giriş Yap