AvalancheGo 설치 가이드
AvalancheGo를 Linux(Ubuntu 22.04/24.04 권장)에 설치하고 실행하는 방법입니다.
출처: Run a Node - From Source, AvalancheGo Installer, Using Binary.
목차
요구사항
- 하드웨어: 8 vCPU, 16GB RAM, 1TB SSD
- 네트워크: 포트 9650(HTTP API), 9651(P2P) 오픈
- 소프트웨어: Go(공식 문서 권장 버전), gcc
방법 1: 소스 빌드
1. Go·gcc 설치
- Go: go.dev/doc/install 또는 예:
wget https://go.dev/dl/go1.21.x.linux-amd64.tar.gz # 최신 버전은 go.dev 확인 sudo tar -C /usr/local -xzf go1.21.x.linux-amd64.tar.gz export PATH=$PATH:/usr/local/go/bin - gcc:
sudo apt install build-essential(Ubuntu/Debian)
2. GOPATH 설정
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
$GOROOT가 없다면 export GOROOT=/usr/local/go 등으로 설정.
3. 클론 및 빌드
mkdir -p $GOPATH/src/github.com/ava-labs
cd $GOPATH/src/github.com/ava-labs
git clone https://github.com/ava-labs/avalanchego.git
cd avalanchego
./scripts/build.sh
바이너리: ./build/avalanchego.
방법 2: Installer Script
시스템 준비 후 한 번에 설치·서비스 등록.
wget -nd -m https://raw.githubusercontent.com/ava-labs/avalanche-docs/master/scripts/avalanchego-installer.sh
chmod 755 avalanchego-installer.sh
./avalanchego-installer.sh
스크립트가 네트워크 유형(동적/정적 IP), RPC 공개(public/private), state sync on/off 등을 묻습니다.
완료 후: sudo systemctl status avalanchego, NodeID는 sudo journalctl -u avalanchego | grep "NodeID".
자세한 준비·옵션: Installer 문서, Preparing Your Environment.
방법 3: Pre-built 바이너리
GitHub Releases에서 OS·아키텍처에 맞는 tarball을 받아 압축 해제 후 avalanchego 실행.
공식 가이드: Using Binary.
실행
Mainnet
cd $GOPATH/src/github.com/ava-labs/avalanchego
./build/avalanchego
다른 머신에서 API 호출을 받으려면:
./build/avalanchego --http-host=0.0.0.0
Fuji Testnet
./build/avalanchego --network-id=fuji
종료: Ctrl+C. 프로덕션에서는 systemd 등으로 서비스화 권장(Installer Script 사용 시 자동 생성됨).
Bootstrap
새 노드는 최신 네트워크 상태와 동기화되는 Bootstrap 단계가 필요합니다.
- Mainnet: 수일 소요
- Fuji: 약 1일
동기화 순서: P-Chain → X-Chain → C-Chain.
각 체인 bootstrap 완료 시 로그에 consensus starting 등이 출력됩니다.
진행 확인: configuration.md의 info.isBootstrapped 호출.
Validator
노드를 Validator로 등록하려면 스테이킹·NodeID 등 추가 설정이 필요합니다.
Add a Validator 및 staking-deposit CLI 등 공식 문서를 참고하세요.