Portainer nasıl kurulur? Docker konteynerlerini panelden yönetin

Portainer, Docker ortamlarını görsel olarak yönetmeye yardımcı olur. Bir web hosting panelinin yerine geçmez; konteynerler, ağlar ve volume’ler üzerinde işlem yapar. Bu rehber tek bir Linux Docker sunucusunu yönetmek içindir.

1. Docker hazır mı?

Root yetkili Docker Engine ve Compose eklentisi kurulu olmalı. Kurulum eksikse önce resmi Docker adımlarını izleyin:

bashsudo docker version
sudo docker compose version
sudo docker ps

Rootless Docker, Podman veya SELinux kullanılan ortamlar için aynı örneğin birebir uygun olduğunu varsaymayın; Portainer gereksinimlerini inceleyin.

2. Kalıcı veri ile başlatın

Aşağıdaki komut yönetim portunu yalnız sunucunun localhost adresine bağlar:

bashsudo docker volume create portainer_data
sudo docker run -d --name portainer --restart=always -p 127.0.0.1:9443:9443 -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:lts

portainer_data panelin kendi verisini saklar. Docker soketi bağlantısı geniş sunucu yetkisi sağlar; Portainer hesabını sunucu yönetici hesabı gibi koruyun. Edge Agent kullanmayan bu örnekte 8000 portunu açmıyoruz.

lts hareketli bir etikettir. İlk kurulumda hangi imajın kullanıldığını kaydedin; güncellemeleri bakım zamanında sürüm notlarıyla değerlendirin.

3. SSH tüneli ve ilk hesap

Kendi bilgisayarınızda:

bashssh -N -L 9443:127.0.0.1:9443 root@SUNUCU_IP

Tarayıcıdan https://localhost:9443 adresine bağlanın. İlk kurulumun kendinden imzalı sertifikasını yalnız doğru SSH tüneline bağlı olduğunuzdan emin olduktan sonra değerlendirin.

Yeni sürüm kurulumları setup token isteyebilir. Sunucuda aşağıdaki günlüğü açıp setup_token= satırındaki değeri kullanın:

bashsudo docker logs portainer

Tokeni paylaşmayın. Hesap oluşturma süresi dolduysa konteyneri yeniden başlatın ve yeni günlük çıktısıyla tekrar deneyin. Bu davranış resmi token belgesinde açıklanıyor.

4. Ortamı inceleyin

Yerel Docker ortamını seçin. Önce mevcut konteynerlerin adlarını, imajlarını, portlarını ve volume bağlantılarını okuyun. Üretimdeki bir konteyner üzerinde silme veya yeniden oluşturma işlemiyle deneme yapmayın.

Bir stack oluşturacaksanız Compose tanımını da sürüm kontrolünde tutun. Panelde yapılan değişikliği dosyaya aktarmamak, sonraki yayında eski ayarların geri gelmesine yol açabilir.

5. Doğrulama ve hatalar

bashsudo docker ps --filter name=portainer
sudo docker logs --tail 50 portainer

Sayfa açılmıyor: SSH tüneli hâlâ açık mı? Ortam görünmüyor: Docker soketi eşlenmiş mi ve daemon çalışıyor mu? İsim çakışması: önce var olan portainer konteynerini inceleyin; rastgele silmeyin.

6. Panel yedeği ve uygulama yedeği

Portainer yedeği, yönetim yapılandırmasını korur. Uygulama veritabanlarını ve bütün Docker volume içeriklerini otomatik kapsadığını düşünmeyin. Her uygulama için ayrı geri yükleme denemesi yapın. Docker yayınlama rehberi ve yedekleme stratejisi ile devam edin.