Stacks 호스트 설치 가이드
Ubuntu 22.04 기준 stacks-core 소스 빌드·실행 개요입니다.
- 공식 문서: https://docs.stacks.co/guides-and-tutorials/running-a-node
- 소스: https://github.com/stacks-network/stacks-core
시스템 요구사항
| 항목 | 권장 |
|---|---|
| CPU | 4+ vCPU |
| RAM | 16 GB+ |
| Disk | 500 GB SSD |
| Network | 100 Mbps+ |
전제 조건: Bitcoin 노드
Stacks는 Bitcoin 메인넷 헤더를 읽어 PoX burn block 이벤트를 파싱합니다. 같은 호스트에서 bitcoind를 실행하는 구성이 가장 안정적입니다. Bitcoin 노드 설치: ../../bitcoin/localhost/README.md.
빌드
sudo apt update && sudo apt install -y git build-essential pkg-config libssl-dev
# Rust 1.80+
curl https://sh.rustup.rs -sSf | sh
source $HOME/.cargo/env
git clone https://github.com/stacks-network/stacks-core.git
cd stacks-core
git checkout 3.1.0.0.5
cargo build --release --bin stacks-node
sudo cp target/release/stacks-node /usr/local/bin/
stacks-node --version
설정
mkdir -p ~/stacks-data
cat > ~/Config.toml <<'EOF'
[node]
working_dir = "/home/stacks/stacks-data"
rpc_bind = "0.0.0.0:20443"
p2p_bind = "0.0.0.0:20444"
bootstrap_node = "02da7a464ac770ae8337a343670778b93410f2f3fef6bea98dd1c3e9224459d36b@seed-0.mainnet.stacks.co:20444"
[burnchain]
chain = "bitcoin"
mode = "mainnet"
peer_host = "127.0.0.1"
username = "bitcoin"
password = "<BITCOIN_RPC_PASSWORD>"
rpc_port = 8332
peer_port = 8333
EOF
실행
stacks-node start --config=$HOME/Config.toml
systemd 서비스
# /etc/systemd/system/stacks.service
[Unit]
Description=Stacks Node
After=network-online.target bitcoin.service
[Service]
User=stacks
ExecStart=/usr/local/bin/stacks-node start --config=/home/stacks/Config.toml
Restart=on-failure
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target