Ana içeriğe geç

UX Sürümü — Web Dashboard

UX (User eXperience) sürümü, SX sürümüyle aynı hafif düğüm daemon'unu çalıştırır, ancak düğümü ve ağı bir tarayıcıda izleyebilmeniz için gömülü bir web dashboard'u ekler. İkili dosya lightnode-ux'tur. SX sürümü gibi, bu da hafif düğümün v3.1.2 hattıdır (zincir sürümünden ayrı, kendi sürümü).

UX sürümü, masaüstü kullanımı ve komut satırı yerine görsel bir arabirimi tercih eden operatörler için doğru seçimdir.

Kurulum

Derlenmiş ikili dosyalar hiçbir yerel bağımlılık olmadan altı platformda doğrudan çalışır — Linux (amd64, arm64), macOS (Intel, Apple Silicon) ve Windows (amd64, arm64) — her biri yaklaşık 16 MB. Çalıştırmadan önce indirmenin sağlama toplamını manifestle doğrulayın — nasıl yapılacağı için bkz. SX Sürümü.

Kaynaktan derleme

UX sürümü Go 1.26.1 gerektirir. Kuantum sonrası kriptografisi saf Go ile yazılmış bir uygulamadır (CGO yok, yerel kitaplık yok):

go build -o build/lightnode-ux ./cmd/lightnode-ux/

Bu, build/lightnode-ux üretir.

Docker

UX hizmeti Dockerfile.ux'ten derlenir:

docker compose up lightnode-ux

UX konteyneri verilerini /root/.qorechain-lightnode konumundaki adlandırılmış bir birimde kalıcı kılar ve zincir RPC adresini QORECHAIN_RPC_ADDR ortam değişkeninden okur.

Çalıştırma

UX düğümünü başlatın:

build/lightnode-ux start

Bu, daemon'u ve gömülü dashboard sunucusunu birlikte başlatır. UX sürümü her zaman dashboard'u etkinleştirir. Başlangıçta ikili dosya dashboard URL'sini yazdırır.

UX sürümü kurulumunu SX sürümüyle paylaşır: ~/.qorechain-lightnode konumundan aynı config.toml'u okur ve aynı Dilithium-5 anahtarlığını kullanır. Düğümü henüz yapılandırmadıysanız, yapılandırmayı yazmak ve anahtarınızı içe aktarmak veya oluşturmak için önce SX sihirbazını (lightnode-sx onboard) çalıştırın — bkz. SX Sürümü.

8420 numaralı bağlantı noktasındaki web dashboard'u

Dashboard 8420 numaralı bağlantı noktasında sunulur. Bu, lightnode-ux Docker imajının bildirdiği (EXPOSE 8420) bağlantı noktasıdır ve ikili dosyanın varsayılan olarak bağlandığı bağlantı noktasıdır; dolayısıyla Docker'da çalışırken dashboard 8420 üzerinden yayınlanır:

http://localhost:8420
Compose bağlantı noktası eşlemenizi kontrol edin

Başka yerlerdeki bazı metinler dashboard için 8080 bağlantı noktasına atıfta bulunur. Yetkili değer 8420'dir — imajın gerçekte sunduğu ve daemon'un varsayılan olarak bağlandığı budur. Kendi docker-compose.yml dosyanızı veya bir ters proxy'yi uyarlarsanız, 8080'e değil 8420'ye eşleyin.

Dashboard'daki hiçbir rota kimlik doğrulaması yapmaz

8420 numaralı bağlantı noktasının arkasındaki hiçbir şeyde giriş veya erişim kontrolü yoktur — oraya ulaşabilen herkes yapılandırmanızı, delegasyonlarınızı ve ödüllerinizi okuyabilir; hiçbir özel anahtar asla sunulmaz. İkili dosya artık tüm arabirimler yerine varsayılan olarak yalnızca loopback'e bağlanır (127.0.0.1:8420) ve daha geniş dinleyecek şekilde yapılandırdıysanız başlangıçta bir uyarı yazdırır — ancak bu uyarı bir reddetme değildir ve kimlik doğrulaması eklemez. Bağı kasıtlı olarak genişletiyorsanız (örneğin başka bir makineden erişmek için veya bağlantı noktasını Docker'dan yayınladığınız için), doğrudan açığa çıkarmak yerine kimlik doğrulaması gerektiren bir ters proxy'nin arkasına yerleştirin. WebSocket telemetri bağlantısı da tarayıcının Origin bilgisini kontrol eder, çünkü geniş bir ağ bağı tek başına aynı tarayıcıda açık başka bir sayfanın bağlanmasını engellemez.

Dashboard neleri gösterir

Dashboard aşağıdaki görünümlere göre düzenlenmiştir:

  • Overview — blok yüksekliği ve düğüm durumuna hızlı bakış.
  • Validators — bağlı doğrulayıcı kümesi.
  • Delegation — mevcut delegasyonlarınız ve bölünmeleri.
  • Network — canlı ağ telemetrisi ve son eşitlenmiş başlıklar.
  • Bridge — çapraz zincir köprü telemetrisi.
  • Tokenomics — token ekonomisi telemetrisi.
  • Settings — düğümün etkin yapılandırması.

Telemetri gerçek zamanlı olarak güncellenir; daemon, doğrulayıcılar, ağ, köprü ve tokenomik verilerini bağımsız aralıklarda yeniler (config.toml içinde [telemetry] altında yapılandırılabilir).

Yalnızca yerel afişi

Düğümde yapılandırılmış bir zincir RPC uç noktası yoksa, dashboard yalnızca yerel modda çalışır ve durumu açıklayan belirgin bir afiş gösterir: PQC yığını doğrulanmıştır, ancak düğüm hiçbir zinciri eşitlemiyordur, dolayısıyla blok yüksekliği 0 olarak kalır. Afiş, sizi ana makinede katılım sihirbazını çalıştırmaya yönlendirir:

lightnode-sx onboard

Sihirbaz PQC kendi kendine testini çalıştırır, zincir uç noktanızı ister ve doğrulayıcı anahtarınızı içe aktarır veya oluşturur. Bir uç nokta yapılandırıldıktan sonra düğümü yeniden başlatın; dashboard canlı zincir verilerini göstermeye başlar.

Sonraki adımlar