TRON 노드 가이드

TRON FullNode·SolidityNode 설치 및 운영 가이드입니다.
공식 문서: Deploy A Node · Deploying a java-tron Node.

TRON 노드 구성

FullNode (풀노드)

역할: TRON 네트워크 진입점. 전체 블록 데이터 동기화, HTTP/gRPC API 제공. 자산 전송·컨트랙트 배포·호출 가능.
소스/릴리스: java-tron (Java 기반)
실행: FullNode.jar + 설정 파일 (config.conf 등)

SolidityNode (고정 노드)

역할: 신뢰한 FullNode로부터 확정(solidified) 블록만 동기화. 블록 조회·검증에 사용.
실행: v4.8.1부터 FullNode.jar --solidity -c config.conf. config 내 node.trustNode로 FullNode gRPC 주소 지정.

Block Production Node (SR 노드)

역할: 슈퍼 대표(Super Representative)가 블록 생산에 참여. FullNode 기능 + 블록 생성·트랜잭션 패키징.
실행: FullNode.jar --witness -c config.conf + config 내 localwitness 또는 keystore 설정.

지원 환경

OS: Linux, macOS (Windows 미지원)
아키텍처·JDK:
- x86_64: Oracle JDK 8
- ARM64 (Apple Silicon 등): JDK 17 (java-tron 4.8.1+)

설치 방법

Localhost 설치 (권장)

호스트에 JDK를 설치한 뒤 FullNode.jar를 다운로드 또는 소스 빌드하여 실행하는 방법입니다.

시작하기: localhost/README.md

Docker 설치

Docker로 메인넷 FullNode만 실행할 때 사용합니다. SolidityNode·SR 노드는 localhost 가이드를 참고하세요.

시작하기: docker/README.md

폴더 구조

tron/
├── README.md                 # 이 파일
├── localhost/                # 호스트 설치 가이드
│   ├── README.md
│   ├── installation.md       # JDK, FullNode, 설정, 실행
│   ├── configuration.md      # config 참고
│   ├── troubleshooting.md    # 문제 해결
│   └── updates/
│       └── README.md
└── docker/                   # Docker FullNode
    ├── README.md
    ├── Dockerfile
    ├── launcher.sh
    ├── docker-compose.yml
    └── .env.example

하드웨어 요구사항

공식 문서 기준 요약입니다.

FullNode 권장

대역폭: 100 Mbps
SSD: 2.5 TB+ (문서에 따라 3 TB~3.5 TB+ 권장)
RAM: 32 GB
CPU: 16코어

FullNode 최소

대역폭: 100 Mbps
SSD: 3 TB
RAM: 16 GB
CPU: 8코어

SR(블록 생산) 노드 권장

RAM: 64 GB
CPU: 32코어
SSD·대역폭은 FullNode와 동일 이상 권장

네트워크

네트워크	설명	설정 파일
Mainnet	메인넷 (실제 TRX·TRC-20 등)	config.conf
Nile	테스트넷 (신기능 먼저 적용)	config-nile.conf 등
Shasta	테스트넷 (메인넷과 유사)	TronGrid 등 공개 엔드포인트 사용. 공개 피어 미제공.
Private	사설망	Private Chain 참고

tron