Ana sayfaya dön

Windows’ta KERNOVIQ

KERNOVIQ’i Windows 10 22H2, 11 ya da Server 2022+ üzerine kurulum sihirbazıyla kurmak: gereksinimler, ağdan erişim, yedekler, yükseltme ve sorun giderme.

KERNOVIQ bir Windows sunucuda ya da bilgisayarda, Linux için Windows Alt Sistemi'nde (WSL 2) kendine ait bir Linux dağıtımında çalışır. Kurulum sihirbazı her şeyi yerine koyar; ağdaki kullanıcılar KERNOVIQ'e, bir Linux sunucuya ulaşır gibi, bu bilgisayar üzerinden HTTPS ile ulaşır. Ürün, verisi ve yedekleri Linux'takiyle aynıdır (kurulum.md, kapali-ag-kurulumu.md).

İngilizcesi: KERNOVIQ on Windows.

kullanıcı tarayıcıları ──HTTPS :443──▶ Windows: KernoviqProxy hizmeti (Caddy)
                                         │ 127.0.0.1:8280 (WSL localhost yönlendirmesi)
                                         ▼
                                       WSL 2: "KERNOVIQ" dağıtımı (Ubuntu 24.04, systemd)
                                         Docker Engine ─ KERNOVIQ (web, API, işçiler, PostgreSQL, Valkey)

1. Gereksinimler

En az Önerilen
Windows Windows 10 22H2, Windows 11, Windows Server 2022 ya da 2025; 64 bit (x64) Windows Server 2025
Bellek 6 GB 8 GB ve üstü
Disk veri klasörünün sürücüsünde 20 GB boş alan 40 GB ve üstü, artı yedekler için yer
İşlemci donanım sanallaştırması açık (Intel VT-x / AMD-V; sanal makinede iç içe sanallaştırma) 4 çekirdek
Ağ kullanıcı ağlarından erişilebilen TCP 443 (yönlendirme için 80); kullanıcılar bu bilgisayarın DNS adını ya da IP adresini açar kullanıcıların çözebildiği, bu bilgisayarı gösteren bir DNS adı
İnternet kurulumda ve yükseltmelerde: Microsoft (WSL), Ubuntu arşivi, KERNOVIQ sitesi ve imaj kayıt defteri

Desteklenmez: Windows Server 2019 ve öncesi, 32 bit ya da Arm Windows, etki alanı denetleyicileri (üye sunucuya kurun). Kurulum için yönetici hesabı gerekir.

