Kurulum sihirbazı
Sitenin /install sayfasındaki beş adım: kurulum anahtarı, veritabanı, site ve yönetici, lisans ve bitiş. Sık görülen hatalar ve çözümleri.
Sunucu tarafı kurulduktan sonra siteyi tarayıcıda açınca kurulum sihirbazına (/install) yönlenirsin. Sihirbaz beş adımdır: Doğrulama, Veritabanı, Site & Yönetici, Lisans ve Bitir. Hepsi birkaç dakika sürer.
Başlamadan önce şunları hazırla:
- Kurulum anahtarı: sunucunun ürettiği tek kullanımlık anahtar (aşağıda nerede olduğu yazıyor).
- Lisans anahtarı: borcube.com'da Hesabım → Lisanslarım → lisansın → Anahtarı göster.
- Yönetici hesabın için bir e-posta, Minecraft kullanıcı adın ve güçlü bir şifre.
1. Doğrulama: kurulum anahtarı#
Kurulumu yalnız sunucuya erişimi olan kişi başlatabilsin diye site ilk açıldığında bir kurulum anahtarı üretir. Anahtar sunucu konsoluna yazılır ve sitenin veri klasöründeki install-token.txt dosyasına kaydedilir.
| Nasıl kurdun? | Kurulum anahtarı nerede |
|---|---|
| Tek komutla | Kurulum sonundaki özette. Sonradan: sudo cat /root/borcube-kurulum.txt ya da sudo cat /var/lib/borcube/install-token.txt |
| Kurulum hizmetiyle | borcube.com'da Hesabım → Kurulum hizmeti sayfasında |
| Docker ile | docker compose logs borcube | grep "Kurulum anahtarı" |
| Elle | Sitenin günlüğünde ya da borcube-data/install-token.txt dosyasında |
Anahtarı Kurulum anahtarı alanına yapıştır ve Devam et'e bas. Anahtar doğrulandıktan sonra sihirbazı tamamlamak için 2 saatin olur; bu süre geçerse anahtarı yeniden girmen istenir.
2. Veritabanı#
Hazır veritabanı
Tek komutla, kurulum hizmetiyle ya da Docker ile kurduysan veritabanı hazırdır. Ekranda Veritabanı hazır başlığı altında sunucu, veritabanı ve kullanıcı adı görünür. Devam et'e bas; tablolar oluşturulur. Veritabanı şifresi tarayıcıya hiç gönderilmez.
Başka bir veritabanı kullanmak istersen Başka bir veritabanı kullan bağlantısına bas.
Elle bağlanmak
Elle kurulumda (ya da başka bir veritabanı seçtiysen) Veritabanı bağlantısı formu çıkar:
| Alan | Açıklama |
|---|---|
| Sunucu (host) | Veritabanı sunucusunun adresi. Varsayılan 127.0.0.1. |
| Port | Varsayılan 3306. |
| Veritabanı adı | Önceden oluşturduğun boş veritabanı. Varsayılan borcube_cms. |
| Kullanıcı adı | Bu veritabanına yetkili kullanıcı. |
| Şifre | Kullanıcının şifresi. |
Bağlan ve kur'a bas. MySQL 8+ ya da MariaDB 10.6+ gerekir; tablolar kendiliğinden oluşturulur.
3. Site ve yönetici#
| Alan | Açıklama |
|---|---|
| Site adı | Sitenin adı, en az 2 karakter (ör. BorCraft). |
| Site adresi | Sitenin tam adresi, https:// ile. Lisans bu adresin alan adına bağlanır. Genelde doğru adres hazır gelir; yine de kontrol et. |
| Minecraft kullanıcı adı | Yönetici hesabının adı. 3–16 karakter: harf, rakam ve _. |
| E-posta | Yönetici hesabının e-posta adresi. |
| Şifre ve Şifre (tekrar) | En az 10 karakter. |
Yöneticiyi oluştur'a bas. Bu hesap bütün yetkilere sahip Yönetici rolüyle açılır. Şifreni yalnız sen bilirsin.
4. Lisans#
Lisans anahtarını (BC-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX) Lisans anahtarı alanına yapıştır ve Lisansı etkinleştir'e bas. Lisans, önceki adımda yazdığın site adresinin alan adı için etkinleştirilir. Bu adımda sunucunun lisans sunucumuza (internete) ulaşabilmesi gerekir.
Lisansın nasıl çalıştığı: Lisans nasıl çalışır?
5. Bitir#
Her şey hazır! ekranında Kurulumu tamamla'ya bas. Kurulum sayfası kalıcı olarak kapanır, kurulum anahtarı silinir ve yönetim panelinin giriş sayfasına (/admin/login) yönlendirilirsin. Kullanıcı adı veya e-posta ve şifrenle giriş yap.
Sonra kurulumdan sonraki ilk adımlara geç.
Sık görülen hatalar#
Kurulum anahtarı
| Mesaj ya da durum | Ne yapmalı |
|---|---|
| Kurulum anahtarı hatalı. | Anahtarı boşluksuz ve eksiksiz kopyala. Doğru sunucunun anahtarını aldığından emin ol. |
| Anahtarı girince yine anahtar soruyor | Siteyi https:// ile aç. Güvenli çerez düz http ile (localhost dışında) kaydedilmez. |
| Kurulum anahtarı doğrulanmadı. | 2 saatlik süre doldu ya da tarayıcı değişti. Sayfayı yenile ve anahtarı yeniden gir. |
Veritabanı
| Mesaj | Ne yapmalı |
|---|---|
| Kullanıcı adı veya şifre hatalı. | Veritabanı kullanıcısının adını ve şifresini kontrol et. |
| Veritabanı bulunamadı. Önce oluşturun. | Veritabanını oluştur ya da adını düzelt. |
| Veritabanı sunucusuna bağlanılamadı. Host ve portu kontrol edin. | Veritabanı çalışıyor mu, adres ve port doğru mu bak. |
| Desteklenmeyen sürüm: … MySQL 8+ veya MariaDB 10.6+ gerekir. | Veritabanı sunucunu güncelle. |
| Hazır veritabanı bilgisi bulunamadı; bilgileri elle girin. | Başka bir veritabanı kullan ile bilgileri elle gir. |
Lisans
| Mesaj | Ne yapmalı |
|---|---|
| Lisans anahtarı BC-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX biçiminde olmalı. | Anahtarı borcube.com'dan eksiksiz kopyala. |
| Lisans anahtarı geçersiz. | Anahtar yanlış yazılmış. Hesabım → Lisanslarım'dan yeniden kopyala. |
| Bu lisans başka bir alan adına bağlı. | Site adresi lisansın alan adıyla aynı olmalı. Gerekirse borcube.com'da alan adını değiştir: Alan adı değiştirme. |
| Bu lisans izin verilen kurulum sayısına ulaştı. | Hesabım → Lisanslarım → lisansın → Kurulumlar listesinde artık kullanmadığın kurulumu Kaldır. |
| Bu lisansın süresi dolmuş. | Süreyi uzat: Süre uzatma. |
| Lisans sunucusuna ulaşılamadı. | Sunucunun internete çıkabildiğini kontrol et; güvenlik duvarı dışarı giden bağlantıları engellememeli. |
Başka bir hatada ekranda "Beklenmeyen bir hata oluştu. Sunucu kayıtlarına bakın." yazar. Tek komutla kurduysan günlüğe şu komutla bakabilirsin:
sudo journalctl -u borcube -n 100Yardım için: Günlükler ve destek.
Bir yanlış ya da eksik mi gördün? Discord’dan haber ver, hemen düzeltelim.