Manuel kurulumlarla, Java sürümleriyle veya dosya izinleriyle uğraşmak istemiyor musunuz? Modern sunucu yönetiminin altın standardı olan Docker ile Hytale sunucunuzu tamamen izole, güvenli ve "tek komutla" çalıştırabilirsiniz.
Bu rehberde, topluluk tarafından hazırlanan ve sürekli güncellenen indifferentbroccoli/hytale-server-docker imajını kullanarak saniyeler içinde sunucu ayağa kaldırmayı anlatacağız.
Neden Docker Kullanmalısınız?
- İzolasyon: Sunucu dosyaları ana işletim sisteminizden bağımsız çalışır.
- Kolay Güncelleme: Hytale Downloader CLI otomatik olarak entegre edilmiştir.
- Temiz Kurulum: Java 25 gibi gereksinimler imajın içinde gelir, bilgisayarınıza ekstra bir şey kurmanıza gerek kalmaz.
📋 Gereksinimler
Docker yöntemini kullanmak için sisteminizde aşağıdaki kaynakların olması önerilir:
- CPU: Minimum 4 çekirdek (Önerilen 8+).
- RAM: Minimum 4GB (Önerilen 8GB+).
- Disk: 10GB - 20GB depolama alanı.
- Mimari: x86_64 veya ARM64 (Apple Silicon desteklenir).
🐋 Docker Kurulumu
Hytale sunucusunu kurmadan önce, konteyner motoru olan Docker'ın sisteminizde yüklü olması gerekir. İşletim sisteminize uygun adımı seçin:
🖥️ Windows İçin Kurulum (Docker Desktop)
Windows kullanıcıları için en kolay yöntem Docker Desktop kullanmaktır.
- İndirme: Docker Desktop Resmi Web Sitesi adresine gidin ve "Download for Windows" butonuna tıklayın.
- Kurulum: İndirdiğiniz
.exe dosyasını çalıştırın. Kurulum sırasında "Use WSL 2 instead of Hyper-V" (Önerilen) seçeneğinin işaretli olduğundan emin olun.
- Başlatma: Kurulum bitince bilgisayarınızı yeniden başlatın ve Docker Desktop uygulamasını açın.
- Doğrulama: PowerShell veya CMD'yi açıp şu komutu yazın:
docker --version
Eğer sürüm numarası görüyorsanız (Örn: Docker version 24.0.0...), hazırsınız demektir.
🐧 Linux İçin Kurulum (Ubuntu/Debian)
Linux sunucularda Docker'ı terminal üzerinden kurmak en sağlıklı yöntemdir.
Hızlı Kurulum Scripti: Docker'ın resmi otomatik kurulum scriptini kullanarak tek komutla kurabilirsiniz:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
Docker Compose Eklentisi: Yeni sürümlerde genellikle dahil gelir ancak emin olmak için:
sudo apt-get install docker-compose-plugin
Doğrulama:
docker compose version
🚀 Docker Compose ile Hızlı Kurulum
En temiz ve yönetilebilir yöntem docker-compose kullanmaktır.
1. Adım: docker-compose.yml Dosyasını Oluşturun
Sunucuyu kurmak istediğiniz klasörde bir docker-compose.yml dosyası oluşturun ve aşağıdaki kodları yapıştırın:
services:
hytale:
image: indifferentbroccoli/hytale-server-docker
restart: unless-stopped
container_name: hytale
stop_grace_period: 30s
ports:
- 5520:5520/udp
env_file:
- .env
volumes:
- ./server-files:/home/hytale/server-files
stdin_open: true
tty: true
2. Adım: Ayarlar Dosyası (.env)
Aynı klasörde bir .env dosyası oluşturarak sunucu ayarlarınızı yapılandırın. İşte en kritik ayarlar:
# Sunucu Adı
SERVER_NAME=HyTurkiye Docker Server
# Port (Sadece UDP)
DEFAULT_PORT=5520
# Maksimum Oyuncu
MAX_PLAYERS=20
# Görüş Mesafesi (RAM kullanımını en çok etkileyen ayar! Varsayılan: 12)
VIEW_DISTANCE=12
# Java RAM Limiti (Örn: 8GB)
MAX_MEMORY=8G
# Otomatik Yedekleme (true/false)
ENABLE_BACKUPS=true
⚠️ Önemli Not: VIEW_DISTANCE ayarı RAM kullanımını katlanarak artırır. 12 chunk (384 blok) varsayılan değerdir ve 8GB RAM önerilir.
3. Adım: Sunucuyu Başlatın
Terminali açın, dosyanın olduğu klasöre gelin ve sihirli komutu yazın:
docker-compose up -d
Bu komut, gerekli imajı indirecek ve sunucuyu arka planda başlatacaktır.
🔐 İlk Kurulum ve Kimlik Doğrulama
Sunucuyu ilk kez başlattığınızda, Hytale hesabınızla eşleştirmeniz gerekir. Docker arka planda çalıştığı için doğrulama linkini loglarda görmeniz gerekir.
Logları izlemek için:
docker-compose logs -f
Ekranda beliren https://accounts.hytale.com/device... linkine tıklayın ve kodu girerek sunucunuzu aktif edin.
🛠️ Sunucu Yönetimi ve Komutlar
Docker içinde çalışan sunucunuza komut göndermek için konsola erişmeniz gerekmez. Aşağıdaki komutları kullanabilirsiniz:
Sunucuya Komut Gönderme (OP Verme vb.)
Sunucu çalışırken /op, /kick gibi komutları göndermek için:
# Oyuncuya OP yetkisi verme
docker exec -u hytale hytale command.sh "/op add kullaniciadi"
# Oyuncuyu atma
docker exec -u hytale hytale command.sh "/kick kullaniciadi"
Sunucuyu Güncelleme
Eğer .env dosyasında DOWNLOAD_ON_START=true ayarı açıksa (varsayılan olarak açıktır), sunucuyu yeniden başlatmak güncellemeleri kontrol eder:
docker-compose restart
📢 Forum Tartışması: Siz Ne Düşünüyorsunuz?
Sizce Docker'ın sunduğu "izolasyon" ve "kolay yedekleme" avantajları, manuel kurulumun esnekliğine tercih edilir mi? Özellikle performans konusunda Docker kullanan arkadaşlar deneyimlerini aşağıda paylaşabilir mi?
👇 Yorumlarda Docker kurulumuyla ilgili sorularınızı bekliyoruz!
