Kurulum

Xudbin'i tek komutla sunucuna kurar, kurulum linkiyle yönetici hesabını oluşturur ve sunucudaki xudbin komutuyla paneli yönetirsin.

Gereksinimler

Ubuntu, Debian veya AlmaLinux/Rocky; en az 2 GB RAM
80 ve 443 portları boş olmalı
Root yetkisi

Tek komutla kurulum

curl -fsSL https://raw.githubusercontent.com/Furkan1116/XudbinPanel/main/install.sh | sudo bash

Betik her adımı terminalde gösterir:

Sistemi kontrol eder; RAM 3 GB'tan azsa 2 GB swap açar.
Docker yoksa kurar.
Xudbin'i /opt/xudbin klasörüne indirir ve xudbin komutunu kurar.
Güvenlik duvarında yalnız SSH, 80, 443 ve panelin IP girişi için 8443'ü açar, SSH için fail2ban kurar.
Hazır imajı (ghcr.io/furkan1116/xudbin) indirir; bulamazsa kaynaktan derler.
Sunucunun IP'sinden xudbin.1-2-3-4.sslip.io gibi bir panel adresi üretir ve HTTPS sertifikasını alır. Panel ayrıca https://1.2.3.4:8443 adresinden de açılır (aşağıya bak).
Kurulum linkini ve QR kodunu gösterir.

Kurulum seçenekleri

Betiği ortam değişkenleriyle özelleştirebilirsin:

# Kendi alan adınla (A kaydı önceden sunucuyu göstermeli)
curl -fsSL https://raw.githubusercontent.com/Furkan1116/XudbinPanel/main/install.sh | sudo XUDBIN_DOMAIN=panel.ornek.com ACME_EMAIL=sen@ornek.com bash

# Dış IP'si olmayan yerel ağ/test sunucusunda HTTPS kapalı
curl -fsSL https://raw.githubusercontent.com/Furkan1116/XudbinPanel/main/install.sh | sudo XUDBIN_HTTPS=0 bash

XUDBIN_HARDEN=0 verirsen güvenlik duvarı ve fail2ban kurulmaz.

IP ile giriş (`https://<ip>:8443`)

Panel, alan adının yanında sunucunun IP adresi ve 8443 portuyla da açılır. Bu adresin sertifikası Caddy'nin kendi sertifika otoritesinden gelir (kendinden imzalı); tarayıcı ilk girişte "bağlantı gizli değil" uyarısı verir, uyarıyı kabul edince panel açılır. Alan adındaki korumalar (WAF, hız sınırı, IP engeli) bu adreste de geçerlidir. Alan adının sertifikası tarayıcıların güvendiği Let's Encrypt sertifikası olduğu için günlük kullanımda alan adını öneririz.

Kapatmak için: Ayarlar → Panel → IP ile giriş (port güvenlik duvarında da kapanır).
Başka port: kurulumda XUDBIN_IP_PORT=9443; tamamen kapatmak için XUDBIN_IP_PORT=0. 8443 sunucuda başka bir serviste kullanılıyorsa kurulum IP girişini kendisi kapatır.
HTTPS kapalı kurulumlarda (XUDBIN_HTTPS=0) IP girişi yoktur.

İlk yönetici hesabı

Kurulumun sonunda bir kurulum linki gösterilir (...?setup=<anahtar>). Yönetici hesabı yalnız bu linkteki kurulum anahtarıyla oluşturulabilir; böylece panel internete açıldığı anda başkası hesabı senden önce ele geçiremez.

Linki tarayıcıda aç (veya QR kodu telefonla okut).
Yönetici hesabını oluştur ekranında adını, e-postanı ve en az 10 karakterlik bir şifre gir. Kurulum anahtarı alanı linkten dolar.
Hesabı oluştur'a bas.

Linki kaçırdıysan sunucuda tekrar göster:

xudbin link

Sunucuya SSH ile her girişte de panel adresi (kurulum bitmediyse kurulum linki) kendiliğinden görünür. Bunu yalnız Docker'a erişebilen kullanıcılar (root ya da docker grubu) görür; kapatmak için sudo mkdir -p /etc/xudbin && sudo touch /etc/xudbin/no-login-link.

Linki kimseyle paylaşma. Hesabı oluşturduktan sonra Ayarlar > Hesap bölümünden iki adımlı doğrulamayı açman önerilir.

`xudbin` komutu

xudbin link                                    # panel adresi (ilk kurulumda kurulum linki), QR kodla
xudbin status                                  # sunucu, uygulama, veritabanı, kullanıcı ve banlı IP sayıları
xudbin user list                               # kullanıcılar
xudbin user create ali@ornek.com Ali --member  # kullanıcı ekler (--member yoksa yönetici), geçici şifre verir
xudbin user reset-password ali@ornek.com       # geçici şifre üretir, oturumları kapatır
xudbin user disable-2fa ali@ornek.com          # telefon kaybolduysa 2FA'yı kapatır
xudbin user delete ali@ornek.com
xudbin unban 203.0.113.7                       # IP banını kaldırır
sudo xudbin restore /root/xudbin-panel-....xbk # panel yedeğini geri yükler
sudo xudbin backup decrypt yedek.sql.gz.xbe    # şifreli veritabanı/volume yedeğini gzip'e çevirir
sudo xudbin update                             # Xudbin'i günceller
xudbin restart                                 # paneli yeniden başlatır
xudbin logs                                    # panel loglarını izler

Güncelleme

Yeni sürüm çıktığında panelin üst kısmında bildirim görünür. Ayarlar > Panel sekmesinde Güncelle'ye basman yeterli; panel birkaç dakika içinde yeniden başlar ve sayfa kendiliğinden yenilenir.

Sunucudan da güncelleyebilirsin:

sudo xudbin update

Güncelleme yalnız etiketlenmiş sürümlerden (v1.2.3) yapılır; main dalındaki değişiklikler sunucuna gelmez. Kurulumdan önce panel ve Caddy imajlarının imzası doğrulanır: imaj resmi reponun GitHub Actions iş akışında imzalanmamışsa güncelleme durur, mevcut sürüm çalışmaya devam eder ve Ayarlar > Panel'de uyarı görünür. Çalışan imaj, doğrulanan özetiyle (@sha256:...) başlatılır.

Belirli bir sürümü kurmak için XUDBIN_REF=v1.3.0 verebilirsin. Kendi imajını ya da çatalını kullanıyorsan XUDBIN_VERIFY=0 doğrulamayı kapatır (önerilmez).

Güncelleme uygulamalarına, veritabanlarına ve panel verisine dokunmaz. Güvenlik düzeltmeleri yalnız en son sürüme gelir.

İmajları doğrulama

Hazır imajlar GitHub Actions'ta derlenip Sigstore (cosign) ile imzalanır; SBOM ve köken (provenance) bilgisi de imajla yayınlanır. İmzayı doğrulamak için:

cosign verify ghcr.io/furkan1116/xudbin:1.3.0 \
  --certificate-identity-regexp '^https://github\.com/Furkan1116/XudbinPanel/\.github/workflows/' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

Uzak sunucu eklemek

Sunucular > Sunucu ekle'ye bas; ad, IP adresi, SSH portu ve kullanıcıyı gir (root önerilir; başka kullanıcı şifresiz sudo yetkisine sahip olmalı).
Kurulum sekmesinde gösterilen komutu sunucuda çalıştırarak panelin SSH anahtarını ekle.
Bağlantıyı dene, ardından Kurulumu başlat. Docker ve Caddy otomatik kurulur; ilk kurulum 3–6 dakika sürebilir.