Linux Kurulumu

Desteklenen dağıtımlar: Debian / Ubuntu ve türevleri (x86_64)

Hızlı kurulum (önerilen)

curl -fsSL https://docs.qetra.tr/install.sh | sh

Betik cihazı Netsoft Access apt deposuna bağlar, qetra paketini kurar ve sistem servisini hazırlar. Sonraki sürümler kendiliğinden gelir.

Elle kurulum

Depoyu kendiniz eklemek isterseniz:

sudo curl -fsSL https://docs.qetra.tr/downloads/repo/deb/qetra-archive-keyring.gpg \
    -o /usr/share/keyrings/qetra-archive-keyring.gpg
sudo tee /etc/apt/sources.list.d/qetra.sources >/dev/null <<'EOF'
Types: deb
URIs: https://docs.qetra.tr/downloads/repo/deb
Suites: stable
Components: main
Architectures: amd64
Signed-By: /usr/share/keyrings/qetra-archive-keyring.gpg
EOF
sudo apt-get update && sudo apt-get install -y qetra

Signed-By, bu kaynaktan yalnızca Netsoft'un anahtarıyla imzalanmış bir dizin kabul edilmesini sağlar; sistemdeki başka anahtarlar bu depo için geçersizdir.

Ağa bağlanın

Yönetim panelinden aldığınız kurulum anahtarıyla (panel: Cihazlar → Cihaz Bağla):

sudo qetra up --management-url https://access.firmaniz.com.tr --setup-key <ANAHTAR>

Sunucu/yönlendirici gibi sürekli açık kalacak makinelerde bunun yerine /etc/qetra/qetra.env dosyasını doldurun ve servisi başlatın — böylece cihaz her açılışta kendiliğinden bağlanır:

sudo nano /etc/qetra/qetra.env      # QETRA_MANAGEMENT_URL ve QETRA_SETUP_KEY
sudo systemctl restart qetra

Doğrulayın

qetra status
systemctl status qetra

Otomatik güncelleme

Kurulumla birlikte günlük bir zamanlayıcı gelir ve açıktır:

systemctl list-timers qetra-update.timer
journalctl -u qetra-update --no-pager -n 20

Zamanlayıcı yalnızca Netsoft Access deposundan yalnızca qetra paketini yükseltir; sistemin geri kalanına dokunmaz. Yükseltme servisi yeniden başlatır, yani tünelde birkaç saniyelik bir kesinti olur. Bütün cihazların aynı anda kopmaması için zamanlayıcı rastgele bir gecikmeyle çalışır.

Kapatmak için /etc/qetra/qetra.env içinde:

QETRA_AUTO_UPDATE=0

WireGuard portu meşgulse

Varsayılan port 51820'yi başka bir yazılım tutuyorsa istemci boş bir porta kayar ve bunu günlüğe yazar. Portu kendiniz sabitlemek isterseniz /etc/qetra/qetra.env içinde QETRA_WG_PORT=51821 gibi bir değer verin.

Stok NetBird istemcisinden geçiş

Makinede NetBird istemcisi kuruluysa qetra kurulumu onu durdurur ve cihaz kimliğini devralır: panelde aynı cihaz kalır, overlay IP'si değişmez, yeni bir kayıt oluşmaz.

Diğer dağıtımlar (RHEL, SUSE, Arch…)

Şu an yalnızca .deb paketi sunulmaktadır. Endüstriyel yönlendiriciler için .apk/.ipk paketleri İndirmeler sayfasındadır; rpm yol haritasındadır.