Ana içeriğe geç
İşiniz için güçlü bir dijital temel.

Bilgi Bankası

Hosting, alan adı ve sanal sunucu hizmetlerinizi daha kolay anlamanız için pratik rehberler.

Docker ve Docker Compose kurulumu: güvenlik duvarını aşan port tuzağına dikkat

Linux Sunucu Yönetimi 8 görüntülenme Markdown

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 sudo ekleyin; depo satırındaki | tee kısmını da | sudo tee olarak 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:

Bash
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do apt-get remove $pkg; done

Kurulum: 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

Bash
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-plugin

Debian

Debian'da yalnızca depo adresi değişir ve sürüm kod adı doğrudan VERSION_CODENAME değişkeninden okunur:

Bash
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-plugin

Bu 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.

Bash
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 docker

Kurulum 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

Bash
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.

Dikkat

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.

Bash
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:

Bash
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 .env

Ardı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.

YAML
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:
Bash
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:8080

Veritabanı 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 herkesUFW 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ı yokYalnızca aynı Docker ağındaki container'larSunucunun 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:

Nginx
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;
    }
}
Bash
# 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.

Bash
# 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-numbers

Bu 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

Bash
# 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 443

ss çı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:

JSON
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}
Bash
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-1
Bilgi

Bu 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:

Bash
cd /opt/wordpress
docker compose pull
docker compose up -d
docker image prune -f
docker system df

docker 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:

Bash
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/yedek

Bu 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

HataOlası nedenÇözüm
Cannot connect to the Docker daemon at unix:///var/run/docker.sockDocker hizmeti çalışmıyor; çoğu zaman daemon.json içinde bir yazım hatası vardırsystemctl 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 socketKullanı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 commandCompose eklentisi kurulu değildocker-compose-plugin paketini kurun; eski tireli docker-compose (v1) yerine docker compose kullanın
Conflicting values set for option Signed-ByDocker 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 useSunucu 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ı engelliyorsetsebool -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

Faydalı oldu mu?

Geri bildiriminiz için teşekkürler!

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.