참여를 연결하는 VeryChain

macOS에서 실행

Apple Silicon(M1 이상) Mac 기준입니다. 화면 왼쪽 위 Apple 메뉴 → 이 Mac에 관하여에서 칩을 확인하세요. Intel Mac용 패키지는 이 안내에 포함되어 있지 않습니다.

1. 다운로드하고 압축 풀기

위의 Mac 노드 클라이언트 ZIP을 누르고, Finder의 다운로드 폴더를 엽니다. ZIP 파일을 두 번 클릭해 압축을 푸세요. 풀린 폴더는 찾기 쉬운 위치에 보관합니다.

현재 배포본에는 아래 두 항목이 있습니다. very만 바탕화면으로 옮기지 말고 src 폴더와 함께 두세요.

압축을 푼 폴더/
├── very          ← 실행할 프로그램
└── src/
    └── key.json  ← 노드 전용 키를 넣는 파일

2. key.json 열고 키 저장하기

1. src 폴더를 열고 key.json을 찾습니다.
2. 파일을 오른쪽 클릭 → 다음으로 열기 → 텍스트 편집기를 선택합니다. 파일을 찾기 어렵다면 Finder의 보기 방식을 목록으로 바꿔보세요.
3. Paste a private key here 등 예시 문구만 지우고, 받은 노드 전용 키를 큰따옴표 사이에 붙여넣습니다. 키 앞뒤에 공백이나 줄바꿈이 붙지 않았는지 확인합니다.
4. Command(⌘)+S로 저장합니다. 파일명은 key.json을 유지하고, .txt나 .rtf 파일로 새로 저장하지 않습니다.

3. very 실행하기

src의 상위 폴더로 돌아가 very를 두 번 클릭합니다. 바로 실행 창이 열리면 5단계로 가세요. “확인되지 않은 개발자” 등의 이유로 열 수 없다는 창이 나오면 닫고 4단계를 진행합니다.

4. macOS에서 실행 허용하기

1. Apple 메뉴 → 시스템 설정 → 개인정보 보호 및 보안을 엽니다.
2. 보안 영역에서 very가 차단되었다는 항목을 찾고 그래도 열기를 누릅니다. 먼저 very 실행을 시도해야 이 항목이 나타날 수 있습니다.
3. Mac 암호 또는 Touch ID 확인을 마치고, 다시 나타나는 확인창에서 열기를 선택합니다. 필요하면 Finder에서 very를 다시 실행합니다.

이 절차는 이 문서의 공식 배포 파일에서 개발자 확인 경고가 발생한 경우에만 적용합니다. 악성 소프트웨어 감지나 손상된 파일이라는 경고라면 실행을 강행하지 말고 파일과 배포처를 확인하세요. Apple의 앱 열기 안내에서도 같은 설정 경로를 확인할 수 있습니다.

5. 동기화 로그 확인하고 켜두기

실행 창에는 시간과 영어 메시지가 계속 표시됩니다. 이것이 노드의 로그, 즉 동작 기록입니다. Block synchronisation started가 보이면 블록 데이터를 받기 시작한 것입니다.

노드를 계속 운영하려면 실행 창과 인터넷 연결을 유지하세요. Mac을 잠자기에 넣거나 노트북 덮개를 닫으면 운영이 중단될 수 있습니다. 전원 어댑터를 연결하고 시스템 설정의 배터리·에너지 관련 잠자기 옵션을 확인합니다. 화면만 꺼지는 것과 컴퓨터가 잠자기에 들어가는 것은 다릅니다.

동기화 완료 확인으로 이동

Windows에서 실행

Intel·AMD x64 PC, Windows 11 기준입니다. 설정 → 시스템 → 정보의 시스템 종류에서 확인할 수 있습니다.

1. 다운로드하고 전용 폴더에 압축 풀기

