Aptos Docker 노드 가이드
Aptos는 공식 aptoslabs/validator 이미지를 제공하며, Docker Compose 템플릿이 공식 저장소에 포함되어 있습니다.
- 공식 이미지: DockerHub aptoslabs/validator
- 공식 저장소 Docker Compose: aptos-core/docker/compose
- 공식 가이드: Run an Aptos Node
빠른 실행 (Mainnet Public Fullnode)
공식 템플릿을 활용하는 방식:
# 저장소 클론 및 이동
git clone https://github.com/aptos-labs/aptos-core.git
cd aptos-core/docker/compose/aptos-node/
# 최신 mainnet 버전 디렉토리로 이동
cd mainnet
# Genesis·waypoint 다운로드
wget https://raw.githubusercontent.com/aptos-labs/aptos-networks/main/mainnet/genesis.blob
wget https://raw.githubusercontent.com/aptos-labs/aptos-networks/main/mainnet/waypoint.txt
# fullnode.yaml 수정 (data_dir, genesis_file_location, waypoint 설정)
# 실행
docker compose -f docker-compose-fullnode.yaml up -d
docker compose logs -f aptos-fullnode
포트
- 6180 / 6181: P2P (validator / fullnode)
- 8080: REST API
- 9101: Prometheus 메트릭
스냅샷 (빠른 동기화)
Aptos는 Genesis 동기화가 매우 느려 스냅샷/DB 백업 복원이 사실상 필수입니다.
- 공식 스냅샷 문서: https://aptos.dev/en/network/nodes/bootstrap-fullnode/bootstrap-fullnode
aws s3 cp기반 동기화 스크립트 제공
# Mainnet 최신 snapshot 다운로드 예시
aws s3 cp s3://aptos-mainnet-backup/ ./aptos-data --recursive --no-sign-request
상태 확인
# REST API에서 최신 ledger 버전·체인 상태
curl -s http://localhost:8080/v1 | jq .
# 메트릭
curl -s http://localhost:9101/metrics | grep aptos_state_sync_version
Validator는 localhost/K8s 권장
공식 문서는 프로덕션 Validator로 Kubernetes(Helm chart) 또는 호스트 systemd 구성을 권장합니다. Docker 단독은 공식 노드(PFN)·개발 용도에 적합합니다.