İçeriğe geç
BorCube
Erken erişim

Tek komutla kurulum

Temiz bir Ubuntu sunucuya BorCube'u borcube.com'daki tek satırlık komutla kurmak ve aynı komutla güncellemek.

BorCube'u kurmanın en kolay yolu: borcube.com'da tek satırlık bir komut oluşturursun, sunucunda çalıştırırsın. Veritabanı, HTTPS, servis ve gece yedeği kendiliğinden kurulur. Kurulum genelde 5–15 dakika sürer.

Başlamadan önce#

  • Sunucun gereksinimlere uymalı: temiz bir Ubuntu 22.04 ya da 24.04, x86_64.
  • Alan adının A kaydı sunucunun IP'sini göstermeli. Bkz. Alan adı ve HTTPS.
  • Etkin bir lisansın olmalı (deneme de olur). Bkz. Lisans almak.
  • Sunucuna root ya da sudo yetkili bir kullanıcıyla bağlanabilmelisin: SSH ile ya da VDS firmanın panelindeki konsoldan.

1. Komutu oluştur#

  1. borcube.com'da Hesabım → İndirmeler sayfasını aç.
  2. BorCube bölümündeki Sunucuna kur kartını bul.
  3. Alan adı alanına sitenin açılacağı adresi yaz (ör. oyun.ornek.com). Lisansın bir alan adına bağlıysa bu alan dolu gelir.
  4. Kurulum komutunu oluştur'a, sonra Kopyala'ya bas.

Komut şu biçimdedir:

Komut
curl -fsSL https://borcube.com/kur.sh | sudo bash -s -- --domain oyun.ornek.com --package '<indirme bağlantısı>' --sha256 <paket özeti>
  • --domain: sitenin alan adı.
  • --package: BorCube paketinin indirme bağlantısı. 10 dakika geçerlidir; süresi geçerse kartta yeni komut oluştur.
  • --sha256: paketin özeti. Kurulum, indirilen dosyanın bozulmadığını bununla denetler.

İstersen komutun sonuna şunları ekleyebilirsin:

  • --cloudflare: alan adın Cloudflare proxy'si (turuncu bulut) arkasındaysa.
  • --email [email protected]: HTTPS sertifikası (Let's Encrypt) için kullanılacak e-posta adresi.

2. Sunucuda çalıştır#

Sunucuna bağlan, kopyaladığın satırı yapıştır ve Enter'a bas. Komut başında sudo olduğu için root olmayan ama sudo yetkisi olan bir kullanıcıyla da çalışır. Kurulum bitene kadar pencereyi kapatma.

Kurulum ne yapar?#

  1. Sunucuyu denetler: root mu, Ubuntu 22.04 / 24.04 mü, x86_64 mü, 80 ve 443 portları boş mu. Bellek azsa uyarı yazar.
  2. BorCube paketini indirir ve SHA-256 özetiyle doğrular.
  3. Eksik sistem paketlerini kurar (MySQL dahil). Sistemin tamamını güncellemez. Bellek yaklaşık 2,6 GB'tan azsa ve takas alanı yoksa 2 GB takas açar.
  4. MySQL'i yalnız sunucunun içinden (127.0.0.1) erişilecek şekilde ayarlar; borcube veritabanını ve rastgele şifreli kullanıcısını oluşturur.
  5. Node.js 24'ü yalnız BorCube için /opt/borcube/node klasörüne kurar.
  6. HTTPS için Caddy'yi kurar.
  7. borcube adlı bir sistem kullanıcısı ve borcube servisini oluşturur. Site 127.0.0.1:3000 adresinde, kısıtlı izinlerle çalışır.
  8. Her gece yedek alan bir zamanlayıcı kurar.
  9. Panelden güncelleme için gereken servisi kurar.
  10. BorCube'u kurar, başlatır ve açılıp açılmadığını denetler.
  11. Caddy'yi alan adın için ayarlar; HTTPS sertifikasını Caddy kendiliğinden alır.
  12. UFW güvenlik duvarı açıksa 80 ve 443 portlarına izin ekler. UFW kapalıysa onu açmaz.
  13. Sonunda bir özet yazar.

Kurulumun bıraktığı önemli dosya ve klasörler:

Yolİçinde ne var
/opt/borcubeBorCube sürümleri ve Node.js
/var/lib/borcubeSitenin ayarları, yüklenen dosyalar, kurulum anahtarı
/etc/borcube/borcube.envServisin ortam ayarları
/var/backups/borcubeGece yedekleri (veritabanı ve dosyalar, 14 gün saklanır)
/root/borcube-kurulum.txtKurulum sonundaki özet

Kurulumun sonunda#

Kurulum bitince ekrana şuna benzer bir özet yazılır:

Metin
BorCube <sürüm> kuruldu.

  1) Tarayıcıda açın:   https://oyun.ornek.com/install
  2) Kurulum anahtarı:  <kurulum anahtarı>
  3) Veritabanı hazır: sihirbazda 'Devam et' yeterli.
  4) Lisans anahtarınızı borcube.com → Hesabım → Lisanslar'dan alın.

