Aptos 호스트 설치 가이드

Ubuntu 22.04 기준 aptos-node 바이너리 설치·실행 개요입니다. 공식 문서: https://aptos.dev/en/network/nodes/full-node/deployments/using-source-code.

시스템 요구사항

사전 준비

sudo apt update && sudo apt install -y git curl clang build-essential pkg-config libssl-dev llvm libpq-dev

# Rust
curl https://sh.rustup.rs -sSf | sh
source $HOME/.cargo/env

빌드

git clone https://github.com/aptos-labs/aptos-core.git
cd aptos-core
git checkout mainnet  # or release branch

./scripts/dev_setup.sh
cargo build -p aptos-node --release

# 바이너리 위치: target/release/aptos-node
sudo cp target/release/aptos-node /usr/local/bin/

설정

mkdir -p ~/aptos-node/data
cd ~/aptos-node

# Genesis / waypoint 다운로드 (mainnet 기준)
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 템플릿 복사
cp ~/aptos-core/docker/compose/aptos-node/mainnet/fullnode.yaml ./fullnode.yaml

# 아래 값 수정
#   base.data_dir: /home/aptos/aptos-node/data
#   base.waypoint.from_file: /home/aptos/aptos-node/waypoint.txt
#   execution.genesis_file_location: /home/aptos/aptos-node/genesis.blob

실행

aptos-node --config ~/aptos-node/fullnode.yaml

systemd 서비스

# /etc/systemd/system/aptos-fullnode.service
[Unit]
Description=Aptos Public Fullnode
After=network-online.target

[Service]
User=aptos
ExecStart=/usr/local/bin/aptos-node --config /home/aptos/aptos-node/fullnode.yaml
Restart=on-failure
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now aptos-fullnode
journalctl -u aptos-fullnode -f

상태 확인

# REST API
curl -s http://localhost:8080/v1 | jq .

# 메트릭 (최신 버전)
curl -s http://localhost:9101/metrics | grep 'aptos_state_sync_version'

참고

• Bootstrap a Fullnode
• Node Requirements