0
DockerResmî

VPS Sunucuda Docker Nasıl Kurulur? Adım Adım Kurulum Rehberi

Mustafa G.·18 Kasım 20262

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 -m komutunun çıktısı x86_64 veya aarch64 olmalı. 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-virt komutuyla 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 gnupg

2. 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.gpg

3. 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/null

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

5. 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 docker

Burada 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, groups komutuyla 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, iptables hataları: Sunucuda firewalld veya kısıtlı bir çekirdek varsa Docker'ın kendi ağ kurallarını yazamamasından kaynaklanır. sudo journalctl -u docker ile 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 df ile kullanımı izleyin, çalışmayan image'ları docker system prune -a ile 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 nginx

Tarayı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

0 cevap

Henüz cevap yok — ilk cevabı siz verin

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

Giriş Yap