AvalancheGo Docker 가이드
Docker로 AvalancheGo 노드를 실행하는 방법입니다.
공식 이미지: avaplatform/avalanchego.
참고: Run AvalancheGo with Docker.
빠른 시작
1. 환경 변수 (선택)
cp env-example.txt .env
# DATA_DIR, AVALANCHEGO_VERSION 등 필요 시 수정
2. 실행
docker compose up -d
3. 로그·Bootstrap 확인
docker compose logs -f
curl -X POST --data '{"jsonrpc":"2.0","id":1,"method":"info.isBootstrapped","params":{"chain":"X"}}' -H 'content-type:application/json' 127.0.0.1:9650/ext/info
Bootstrap은 Mainnet 수일, Fuji 약 1일 걸릴 수 있습니다.
포트
| 포트 | 용도 |
|---|---|
| 9650 | HTTP API (RPC) |
| 9651 | P2P / Staking |
9651은 네트워크 참여를 위해 외부에서 접근 가능해야 합니다.
데이터 디렉터리
${DATA_DIR:-./avalanche-data}가 컨테이너 내 /root/.avalanchego에 마운트됩니다.
이 볼륨이 없으면 컨테이너 삭제 시 데이터가 사라지고, 재시작 시 처음부터 동기화됩니다.
Fuji Testnet
.env 또는 docker-compose.yml에서 이미지 태그를 유지한 뒤, command에 --network-id=fuji 추가.
데이터 디렉터리는 Mainnet과 분리하는 것이 좋습니다(예: DATA_DIR=./avalanche-fuji-data).
command:
- --http-host=0.0.0.0
- --network-id=fuji
설정 플래그
Config Flags 문서를 참고해 command에 플래그를 추가할 수 있습니다.
예: --public-ip-resolution-service=opendns
업그레이드
새 버전으로 올릴 때:
docker compose down
# .env 에 AVALANCHEGO_VERSION=v1.x.x 설정
docker compose pull
docker compose up -d
데이터는 호스트 볼륨에 남아 있어 이어서 동기화됩니다.