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

Gereksinim	Detaylar
Depolama	600 GB - 1 TB SSD
RAM	En az 16 GB
CPU	6-8 Çekirdek
İşletim Sistemi	Ubuntu 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:

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

---

3- Logları İzleme Komutu:

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

docker logs -f geth

Örnek Çıktı -Kurulum Devam Ediyorsa:

Örnek Çıktı - Kurulum Bittiyse:

---

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	Açıklama
Docker Compose ile kurulum	http://127.0.0.1:8545	Docker Bridge kullanır. Bu yüzden localhost zorunlu.
CLI (senin scriptin) ile kurulum	http://vps-ip:8545	Dış 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	Açıklama
Docker Compose ile kurulum	http://127.0.0.1:3500	Docker Bridge kullanır. Sadece localhost üzerinden erişilir.
CLI (benim rehberimle kurduysan) ile kurulum	http://kendi-sunucu-ip:3500	Direkt 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

---