Docker ve Docker Compose kurulumu: güvenlik duvarını aşan port tuzağına dikkat
Bu rehberde Docker Engine'i ve Compose eklentisini Ubuntu, Debian ve AlmaLinux'ta Docker'ın resmi deposundan kuracak, ilk Compose projenizi çalıştıracak ve çoğu kişinin geç fark ettiği bir açığı kapatacaksınız: yayımlanan kapsayıcı (container) portları, UFW ya da firewalld kurallarınıza takılmadan internete açılır.
Kurulumdan önce: neden resmi depo?
Ubuntu ve Debian depolarındaki docker.io paketi çoğu zaman Docker'ın güncel sürümünün gerisinde kalır; Compose v2 eklentisi de farklı paketlenir. Docker'ın belgelediği yöntem, download.docker.com deposunu imza anahtarıyla ekleyip docker-ce paketlerini oradan kurmaktır. Böylece güvenlik düzeltmeleri dağıtımın takvimini beklemeden gelir.
- Sürüm: Docker'ın desteklediği dağıtım sürümlerini resmi kurulum belgesinden kontrol edin. Yeni bir kurulum için Ubuntu 24.04 veya 26.04 LTS, Debian 12 veya 13 ya da AlmaLinux 9 seçin; Ubuntu 24.10 ve 25.04 gibi ara sürümlerin desteği kısa sürer.
- Geri dönüş noktası: İçinde veri bulunan bir sunucuya kuruyorsanız önce müşteri panelindeki Anlık Görüntüler aracıyla bir anlık görüntü (snapshot) alın. Aynı anda en fazla 2 snapshot tutulabilir ve snapshot yedeğin yerine geçmez (snapshot rehberi).
- Yetki: Komutlar root olarak çalıştırıldığı varsayılarak yazıldı. Sudo yetkili bir kullanıcıyla çalışıyorsanız komutların başına
sudoekleyin; depo satırındaki| teekısmını da| sudo teeolarak yazın.
Daha önce dağıtım paketleriyle Docker kurduysanız çakışmayı önlemek için önce onları kaldırın. Bu işlem /var/lib/docker altındaki imajları, container'ları ve volume'leri silmez:
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do apt-get remove $pkg; doneKurulum: Ubuntu, Debian ve AlmaLinux
Ubuntu ve Debian'da deponun imza anahtarı /etc/apt/keyrings altına indirilir, depo satırı sunucunun mimarisi ve sürüm kod adıyla yazılır, ardından Engine (docker-ce), istemci, containerd, Buildx ve Compose eklentisi kurulur.
Ubuntu
apt-get update
apt-get install -y ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
tee /etc/apt/sources.list.d/docker.list > /dev/null
apt-get update
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginDebian
Debian'da yalnızca depo adresi değişir ve sürüm kod adı doğrudan VERSION_CODENAME değişkeninden okunur:
apt-get update
apt-get install -y ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
tee /etc/apt/sources.list.d/docker.list > /dev/null
apt-get update
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginBu iki dağıtımda Docker hizmeti kurulumun ardından kendiliğinden başlar ve açılışta etkin gelir.
AlmaLinux 9
RHEL ailesinde Docker'ın rhel deposu kullanılır. Podman veya runc kuruluysa Docker paketleriyle çakıştığı için önce kaldırılır; kurulu olmayan paketler için görülen "No match for argument" uyarısı normaldir.
dnf remove docker docker-client docker-client-latest docker-common docker-latest \
docker-latest-logrotate docker-logrotate docker-engine podman runc
dnf -y install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now dockerKurulum sırasında dnf, Docker'ın GPG anahtarını onaylamanızı ister; ekrandaki parmak izini resmi belgedekiyle karşılaştırın, eşleşmiyorsa durun. RHEL ailesinde hizmet kendiliğinden başlamaz; son satır hem başlatır hem açılışta etkinleştirir.
Doğrulama ve docker grubu
systemctl status docker --no-pager
docker run --rm hello-world
docker compose version
docker info --format '{{.ServerVersion}} {{.LoggingDriver}} {{.CgroupDriver}}'hello-world container'ı "Hello from Docker!" iletisini yazıp kapanıyorsa Engine, imaj indirme ve container ağı çalışıyor demektir.
Bir kullanıcıyı docker grubuna eklemek, ona parola sormadan root yetkisi vermekle eşdeğerdir: bu kullanıcı sunucunun kök dizinini bir container'a bağlayıp her dosyayı değiştirebilir. Grubu yalnızca root yetkisi vermeye hazır olduğunuz hesaplara verin; birden çok kişinin çalıştığı sunucularda Docker'ın güvenlik belgesindeki rootless kipini değerlendirin.
usermod -aG docker deploy
# deploy kullanıcısı oturumu kapatıp yeniden açtıktan sonra:
id deploy
docker run --rm hello-worldİlk Compose projesi: WordPress ve MariaDB
Aşağıdaki örnekte üç karar bilinçli olarak verildi. Web container'ı yalnızca 127.0.0.1 adresine yayımlanır ve dışarıya sunucudaki Nginx üzerinden açılır. Veritabanının hiç ports satırı yoktur. Veri, container silinse de kalan adlandırılmış volume'lerde (named volume) tutulur. restart: unless-stopped ilkesi sunucu yeniden başladığında container'ları geri getirir, sizin elle durdurduklarınızı ise durdurulmuş bırakır.
Önce proje dizinini ve parolaları tutan .env dosyasını oluşturun. Onaltılık (hex) parola kullanmak, Compose'un parolanın içindeki $ karakterini değişken sanması gibi sorunları önler:
mkdir -p /opt/wordpress && cd /opt/wordpress
printf 'DB_PASSWORD=%s\nDB_ROOT_PASSWORD=%s\n' "$(openssl rand -hex 24)" "$(openssl rand -hex 24)" > .env
chmod 600 .envArdından /opt/wordpress/compose.yaml dosyasını oluşturun. Compose v2'de dosyanın başına version: satırı yazmanız gerekmez; yazarsanız "obsolete" uyarısı alırsınız.
services:
db:
image: mariadb:11.4
restart: unless-stopped
environment:
MARIADB_DATABASE: wordpress
MARIADB_USER: wordpress
MARIADB_PASSWORD: ${DB_PASSWORD}
MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
volumes:
- db_data:/var/lib/mysql
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 5
start_period: 30s
# ports satırı yok: veritabanına yalnızca bu projedeki container'lar erişir
wordpress:
image: wordpress:latest
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
WORDPRESS_DB_HOST: db
WORDPRESS_DB_NAME: wordpress
WORDPRESS_DB_USER: wordpress
WORDPRESS_DB_PASSWORD: ${DB_PASSWORD}
ports:
- "127.0.0.1:8080:80" # yalnızca sunucunun kendisi erişebilir
volumes:
- wp_data:/var/www/html
volumes:
db_data:
wp_data:cd /opt/wordpress
docker compose config --quiet && docker compose up -d
docker compose ps
docker compose logs --tail=50 wordpress
curl -I http://127.0.0.1:8080Veritabanı imajında ana sürümü sabitleyin (örnekte 11.4): ana sürüm atlamak veri dizininin yükseltilmesini gerektirebilir ve bunun sıradan bir pull ile habersizce olmasını istemezsiniz. Üretimde uygulama imajı için de latest yerine belirli bir sürüm etiketi tercih edin.
Port tuzağı: yayımlanan portlar güvenlik duvarını neden aşar?
Compose dosyasına "8080:80" yazdığınızda Docker, iptables'ın nat tablosuna bir hedef adres çevirisi (DNAT) kuralı ekler. Sunucuya 8080 portundan gelen paket, yönlendirme kararı verilmeden önce container'ın iç adresine çevrilir; artık sunucunun kendisine gelen değil, container'a yönlendirilen trafik sayılır ve INPUT zinciri yerine FORWARD zincirinden geçer. UFW kurallarınız INPUT zincirinde durduğu için devreye girmez; firewalld'da sunucu hizmetleri için tanımladığınız bölge (zone) kuralları da bu trafiği durdurmaz. Sonuç olarak ufw status çıktısında 8080 kapalı görünür ama port internetten erişilebilir. Bu durum veritabanları (3306, 5432), Redis (6379) ve yönetim arayüzleri için özellikle tehlikelidir.
| Compose yazımı | Kim erişebilir? | Güvenlik duvarı etkisi |
|---|---|---|
"8080:80" | Sunucunun tüm adresleri üzerinden herkes | UFW ve firewalld kuralları uygulanmaz |
"127.0.0.1:8080:80" | Yalnızca sunucunun kendisi (Nginx, SSH tüneli) | Dışarıdan erişim yok |
"203.0.113.20:8080:80" | Yalnızca o adres üzerinden herkes (ör. bir ek IP) | Yine UFW ve firewalld kurallarını aşar |
ports satırı yok | Yalnızca aynı Docker ağındaki container'lar | Sunucunun dışına açılmaz |
Çözüm 1: Yalnızca yerel adrese yayımlayın, dışarıya Nginx ile açın
Örnekteki 127.0.0.1:8080:80 yazımı portu yalnızca sunucunun geri döngü (loopback) adresinde açar. Siteyi dışarıya sunucuda çalışan Nginx ters vekil (reverse proxy) olarak yayınlar; böylece güvenlik duvarında yalnızca 80 ve 443 portlarını bilinçli olarak açar, TLS sertifikasını da tek yerde yönetirsiniz. Nginx kurulumu için LEMP rehberine, sertifika için Let's Encrypt rehberine bakın. Aşağıdaki yapılandırmayı Ubuntu ve Debian'da /etc/nginx/sites-available/wordpress, AlmaLinux'ta /etc/nginx/conf.d/wordpress.conf olarak kaydedin:
server {
listen 80;
server_name example.com www.example.com;
client_max_body_size 64m;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}# Ubuntu/Debian: /etc/nginx/sites-available/wordpress dosyasını etkinleştirin
ln -s /etc/nginx/sites-available/wordpress /etc/nginx/sites-enabled/wordpress
nginx -t && systemctl reload nginx
curl -I -H 'Host: example.com' http://127.0.0.1Çözüm 2: Veritabanı portlarını hiç yayımlamayın
Aynı Compose projesindeki container'lar ortak bir iç ağda servis adıyla birbirine ulaşır; WordPress veritabanına db:3306 üzerinden bağlanır ve bunun için hiçbir port yayımlamanız gerekmez. Bakım için docker compose exec db mariadb -u root -p komutunu kullanın. Bilgisayarınızdaki bir veritabanı istemcisiyle bağlanmanız gerekiyorsa portu yalnızca 127.0.0.1:3306:3306 olarak yayımlayın ve SSH tüneli açın: ssh -L 3307:127.0.0.1:3306 root@SUNUCU_IP. Ardından istemcide 127.0.0.1:3307 adresine bağlanın.
Çözüm 3: Açık kalması gereken portu DOCKER-USER zinciriyle süzün
Bir portun dışarıya açık kalması ama yalnızca belirli adreslerden erişilmesi gerekiyorsa kuralı, Docker'ın kendi kurallarından önce işlenen DOCKER-USER zincirine ekleyin. --ctorigdstport adres çevrilmeden önceki sunucu portunu eşleştirir; --ctdir ORIGINAL ise container'ların kendi başlattığı bağlantıların dönüş trafiğinin etkilenmemesini sağlar.
# Varsayılan rotanın çıktığı dış arayüzü bulun (ör. ens160)
IFACE=$(ip route show default | awk '{print $5; exit}')
# 8080 portuna yalnızca 203.0.113.10 adresi erişebilsin
iptables -I DOCKER-USER -i "$IFACE" -p tcp -m conntrack --ctorigdstport 8080 --ctdir ORIGINAL ! -s 203.0.113.10 -j DROP
iptables -L DOCKER-USER -n -v --line-numbersBu kural sunucu yeniden başlatıldığında kaybolur ve kalıcı hale getirmek ek yapılandırma ister; bu yüzden önce Çözüm 1'i tercih edin. /etc/docker/daemon.json dosyasına "iptables": false yazmak sorunu çözüyor gibi görünse de container'ların ağ erişimini ve port yönlendirmesini bozar; bu yolu önermiyoruz.
Doğrulama: içeriden ve dışarıdan test edin
# Sunucuda: hangi port hangi adreste dinleniyor?
ss -tulpn | grep -E ':(80|443|8080|3306)\s'
docker compose ps
# Sunucunun dışındaki başka bir Linux veya macOS makineden:
nc -vz -w 3 SUNUCU_IP 8080
nc -vz -w 3 SUNUCU_IP 3306
nc -vz -w 3 SUNUCU_IP 443ss çıktısında 127.0.0.1:8080 görmelisiniz; 0.0.0.0:8080 görüyorsanız port herkese açıktır. Dışarıdan yapılan testte 8080 ve 3306 için reddedilen bağlantı ya da zaman aşımı, 443 için başarılı bağlantı beklenir. Windows bilgisayardan aynı testi PowerShell'de Test-NetConnection SUNUCU_IP -Port 8080 ile yapabilirsiniz. Sunucudaki güvenlik duvarı kuralları için UFW ve firewalld rehberine bakın.
Bakım: günlük sınırı, güncelleme ve yedek
Günlük dosyalarının diski doldurmasını önleyin
Docker varsayılan olarak json-file günlük sürücüsünü boyut sınırı olmadan kullanır; çok kayıt üreten bir container'ın günlüğü /var/lib/docker/containers/ altında gigabaytlara ulaşabilir. Sınırı Docker hizmetinin genel ayar dosyası olan /etc/docker/daemon.json ile koyun. Dosya zaten varsa mevcut anahtarları koruyarak ekleyin:
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}dockerd --validate --config-file=/etc/docker/daemon.json
systemctl restart docker
cd /opt/wordpress && docker compose up -d --force-recreate
docker inspect --format '{{.HostConfig.LogConfig}}' wordpress-wordpress-1Bu ayar yalnızca yeni oluşturulan container'lara uygulanır; mevcut container'lar için --force-recreate gerekir. Docker hizmetini yeniden başlatmak çalışan container'ları kısa süreliğine durdurur, bu yüzden işlemi trafiğin az olduğu bir saatte yapın. Dosyadaki tek bir yazım hatası Docker'ın hiç başlamamasına yol açar; yeniden başlatmadan önce dockerd --validate ile denetleyin.
Disk zaten dolduysa disk doldu rehberindeki adımlarla başlayın.
Güncelleme ve temizlik
İmajlarınızı düzenli olarak güncelleyin. pull yeni imajları indirir; up -d yalnızca imajı değişen container'ları yeniden oluşturur ve volume'lerdeki veri korunur:
cd /opt/wordpress
docker compose pull
docker compose up -d
docker image prune -f
docker system dfdocker image prune yalnızca etiketi kalmamış (dangling) imajları siler; -a bayrağı hiçbir container'ın kullanmadığı tüm imajları siler. docker system df imajların, container'ların ve volume'lerin kapladığı yeri gösterir. docker volume prune ve docker system prune --volumes komutlarını, silinecek volume'leri docker volume ls ile görmeden çalıştırmayın.
Docker Engine işletim sistemi paketleriyle güncellenir (apt-get upgrade veya dnf upgrade) ve güncelleme container'ları yeniden başlatır. Ubuntu ve Debian'da unattended-upgrades varsayılan yapılandırmada yalnızca dağıtımın kendi depolarını izler; Docker deposundaki paketleri siz güncellersiniz (otomatik güvenlik güncellemeleri).
Volume'leri yedekleyin
Volume'ler, snapshot'tan bağımsız ve sunucunun dışında saklanan bir yedeğe ihtiyaç duyar. Çalışan bir veritabanının veri dizinini kopyalamak tutarsız bir yedek üretebilir; veritabanından döküm (dump) alın, dosya volume'lerini ise salt okunur bağlayıp arşivleyin:
cd /opt/wordpress
mkdir -p /root/yedek
# Veritabanı dökümü: InnoDB tablolarını kilitlemeden tutarlı bir kopya
docker compose exec -T db sh -c 'exec mariadb-dump -uroot -p"$MARIADB_ROOT_PASSWORD" --single-transaction --routines --triggers --all-databases' \
| gzip > /root/yedek/wp-db-$(date +%F).sql.gz
# Dosya volume'ünü salt okunur bağlayıp arşivleyin (adı docker volume ls ile doğrulayın)
docker run --rm -v wordpress_wp_data:/data:ro -v /root/yedek:/yedek alpine \
tar czf /yedek/wp-files-$(date +%F).tar.gz -C /data .
ls -lh /root/yedekBu arşivleri restic ile başka bir sunucuya taşımak için sunucu yedekleme stratejisi rehberine bakın. Büyük bir imaj ya da Compose değişikliğinden önce Anlık Görüntüler ile kısa ömürlü bir geri dönüş noktası alın ve değişikliği doğruladıktan sonra silin.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
Cannot connect to the Docker daemon at unix:///var/run/docker.sock | Docker hizmeti çalışmıyor; çoğu zaman daemon.json içinde bir yazım hatası vardır | systemctl status docker ve journalctl -u docker -n 50 ile nedeni okuyun, dosyayı dockerd --validate ile denetleyin |
permission denied while trying to connect to the Docker daemon socket | Kullanıcı docker grubunda değil ya da grup üyeliği açık oturuma yansımadı | sudo kullanın veya oturumu kapatıp yeniden açın; id çıktısında docker grubunu arayın |
docker: 'compose' is not a docker command | Compose eklentisi kurulu değil | docker-compose-plugin paketini kurun; eski tireli docker-compose (v1) yerine docker compose kullanın |
Conflicting values set for option Signed-By | Docker deposu iki ayrı dosyada farklı anahtar yoluyla tanımlı | /etc/apt/sources.list.d/ altındaki eski Docker kaydını silip apt-get update çalıştırın |
bind: address already in use | Sunucu portunu başka bir süreç kullanıyor (ör. Nginx 80'de) | ss -ltnp 'sport = :80' ile süreci bulun, farklı bir sunucu portu seçin |
connect() to 127.0.0.1:8080 failed (13: Permission denied) | AlmaLinux'ta SELinux, Nginx'in ağ bağlantısı kurmasını engelliyor | setsebool -P httpd_can_network_connect 1 |
toomanyrequests (pull rate limit) | Docker Hub'ın oturum açmamış kullanıcılar için koyduğu indirme sınırı | docker login ile oturum açın, gereksiz pull döngülerini azaltın |
Sık sorulan sorular
UFW ile Docker'ı birlikte kullanabilir miyim?
Evet. UFW, SSH ve Nginx gibi doğrudan sunucuda çalışan hizmetleri korumaya devam eder; yalnızca Docker'ın yayımladığı portları yönetemez. Container'ları 127.0.0.1 adresine yayımlayıp dış erişimi Nginx üzerinden verirseniz iki araç çakışmadan çalışır.
Ubuntu'da snap ile kurulan Docker'ı kullanmalı mıyım?
Snap paketi, Docker'ın belgelediği kurulum yöntemi değildir; dosyaları farklı dizinlerde tutar ve snap kısıtlamaları nedeniyle bazı bağlama (bind mount) yolları beklendiği gibi çalışmayabilir. Bu rehberdeki yolların geçerli olması için resmi depoyu kullanın ve iki kurulumu aynı anda tutmayın.
Sunucu yeniden başlayınca container'lar kendiliğinden açılır mı?
Docker hizmeti açılışta etkinse ve container'da restart: unless-stopped ya da always ilkesi varsa açılır. docker compose stop ile elle durdurduğunuz bir container, unless-stopped ilkesinde yeniden başlatmadan sonra da durmuş kalır.
Docker için ne kadar kaynak gerekir?
Engine'in kendi tüketimi düşüktür; ihtiyacı container'larınız belirler. Veritabanı içeren projelerde RAM'i öne alın ve kullanımı docker stats ile izleyin. Paket seçerken kaynak seçimi rehberinden yararlanabilirsiniz.
İlgili yazılar
Geri bildiriminiz için teşekkürler!