위의 Windows 노드 클라이언트 ZIP을 내려받습니다. 파일 탐색기의 다운로드 폴더에서 ZIP을 오른쪽 클릭 → 모두 압축 풀기를 누르세요. 바탕화면 등에 very_node라는 폴더를 만들어 보관하면 찾기 쉽습니다.

ZIP 안에서 바로 실행하지 않습니다. 압축을 푼 폴더 안에 very.exe와 src가 함께 있어야 합니다.

very_node/
├── very.exe      ← 실행할 프로그램
└── src/
    └── key.json  ← 노드 전용 키를 넣는 파일

탐색기에서 보기 → 표시 → 파일 확장명을 켜면 .exe, .json까지 확인할 수 있습니다.

2. 메모장으로 key.json 열기

src 폴더를 열고 key.json을 오른쪽 클릭 → 메모장에서 편집을 선택합니다. 이 메뉴가 없다면 연결 프로그램 → 메모장을 선택하세요.

3. 키 입력하고 저장하기

큰따옴표 안의 예시 문구만 받은 노드 전용 키로 바꾸고 Ctrl+S로 저장합니다. 메모장을 닫은 뒤 탐색기에서 파일명이 여전히 key.json인지 확인하세요. key.json.txt가 되면 노드가 설정을 읽지 못할 수 있습니다.

4. 관리자 권한으로 실행하기

src의 상위 폴더로 돌아가 very.exe를 오른쪽 클릭 → 관리자 권한으로 실행을 선택합니다. Windows가 변경 허용 여부를 물으면 실행하려는 파일이 맞는지 확인한 뒤 허용합니다.

“Windows의 PC 보호”라는 SmartScreen 창이 나타날 수도 있습니다. 이 문서의 공식 배포 파일임을 확인한 경우에 추가 정보 → 실행 순서로 진행합니다. 이미 ‘실행’ 버튼이 보이면 그 버튼을 선택합니다. 보안 프로그램이 악성 코드로 탐지·격리한 경우에는 이 경고와 구별해 차단 사유부터 확인하세요.

5. 로그에서 동기화 시작 확인하기

실행 창에 영어 로그가 나타납니다. Block synchronisation started는 동기화를 시작했다는 뜻입니다. 처음에는 블록 데이터를 내려받느라 시간이 걸릴 수 있습니다.

PC를 계속 운영할 때는 전원과 절전 설정을 확인합니다. Windows를 다시 시작했다면 같은 폴더의 very.exe를 다시 실행하고 로그가 이어지는지 확인하세요.

동기화 완료 확인으로 이동

클라우드에서 실행 — Ubuntu

클라우드는 인터넷에 연결된 컴퓨터를 빌려 쓰는 방식입니다. 여기서는 AWS EC2에 Ubuntu 서버를 만드는 과정을 예로 설명합니다. 이미 Ubuntu 서버가 있다면 3단계부터 따라가되, 사양·접속 키·네트워크 설정을 먼저 확인하세요.

이 안내에는 두 종류의 명령창이 나옵니다. ‘내 컴퓨터에서’는 Mac의 터미널 또는 Windows의 PowerShell, ‘서버에서’는 SSH로 접속한 뒤의 창입니다. 한 줄씩 실행하고 결과를 확인한 뒤 다음 줄로 넘어가세요.

1. AWS에서 EC2 화면 열기

AWS 콘솔에 로그인하고, 사용할 리전(서버가 위치한 지역)을 선택합니다. 상단 검색창에 EC2를 입력해 해당 서비스로 들어갑니다.

왼쪽 메뉴의 인스턴스(Instances)로 이동한 뒤 인스턴스 시작(Launch instances)을 누릅니다. ‘인스턴스’는 여기서 만들 서버 한 대를 뜻합니다.

2. 서버 사양, 접속 키, 네트워크 설정하기

설정 화면을 위에서 아래로 내려가며 다음 항목을 입력합니다. 화면 예시의 예전 기본값보다 아래 표의 사양을 기준으로 선택하세요.

