Wiki

uVersion Server Kurulumu

Yolunuzu seçin: Ubuntu / Debian (.deb paketi), Windows (PowerShell) veya Docker.

uVersion sunucusu Ubuntu/Debian üzerinde, Windows üzerinde veya Docker aracılığıyla tek bir komutla kurulur. Kurulum programı birkaç soru sorar, PostgreSQL'i, veritabanını, sistem hizmetini ve HTTPS sertifikasını kurar, ardından size yönetici parolanızı gösterir. On dakika hesaplayın.

Terimler

Bu sayfalarda altı sözcük her yerde karşınıza çıkar. Biri size yabancıysa bu bölüm yeterlidir: başka hiçbir şey bilindiği varsayılmaz.

Veri klasörü: sunucunun size ait olan her şeyi, yani sürüm denetimindeki dosyalarınızın içeriğini, sertifikasını ve kimliğini yazdığı klasör. Kurulum sırasında onu siz seçersiniz. Yedeklenecek klasör budur.
PostgreSQL kümesi: kendi klasörü ve kendi bağlantı noktası olan bir veritabanı örneği. Aynı makine, birbirlerini görmeden birkaç tanesini barındırabilir. uVersion, verdiğiniz yanıta göre sistemin kümesini ya da kendi kümesini kullanır.
Sistem hizmeti: arka planda çalışan ve makine açıldığında kendiliğinden yeniden başlayan bir program. Windows'ta «Windows hizmeti», Linux'ta «systemd birimi» denir.
TLS parmak izi: sunucunun sertifikasını tanımlayan 64 karakterlik bir dizi. Bir makineye ilk SSH bağlantısı gibi, her iş istasyonunda bir kez onaylarsınız.
Etkinleştirme kodu: e-posta ile alınan UV-XXXX-XXXX-XXXX kodu. Kurulum programı bunu tam lisansınızla değiştirir. Yalnızca bir kez kullanılır.
Purge (tümüyle kaldırma): yapılandırma yanıtları dahil, bir paketin tamamen kaldırılması. Debian'da apt remove programı kaldırır, apt purge ayrıca ayarlarını da kaldırır.

Ön koşullar

Bir makine (VPS, mini PC, ofis sunucusu); Ubuntu 24.04+, Debian 13+ veya Windows 10, 11, Server 2019+ çalıştıran. Diğer dağıtımları Docker kapsar.
O makinede yönetici hakları: Linux'ta root (uygulamada sudo ile) veya Windows'ta PowerShell «Yönetici olarak çalıştır». Kurulum programı bunlar olmadan başlamayı reddeder.
uVersion etkinleştirme kodunuz (biçim UV-XXXX-XXXX-XXXX); lisansınız oluşturulduğunda e-posta ile gelir veya hesap alanınızdan alınabilir. Bu kod tek kullanımlıktır: bir kez değiştirildiğinde başka bir makinede artık kullanılamaz.
licence.uversion.io adresine giden yönde İnternet erişimi (HTTPS); kodun değiştirilmesi süresince. İnternet erişimi olmayan bir ağda, Ubuntu sayfasındaki «Etkileşimsiz ve çevrimdışı kurulum» bölümüne bakın: kurulum programı tam lisans anahtarını da kabul eder; bunu başka bir iş istasyonunda hesap alanınızdan alırsınız.
PostgreSQL. Ubuntu ve Debian'da paketin bağımlılığı olarak otomatik gelir, yapmanız gereken bir şey yoktur. Windows'ta kurulum programı onu winget ile kurar; winget, Windows Server 2019 ve 2022'de yoktur: bu iki sürümde, betiği çalıştırmadan önce PostgreSQL 16'yı elle kurun.
Disk alanı. Sunucunun kendisi ve veritabanı az yer kaplar: baskın olan, parça deposudur (tüm sürümleriyle birlikte dosyalarınızın içeriği); bu yüzden Unreal projelerinizin boyutuna ve geçmişine göre ölçeklendirin. Veritabanını da veri klasörüne yerleştirirseniz, kurulum programı oraya ayrıca 1 GB'lık bir balast (dolgu) dosyası yazar; disk dolduğunda silinmelidir.
Gelen yönde açık TCP bağlantı noktası 8443, iş istasyonlarınız buradan bağlanır. Windows kurulum programı güvenlik duvarı kuralını kendi oluşturur. Debian paketi hiçbir bağlantı noktası açmaz: bunu kendiniz yapın, örneğin sudo ufw allow 8443/tcp.

Yolunuzu seçin

Ubuntu / Debian

Ubuntu 24.04+, Debian 13+. .deb paketi ile kurulum.


        sudo apt install ./uversion-server_*.deb

Windows

Windows 10, 11, Server 2019+. Yönetici olarak tek satırlık PowerShell.


        iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex

Docker

Sunucu ve veritabanı konteynerlerde. Red Hat ailesinde (RHEL, Rocky, AlmaLinux, Fedora) desteklenen tek yol.


        docker compose up -d

HTTPS ve sertifika

Sunucu 8443 bağlantı noktasında yalnızca HTTPS konuşur. Yapılandırılacak bir şey yoktur ve herhangi bir alan adı gerekmez: ilk açılışta sunucu, kendinden imzalı denen sertifikasını kendisi üretir ve kurulumun sonunda SHA-256 parmak izini gösterir. Her iş istasyonu bu parmak izini ilk bağlantıda bir kez onaylar ve sonrasında farklı her parmak izini reddeder.

Görünür sonuç: https://<sunucu-ip>:8443 adresini açan bir tarayıcı bir güvenlik uyarısı gösterir; çünkü bu sertifika herhangi bir genel makam tarafından imzalanmamıştır. Bu beklenen bir durumdur. Gösterilen parmak izinin kurulumda not ettiğiniz parmak izi olduğunu doğrulayın, ardından devam edin.

Sunucuya ilk baglantida tarayicinin gosterdigi guvenlik uyarisi ve devam etmeyi saglayan dugme.

İş istasyonu tarafındaki yordamın ayrıntıları: TLS parmak izi. Sunucunuzun bir alan adı varsa ve zaten bir sertifikanız varsa, onun yerine kendinizinkini koyabilirsiniz: sunucuyla birlikte gelen işletim el kitabının (docs/operations.md) 2. bölümüne bakın.

Sonrası?

Kurulum, bir kutu içinde admin kullanıcı adını, geçici bir parolayı ve sunucu adresini gösterir. Bunları not edin. Ardından ağdaki herhangi bir iş istasyonundan, bir tarayıcı veya masaüstü istemcisiyle, https://<sunucu-ip>:8443 adresine bağlanırsınız; burada <sunucu-ip> az önce kurduğunuz makinenin adresidir.

İlk oturum açma : başlangıç parolasıyla giriş yapın ve değiştirin
TLS parmak izi : kendinden imzalı sertifika, istemci tarafında bir kez onaylanır
Sorun giderme : "hizmet başlamıyor", "etkinleştirme kodu reddedildi" vb.