Ana içeriğe geç

Hızlı Başlangıç

Dakikalar içinde bir QoreChain düğümü çalıştırın. En hızlı kurulum için Docker Compose'u seçin veya tam kontrol için kaynaktan derleyin.


Docker Compose (Önerilen)​

Tüm servisleri önceden yapılandırılmış şekilde tam bir QoreChain ortamı çalıştırmanın en basit yolu.

git clone https://github.com/qorechain/qorechain-core.git
cd qorechain-core
cp .env.example .env
cp .env.sidecar.example .env.sidecar
# edit .env and set GRAFANA_PASSWORD (Compose refuses to start without it)
docker compose up -d

İlk başlatmadan önce .env.example dosyasını .env olarak, .env.sidecar.example dosyasını .env.sidecar olarak kopyalayın (yukarıdaki gibi) ve GRAFANA_PASSWORD değerini ayarlayın.

Bu, aşağıdaki servisleri başlatır:

ServisPortlarAçıklama
qorechain-node26657 (RPC), 1317 (REST), 9090 (gRPC), 8545 / 8546 (EVM)Çok VM desteğine sahip tam blok zinciri düğümü
ai-sidecar50051QCAI anomali tespiti ve risk puanlama motoru
indexer--Geçmiş sorgular için blok dizinleyici
postgres5432Dizinleyici için veritabanı arka ucu
prometheus9091Metrik toplama
grafana3001İzleme panoları

Tüm konteynerler sağlıklı duruma geldiğinde yerel, tek düğümlü bir geliştirme zincirine sahip olursunuz (kendi genesis'ini başlatır; ana ağa veya test ağına katılmaz). Canlı bir ağa katılmak için Ana Ağa Bağlanma veya Test Ağına Bağlanma sayfalarını izleyin.


Kaynaktan Derleme​

Ön Koşullar​

  • CGO etkin Go 1.26+
  • Rust araç zinciri (PQC kriptografisi ve SVM çalışma zamanı kütüphanelerini derlemek için)
  • Git

İkili Dosyayı Derleme​

CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/
Kaynaktan derleme yerel geliştirme içindir

Herkese açık kaynak ağacı, topluluk ikili dosyasını derler. Komut kümesinin tamamına sahiptir ancak kuantum sonrası imzalayıcıyı içermez: tx pqc gen-key ve tx pqc cosign bir hata ("requires the full build") döndürür; bu nedenle hibrit imza gerektiren bir ağ için işlem oluşturamaz ve taslak (stub) keeper'ları ağların konsensüs durumunu yeniden üretmez. Ana ağa veya test ağına katılmak ya da bu ağlarda işlem yapmak için download.qore.host adresindeki latest.json içinde belirtilen sürüm ikili dosyasını kurun.

Düğümü Başlatma​

./qorechaind init my-node --chain-id qorechain-diana

Bu, ~/.qorechaind/ altında varsayılan yapılandırma ve veri dizinlerini oluşturur. Tek başına başlatıldığında düğüm, yerel tek düğümlü bir zincir oluşturur; canlı bir ağa katılmak için Bağlanma sayfalarını izleyin.

Düğümü Çalıştırma​

./qorechaind start

Düğüm varsayılan ayarlarla başlar. Uygun genesis ve eş yapılandırmasıyla canlı ağa katılmak için Test Ağına Bağlanma bölümüne bakın.

not

Bu sayfadaki örnekler qorechain-diana test ağını (EVM zincir kimliği 9800) hedefler. Ana ağ (qorechain-vladi, EVM zincir kimliği 9801) 7 Haziran 2026'dan beri canlıdır (12 Kasım 2026'dan beri v3.2.7 sürümü; test ağı 12 Kasım 2026'dan beri v3.2.8 çalıştırır) ve kendine ait özel bir Ana Ağa Bağlanma sayfasına sahiptir.


Kurulumu Doğrulama​

Düğümünüzün doğru çalıştığını teyit edin:

# Check that the binary runs
./qorechaind --help
# Query the node status via RPC
curl localhost:26657/status

Başarılı bir yanıt, düğümün moniker, network (yukarıda oluşturulan yerel geliştirme zinciri için qorechain-diana veya katıldığınız zincir) ve geçerli blok yüksekliğini içerir.


Sonraki Adımlar​