VPS Sunucuda Docker Nasıl Kurulur? Adım Adım Kurulum Rehberi
Bir uygulamayı test ortamında çalıştırıp sunucuya taşıdığınızda "bende çalışıyordu" derdini yaşamak, VPS kullanan herkesin en az bir kez başına gelmiştir. Docker tam da bu noktada devreye girer: uygulamayı bağımlılıklarıyla birlikte izole bir konteyner içine kapatır ve hangi makinede çalıştırırsanız çalıştırın aynı davranmasını garanti eder.
Bu rehberde bir VPS sunucuya Docker'ın güncel sürümünü kurmayı, servisi doğru yapılandırmayı ve ilk konteynerinizi çalıştırmayı anlatacağım. Ubuntu 22.04 / 24.04 üzerinden gideceğim; Debian için adımlar neredeyse aynıdır. CentOS/Rocky kullanıyorsanız paket yönetimi kısmı değişir, geri kalan her şey aynıdır.
Kurulum Öncesi Kontrol Listesi
İşe koyulmadan önce birkaç şeyi teyit edin:
- Sunucu mimarisi:
uname -mkomutunun çıktısıx86_64veyaaarch64olmalı. Docker ikisini de destekler, ama bazı eski OpenVZ tabanlı VPS'lerde çekirdek kısıtlamaları nedeniyle konteynerler düzgün çalışmaz. - Sanallaştırma tipi: KVM tabanlı bir VPS'te sorun yaşamazsınız. LXC veya OpenVZ konteyneri üzerindeyseniz
systemd-detect-virtkomutuyla kontrol edin; bu ortamlarda Docker genelde çalışmaz veya kısıtlı çalışır. - Kaynak: 1 GB RAM ve 20 GB disk pratik bir alt sınır. Ayrıca sunucunuzun saat ayarı doğru olsun; yanlış saat, TLS sertifika hatalarıyla kurulumu bloke edebilir.
WEBKUR VPS paketlerindevarsayılan sanallaştırma KVM tabanlıdır; Docker sorunsuz çalışır. Farklı bir sağlayıcı kullanıyorsanız sanallaştırma tipini mutlaka teyit edin.
Resmî Depodan Docker Kurulumu (Ubuntu/Debian)
Dağıtımın kendi deposundaki docker.io paketini kurmayı içgüdüsel olarak yapan çok kişi var. Sorun şu: o paket genelde aylar geridedir. Uzun vadede güncellemeler ve Docker Compose v2 için resmî depoyu eklemek daha doğru.
1. Eski paketleri temizleyin ve bağımlılıkları kurun
sudo apt update
sudo apt remove -y docker docker-engine docker.io containerd runc
sudo apt install -y ca-certificates curl gnupg2. Docker'ın GPG anahtarını ekleyin
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg3. Depoyu tanımlayın
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/nullDebian kullanıyorsanız URL'deki ubuntu yerine debian yazmanız yeterli.
4. Docker Engine'i kurun
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin5. Kurulumu doğrulayın
sudo docker run hello-world"Hello from Docker!" çıktısını görüyorsanız her şey yolunda demektir. Bu komut aynı zamanda ağ çıkışınızı, DNS çözümlemesini ve çekirdek yeteneklerinizi de fiilen test ettiği için sağlıklı bir ilk kontrol noktasıdır.
Sudo Olmadan Docker Kullanmak
Her komutta sudo yazmaktan sıkıldıysanız kullanıcılarınızı docker grubuna ekleyin:
sudo usermod -aG docker $USER
newgrp dockerBurada durup bir güvenlik notu düşmek şart: docker grubuna üyelik fiilen root yetkisi verir. Sunucuda birden fazla kişinin hesabı varsa bunu yalnızca gerçekten ihtiyacı olan kullanıcıya verin. Sadece siz kullanıyorsanız sorun yok.
En Sık Yapılan Kurulum Hataları
Destek taleplerinde en çok karşılaştığım durumlardan birkaçı:
- "permission denied" hatası hello-world'de: Genelde kullanıcı gruba eklendikten sonra oturumu yenilemeyi atlıyorlar. SSH bağlantısını kapatıp açın,
groupskomutuyla docker grubunun listede olduğunu görün. - Depo hatası (404 / NO_PUBKEY): Ubuntu sürümünüz EOL olmuş veya koda adı yanlış girilmiş olabilir.
lsb_release -csçıktısının desteklenen bir sürüm olduğu teyit edin. - Konteynerler başlamıyor,
iptableshataları: Sunucudafirewalldveya kısıtlı bir çekirdek varsa Docker'ın kendi ağ kurallarını yazamamasından kaynaklanır.sudo journalctl -u dockerile servisin kayıtlarına bakın; hatanın kaynağı orada net görünür. - Disk dolması: Ubuntu'nun minimal imajlarında disk hızlı dolar.
docker system dfile kullanımı izleyin, çalışmayan image'larıdocker system prune -aile temizleyin. Bu komut kullanılmayan her şeyi sildiği için canlı sisteme basmadan önce iki kez düşünün.
İlk Gerçek Konteynerinizi Çalıştırın
Kurulumu doğruladıktan sonra hello-world ile kalmayın; gerçekçi bir örnek yapalım. Nginx'i 8080 portunda yayınlayacak şekilde çalıştıralım:
docker run -d --name web -p 8080:80 --restart unless-stopped nginxTarayıcıdan http://SUNUCU_IP:8080 adresine girin; Nginx karşılama sayfasını görüyorsanız Docker ağı ve port yönlendirme çalışıyor demektir. Kullandığım parametrelerin kısa özeti:
-d— arka planda (detached) çalıştırır.-p 8080:80— sunucudaki 8080 portunu konteynerin 80 portuna bağlar.--restart unless-stopped— sunucu yeniden başladığında konteyner otomatik açılır. Canlı projelerde bunu her zaman ekleyin; ilk kurulumdan sonra