SFTP, gameserver dosyalarını panel dışında yönetmenin pratik yoludur: yapılandırmaları düzenlemek, plugin veya mod yüklemek, logları kaydetmek ve dünyaları indirmek. Bunun için yalnızca uygun bir istemciye, dashboard içindeki erişim bilgilerine ve önemli dosyaların üzerine yazarken biraz dikkate ihtiyacın var.

SFTP gameserver için ne sağlar

SFTP, SSH File Transfer Protocol anlamına gelir ve dosyaları şifreli bir bağlantı üzerinden aktarır. Gameserverlar için bu özellikle kullanışlıdır, çünkü her değişikliği tarayıcıdaki dosya yöneticisi üzerinden yapmak zorunda kalmazsın. Büyük klasörler, çok sayıda plugin dosyası veya yerel yedekler genellikle masaüstü istemcisiyle daha düzenli yönetilir.

Ayrım önemli: SFTP, klasik FTP ile aynı şey değildir. İstemcin birden fazla protokol sunuyorsa özellikle SFTP seçmelisin. FileZilla resmi belgelerinde SFTP'yi desteklenen bir protokol olarak belirtir; WinSCP de kendini, SFTP dahil olmak üzere dosya aktarımı için resmi bir istemci olarak tanımlar. Bu yüzden resmi indirmeleri kullan ve üçüncü taraf sitelerden gelen gayriresmi kurulum dosyalarından kaçın.

Gereksinimler

Aktif bir gameservera, game-serverhosting dashboarduna erişime ve bilgisayarında bir SFTP istemcisine ihtiyacın var. Ayrıca riskli değişikliklerden önce bir yedek oluşturmalı veya en azından etkilenen dosyaları yerel olarak indirmelisin. Bu özellikle dünyalar, veritabanları, sunucu yapılandırmaları ve plugin klasörleri için geçerlidir.

Şu anda başka bir sağlayıcıdan geliyorsan, Gameserver taşıma: Her hosterden game-serverhosting'e rehberi yedekleme, yükleme ve kontrol sırası konusunda yardımcı olur. Minecraft'a özel eklentiler için Minecraft pluginlerini kurma ve yönetme – Panelde Spigot/Paper rehberi, SFTP adımlarını plugin ayrıntılarıyla tamamlar.

SFTP istemcisi kurma

İstemci OS İndirme
FileZilla Windows/Mac/Linux filezilla-project.org
WinSCP Windows winscp.net
Cyberduck Mac/Windows cyberduck.io

Windows için WinSCP çoğu zaman rahattır, çünkü arayüz, editör entegrasyonu ve senkronizasyon net şekilde ayrılmıştır. FileZilla platformlar arasıdır ve Windows, macOS veya Linux üzerinde benzer şekilde çalışmak istiyorsan iyi çalışır. Basit bir arayüz tercih ediyorsan Cyberduck da bir seçenektir.

Bağlantı kurma

SFTP istemcini aç ve yeni bir bağlantı oluştur. Değerleri sunucunun dashboardunda bulabilirsin. Bunları ekran görüntüsüyle üçüncü kişilerle paylaşma ve parolaları yalnızca güvendiğin cihazlarda kaydet.

Alan Değer
Protokol SFTP
Host Sunucu IP adresin
Port 2022 (Pterodactyl standardı)
Kullanıcı Dashboarddan
Parola Dashboarddan

Ardından Bağlan'a tıkla. İlk bağlantı sırasında istemcin bir host anahtarı sorabilir. Doğru hosta bağlandığını kontrol et ve anahtarı yalnızca sunucu bilgileri doğruysa onayla. Sonrasında istemci genellikle iki bölüm gösterir: solda yerel dosyaların, sağda gameserver üzerindeki dosyalar.

Tipik klasör yapısı

Tam yapı, oyuna ve kullanılan sunucu tipine bağlıdır. Ancak birçok kurulum şu şekilde bir container dizinine dayanır:

