İndirmeler
Tüm istemci paketleri bu sunucudan (docs.qetra.tr) dağıtılır.
Masaüstü / Sunucu
| Platform | Paket | Boyut | Not |
|---|---|---|---|
| Windows 10/11 (x64) | NetsoftAccessVPN-Setup-0.2.60.exe | ~4,7 MB | Yerli Rust istemci (tepsi arayüzü + servis), imzalı — kurulu istemciler kendiliğinden güncellenir |
| Debian/Ubuntu (amd64) | Paket deposu — aşağıya bakın | ~1,4 MB | Yerli Rust istemci, otomatik güncellenir |
| macOS 12+ (Intel x64) | QetraVPN-1.0.0-macos-x64.pkg | ~13 MB | NetBird tabanlı (yerli istemci hazırlanıyor) |
Debian / Ubuntu — tek satır
curl -fsSL https://docs.qetra.tr/install.sh | sh
Betik cihazı Netsoft Access apt deposuna bağlar ve qetra paketini kurar. Tek bir
.deb indirmek yerine depoya bağlamamız bilinçli: bir VPN istemcisinin
güvenlik düzeltmesi almadan sahada asılı kalmaması gerekir.
Deponun elle eklenmesi (betiği çalıştırmak istemeyenler için):
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
Otomatik güncelleme
Kurulumla birlikte günlük bir zamanlayıcı (qetra-update.timer) gelir;
yalnızca Netsoft Access deposundan yalnızca qetra paketini yükseltir,
sistemin geri kalanına dokunmaz. Yükseltme servisi yeniden başlatır —
tünelde birkaç saniyelik kesinti olur, bu yüzden zamanlayıcı rastgele bir
gecikmeyle çalışır (tüm filo aynı anda kopmasın).
Kapatmak için /etc/qetra/qetra.env içinde QETRA_AUTO_UPDATE=0.
Durumu görmek için: systemctl list-timers qetra-update.timer
NetBird tabanlı eski .deb kaldırıldı
Daha önce buradan dağıtılan qetra-vpn_1.0.0_amd64.deb NetBird tabanlıydı
ve netbird up komutuyla kullanılıyordu. Yerini yerli Rust istemcimiz aldı.
O paketi kurmuş bir makinede yukarıdaki kurulum, cihaz kimliğini koruyarak
geçiş yapar: panelde aynı cihaz kalır, overlay IP'si değişmez.
Endüstriyel Yönlendirici — qetra (Rust) 0.2.40
Yönlendiricinin ürün yazılımına göre paket biçimi değişir. Yanlış biçimi kurmayı denemek zararsızdır (paket yöneticisi reddeder), ama doğrusunu baştan seçmek zaman kazandırır:
| Ürün yazılımı | Paket yöneticisi | İndirilecek |
|---|---|---|
| RUT2xx — OpenWrt 24.10+ / snapshot | apk |
qetra-0.2.40-r1-mipsel_24kc.apk (~1.3 MB) |
| RUT2xx — RUTOS ve eski OpenWrt | opkg |
qetra_0.2.40-1_mipsel_24kc.ipk (~1.3 MB) |
| RUTX serisi — OpenWrt 24.10+ / snapshot | apk |
qetra-0.2.40-r1-arm_cortex-a7_neon-vfpv4.apk (~1.1 MB) |
| RUTX serisi — RUTOS ve eski OpenWrt | opkg |
qetra_0.2.40-1_arm_cortex-a7_neon-vfpv4.ipk (~1.1 MB) |
Emin değilseniz cihazda tek komut:
command -v apk >/dev/null && echo ".apk indirin" || echo ".ipk indirin"
Paket deposu (önerilen)
Tek tek dosya indirmek yerine cihazı Netsoft Access deposuna bağlayın; sonraki
güncellemeler apk upgrade qetra / opkg upgrade qetra kadar kısalır.
wget -q -O /etc/apk/keys/qetra-repo.pem https://docs.qetra.tr/downloads/repo/qetra-repo.pem
mkdir -p /etc/apk/repositories.d
echo "https://docs.qetra.tr/downloads/repo/apk/$(apk --print-arch)/packages.adb" \
> /etc/apk/repositories.d/qetra.list
apk update && apk add qetra
--allow-untrusted gerekmez.
ARCH=$(opkg print-architecture | awk '/cortex|mipsel/{print $2}' | head -1)
echo "src/gz qetra https://docs.qetra.tr/downloads/repo/opkg/$ARCH" \
>> /etc/opkg/customfeeds.conf
opkg update && opkg install qetra
Kurulum (mevcut yapılandırma ve cihaz kimliği korunur):
apk add --allow-untrusted ./qetra-0.2.40-r1-mipsel_24kc.apk
opkg install ./qetra_0.2.40-1_mipsel_24kc.ipk
Yükseltmede ne olur?
Yükseltme cihazın kimliğini ve UCI ayarlarını korur — overlay IP'niz ve
panel kaydınız değişmez. Yeni yapılandırma şablonu /etc/config/qetra.apk-new
olarak ayrı bırakılır, mevcut ayarlarınızın üzerine yazılmaz.
0.2.30 ve oncesinden yukseltiyorsaniz
0.2.30'a kadar olan surumlerde kurulum betigi, zaten calisan servisi
yeniden baslatmiyordu: yeni dosya diske yaziliyor ve qetra --version yeni
surumu gosteriyor, ama calisan surec eski kod olarak kaliyordu. 0.2.31 bunu
duzeltir - kurulum servisi kendisi yeniden baslatir.
Yukseltmenin gercekten uygulandigini gormek isterseniz, servisin yeniden basladigi log satirlarina bakabilirsiniz:
logread | tail -20
Sunucu (Denetleyici) Kurulum Paketi
Kendi sunucunuzu kuracaksanız. Konteyner imajları, yönetim ikilileri ve panel tek arşivdedir; kurulum internet gerektirmez.
Hazır sanal makine imajları — işletim sistemi ve tüm bileşenler gömülü, ilk açılışta kurulum sihirbazı karşılar:
| Biçim | Platform | Dosya |
|---|---|---|
| Kurulum ISO'su | Proxmox, ESXi, bare-metal | installer-2.1.1.iso (3,3 GB) |
| qcow2 | Proxmox / KVM | 2.1.1.qcow2 (2,8 GB) |
| OVA | VMware / VirtualBox | 2.1.1.ova (2,8 GB) |
| VHDX | Hyper-V | 2.1.1.vhdx (6,1 GB) |
Mevcut bir Ubuntu 24.04 sunucusuna kuracaksanız kurulum paketi:
| Paket | Boyut | İçindekiler |
|---|---|---|
| qetra-seed-v2.1.2-ctl0.2.41.tar.gz | ~164 MB | Kontrol düzlemi 0.2.41, helmqet 1.1.2, yönetim konsolu, panel, Dex/Traefik/nginx imajları |
SHA-256: 564a713d66de188a1b6e28c3924fe54b745760c265d6fb04eedd9372759c246b
NetBird'den taşınıyorsanız 2.1.2 kullanın
0.2.41, göç sırasında rotaların sessizce düşmesini düzeltir. Daha eski bir sürümle taşınan kurulumda yayınlanmış ağ rotaları hiç aktarılmaz ve bunu söyleyen bir uyarı da çıkmaz.
Önceki sürüm hâlâ erişilebilir: qetra-seed-v2.1.1-ctl0.2.40.tar.gz
Kurulum sırasında internet gerekiyor
Paket dört konteyner imajını da içerir, ancak Dex imajı digest ile
sabitlendiği için docker load sonrası yerelden çözülemiyor; kurulum onu
çekmeye çalışır. Yani paket şu an tam hava-boşluklu (air-gap) kurulumu
desteklemiyor — kurulum yapacağınız makinenin ghcr.io'ya erişmesi
gerekiyor. Diğer üç imaj (kontrol düzlemi, Traefik, nginx) yerelden
çözülüyor. Ölçüldü: 2026-09-02.
Adım adım: Sunucu Kurulumu · özetler: appliance/SHA256SUMS
Ürün Yazılımı (Firmware)
Qetra SDWAN-Lite imajları — panel, tüm Qetra araçları ve VPN istemcisi gömülü.
Her dizinde SHA256SUMS bulunur.
| Cihaz | Sürüm | Dosya | Kullanım |
|---|---|---|---|
| RUTX12 | v1.4.6 (qetra 0.2.40) | qetra-rutx12-v1.4.6-sysupgrade.tar | Cihaz içinden: sysupgrade /tmp/qetra-rutx12-v1.4.6-sysupgrade.tar (ayarlar korunur) |
| RUTX12 | v1.4.6 | factory.ubi | Yalnız bootloader menüsünden |
| RUTX12 | v1.4.6 | initramfs.itb | RAM-boot testi (flaşa yazmaz) |
| RUTX50 (5G) | v1.1.10 (qetra 0.2.40) | qetra-sdwan5g-rutx50-v1.1.10-sysupgrade.tar | Cihaz içinden: sysupgrade /tmp/qetra-sdwan5g-rutx50-*.tar (ayarlar korunur) |
| RUTX50 (5G) | v1.1.10 | factory.ubi | Yalnız bootloader menüsünden |
| RUTX50 (5G) | v1.1.10 | initramfs.itb | RAM-boot testi (flaşa yazmaz) |
| RUT200 | v1.6.2 (OpenWrt 25.12.4, qetra 0.2.40) | qetra-rut200-1.6.2-sysupgrade.bin | Cihaz içinden: sysupgrade /tmp/qetra-rut200-*.bin (ayarlar korunur) |
| RUT200 | v1.6.2 | factory.bin | İlk kurulum (stok arayüzden) |
Ürün yazılımı yükseltmesi, paketle kurulan istemciyi GERİ ALIR
İstemci cihaza iki yoldan gelebilir ve ikisi ayrı yerlerde durur:
- İmaja gömülü (
/rom/usr/bin/qetra) — kalıcıdır, ama sürümü imajın çıktığı andaki sürümdür. - Paketle kurulu (
apk add qetra/opkg install) — overlay'e yazılır.
Ayarları koruyan bir sysupgrade overlay'i siler. Bu yüzden paketle
yapılmış bir yükseltme, ürün yazılımı güncellemesinde geri alınır:
imajdaki eski sürüm geri döner ve paket veritabanı da gider. Belirti
sinsidir — cihaz çalışır, yalnız eski koddadır.
Ürün yazılımını güncelledikten sonra istemciyi tekrar kurun:
apk update && apk add qetra # veya: opkg update && opkg install qetra
qetra --version # beklenen sürümü doğrulayın
Ayrıca apk upgrade qetra, istemci yalnızca imajdan geliyorsa sessizce
hiçbir şey yapmaz (ortada paket olmadığı için "OK" der ve sürüm değişmez).
O durumda upgrade değil add kullanın.
sysupgrade -n cihazın VPN kimliğini siler
-n bayrağı yapılandırma korumasını komple kapatır. Qetra imajları
/etc/qetra/ (cihaz kimliği ve yapılandırması), /etc/dashboard/ ve depo
ayarlarını (qetra-repo.pem, qetra.list) bilerek koruma listesine alır;
-n bunların hepsini atar. Sonuç: cihaz panelden düşer, yeniden kayıt
gerekir ve overlay IP'si değişir.
Normal yükseltmede -n kullanmayın:
sysupgrade /tmp/qetra-<cihaz>-<sürüm>-sysupgrade.tar
-n yalnız cihazı bilerek sıfırdan kurmak istediğinizde doğrudur.
RUTX serisi: cihaz içinden yalnız .tar kullanın
OpenWrt çalışan bir RUTX12 veya RUTX50'de sysupgrade.tar kullanılır.
.ubi imajını cihaz içinden sysupgrade'e vermek UBI bölümünü bozar ve
cihazı açılmaz hâle getirir; .ubi yalnız bootloader'dan yüklenir.
Sürüm doğrulama
Her dosyanın SHA-256 özeti: SHA256SUMS
sha256sum -c --ignore-missing SHA256SUMS
Kurulumdan sonra
Paket kurulumu cihazı ağa bağlamaz. Bağlantı komutu (yönetim adresi + kurulum anahtarı) kurumunuzun panelinden alınır: Cihazlar → Cihaz Bağla.