메인 콘텐츠로 건너뛰기

​
목적 및 범위

이 문서는 StableNet 설치, 노드 구성, 최초 실행 과정을 안내합니다. 시스템 요구사항부터 초기 시작까지 노드를 운영 가능한 상태로 만드는 필수 단계를 다룹니다. 상세 정보는 다음 문서를 참조하세요:

​
사전 요구사항

StableNet은 Go로 빌드되며 다음이 필요합니다:
요구사항최소 버전비고
Go1.22.x소스 빌드 시 필수
디스크200+ GBFull Sync 기준; 네트워크에 따라 상이
RAM8 GB검증자 노드는 16 GB 권장
CPU2코어 이상4코어 이상 권장
네트워크25 Mbps 이상P2P 동기화에 필요; 초기 동기화 시 50 Mbps 이상 권장

​
설치 개요

StableNet은 여러 방법으로 설치할 수 있습니다:

​
소스에서 빌드

주요 빌드 방법은 CI 빌드 스크립트를 사용합니다: 
git clone https://github.com/stable-net/go-stablenet
cd go-stablenet

# Build gstable binary
go run build/ci.go install ./cmd/gstable

# Binary will be in build/bin/gstable
./build/bin/gstable version
빌드 시스템은 build/ci.go 스크립트를 통해 크로스 컴파일과 정적 링크를 지원하며, 모든 빌드 플래그와 의존성을 처리합니다.

​
릴리스 바이너리 사용

사전 빌드된 바이너리는 GitHub Releases에서 다운로드할 수 있습니다: 
# 릴리스 페이지에서 다운로드
tar -xzf gstable-linux-amd64-<version>.tar.gz

# 바이너리를 PATH에 추가
sudo mv gstable /usr/local/bin/

# 설치 확인
gstable version
플랫폼별 상세 설치 절차는 설치 및 빌드를 참조하세요.

​
네트워크 선택

StableNet은 여러 네트워크 구성을 지원합니다:
네트워크플래그ChainID
Mainnet--mainnet8282
Testnet--testnet8283
커스텀--genesis /path/to/genesis.json --networkid <id>사용자 지정
커스텀 네트워크 설정은 제네시스 설정 및 네트워크 초기화를 참조하세요.

​
기본 구성

노드는 명령줄 플래그, TOML 설정 파일 등으로 구성할 수 있습니다. --datadir, --http, --port 등 주요 옵션은 노드 구성을 참조하세요.

​
첫 번째 노드 실행

  1. 데이터 초기화: 첫 실행 시 네트워크 플래그를 지정하지 않을 경우 Mainnet으로 초기화됩니다. 커스텀 네트워크는 제네시스 설정 및 네트워크 초기화를 참조하세요.
  2. 노드 시작: 노드는 기본적으로 합의에 참여하지 않는 일반 노드로 시작하며, 검증자 모드로 합의에 참여하려면 --mine 옵션을 지정해야 합니다. 실행 명령과 플래그는 노드 구성을 참조하세요.
  3. 동작 확인: RPC, JavaScript 콘솔, 피어 연결 확인 방법은 노드 구성을 참조하세요.
문제 발생 시 노드 구성과 노드 모니터링 및 유지보수를 참조하세요.

​
다음 단계

첫 번째 노드를 성공적으로 실행한 후: