Sui Full Node 설치 가이드
Sui Full Node(sui-node)를 Linux(권장 Ubuntu/Debian)에 설치하고 실행하는 방법입니다.
출처: Sui Full Node, Install Binaries.
목차
요구사항
- 하드웨어: 공식 권장 4TB NVMe, 128GB RAM, 8물리/16 vCPU. 최소 참고치 16GB+ RAM, 1TB+ NVMe, 16+ 코어.
- OS: Ubuntu/Debian 권장. macOS는 개발용.
- Rust: 최신 stable.
rustup으로 설치·업데이트.
Linux 의존성
Ubuntu/Debian:
sudo apt-get update && sudo apt-get install -y --no-install-recommends \
tzdata libprotobuf-dev ca-certificates build-essential libssl-dev \
libclang-dev libpq-dev pkg-config openssl protobuf-compiler git clang cmake
libpq-dev 없으면 빌드 시 cannot find -lpq 오류가 날 수 있습니다.
Rust 설치
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"
rustup update
소스 빌드
git clone https://github.com/MystenLabs/sui.git
cd sui
git checkout mainnet # 또는 testnet / devnet 브랜치
cargo build --release --bin sui-node --bin sui
바이너리: target/release/sui-node, target/release/sui(CLI).
바이너리 다운로드 (선택)
GitHub Releases에서 mainnet-v1.x.x 등 Pre-built 아카이브를 받아 sui-node, sui를 PATH에 두고 사용할 수 있습니다. Install Binaries 가이드와 동일한 방식입니다.
설정 파일 및 Genesis
1. fullnode.yaml
저장소의 템플릿을 복사해 사용합니다.
mkdir -p ~/.sui
cp /path/to/sui/crates/sui-config/data/fullnode-template.yaml ~/.sui/fullnode.yaml
또는 fullnode-template.yaml 내용을 받아 ~/.sui/fullnode.yaml로 저장합니다.
2. Genesis blob
연결할 네트워크에 맞는 genesis.blob을 받습니다.
- Mainnet:
curl -fLJO https://github.com/MystenLabs/sui-genesis/raw/main/mainnet/genesis.blob - Testnet:
curl -fLJO https://github.com/MystenLabs/sui-genesis/raw/main/testnet/genesis.blob - Devnet:
curl -fLJO https://github.com/MystenLabs/sui-genesis/raw/main/devnet/genesis.blob
fullnode.yaml의 genesis-file-location을 이 파일 경로로 수정합니다.
3. fullnode.yaml 수정
db-path: DB 저장 경로 (예:"/data/sui-fullnode"또는"~/.sui/db").genesis-file-location: 위에서 받은genesis.blob절대 경로.- Mainnet/Testnet:
p2p-config.seed-peers를 공식 문서의 Full Node 가이드에 나온 seed 목록으로 채웁니다. - state-archive-read-config: mainnet은
https://checkpoints.mainnet.sui.io, testnet은https://checkpoints.testnet.sui.io등 문서대로 설정.
자세한 필드는 configuration.md를 참고하세요.
스냅샷에서 시작
Genesis부터 동기화하면 시간과 디스크가 많이 듭니다.
반드시 Sui Snapshots 가이드에 따라 최신 스냅샷을 받아 그 기준으로 동기화를 시작하세요.
실행
sui-node --config-path ~/.sui/fullnode.yaml
프로덕션에서는 systemd 등으로 서비스화해 백그라운드 실행하고, 재부팅 시 자동 기동하도록 설정하는 것을 권장합니다.