Flow 호스트 설치 가이드

Flow는 주로 Docker/Kubernetes로 배포됩니다. 호스트 설치는 개발·테스트 목적에 국한하며, 프로덕션은 Docker 가이드 권장.

• 공식 문서: https://developers.flow.com/networks/node-ops
• 소스: https://github.com/onflow/flow-go

로컬 개발 (flow emulator)

가장 빠른 시작은 Flow CLI의 에뮬레이터입니다.

# Flow CLI 설치
sh -ci "$(curl -fsSL https://raw.githubusercontent.com/onflow/flow-cli/master/install.sh)"
flow version

# 에뮬레이터 시작
flow emulator start --block-time 1s

# 기본 포트:
#   3569 (P2P), 8080 (admin), 8888 (gRPC), 8701 (REST)

Access Node 소스 빌드 (개발용)

프로덕션 참여는 staking 및 Dapper Labs 심사 필요. 소스 빌드는 학습·테스트 목적에 국한하세요.

sudo apt install -y git build-essential

# Go 1.22+
git clone https://github.com/onflow/flow-go.git
cd flow-go
git checkout v0.38.3

# 빌드 (access)
make crypto_setup_gopath
go build -o flow-access ./cmd/access
./flow-access --help

Observer Node 설치 (호스트)

Observer는 staking이 필요 없으므로 호스트 설치도 간단합니다.

# 바이너리 얻기 (공식 tarball 또는 위 소스 빌드)
# 그 후
flow-observer \
  --bootstrapdir=./bootstrap \
  --datadir=./data/protocol-state \
  --bind=0.0.0.0:3569 \
  --rpc-addr=0.0.0.0:9000 \
  --observer-networking-key-path=./bootstrap/private-root-information/observer.key

참고

• Flow CLI
• Flow Releases