Flow Docker 노드 가이드 (Access Node)
Flow는 공식 Docker 이미지를 제공합니다. 프로덕션에서 가장 보편적으로 운영되는 Access Node (RPC gateway) 구성 예시입니다.
- 공식 이미지: gcr.io/flow-container-registry/access
- 공식 문서: https://developers.flow.com/networks/node-ops/access-onchain-data/light-nodes/observer-node
- 공식 Helm/YAML: https://github.com/onflow/flow-go/tree/master/insecure/cmd
실행 (Mainnet Access Node)
# 데이터 디렉토리
sudo mkdir -p /data/flow
sudo chown -R 1000:1000 /data/flow
docker run -d --name flow-access \
--restart unless-stopped \
-p 9000:9000 -p 9001:9001 -p 3569:3569 \
-v /data/flow:/data \
gcr.io/flow-container-registry/access:v0.38.3 \
--bootstrapdir=/bootstrap \
--datadir=/data/protocol-state \
--secretsdir=/data/secrets \
--nodeid=<YOUR_NODE_ID> \
--bind=0.0.0.0:3569 \
--rpc-addr=0.0.0.0:9000 \
--rpc-metrics-enabled=true \
--loglevel=info \
--script-execution-mode=execution-nodes-only
- 3569: libp2p
- 9000: gRPC (public)
- 9001: REST
--nodeid,bootstrap/디렉토리(노드 staking 정보)는 공식 문서의 "Access Node Setup" 절차로 생성해야 합니다.
Observer Node (간편)
Observer Node는 staking 없이 공개 네트워크에서 블록 데이터를 소비할 수 있는 경량 노드입니다.
docker run -d --name flow-observer \
--restart unless-stopped \
-p 9000:9000 -p 3569:3569 \
-v /data/flow-observer:/data \
gcr.io/flow-container-registry/observer:v0.38.3 \
--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
상태 확인
# gRPC API로 latest block
docker exec flow-access flow-cli blocks get latest --host localhost:9000
# 또는 grpcurl
grpcurl -plaintext localhost:9000 flow.access.AccessAPI/GetLatestBlock