Aztec Lokal RPC Kurulum Rehberi (Geth + Prysm)

Bu rehber, kendi VPS sunucunuzda Sepolia için Geth (Execution) + Prysm (Beacon) RPC kurulumunu sadece tek komutla yapabilirsiniz. Her şey Docker kullanılarak otomatik kurulur. Bu RPC'leri Aztec Sequencer node'larınızda kullanabilir ve hiçbir sorun yaşamazsınız.


Sistem Gereksinimleri

GereksinimDetaylar
Depolama600 GB - 1 TB SSD
टक्कर मारनाEn az 16 GB
CPU6-8 Çekirdek
İşletim SistemiUbuntu 22.04+

1- Tek Komutla Kurulum:

[ -f "new_script.sh" ] || curl -sSL -o new_script.sh https://raw.githubusercontent.com/UfukNode/geth-prysm-node-setup/main/script.sh; \
apt update -y && apt install curl -y && \
chmod +x new_script.sh && ./new_script.sh

Kurulum sonunda Geth ve Prysm Docker içinde otomatik başlar.


2- Sync Durumu Kontrolü:

Kurulum sonrası senkronizasyon durumunu anlık kontrol etmek için:

bash <(curl -s https://raw.githubusercontent.com/UfukNode/geth-prysm-node-setup/main/sekronize-kontrol.sh)

Örnek Çıktı - Senkronize OLDU:

Ekran görüntüsü 2025-05-15 144800

Örnek Çıktı - HENÜZ Devam Ediyor:

WhatsApp Görsel 2025-05-15 saat 18 53 38_0ae9c891

3- Logları İzleme Komutu:

Loglarını anlık görmek için:

docker logs -f geth

Örnek Çıktı -Kurulum Devam Ediyorsa:

Ekran görüntüsü 2025-05-15 013036

Örnek Çıktı - Kurulum Bittiyse:

Ekran görüntüsü 2025-05-16 192151

Geth (Execution Node):

  • Sepolia ağı FULL NODE kuruyorsun, ilk senkronizasyonu çok uzun sürer.
  • 600 GB - 1 TB arası veri indirir.
  • 1 gün kadar sürebilir, ağ hızın ve VPS performansına bağlı.
  • Disk'i aşağıdaki komut ile dolup dolmadığını kontrol edebilirsin:

df -h

Prysm (Beacon Node):

  • Çok daha hızlı senkronize olur.
  • Genelde 1-2 saatte başlar ama tam senkronizasyon Geth'e bağlıdır.

- Sabırlı olun. - Geth %100 olmadan Aztec node hatalar verir.


4- VPS Güvenlik Duvarı Ayarları (Mutlaka Yapılmalı)

A- Duvarı Aktif Et:

sudo ufw allow 22
sudo ufw allow ssh
sudo ufw enable

B- Geth P2P Bağlantılarına İzin Ver:

sudo ufw allow 30303/tcp
sudo ufw allow 30303/udp

C- Hem Lokal Hem Dış IP İçin Geth & Prysm RPC Portlarını Aç:

sudo ufw allow 8545/tcp
sudo ufw allow 3500/tcp
sudo ufw allow from 127.0.0.1 to any port 8545 proto tcp
sudo ufw allow from 127.0.0.1 to any port 3500 proto tcp

D- Duvar Ayarlarını Uygula:

sudo ufw reload


5- RPC Adreslerini Doğru Kullanma (CLI ve Docker Ayrımı):

📌 Aztec Sequencer kurarken Geth ve Prysm RPC'lerini doğru yazmazsan node hata verir. Bu yüzden Docker kuranlarla CLI kuranların kullanacağı adresler farklıdır.


✅ Geth Execution RPC

Kurulum TürüDoğru Adres Örneğiस्पष्टीकरण
Docker Compose ile kurulumhttp://127.0.0.1:8545Docker Bridge kullanır. Bu yüzden localhost zorunlu.
CLI (senin scriptin) ile kurulumhttp://vps-ip:8545Dış IP üzerinden kullanılmalı. Docker olmadığı için IP fark etmez.

Özet:

  • Docker ile kurduysan: Aztec Sequencer node içinde mutlaka http://127.0.0.1:8545 kullan.
  • Senin scriptin ile kurduysan: http://vps-ip:8545 şeklinde sunucunun dış IP adresini kullan.

✅ Prysm Beacon RPC

Kurulum TürüDoğru Adres Örneğiस्पष्टीकरण
Docker Compose ile kurulumhttp://127.0.0.1:3500Docker Bridge kullanır. Sadece localhost üzerinden erişilir.
CLI (benim rehberimle kurduysan) ile kurulumhttp://kendi-sunucu-ip:3500Direkt VPS IP'si üzerinden kullanılır.

Özet:

  • Docker ile kurduysan: Aztec Sequencer node'a http://127.0.0.1:3500 yaz.
  • Benim scriptin ile kurduysan: http://kendi-sunucu-ip:3500 şeklinde VPS IP kullanılır.

📌 KURAL:

  • Docker Compose:

* Sequencer node'un aynı sunucuda çalışıyorsa: localhost * Farklı sunucudan kullanılamaz.

  • CLI (benim rehberim ile yaptıysan):

* Hem içeride hem dışarıda VPS IP'si kullanılır. * localhost kullanırsan hata alırsın.


⚠️ Unutma:

  • Docker Compose izolasyonlu çalışır. Sadece iç ağdan (localhost) erişilir.
  • Benim rehberim yani CLI ile kurduysan VPS IP'ni girerek direkt kullanabilirsin.

Ulaşmak & Sorularınız İçin:

https://x.com/UfukDegen