2. Kurulum

  1. KERNOVIQ-Setup.exe dosyasını KERNOVIQ sitesinden indirin. Çalıştırmadan önce Özellikler → Dijital İmzalar sekmesine bakın: imzalayan KERNOVIQ yayıncısıdır. Her kurulum programının SHA-256 değeri sürümün imzalı SHA256SUMS dosyasındadır (releases/<sürüm>/).
  2. Yönetici olarak çalıştırın ve lisans sözleşmesini kabul edin.
  3. Kurulum ayarları:
    • Tam sürüm (önerilen): lisans e-postasındaki anahtarı (KQL1…) içeren lisans dosyasını seçin; kurulum tam sürümü bu anahtarla lisans sunucusundan indirir ve lisansı etkinleştirir.
    • Deneme sürümü: lisanssız (deneme sürümü). Sonradan Ayarlar → Lisans'ta girilen anahtar kurulumu yerinde tam sürüme geçirir.
    • İki durumda da ağdaki kullanıcılar HTTPS ile, sunucu adıyla (varsayılan: bu bilgisayarın DNS adı) ya da bu bilgisayarın IP adresiyle (https://192.168.1.20) bağlanır. KERNOVIQ'i yalnızca bu bilgisayara bırakmak için (http://127.0.0.1:8280, başka kimse bağlanamaz) komut satırından kernoviq install --local ile kurun.
    • Kuruluşumun sertifikasını kullan: kurumunuzun CA'sından (ör. AD CS) PEM biçiminde bir sertifika ve özel anahtarı. Seçilmezse kurulum bir iç sertifika otoritesi (iç CA) oluşturur.
    • Veri klasörü: dağıtımın sanal diskinin büyüdüğü yer (varsayılan C:\ProgramData\KERNOVIQ\wsl; yerel bir NTFS sürücü).
  4. Gerekirse kurulum WSL'yi açar. Bunun için Windows'un yeniden başlaması gerekiyorsa sihirbaz söyler; yeniden başlattıktan sonra aynı hesapla oturum açın, kurulum bir pencerede kendiliğinden devam eder.
  5. İlk kurulum 10–20 dakika sürer (Ubuntu, Docker Engine ve KERNOVIQ imajları indirilir). Sonunda sihirbaz şunları gösterir:
    • adres, ör. https://kernoviq.kurum.local;
    • kurumu ve ilk yöneticiyi tarayıcıda oluşturmak için tek kullanımlık bağlantı; kullanılana kadar kimseyle paylaşmayın, sonra devreden çıkarın: kernoviq ctl config set SETUP_TOKEN= ve kernoviq restart (kernoviq status o tanımlı kaldıkça hatırlatır);
    • iç CA ile: kullanıcı bilgisayarlarının güvenmesi gereken C:\ProgramData\KERNOVIQ\kernoviq-ca.crt (bölüm 4);
    • yedek anahtarı C:\ProgramData\KERNOVIQ\keys\backup.key: bu bilgisayarın dışında güvenli bir yere kopyalayın; o olmadan yedekler geri yüklenemez.

Başlat menüsüne adrese giden bir KERNOVIQ kısayolu eklenir; kernoviq komutu her yeni yönetici komut isteminde ya da PowerShell penceresinde çalışır.

Gözetimsiz kurulum

KERNOVIQ-Setup-<sürüm>.exe /S /ACCEPT_EULA /SERVERNAME=kernoviq.kurum.local /LICENSEKEYFILE=C:\lisans.txt
Seçenek
/S sessiz (büyük harf, tek başına)
/ACCEPT_EULA /S ile zorunlu: Son Kullanıcı Lisans Sözleşmesi'ni kabul edersiniz
/EDITION=full ya da demo tam sürüm (varsayılan) ya da deneme; ikisi de ağa hizmet verir
/SERVERNAME=ad kullanıcıların tarayıcıya yazacağı DNS adı (IP adresi de olur)
/LICENSEKEYFILE=dosya lisans anahtarı (tam sürüm için zorunlu)
/CERT=dosya /KEY=dosya [/CA=dosya] kurumunuzun sertifikası (PEM)
/DATADIR=klasör veri klasörü

Çıkış kodları: 0 kuruldu, 3010 Windows yeniden başlamalı (kurulum aynı yöneticinin bir sonraki oturumunda devam eder), 1 başarısız (kayıtlar, bölüm 9), 2 iptal edildi ya da /ACCEPT_EULA eksik.

Sihirbaz kurulum motorunu çalıştırır; yöneticiler motoru doğrudan da kullanabilir: kernoviq help seçenekleri listeler (portlar, --local, --allowed-cidrs, --firewall-public, WSL paketinin ve Ubuntu imajının yerel kopyaları).

3. Kurulumun kurdukları

Parça Ne olduğu
C:\Program Files\KERNOVIQ program: kernoviq.ps1 (motor ve komutlar), bin\kernoviq.cmd (sistem PATH'inde), proxy (proxy\caddy.exe), lisans metinleri, uninstall.exe
C:\ProgramData\KERNOVIQ config.json, logs\, backups\, keys\backup.key, kernoviq-ca.crt, proxy'nin ayarları ve sertifikası (proxy\), dağıtımın diski (wsl\)
KERNOVIQ WSL dağıtımı Ubuntu 24.04 (Canonical'ın imajı, sabitlenmiş SHA-256'sıyla denetlenir), systemd, Ubuntu arşivinden Docker Engine ve Compose v2, otomatik güvenlik güncellemeleri. Windows programlarına ve Windows sürücülerine erişimi yoktur. KERNOVIQ /opt/kernoviq altındadır ve Linux'taki gibi kernoviqctl ile işletilir
kernoviq-wsl hesabı dağıtımın sahibi olan yerel hesap. Rastgele parolasını yalnızca Görev Zamanlayıcı bilir ve parolanın süresi dolmaz; yalnızca zamanlanmış görev çalıştırabilir — yerel, Uzak Masaüstü ya da ağ üzerinden oturum açması yasaktır — ve oturum açma ekranında görünmez
\KERNOVIQ\Distribution görevi Windows açılışında, kimse oturum açmadan: dağıtımı çalışır tutar, durursa yeniden başlatır; yeni yedekleri saatte bir dışarı kopyalar
\KERNOVIQ\Run görevi yöneticilerin kernoviq komutlarını dağıtımın içinde yürütür
KernoviqProxy hizmeti NT SERVICE\KernoviqProxy sanal hesabıyla Caddy: 443'te HTTPS (TLS 1.2 ve 1.3), 80'den yönlendirme, yeniden başlatmadan sonra KERNOVIQ açılırken bir "başlıyor" sayfası; sunucu adına ve bu bilgisayarın IP adreslerine hizmet verir, başka host adları sunucu adına yönlendirilir. Yalnızca bu bilgisayarın erişebildiği 127.0.0.1:8280'e iletir
güvenlik duvarı kuralları (KERNOVIQ grubu) yalnızca proxy hizmeti için gelen 443 ve 80; Etki Alanı ve Özel ağlarda (--firewall-public Ortak ağı da ekler)
WSL ayarları hizmet hesabının .wslconfig dosyası: WSL sanal makinesinin belleği (bilgisayarın belleğinin dörtte üçü, 4 ile 16 GB arası, Windows'a en az 2 GB bırakır; kernoviq memory GB ile değişir)
Uygulama olay günlüğü KERNOVIQ kaynağı: kurulum, yükseltmeler ve dağıtım durmaya devam ederse bir uyarı (olay 1001)

--local ile kurulduysa (yalnızca bu bilgisayar) proxy hizmeti ve güvenlik duvarı kuralı yoktur: KERNOVIQ bu bilgisayarda http://127.0.0.1:8280 adresinden yanıt verir. Deneme sürümü ağa açılmadan önce yapılmış deneme kurulumları da böyledir ve yükseltmelerde böyle kalır.

4. Kullanıcılar ve ağ

  • Ad ya da adres: kullanıcılar sunucu adını — kullanıcılar için bu bilgisayarı göstermelidir (DNS'inizde bir A kaydı) — ya da bu bilgisayarın IP adresini açar. Sertifika bu ad ve bilgisayarın IPv4 adresleri için verilir; başka adlar sunucu adına yönlendirilir. Adres değişince (DHCP) kernoviq cert renew yenisini ekler.
  • İç CA: C:\ProgramData\KERNOVIQ\kernoviq-ca.crt dosyasını kullanıcıların bilgisayarlarına dağıtın, ör. grup ilkesiyle (Bilgisayar Yapılandırması → İlkeler → Windows Ayarları → Güvenlik Ayarları → Ortak Anahtar İlkeleri → Güvenilen Kök Sertifika Yetkilileri). kernoviq ca --trust bu bilgisayarda da güvenilir yapar.
  • Kendi sertifikanız sonradan: kernoviq cert install --cert DOSYA --key DOSYA [--ca DOSYA] (PEM, önce sunucu sertifikası). İç CA'nın sunucu sertifikası kernoviq cert renew ile yenilenir; kernoviq doctor süresi dolmadan 30 gün önce uyarır.
  • Güvenlik duvarı: kurallar Etki Alanı ve Özel ağlarda geçerlidir. Windows'un Ortak saydığı bir ağdaki kullanıcılar bağlanamaz: ağı Özel olarak sınıflandırın ya da --firewall-public ile kurun.
  • İç sistemler (dizin, e-posta aktarıcısı, webhook'lar, özel aralıklardaki tarama hedefleri): kurulumda --allowed-cidrs ya da kapali-ag-kurulumu.md bölüm 8'deki gibi kernoviq ctl.

5. Günlük işletim

Yönetici komut isteminde ya da PowerShell penceresinde:

Komut
kernoviq status neyin çalıştığı ve KERNOVIQ'in yanıt verip vermediği
kernoviq doctor Windows'u, WSL'yi, dağıtımı, proxy'yi, sertifikayı, DNS'i, güvenlik duvarını ve yedekleri öneriyle denetler
kernoviq start, stop, restart bütün uygulama; restart web (tek servis)
kernoviq logs [-f] [SERVİS] uygulamanın kayıtları
kernoviq backup hemen şifreli yedek
kernoviq restore DOSYA [--force] bütün veriyi bir yedekle değiştirir (önce mevcut durumun yedeği alınır)
kernoviq cert show, renew, install sunucu sertifikası
kernoviq ca [--trust | --untrust] iç CA sertifikası
kernoviq proxy reload proxy ayarlarını yeniden yazar ve proxy'yi yeniden başlatır
kernoviq memory [GB] WSL sanal makinesinin belleği (KERNOVIQ yeniden başlar)
kernoviq ctl ARGÜMANLAR… geri kalan her şey için dağıtımın içinde kernoviqctl (kapali-ag-kurulumu.md)
kernoviq upgrade, uninstall, version, help

Windows yeniden başladıktan sonra KERNOVIQ, kimse oturum açmadan birkaç dakikada geri gelir; o zamana kadar kullanıcılar "başlıyor" sayfasını görür.

6. Yedekler

KERNOVIQ her gece ve her yükseltmeden önce dağıtımın içinde şifreli yedek alır. Yeni yedekler saatte bir C:\ProgramData\KERNOVIQ\backups klasörüne kopyalanır: bu klasörü Windows yedeğinize ekleyin. En az 7 yeni kopya kaldığı sürece 45 günden eski kopyalar silinir.

Yedekler yedek anahtarı ile şifrelenir (C:\ProgramData\KERNOVIQ\keys\backup.key, yalnızca yöneticiler okuyabilir). Bir kopyasını bu bilgisayarın dışında saklayın. Geri yüklemek için:

kernoviq restore C:\ProgramData\KERNOVIQ\backups\kernoviq-<tarih>-<etiket>.kqbak

Kaldırma, yedekleri ve anahtarı yerinde bırakır. Aynı bilgisayara yapılan yeni kurulum, kendi yedeğini almadan önce o anahtarı devralır; böylece eski yedekler yeni kuruluma geri yüklenebilir. Orada farklı bir anahtar bulunursa silinmez, backup-<tarih>.key adıyla saklanır. Başka bir bilgisayara geri yüklemek için anahtarı orada KERNOVIQ'i kurmadan önce C:\ProgramData\KERNOVIQ\keys\backup.key olarak kopyalayın, sonra yedeği yeni kuruluma geri yükleyin.

7. Yükseltme

Yeni kurulum programını çalıştırın. Önce yedek alır, dağıtımı ve KERNOVIQ'i yükseltir; yükseltme başarısız olursa önceki sürüme kendiliğinden döner. Ayarlar, veriler ve sertifikalar korunur. Kurulumun çalıştırdığı yapı korunur: tam sürüm (deneme sürümünden geçmiş olanlar dahil) etkin lisans anahtarıyla lisans sunucusundan indirilir; anahtarın yeni sürümü kapsaması gerekir (güncelleme süresi). Deneme kurulumunu elle tam sürüme geçirmek için: kernoviq ctl upgrade-edition. Aynı sürümü yeniden çalıştırmak Windows tarafını onarır (hesap, görevler, proxy, PATH). Gözetimsiz: KERNOVIQ-Setup-<sürüm>.exe /S /ACCEPT_EULA.

WSL'nin kendisi yeniden başlatma isteyen bir güncelleme gerektirirse kurulum bunu söyler (çıkış kodu 3010): Windows'u yeniden başlatın ve kurulum programını bir kez daha çalıştırın.

8. Kaldırma

Ayarlar → Uygulamalar → KERNOVIQ → Kaldır (ya da program klasöründeki uninstall.exe). Son bir yedek alır; sonra proxy hizmetini, güvenlik duvarı kurallarını, dağıtımı ve diskini, görevleri, hizmet hesabını ve profilini, program klasörünü kaldırır. Yedekler ve yedek anahtarı C:\ProgramData\KERNOVIQ altında kalır; onları da silmek için Tüm verileri, yedekleri ve yedek anahtarını da sil kutusunu işaretleyin.

Gözetimsiz: "C:\Program Files\KERNOVIQ\uninstall.exe" /S (yedekler kalır) ya da /S /PURGE (her şey silinir). Çıkış kodları: 0 kaldırıldı, 1 başarısız, 2 iptal edildi. WSL'nin kendisi kurulu kalır: başka yazılımlar kullanıyor olabilir.

9. Sorun giderme

Kayıtlar: C:\ProgramData\KERNOVIQ\logs — install-*.log, upgrade-*.log, uninstall-*.log, distribution.log (dağıtımı çalışır tutan görev), run.log (istek görevi), proxy.log. Olay Görüntüleyicisi → Uygulama KERNOVIQ kaynağının olaylarını gösterir. Sorunların çoğunu kernoviq doctor gösterir.

Belirti Neden ve çözüm
hardware virtualization is off ürün yazılımında Intel VT-x / AMD-V'yi açın; Hyper-V sanal makinesinde: Set-VMProcessor -VMName AD -ExposeVirtualizationExtensions $true (VMware: "Expose hardware assisted virtualization")
cannot run WSL 2 as KERNOVIQ needs it Windows'u 10 22H2, 11 ya da Server 2022 ve üstüne güncelleyin
this computer is a domain controller üye bir sunucuya kurun
TCP port 443 is already in use portu başka bir web sunucusu (IIS) tutuyor: o siteyi durdurun ya da --https-port ile kurun
kullanıcılar sertifika uyarısı alıyor bilgisayarları iç CA'ya henüz güvenmiyor (bölüm 4) ya da sertifikada olmayan bir adı kullanıyorlar: sunucu adını kullanın
Windows'taki curl.exe: CERT_TRUST_REVOCATION_STATUS_UNKNOWN iç CA iptal listesi yayımlamaz, Windows'un curl'ü ise onu arar; tarayıcılar aramaz: --ssl-no-revoke ekleyin (betikler ve izleme)
kullanıcılar hiç bağlanamıyor DNS bu bilgisayarı göstermiyor ya da ağ Windows için Ortak (bölüm 4); kernoviq doctor ikisini de denetler
"başlıyor" sayfası gitmiyor dağıtım açılmıyor: kernoviq doctor, distribution.log; olay 1001 dağıtımın durmaya devam ettiğini gösterir
kurulum başarısız oldu neden sihirbazın ayrıntılarında ve install-*.log dosyasında; sorunu giderip kurulum programını yeniden çalıştırın: yapılmış olanın üzerinden devam eder
PowerShell betikleri reddediyor grup ilkesi imzalı betik istiyor (AllSigned): KERNOVIQ'in betikleri imzalıdır, yayıncının sertifikasını bilgisayarın Güvenilir Yayımcılar deposuna ekleyin

10. Güvenlik notları

  • Dağıtım Windows programlarını başlatamaz ve Windows sürücülerini görmez; Windows ile arasında dosyalar yalnızca istek görevi üzerinden, hizmet hesabıyla taşınır.
  • Ağı yalnızca proxy hizmeti dinler. KERNOVIQ'in kendi 8280 portu 127.0.0.1'e bağlıdır; PostgreSQL, Valkey ve API dağıtımın dışına açılmaz.
  • Yedek anahtarını, proxy'nin özel anahtarını ve ayarları yalnızca yöneticiler ve SYSTEM okuyabilir; hizmet hesabı yalnızca çalıştığı klasörleri değiştirebilir.
  • Kurulum programı, kaldırma programı ve PowerShell betikleri yayıncının kod imzalama sertifikasıyla imzalıdır; kurulumun indirdikleri (WSL, Ubuntu, Caddy, KERNOVIQ) sabitlenmiş sağlama toplamlarıyla ya da sürüm imzasıyla denetlenir.
  • KERNOVIQ Windows'tan da telemetri göndermez.

Bu sayfa ürünle birlikte gelen Windows belgesinden üretilir.