Özetin altında alan adının hangi IP'ye yönlendiği ve sunucunun IP'si de yazar. İkisi aynı değilse DNS A kaydını düzelt; HTTPS sertifikası DNS doğru olunca kendiliğinden alınır. Cloudflare proxy'si açıksa alan adı Cloudflare'in IP'sini gösterir; bu normaldir.

Özet /root/borcube-kurulum.txt dosyasına da kaydedilir. Sonradan görmek için:

Komut
sudo cat /root/borcube-kurulum.txt

Şimdi tarayıcıda https://<alan adın>/install adresini aç ve kurulum sihirbazını tamamla.

Aynı komutla güncelleme#

BorCube kurulu bir sunucuda aynı komut güncelleme yapar. İndirmeler'deki kartta yeni bir komut oluştur ve sunucuda çalıştır:

  • Önce veritabanının ve dosyaların yedeği alınır.
  • Yeni sürüm ayrı bir klasöre kurulur ve başlatılır.
  • Yeni sürüm açılmazsa önceki sürüme dönülür; veritabanını yedekten geri yükleme komutu ekrana yazılır.

Güncellemede --domain gerekmez: önceki ayarlar /etc/borcube/kur.conf dosyasında saklanır. Bu yolla kurulan sitede yeni sürümleri Yönetim paneli → Ayarlar → Güncellemeler sayfasından da kurabilirsin. Bkz. Güncellemeler.

Sık karşılaşılan hatalar#

Kurulum bir sorunla durursa ekrana kırmızı bir HATA satırı yazar.

HataNe yapmalı
root olarak çalıştırınKomutu başındaki sudo ile, ya da root kullanıcısıyla çalıştır.
Ubuntu 22.04 ya da 24.04 gerekli.Sunucuya bu sürümlerden birini kur (genelde VDS panelinden yeniden kurulumla).
yalnız x86_64 (amd64) sunucular destekleniyorARM işlemcili sunucuda çalışmaz; x86_64 bir sunucu kullan.
80/443 portlarını başka bir program kullanıyorSunucuda Apache, Nginx gibi bir web sunucusu var. Onu kaldır ya da temiz bir sunucu kullan.
İndirilemedi. Bağlantı 10 dakika geçerliİndirme bağlantısının süresi doldu. İndirmeler'de yeni komut oluştur.
Paket doğrulanamadı (SHA-256 uyuşmuyor).İndirme bozuldu ya da komut eksik kopyalandı. Yeni komut oluşturup yeniden dene.
Başka bir BorCube kurulumu ya da güncellemesi sürüyorSüren işin bitmesini bekle, sonra yeniden çalıştır.
Yeni sürüm açılmadı; önceki sürüme dönüldüSite eski sürümle çalışmaya devam ediyor. Ekrandaki günlüğü kaydet ve destekle paylaş.

Sitenin günlüğüne bakmak için:

Komut
sudo journalctl -u borcube -n 100

Günlükler ve destek için: Günlükler ve destek.

ÖncekiLisans almakSonraki Ücretsiz kurulum hizmeti

Bir yanlış ya da eksik mi gördün? Discord’dan haber ver, hemen düzeltelim.