키 페어는 서버에 접속할 때 필요한 열쇠입니다. 내려받은 very-node-key.pem 파일은 다시 찾을 수 있는 곳에 보관합니다. 이 파일을 key.json에 넣는 것이 아닙니다.

네트워크 설정의 보안 그룹은 서버에 들어올 수 있는 연결을 정합니다. 새 그룹을 만들거나 기존 그룹을 편집해 다음 인바운드 규칙을 설정합니다.

SSH의 ‘내 IP’와 노드 통신의 전체 IPv4 허용은 서로 다른 규칙입니다. 이 패키지 운영을 위해 RPC·관리 포트를 추가로 공개할 필요는 없습니다. 서버의 인터넷 아웃바운드 연결도 가능해야 합니다.

스토리지를 500GiB 이상으로 설정하고 오른쪽 요약에서 사양을 확인합니다. 서버·디스크 등의 예상 요금을 확인한 뒤 인스턴스를 시작하세요. 이 사양을 무료 사용 대상으로 가정하지 않습니다.

3. 서버 IP 확인하고 설치 파일 준비하기

생성한 인스턴스를 선택하고 세부 정보에서 퍼블릭 IPv4 주소(Public IPv4 address)를 복사합니다. 아래 명령의 YOUR_SERVER_IP 자리에 이 값을 넣습니다. 화면에서 가려진 주소를 따라 쓰지 마세요.

인스턴스를 선택한 뒤 연결(Connect) → SSH 클라이언트(SSH client) 탭에서도 내 서버에 맞는 접속 예시를 확인할 수 있습니다.

내 컴퓨터의 다운로드 폴더에 두 파일을 준비합니다.

• 위 다운로드 표에서 받은 2026_Guide.zip
• 서버를 만들 때 받은 very-node-key.pem

파일 이름을 다르게 정했다면 이후 명령에서도 실제 파일 이름으로 바꿔야 합니다. 여기서는 AWS Ubuntu의 기본 사용자 이름인 ubuntu를 사용합니다.

4. 내 컴퓨터에서 파일 보내고 서버에 접속하기

Mac인 경우: Command(⌘)+Space에서 ‘터미널’을 검색해 엽니다. 아래 명령에서 YOUR_SERVER_IP를 실제 주소로 바꾼 뒤 한 줄씩 실행하세요. chmod 400은 서버 접속 키를 본인만 읽을 수 있게 설정합니다.

cd ~/Downloads
chmod 400 very-node-key.pem
scp -i very-node-key.pem 2026_Guide.zip ubuntu@YOUR_SERVER_IP:/home/ubuntu/
ssh -i very-node-key.pem ubuntu@YOUR_SERVER_IP

Windows인 경우: 시작 메뉴에서 ‘PowerShell’을 검색해 엽니다. 다운로드 폴더를 다른 곳으로 지정했다면 첫 줄의 경로를 해당 폴더로 바꿉니다.

cd "$HOME\Downloads"
scp -i .\very-node-key.pem .\2026_Guide.zip ubuntu@YOUR_SERVER_IP:/home/ubuntu/
ssh -i .\very-node-key.pem ubuntu@YOUR_SERVER_IP

scp는 ZIP을 서버로 복사하고, ssh는 서버에 접속합니다. 처음 연결할 때 yes/no를 물을 수 있습니다. 내 서버 주소가 맞는지 확인하고, 가능하면 AWS 콘솔의 서버 지문과 대조한 뒤 yes를 입력합니다. 키 파일 접근 권한 오류나 접속 실패는 AWS SSH 접속 안내를 참고하세요.

Windows에서 ssh 또는 scp 명령을 찾을 수 없다고 하면 OpenSSH 클라이언트 설치가 필요합니다. 위 AWS 안내의 Windows 설치 절차를 진행한 뒤 PowerShell을 다시 열어 연결합니다.

5. 서버에서 압축 풀고 노드 전용 키 입력하기

먼저 설치에 필요한 도구를 준비하고 ZIP을 풉니다. 명령을 한 줄씩 실행하고, 오류가 없다면 다음 줄로 진행하세요.

