NEAR 호스트 설치 가이드

Ubuntu 22.04 기준 neard 바이너리 설치·실행 개요입니다. 공식 문서: https://near-nodes.io/.

시스템 요구사항

NEAR는 I/O가 매우 무거운 편이라 NVMe 필수입니다. SSD/HDD 사용 시 블록 production에 실패할 수 있습니다.

빌드 or 바이너리

A. 공식 사전 빌드 (권장)

# 공식 릴리스 다운로드
VERSION=2.4.0
wget https://s3.us-east-1.amazonaws.com/build.nearprotocol.com/nearcore/Linux/${VERSION}/neard
chmod +x neard
sudo mv neard /usr/local/bin/neard
neard --version

B. 소스 빌드 (Rust)

sudo apt install -y git curl cmake llvm clang libclang-dev pkg-config libssl-dev build-essential

curl https://sh.rustup.rs -sSf | sh
source $HOME/.cargo/env

git clone https://github.com/near/nearcore.git
cd nearcore
git checkout 2.4.0
make neard

sudo cp target/release/neard /usr/local/bin/

초기화 (Mainnet RPC)

neard --home ~/.near init \
  --chain-id mainnet \
  --download-config rpc \
  --download-genesis

스냅샷 사용

# 공식 스냅샷 인덱스
# https://near-nodes.io/intro/node-data-snapshots
# rclone 또는 aws s3 sync로 ~/.near/data 에 복사

예시(AWS S3 public bucket):

# 최신 mainnet rpc snapshot 경로는 공식 문서에서 확인
aws s3 sync --no-sign-request \
  s3://near-protocol-public/backups/mainnet/rpc/latest/ ~/.near/data/

실행

neard --home ~/.near run

systemd 서비스

# /etc/systemd/system/neard.service
[Unit]
Description=NEAR node
After=network-online.target

[Service]
User=near
ExecStart=/usr/local/bin/neard --home /home/near/.near run
Restart=on-failure
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now neard
journalctl -u neard -f

상태 확인

curl -s -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"status","params":[]}' \
  http://localhost:3030 | jq '.result.sync_info'

Validator 추가 절차

1. validator_key.json 생성: neard --home ~/.near validator-key ...
2. config.json의 tracked_shards 설정
3. Stake 트랜잭션 송출 (near-cli)
4. 서명 키는 절대 백업/반출 금지

자세한 절차: https://near-nodes.io/validator/running-a-node