Docker Container'a Port Nasıl Açılır ve Yönlendirilir?
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
- hostPort:containerPort — en yaygın kullanım:
-p 8080:80 - 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. - IP:hostPort:containerPort — yönlendirmeyi belirli bir arayüze kısıtlar:
-p 127.0.0.1:8080:80yalnızca sunucu üzerindeki yerel erişime açar. Ters proxy arkasında çalışan uygulamalar için idealdir. - hostPort:containerPort/udp — UDP servisleri için:
-p 53:53/udp - Port aralığı —
-p 7000-7005:7000-7005gibi 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:
- 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
portssatırını ekleyipup -dyapmak yeterlidir. - İ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.
- Socat ile köprü:
socat TCP-LISTEN:8080,fork TCP:172.17.0.2:80gibi 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/tcpile 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.1adresini dinliyorsa dış yönlendirme çalışmaz. Uygulamayı0.0.0.0dinlemeye 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 8080ile portu kimin kullandığını bulun. - Yanlış port yönü:
-p 80:8080ile-p 8080:80birbirinin tersidir. Sıra daima host:container şeklindedir — bu karışıklık saatlerce vakit kaybına yol açar. - Conflicting ayarlar:
network_mode: hostkullanan container'larda-pyok 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:8080veya tarayıcıdan test edin; erişilemiyorsa firewall/güvenlik grubunu kontrol edin. iptables -t nat -L DOCKER -nile 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.