0G AI Alignment Node - Servis Kurulum Rehberi
0G AI Alignment Node - Servis Kurulum Rehberi
Sistem Gereksinimleri
Öncelikle sisteminizin bu minimum gereksinimleri karşıladığından emin olun:
RAM
2 GB
CPU
1 x86 Core @ 2.1GHz
Disk Alanı
50 GB
İnternet
100 Mbps bağlantı
Network
Port dışarıdan erişilebilir olmalı (firewall'da yapılandır)
NOT: private key işlemelride baştaki 0X kullanmıyoruz.
LOGLARINIZI KİMSEYLE PAYLAŞMAYINIZ... KİMSEYLE
CoreNode Operator Adres : 0xb984B1f158963417467900b4Be868f83deA007fC
Adım 1: Dizin Yapısı ve Binary Kurulumu
1. Ana dizini ve alt klasörleri oluşturun:
# Ana 0G dizinini ev dizininde oluştur
mkdir -p $HOME/0g-ai/{bin,config,logs}
2. Node binary'sini indirin ve yerleştirin:
# 0g-ai dizinine geçin
cd $HOME/0g-ai
# En son 0G alignment node binary'sini indirin
wget https://github.com/0gfoundation/alignment-node-release/releases/download/v1.0.0/alignment-node.tar.gz
tar -xzf alignment-node.tar.gz
# Çalıştırma izni verin
mv alignment-node/0g-alignment-node $HOME/0g-ai/bin/0g-alignment-node
chmod +x $HOME/0g-ai/bin/0g-alignment-node
rm -rf alignment-node alignment-node.tar.gz
3. Sistem genelinde erişim için symbolic link oluşturun:
# /usr/local/bin'e symbolic link oluştur (sistem geneli erişim)
sudo ln -s $HOME/0g-ai/bin/0g-alignment-node /usr/local/bin/0g-alignment-node -f
# Link'in çalıştığını test edin
0g-alignment-node --help
Adım 2: Yapılandırma Dosyasını Oluşturun
1. Yapılandırma dosyasını oluşturun:
# Config dizinine .env dosyası oluştur
nano $HOME/0g-ai/config/.env
2. .env Dosyası İçeriği:
ZG_ALIGNMENT_NODE_LOG_LEVEL="info"
ZG_ALIGNMENT_NODE_SERVICE_IP="http://0.0.0.0:8080"
ZG_ALIGNMENT_NODE_SERVICE_PRIVATEKEY="your_private_key_here"
# Config dizinine config.toml dosyası oluştur
nano $HOME/0g-ai/config/config.toml
ZG_ALIGNMENT_NODE_LOG_LEVEL="info"
ZG_ALIGNMENT_NODE_SERVICE_IP="http://0.0.0.0:8080"
ZG_ALIGNMENT_NODE_SERVICE_PRIVATEKEY="your_private_key_here"
Önemli Notlar:
LOG_LEVEL
: Sorun giderme içindebug
, normal çalışma içininfo
SERVICE_PORT
: Varsayılan 8080. Bu portun dışarıdan erişilebilir olduğundan emin olunPRIVATEKEY
: Alignment node lisanslarınızı tutan cüzdanınızın private key'i
Adım 3: Network Yapılandırması
Yapılandırmanızda belirtilen port (varsayılan 8080) consensus iletişimi için dışarıdan erişilebilir olmalıdır.
Bu portun açık olduğundan emin olun:
Cloud security groups/firewall'larda (AWS, Azure, GCP vb.)
VPS sağlayıcı firewall'larında
Yerel sunucu firewall kurallarında
Register.
cd
cd $HOME/0g-ai/config
0g-alignment-node approve --mainnet --key privatey-key-yaz --chain-id 42161 --rpc https://arb1.arbitrum.io/rpc --contract 0xdD158B8A76566bC0c342893568e8fd3F08A9dAac --destNode cüzdan-adresi-yaz --tokenIds YOUR_NFT_TOKEN_ID
0g-alignment-node registerOperator --key privatey-key-yaz --token-id YOUR_NFT_TOKEN_ID --commission 10 --chain-id 42161 --rpc https://arb1.arbitrum.io/rpc --contract 0xdD158B8A76566bC0c342893568e8fd3F08A9dAac --mainnet
NOT: daha sonraki işlemleri https://claim.0gfoundation.ai/ yapıcaksınız.
Adım 4: Systemd Servisi Oluşturma
Node'unuzu systemd servisi olarak çalıştırmak için:
1. Servis dosyasını tee ile oluşturun:
sudo tee /etc/systemd/system/0g-alignment-node.service > /dev/null <<EOF
[Unit]
Description=0G AI Alignment Node
After=network.target
Wants=network.target
[Service]
Type=simple
User=$USER
WorkingDirectory=$HOME/0g-ai
EnvironmentFile=$HOME/0g-ai/config/.env
ExecStart=$(which 0g-alignment-node) start --mainnet
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
SyslogIdentifier=0g-alignment-node
# Log dosyasını da tutmak isterseniz (opsiyonel)
# StandardOutput=append:$HOME/0g-ai/logs/node.log
# StandardError=append:$HOME/0g-ai/logs/node-error.log
[Install]
WantedBy=multi-user.target
EOF
Not:
User=$USER
mevcut kullanıcıyı kullanırSistem servisi olduğu için tam path kullanıyoruz
$(which 0g-alignment-node)
dinamik olarak binary'nin tam yolunu bulur
2. Servisi etkinleştirme ve başlatma:
# Systemd daemon'unu yeniden yükle
sudo systemctl daemon-reload
# Servisi etkinleştir (boot'ta otomatik başlasın)
sudo systemctl enable 0g-alignment-node
# Servisi başlat
sudo systemctl start 0g-alignment-node
Servis Yönetimi Komutları
# Servisi başlat
sudo systemctl start 0g-alignment-node
# Servisi durdur
sudo systemctl stop 0g-alignment-node
# Servisi yeniden başlat
sudo systemctl restart 0g-alignment-node
# Servis durumunu kontrol et
sudo systemctl status 0g-alignment-node
# Servisi devre dışı bırak
sudo systemctl disable 0g-alignment-node
# Logları görüntüle
sudo journalctl -u 0g-alignment-node -f
# Son 100 log girişini görüntüle
sudo journalctl -u 0g-alignment-node -n 100
LOGLARINIZI KİMSEYLE PAYLAŞMAYINIZ... KİMSEYLE
Node İzleme
Node durumunu kontrol etme:
# Sistemde herhangi bir yerden çalıştırabilirsiniz
0g-alignment-node status
# which komutu ile tam yolu görebilirsiniz
which 0g-alignment-node
Logları görüntüleme:
# Systemd logları (önerilen)
sudo journalctl -u 0g-alignment-node -f
# Eğer dosyaya da log yazdırıyorsanız
tail -f $HOME/0g-ai/logs/node.log
Sağlıklı çalışma kontrolleri:
Durum raporları hata içermemeli
Loglar düzenli aktivite göstermeli, sürekli çökmeler olmamalı
Sorun Giderme
Node bağlanamıyor:
Portun açık ve dışarıdan erişilebilir olduğunu doğrulayın
Firewall/security group ayarlarınızı kontrol edin
Private key'in ilişkili lisanslara sahip olduğundan emin olun
Node çöküyor:
Hatalara ilişkin logları kontrol edin
Sistem gereksinimlerinin karşılandığını doğrulayın
İnternet bağlantısının kararlı olduğundan emin olun
En İyi Uygulamalar
Kendi Barındırılan Node'lar İçin:
Düzenli Güncellemeler: Node binary'sini güncel tutun
İzleme: Kesinti durumu için uyarılar ayarlayın
Yedekleme: Private key'lerin güvenli yedeğini saklayın
Güvenlik: Node işlemi için özel cüzdan kullanın
Ağ: Kararlı internet bağlantısı sağlayın
Güvenlik Notları
Private Key Güvenliği: Private key'inizi güvenli bir şekilde saklayın
Firewall Yapılandırması: Sadece gerekli portları açın
Düzenli Güncelleme: Node yazılımını düzenli olarak güncelleyin
Log İzleme: Anormal aktiviteleri takip edin
Güncelleme İşlemi
Yeni sürüm geldiğinde güncelleme yapmak çok kolay:
1. Servisi durdurun:
sudo systemctl stop 0g-alignment-node
2. Mevcut binary'yi yedekleyin (opsiyonel):
cp $HOME/0g-ai/bin/0g-alignment-node $HOME/0g-ai/bin/0g-alignment-node.backup
3. Yeni binary'yi indirip değiştirin:
...
# Symbolic link otomatik olarak yeni binary'yi işaret edecek
4. Servisi yeniden başlatın:
sudo systemctl start 0g-alignment-node
5. Güncellemeyi doğrulayın:
# Versiyon kontrolü
0g-alignment-node version
# Servis durumu kontrolü
sudo systemctl status 0g-alignment-node
Dizin Yapısı Özeti
Kurulum sonunda dizin yapınız şöyle olacak:
$HOME/0g-ai/
├── bin/
│ └── 0g-alignment-node # Binary dosyası
├── config/
│ └── .env # Yapılandırma dosyası
│ └── config.toml
└── logs/ # Log dosyaları (opsiyonel)
├── node.log
└── node-error.log
/usr/local/bin/
└── 0g-alignment-node -> $HOME/0g-ai/bin/0g-alignment-node # Symbolic link
/etc/systemd/system/
└── 0g-alignment-node.service # Systemd servis dosyası
Ek Komutlar
# Node versiyonunu kontrol et
0g-alignment-node version
# Binary'nin nerede olduğunu göster
which 0g-alignment-node
# Yapılandırma dosyasını test et
0g-alignment-node validate-config
# Manuel çalıştırmak isterseniz (test için)
cd $HOME/0g-ai && source config/.env && 0g-alignment-node start
# Symbolic link'i yeniden oluşturmak için
sudo ln -s $HOME/0g-ai/bin/0g-alignment-node /usr/local/bin/0g-alignment-node -f
Bu rehber ile 0G AI Alignment Node'unuzu başarıyla systemd servisi olarak kurabilir ve çalıştırabilirsiniz. Herhangi bir sorunla karşılaşırsanız, logları kontrol edin ve sorun giderme bölümündeki adımları izleyin.
Last updated