NEAR Docker 노드 가이드
NEAR는 공식 nearprotocol/nearcore Docker 이미지를 제공합니다. 단, 프로덕션 RPC/Validator는 베어메탈/NVMe 구성을 강력히 권장합니다. Docker는 개발·Testnet·RPC 실험용에 적합합니다.
빠른 실행 (Testnet RPC)
# 데이터 디렉토리 준비
sudo mkdir -p /data/near
sudo chown -R 1000:1000 /data/near
# 초기화 (최신 config/genesis 다운로드)
docker run --rm -v /data/near:/srv/near \
nearprotocol/nearcore:2.4.0 \
neard --home /srv/near init \
--chain-id testnet \
--download-config rpc \
--download-genesis
# Full Node 실행
docker run -d --name neard \
--restart unless-stopped \
-p 3030:3030 -p 24567:24567 \
-v /data/near:/srv/near \
nearprotocol/nearcore:2.4.0 \
neard --home /srv/near run
- 3030: JSON-RPC HTTP
- 24567: P2P
스냅샷 사용 (빠른 동기화)
Genesis에서 동기화는 수일~수주가 걸리므로 스냅샷 사용이 사실상 필수입니다.
# 공식 스냅샷 안내
# https://near-nodes.io/intro/node-data-snapshots
# (예) testnet 최신 snapshot 다운로드 후 /data/near/data 에 풀기
Mainnet RPC
docker run --rm -v /data/near:/srv/near \
nearprotocol/nearcore:2.4.0 \
neard --home /srv/near init \
--chain-id mainnet --download-config rpc --download-genesis
docker run -d --name neard-mainnet \
--restart unless-stopped \
-p 3030:3030 -p 24567:24567 \
-v /data/near:/srv/near \
nearprotocol/nearcore:2.4.0 \
neard --home /srv/near run
상태 확인
# 최신 블록 높이
curl -s -H 'Content-Type: application/json' \
--data '{"jsonrpc":"2.0","id":1,"method":"status","params":[]}' \
http://localhost:3030 | jq '.result.sync_info'
Validator는 localhost 권장
KES/서명 키 관리, Stake 트랜잭션, 고성능 I/O 요구 때문에 Validator는 ../localhost/README.md 의 호스트 설치 방식을 권장합니다.