Nodes/sui/localhost/configuration

sui

Sui Full Node 설정 가이드

3분 읽기 · localhost/configuration

list목차(7)

Sui Full Node 설정 가이드

fullnode.yaml 및 genesis·seed-peers·gRPC 설정 요약입니다.
출처: Sui Full Node, fullnode-template.yaml.

설정 파일 위치

  • 템플릿: MystenLabs/sui 저장소의 crates/sui-config/data/fullnode-template.yaml
  • 사용: 복사 후 genesis-file-location, db-path, seed-peers 등만 수정해 사용.

주요 필드

필드 설명
db-path Full Node DB 경로. 충분한 디스크(예: NVMe) 지정.
genesis-file-location genesis.blob 절대 경로. Mainnet/Testnet/Devnet별로 sui-genesis에서 다운로드.
network-address 노드 공개 주소 (예: /ip4/X.X.X.X/tcp/8080/http).
metrics-address 메트릭 수집 주소 (기본 0.0.0.0:9184). 포트 충돌 시 9180 등으로 변경.
json-rpc-address JSON-RPC 주소 (기본 0.0.0.0:9000). WebSocket도 동일.
p2p-config.listen-address P2P 리슨 (예: 0.0.0.0:8084).
p2p-config.seed-peers Mainnet/Testnet용 seed 피어 목록. 공식 Full Node 가이드에 예시 있음.
state-archive-read-config 체크포인트 아카이브 URL (mainnet: https://checkpoints.mainnet.sui.io, testnet: https://checkpoints.testnet.sui.io).

Seed peers (Mainnet 예시)

Full Node 가이드에 나온 대로 fullnode.yaml 끝에 추가:

p2p-config:
  seed-peers:
    - address: /dns/mel-00.mainnet.sui.io/udp/8084
      peer-id: d32b55bdf1737ec415df8c88b3bf91e194b59ee3127e3f38ea46fd88ba2e7849
    # ... (나머지는 docs.sui.io 또는 저장소 예시 참고)

Testnet용 seed 목록도 동일 문서에 있습니다.

gRPC (선택)

JSON-RPC는 단계적 deprecated이며, gRPC 사용을 권장합니다.
gRPC 인덱싱을 켜려면:

rpc:
  enable-indexing: true

인덱싱 중에는 다른 트래픽에 영향이 있을 수 있으므로, 롤링 업그레이드·다운타임 계획을 세우세요.
JSON-RPC를 끄고 gRPC만 쓰려면:

enable-index-processing: false

저장 공간 조절:

authority-store-pruning-config:
  num-epochs-to-retain: 14
  num-epochs-to-retain-for-checkpoints: 14

자세한 내용: Data serving / gRPC API.

포트

  • 8084: P2P (UDP/TCP)
  • 9000: JSON-RPC / WebSocket
  • 9184: Metrics (충돌 시 예: 9180)

Genesis

genesis-file-location을 다운로드한 파일의 절대 경로로 설정하세요.

Archival Fallback

오래된 체크포인트에서 동기화하려면 Archival Fallback 가이드를 참고해 설정합니다. seed-peers만으로는 몇 에폭 분량의 이력만 유지됩니다.

sui 다른 챕터