/home/container/
├── server.properties     # Sunucu yapılandırması
├── plugins/              # Pluginler (Paper/Spigot)
├── mods/                 # Modlar (Forge/Fabric)
├── world/                # Oyun dünyası
├── logs/                 # Sunucu logları
└── backups/              # Yedekler

Dosyaları mümkün olduğunca hedefli şekilde düzenle. Bir yapılandırma dosyasını önce indir, uygun bir editörde yerel olarak değiştir ve ardından tekrar yükle. Dosya uzantılarını değiştirmemeye dikkat et. Örneğin server.properties yanlışlıkla server.properties.txt olmamalıdır.

Sık yapılan işler

  • Config düzenleme: Dosyayı indir → düzenle → yükle
  • Plugin kurma: JAR dosyasını /plugins/ içine yükle
  • Yedekleri indirme: /world/ klasörünü indir
  • Logları kontrol etme: latest.log dosyasını indir

Plugin veya modlarda dosya yüklemeden önce sunucu sürümünü, loaderı ve bağımlılıkları kontrol etmelisin. Bir Paper plugini genellikle /plugins/ içine, bir Forge veya Fabric modu /mods/ içine konur. Yüklemeden sonra sunucunun yeni dosyayı yüklemesi için çoğu zaman yeniden başlatma gerekir.

Dünya yedekleri için net bir akış önerilir: sunucuyu durdur, dünya klasörünü indir, yerel kopyaya anlamlı bir ad ver ve ancak sonra büyük değişiklikler yap. Sunucu kopyalama sırasında aktif olarak yazıyorsa yedek eksik veya tutarsız olabilir.

Sonucu kontrol etme

Bir değişiklikten sonra önce yüklemenin tamamen tamamlanıp tamamlanmadığını kontrol et. Birçok SFTP istemcisi başarısız aktarımları bir kuyrukta veya hata sekmesinde gösterir. Ardından gerekirse gameserverı yeniden başlat ve logları kontrol et. Minecraft'ta latest.log çoğu zaman ilk bakılacak yerdir; diğer oyunlarda ilgili sunucu dizininde kendi log dosyaları bulunur.

Sonrasında oyunda veya panelde değişikliğin gerçekten aktif olup olmadığını test et. Sadece bir dosyanın yüklenmiş olması, sunucu tarafından okunduğu anlamına gelmez. Önemli olan, başlangıcın hatasız tamamlanması ve istenen işlevin görünür olmasıdır.

Temiz çalışma için ipuçları

  • Drag & Drop: Dosyaları kolayca sürükleyip bırakarak aktar
  • Çift tıklama: Dosyaları doğrudan editörde aç
  • Senkronize etme: Bazı istemciler klasör senkronizasyonu sunar
  • Anahtar kimlik doğrulaması: Daha fazla güvenlik için parola yerine SSH anahtarları

Yine de kontrollü çalış: Senkronizasyon yerel hataları hızla sunucuya aktarabilir. Çok sayıda dosyayı değiştiriyorsan önce hedef klasörü ve senkronizasyon yönünü kontrol et. Yapılandırma dosyalarında her değişiklikten önce yerel bir kopya almak mantıklıdır.

Troubleshooting

Bağlantı başarısız olursa önce protokolü, hostu, portu, kullanıcı adını ve parolayı kontrol et. Sık yapılan bir hata, yanlışlıkla SFTP yerine FTP seçmek veya portu yanlış girmektir. Birçok Pterodactyl kurulumunda kullanılan standart port 2022'dir; ancak her zaman dashboardundaki değerler geçerlidir.

Yükleme yarıda kesilirse yerel bağlantı kararsız olabilir veya hedef klasör eksik olabilir. Aktarımı tekrarla ve istemcinin dosyayı yalnızca kısmen yükleyip yüklemediğine dikkat et. Şüphede kalırsan eksik hedef dosyayı sil ve yeniden yükle.