cd /home/ubuntu
sudo apt-get update
sudo apt-get install -y unzip nano
unzip 2026_Guide.zip
cd 2026_Guide
ls

ls는 현재 폴더의 파일 목록을 보여줍니다. 다음 파일들이 보이면 올바른 위치입니다.

2026_Guide/
├── 0_prepare.sh
├── 1_build.sh
├── 2_execute.sh
├── 3_log.sh
├── docker-compose.yml
└── key.json

다음 명령으로 키 파일을 엽니다.

nano key.json

nano는 서버에서 쓰는 텍스트 편집기입니다. 방향키로 이동해 큰따옴표 안의 예시 문구만 지우고 발급받은 노드 전용 키를 붙여넣습니다. 저장은 Ctrl+O → Enter, 닫기는 Ctrl+X 순서입니다. Mac에서도 이 단축키는 Command가 아닌 Control 키를 사용합니다.

클라우드판의 키 파일은 지금 폴더에 있습니다. Mac·Windows처럼 src 폴더를 새로 만들지 마세요. docker-compose.yml과 key.json이 나란히 있어야 합니다.

6. Docker 설치하고 다시 접속하기

Docker는 노드 프로그램을 정해진 실행 환경에서 구동하는 도구입니다. 같은 폴더에서 다음을 실행하면 패키지의 스크립트가 Docker와 Compose를 준비합니다.

sh 0_prepare.sh

설치가 끝나고 다시 입력할 수 있는 줄이 나타날 때까지 기다립니다. 오류가 발생했다면 다음 단계로 넘어가지 말고 오류 내용을 확인하세요. 이 과정은 현재 사용자에게 Docker 실행 권한도 추가하므로 서버에서 나갔다가 다시 접속해야 합니다.

exit

이제 내 컴퓨터의 명령창으로 돌아왔습니다. 4단계에서 사용한 SSH 명령으로 다시 연결합니다.

ssh -i very-node-key.pem ubuntu@YOUR_SERVER_IP

다시 서버에 접속한 뒤 아래 명령으로 설치 폴더로 이동하고 Docker가 준비됐는지 확인합니다.

cd /home/ubuntu/2026_Guide
docker compose version
docker ps

7. 노드 내려받기 → 실행 → 로그 보기

아래 세 명령을 순서대로 한 줄씩 실행합니다. 각 명령이 끝나고 오류가 없는지 확인하세요.

노드 프로그램 이미지를 내려받습니다. 다운로드가 끝나면 다음 명령을 실행합니다.

sh 1_build.sh

노드를 백그라운드에서 시작합니다.

sh 2_execute.sh

로그를 열어 동작 상황을 확인합니다.

sh 3_log.sh

Block synchronisation started 이후 블록 로그가 갱신되는지 확인합니다. 로그 보기 중 Ctrl+C를 누르면 로그 표시만 끝나고 노드는 백그라운드에서 계속 실행됩니다. exit로 SSH 접속을 끝내도 서버와 컨테이너가 실행 중이면 노드는 계속 동작합니다.

8. 다음에 다시 접속해서 상태 확인하기

내 컴퓨터에서 4단계의 SSH 명령으로 연결하고, 서버에서 아래 명령을 실행합니다.

cd /home/ubuntu/2026_Guide
docker compose ps

very-node의 상태가 Up 또는 running이면 컨테이너가 실행 중입니다. 이것은 프로그램 실행 상태이므로, 동기화 완료 여부는 로그의 블록 높이로 따로 확인합니다.

동기화 데이터는 db-data/node에 저장됩니다. 재시작을 위해 이 폴더나 key.json을 삭제할 필요는 없습니다. 서버를 중지한 뒤 다시 켰다면 퍼블릭 IP가 바뀌었는지도 확인합니다. 노드 프로세스를 멈추는 것만으로 클라우드 이용 요금이 모두 멈추는 것은 아닙니다.

동기화 완료 확인으로 이동