Nodes/avalanche

avalanche

3분 읽기

list목차(9)

Avalanche 노드 가이드

AvalancheGo 노드 설치 및 운영 가이드입니다. Go 기반이며 Ubuntu 22.04/24.04 권장. Mainnet·Fuji Testnet 지원.

공식 문서: Run a Node (Builder Hub) · AvalancheGo Installer · Using Binary.

노드 역할

  • AvalancheGo: Avalanche 네트워크의 합의·노드 구현. P-Chain, X-Chain, C-Chain 등 참여, RPC 제공.
  • Full Node: 블록체인 동기화·검증, API 서빙. Validator로 전환 시 스테이킹·검증자 등록 추가 설정 필요.
  • 최소 요구사항: 8 vCPU, 16GB RAM, 1TB SSD, 포트 9650–9651 오픈.
  • 주의: Bootstrap(첫 동기화)에 Mainnet은 수일, Fuji는 약 1일 소요. NodeID는 avalanchego --version 또는 로그에서 확인.

지원 환경

  • OS: Ubuntu 22.04/24.04 권장. 기타 Linux·macOS에서도 빌드·실행 가능.
  • 빌드: Go(공식 문서에서 권장 버전 확인), gcc. ava-labs/avalanchego. Pre-built: Releases.

설치 방법

Localhost 설치 (권장)

소스 빌드, Installer Script, 또는 바이너리로 호스트에 설치 후 실행.

시작하기: localhost/README.md

Docker 설치

공식 이미지 avaplatform/avalanchego로 컨테이너에서 실행.

시작하기: docker/README.md

폴더 구조

avalanche/
├── README.md                 # 이 파일
├── localhost/                # 호스트 설치 가이드
│   ├── README.md
│   ├── installation.md       # Go·소스 빌드·Installer·바이너리·실행
│   ├── configuration.md      # 플래그·RPC·bootstrap
│   ├── troubleshooting.md
│   └── updates/
│       └── README.md
└── docker/                   # Docker 노드
    ├── README.md
    ├── docker-compose.yml
    ├── env-example.txt
    └── .dockerignore

포트

포트 용도
9650 HTTP API (RPC)
9651 P2P (Staking 등)

RPC 엔드포인트 (Bootstrap 완료 후)

  • P-Chain: http://localhost:9650/ext/bc/P
  • X-Chain: http://localhost:9650/ext/bc/X
  • C-Chain RPC: http://localhost:9650/ext/bc/C/rpc

원격 접속 시 localhost를 노드의 공개 IP로 바꾸고, --http-host=0.0.0.0 로 기동해야 합니다.

참고 링크

챕터