TON 노드 Localhost 설치 가이드

Ubuntu/Debian 호스트에 MyTonCtrl로 TON Full Node를 설치하고, Validator 또는 LiteServer 모드를 활성화하는 방법입니다.

공식 문서: Run a node with MyTonCtrl, Full Node.

전제 조건

OS: Ubuntu 22.04/24.04 LTS 또는 Debian 11/12
non-root 사용자: 반드시 생성 후 해당 사용자로 설치. root로 실행하면 권한 문제 발생.
하드웨어: 16코어, 128GB RAM, 1TB NVMe SSD, 1Gbps, 고정 공인 IP (권장 사양은 README 참고).

빠른 시작

1. non-root 사용자 생성

sudo adduser <username>
sudo usermod -aG sudo <username>
# 새 사용자로 재접속
ssh <username>@<server_ip>

2. MyTonCtrl 설치

sudo apt update
sudo apt install -y curl wget git ca-certificates python3-pip
wget https://raw.githubusercontent.com/ton-blockchain/mytonctrl/master/scripts/install.sh
sudo bash install.sh -d

Mainnet(기본): 위대로 실행.
Testnet: sudo bash install.sh -c https://ton.org/testnet-global.config.json
-d: 덤프 다운로드로 동기화 가속.
-m validator / -m liteserver: 초기 모드 선택(대화형에서도 선택 가능).

3. 동기화·상태 확인

mytonctrl
MyTonCtrl> status
MyTonCtrl> status_fast
MyTonCtrl> status_modes

Local validator out of sync가 20초 미만, synchronized 될 때까지 대기(최대 수 시간). 이후 Validator 또는 LiteServer 모드 활성화.

4. Validator 또는 LiteServer 활성화

Validator: stake·지갑 준비 후 enable_mode validator. 상세: installation.md.
LiteServer: enable_mode liteserver. 상세: installation.md.

자세한 단계·플래그: installation.md. 설정·포트: configuration.md.

파일 구조

localhost/
├── README.md           # 이 파일
├── installation.md     # MyTonCtrl 설치·Validator·LiteServer·Archive
├── configuration.md    # 모드·포트·지갑·stake
├── troubleshooting.md
└── updates/
    └── README.md