Trupeer AI - Create professional product videos and guides
logo

NEAR Protocol - nearcore 로컬에서 실행하기 (localnet)

Aug 6, 2025

18 Views
0 Comments
0 Reactions
Loading video...

NEAR Protocol - nearcore 로컬에서 실행하기 (localnet)

이 문서는 Docker를 사용하여 로컬 머신에서 NEAR Protocol을 설정하고 구성하는 단계별 프로세스를 제공합니다. 최신 안정 버전을 가져오고, Docker 환경을 설정하며, NEAR Protocol 노드와의 상호작용을 위한 로컬 네트워크를 구성하는 과정을 포함합니다.

Step 1

hub.docker.com으로 이동하여 NEAR Protocol을 검색합니다. 마스터 브랜치에 커밋될 때마다 사용할 수 있는 nearprotocol/nearcore 이미지를 찾습니다.

Screenshot

Step 2

릴리즈 태그 2.7.0-rc.3 (testnet에 배포되는 release candidate) 또는 2.6.5 (mainnet의 안정 릴리즈)를 찾을 수 있습니다. Docker가 시스템에 설치되어 최신 안정 버전을 시작하고 가져올 수 있도록 합니다.

Screenshot

Step 3

현재 최신 버전은 2.6.5 stable입니다. 이를 가져오겠습니다. arm64 아키텍처를 사용하는 경우 (예: M 시리즈 CPU가 장착된 Mac), --platform 매개변수를 linux/amd64로 지정합니다. Windows, Linux, macOS에서 동일하게 작동합니다. 따라서 이 매개변수를 어디서든 사용하는 것이 안전합니다.

포트를 노출하는 것도 필요합니다. nearcore 노드 상호작용을 위한 기본 JSON RPC 포트는 3030이며, 노드 구성을 수행하고 실행 간 데이터를 잃지 않고 노드를 재시작할 수 있도록 bash를 대화형 모드로 실행합니다.

docker run --platform linux/amd64 -it --rm -p 3030:3030 nearprotocol/nearcore:2.6.5 bash

Screenshot

Step 4

컨테이너 내부에서 neard 바이너리를 사용합니다. 버전을 확인해 보겠습니다.

Screenshot

Step 5

near 노드가 있으므로, 이제 localnet을 위해 초기화할 시간입니다. /tmp/neard 안에 home 폴더를 설정합니다:

neard --home /tmp/neard init

Screenshot

홈 디렉토리에 생성된 config.json, genesis.json, node_key.json, validator_key.json을 찾을 수 있습니다.

Screenshot

Step 6

지금은 이러한 구성을 확인할 필요가 없습니다. 즉시 노드를 실행하십시오.

neard --home /tmp/neard run

Screenshot

Step 7

노드가 이제 실행 중입니다. 터미널을 사용하여 샘플 작업으로 curl 명령을 실행합니다.

curl http://localhost:3030/status

Screenshot

Step 8

모든 설정이 완료되면, NEAR CLI를 설치하고 로컬 네트워크를 사용하도록 구성합니다. near 명령을 사용하여 연결을 추가하고, 프롬프트에 따라 네트워크 이름(localnet), RPC URL(http://localhost:3030)을 제공하며 다른 설정은 무시하십시오.

Screenshot

Step 9

이제 NEAR CLI를 사용하여 test.nearlocalnet에 대한 계정 정보를 액세스하고, 사용 가능한 로컬 NEAR 토큰의 양을 검색합니다 (이 NEAR 토큰은 가치가 없습니다). near 명령어를 입력하고 인터랙티브 프롬프트를 따르거나 완전히 지정된 명령어를 사용하십시오:

near account view-account-summary test.near network-config localnet now

Screenshot

Step 10

이 토큰을 사용하여 test.near 계정으로 트랜잭션을 전송해보겠습니다.

Screenshot

Step 11

다른 계정으로 NEAR를 전송할 것입니다. 로컬넷에 있는 유일한 다른 계정을 사용하므로, near를 사용합니다. test.near 계정의 평문 개인 키를 사용하여 트랜잭션을 서명하십시오 - /tmp/neard 홈 폴더의 validator_key.json에서 확인할 수 있습니다.

Screenshot

Step 12

트랜잭션이 성공적으로 서명되면 전송하십시오. 여기에서 토큰 전송 트랜잭션이 성공적으로 서명되고 네트워크로 전송된 것을 볼 수 있습니다. 전송이 성공했습니다!

Screenshot

Happy BUIDLing on NEAR!

U