Bir değişiklikten sonra sunucu başlamazsa son çalışan dosyayı geri yükle veya en son yüklenen plugini ya da modu kaldır. Ardından logları kontrol et. Sunucu dosyalarıyla ilgili temel terminal işleri için ayrıca Linux gameserver komutları – En önemli terminal commands rehberi yardımcı olur.

Kontrol, sınırlar ve güvenli geri dönüş

“Gameserver için SFTP erişimi – dosyaları yönet” rehberi, makalede açıklanan sunucu tipi ve kontrol anında görünen sürüm durumu için geçerlidir. Menü adları, mevcut sürümler, mod veya plugin uyumluluğu ve gerekli kaynaklar güncellemelerden sonra değişebilir. Bu yüzden değerleri kontrol etmeden başka bir oyun, loader veya sunucu sürümüne aktarma.

Dünya, oyun kaydı, yapılandırma veya eklentilerde değişiklik yapmadan önce etkilenen dosyaların yedeğini oluştur. Ardından yalnızca birbiriyle bağlantılı tek bir adımı değiştir ve bunu daha sonra oynamak istediğin aynı istemci ve sunucu sürümüyle kontrol et.

Kontrol noktası Beklenen sonuç İptal ve geri dönüş
Sunucu başlatma Sunucu yeni hata mesajı olmadan çalışmaya hazır duruma ulaşır. Başlatma hatalarında değişikliği geri al ve son yedeği yükle.
Bağlantı testi Bir test hesabı panelde gösterilen adres üzerinden bağlanabilir. Sürüm veya bağlantı hatalarında sürümü, portu ve izinleri yeniden karşılaştır.
İşlev testi Değiştirilen somut işlev, mevcut dünya veya oyun verilerine zarar vermeden çalışır. Yan etkilerde sunucuyu durdur ve yedeklenen dosyaları geri yükle.

Başarılı bir tekil test, performans veya erişilebilirlik garantisi değildir. Dünya boyutu, modlar, pluginler, oyuncu sayısı, ağ yolu ve eşzamanlı yük sonucu değiştirebilir. Sürümü, değişikliği ve test sonucunu belgeleyerek daha sonraki sapmaları takip edebilirsin.

FAQ

SFTP, FTP'den daha güvenli mi?

Evet, SFTP dosyaları şifreli bir bağlantı üzerinden aktarır. Yine de erişim bilgilerini koruman, yalnızca güvenilir istemciler kullanman ve kayıtlı parolaları ortak kullanılan cihazlarda saklamaman önemlidir.

Hangi SFTP istemcisini kullanmalıyım?

Güvenilir şekilde çalışabildiğin istemciyi seç. FileZilla platformlar arasıdır, WinSCP Windows'ta çok popülerdir, Cyberduck macOS ve Windows üzerinde çalışır. İstemciyi doğrudan resmi web sitesinden indir.

Her yüklemeden önce gameserverı durdurmam gerekir mi?

Her dosyada gerekmez. Loglar veya basit indirmeler için çoğu zaman gerekli değildir. Dünya klasörleri, veritabanları, modlar, pluginler veya merkezi yapılandırmalarda değişikliğe bağlı olarak durdurma ya da yeniden başlatma mantıklıdır, böylece dosyalar aynı anda yazılmaz.

Yüklediğim değişikliği oyunda neden görmüyorum?

Olası nedenler eksik bir yeniden başlatma, yanlış hedef klasör, uyumsuz bir plugin veya mod sürümü ya da yapılandırma hatası olabilir. Önce yüklemeyi, sonra sunucu loglarını ve ardından tam yol bilgisini kontrol et.

Tam yedekleri SFTP ile indirebilir miyim?

Evet, /world/ gibi klasörleri veya mevcut yedek dizinlerini indirebilirsin. Tutarlı oyun dünyası yedekleri için sunucuyu önceden durdurmalı veya sunucun için mevcutsa panelindeki yedekleme işlevini kullanmalısın.