← Блог
10 мин чтения
|
Опубликовано
|
Обновлено

Как настроить ноду TRON (прагматичный способ)

Запустите ноду TRON без 3 ТБ диска: Lite FullNode из снапшота, systemd и Docker, таблица оборудования, расходы и точка безубыточности против API.

Главы
C
Chaingateway Team
Эксперты по блокчейну

Проверил(а) Maurice Sobiera

Нода TRON — это запущенный экземпляр java-tron, эталонного клиента, который проверяет блоки и ретранслирует транзакции. Она открывает HTTP API на порту 8090 и gRPC API на порту 50051, через которые приложения запрашивают состояние цепочки и отправляют транзакции. Lite FullNode, запущенная из снапшота, требует гораздо меньше диска, чем полная нода.

Официальная документация описывает сборку java-tron через инструментарий JDK. Это руководство идёт короче: готовый FullNode.jar со страницы релизов плюс снапшот Lite FullNode. Docker следует как альтернатива без локальной установки Java. В конце руководства — сроки синхронизации, оценка стоимости и точка безубыточности относительно API.

Что такое нода TRON?

Нода TRON работает на java-tron и подключает вас к сети, которая производит блок каждые 3 секунды. Через HTTP и gRPC API можно развернуть и вызвать контракты, перевести TRX и токены и запросить состояние цепочки. Портал TRON developer hub описывает типы нод и оборудование.

java-tron выходит часто. Релизы java-tron на GitHub на момент написания называют самыми новыми v4.8.1 (Democritus, февраль 2026), v4.8.1.1 (Hypatia, июнь 2026) и v4.8.2.4 (Empedocles, 22 октября 2026). Перед загрузкой проверьте страницу, чтобы узнать текущую версию.

Есть три роли ноды:

  • FullNode проверяет и ретранслирует блоки и отвечает на запросы API. Почти в каждом случае нужна именно эта роль.
  • Witness-нода производит блоки. Это зарезервировано за 27 супер-представителями, избранными голосами TRX, поэтому флаг --witness никому, кроме них, ничего полезного не даёт.
  • Lite FullNode — то же ПО с меньшей базой данных. Она стартует со снапшота, который содержит текущее состояние и последние 65 536 блоков.

Lite FullNode покрывает то, что нужно платёжному бэкенду: текущее состояние, новые блоки, рассылку транзакций и отслеживание депозитов. Она не может отвечать на вопросы об истории до своего снапшота, поэтому запрос старой транзакции по ID завершится ошибкой. Эксплорерам и аналитическим платформам нужна полная история. Большинству интеграций она не нужна.

Три роли рядом:

Lite FullNodeFullNode (полная история)Witness-нода (SR)
Дискнесколько процентов от полной ноды; планируйте 300–500 ГБ4 ТБ и более SSD (официальная рекомендация)4 ТБ и более SSD
Историяот своего снапшота и далееполная с генезисаполная
API HTTP/gRPCдадада
Производит блокинетнетда — только 27 избранных SR
Типичный операторплатёжные бэкенды, интеграцииэксплореры, аналитика, архивы для комплаенсаизбранные супер-представители

Какое оборудование нужно ноде TRON?

Официальная документация называет минимум: 8 ядер CPU, 16 ГБ ОЗУ, канал 100 Мбит/с и 4 ТБ и более SSD. Рекомендуемые конфигурации:

КомпонентFullNode (полная история)Lite FullNodeWitness-нода (SR)
CPU16 ядер16 ядер32 ядра
RAM32 ГБ32 ГБ64 ГБ
Диск4 ТБ+ SSDнесколько процентов от размера полной ноды, растёт4 ТБ+ SSD
Сеть100 Мбит/с100 Мбит/с100 Мбит/с

Источник: документация TRON developer hub, развёртывание FullNode. Страница не называет точный размер диска для Lite, поэтому планируйте 300–500 ГБ и измеряйте сами. ОЗУ важна в TRON дважды: для кучи JVM и для файлового кеша операционной системы.

Пошагово: Lite FullNode с готовым jar-файлом релиза

Команды рассчитаны на Ubuntu 24.04.

1. Установите Java 8

На x86_64 java-tron поддерживает только JDK 8. На ARM64 — только JDK 17, начиная с v4.8.1. Нода завершается, если версия JDK не соответствует архитектуре.

Terminal window
sudo apt update
sudo apt install -y openjdk-8-jdk
java -version # must report 1.8.x

2. Создайте пользователя и каталоги

Terminal window
sudo useradd --no-create-home --shell /usr/sbin/nologin tron
sudo mkdir -p /opt/tron /var/lib/tron
sudo chown -R tron:tron /opt/tron /var/lib/tron

3. Скачайте jar-файл релиза и конфигурацию mainnet

Сборка через Gradle не нужна. Каждый релиз java-tron содержит готовый FullNode.jar:

Terminal window
cd /opt/tron
sudo -u tron wget $(curl -s https://api.github.com/repos/tronprotocol/java-tron/releases/latest \
| grep browser_download_url | grep FullNode.jar | cut -d '"' -f 4)
sudo -u tron wget https://raw.githubusercontent.com/tronprotocol/tron-deployment/master/main_net_config.conf

На страницах релизов публикуются контрольные суммы. Выполните sha256sum FullNode.jar и сравните результат, прежде чем запускать код, который месяцами будет держать сетевые соединения открытыми.

4. Восстановите снапшот Lite FullNode

На странице снапшотов базы данных портала TRON developer hub перечислены зеркала в Сингапуре и США в вариантах LevelDB и RocksDB. Берите LevelDB, если ваша конфигурация не требует иного, потому что движок базы должен совпадать со снапшотом. На странице сказано, что Lite-снапшот обычно составляет несколько процентов от полного набора данных. Архивы полной FullNode в сентябре 2026 года составляли около 3,3 ТБ (сжатые), значит, загрузка Lite исчисляется сотнями гигабайт.

Выберите зеркало, ближайшее к серверу, скопируйте актуальную ссылку и выполните:

Terminal window
cd /var/lib/tron
sudo -u tron wget '<PASTE_LITE_SNAPSHOT_URL>'
sudo -u tron tar xzf LiteFullNode_output-directory.tgz

Снапшот Lite содержит текущее состояние и последние 65 536 блоков. После распаковки у вас должен появиться каталог /var/lib/tron/output-directory с базой данных. Именно эта папка и есть весь трюк «синхронизации из снапшота»: нода стартует поверх этого состояния вместо того, чтобы проигрывать годы блоков. Если вы когда-нибудь восстанавливаете вариант с полной историей, используйте потоковую форму, которую рекомендуют зеркала: wget -qO- '<URL>' | tar xz. Так архив на 3 ТБ никогда не лежит на диске рядом со своей распакованной копией. Для архива Lite нормально сначала скачать его, а потом распаковать.

5. Юнит systemd

Создайте /etc/systemd/system/tron.service:

[Unit]
Description=TRON Lite FullNode (java-tron)
After=network-online.target
Wants=network-online.target
[Service]
User=tron
Group=tron
Type=simple
Restart=always
RestartSec=10
WorkingDirectory=/var/lib/tron
ExecStart=/usr/bin/java -Xms9g -Xmx12g -XX:+UseConcMarkSweepGC \
-jar /opt/tron/FullNode.jar \
-c /opt/tron/main_net_config.conf \
-d /var/lib/tron/output-directory
[Install]
WantedBy=multi-user.target

Две детали JVM прямо следуют из официальной документации. Параметры JVM, например флаг сборщика мусора, ставятся перед -jar, а не после него. Для хостов с 32 ГБ ОЗУ и более документация советует задавать -Xmx примерно в 40% физической памяти и начинать -Xms с 9 ГБ, а затем настраивать под нагрузку. В примерах документации для 16 ГБ используется -Xmx12G. Флаг UseConcMarkSweepGC относится к JDK 8 на x86_64. systemd останавливает сервис сигналом SIGTERM, что совпадает с инструкцией документации kill -15, а kill -9 для ноды TRON недопустим: LevelDB повреждается, и вместо ужина вам придётся восстанавливать снапшот.

Откройте порт P2P, а API-порты держите закрытыми:

Terminal window
sudo ufw allow 18888 comment 'tron p2p'

Порты 8090 и 50051 не требуют аутентификации, поэтому они должны оставаться закрытыми для интернета.

6. Запустите и проверьте

Terminal window
sudo systemctl daemon-reload
sudo systemctl enable --now tron
journalctl -fu tron

Когда появятся сообщения о блоках, проверьте высоту:

Terminal window
curl -s http://127.0.0.1:8090/wallet/getnowblock | jq '.block_header.raw_data.number'

Сверьте число с последним блоком на tronscan.org. curl http://127.0.0.1:8090/wallet/getnodeinfo дополнительно показывает число пиров и статус синхронизации. Когда ваша высота совпадает с эксплорером, нода работает.

Несколько слов о производстве блоков, которому официальная документация посвящает целые страницы. Witness-нода имеет смысл только для 27 избранных супер-представителей. Механика — флаг --witness плюс приватный ключ SR в списке localwitness файла main_net_config.conf или вариант с keystore и паролем, если вы отказываетесь хранить ключи открытым текстом, — описана в upstream-документации. Всем остальным подходит обычная FullNode.

Docker вместо Java

Официальный образ Docker решает за вас требование JDK 8:

Terminal window
docker pull tronprotocol/java-tron
docker run -d --name tron --restart unless-stopped \
-p 127.0.0.1:8090:8090 -p 127.0.0.1:50051:50051 \
-p 18888:18888 -p 18888:18888/udp \
-v /var/lib/tron/output-directory:/java-tron/output-directory \
tronprotocol/java-tron

Монтирование тома использует снапшот Lite из шага 4, поэтому запуск контейнера — не повторная синхронизация. Привязка портов 8090 и 50051 к 127.0.0.1 держит API закрытыми, а порт P2P остаётся доступным. Для собственных настроек смонтируйте свой main_net_config.conf в контейнер и передайте -c как аргумент команды. Без этого образ работает с настройками mainnet по умолчанию. Если на хосте уже работают другие контейнеры, это более чистая схема: обновление одного образа заменяет весь стек Java.

Время синхронизации и работа со снапшотом

Арифметика, а не обещания. Например, архив Lite на 150 ГБ при устойчивых 50 МБ/с загружается примерно за 50 минут, а распаковка на NVMe добавляет минуты. TRON производит около 28 800 блоков в сутки при интервале 3 секунды. Нода импортирует блоки быстрее реального времени, поэтому догнать снапшот возрастом в несколько дней занимает от минут до нескольких часов. Рабочая Lite FullNode укладывается в один рабочий день.

Для ноды с полной историей та же арифметика неприятнее. Архив на 3,3 ТБ при 100 МБ/с загружается около 9 часов ещё до начала распаковки. Синхронизация с генезиса без снапшота занимает гораздо дольше. Одна асимметрия, которую нужно знать: документация описывает инструмент обрезки (pruning), который создаёт Lite-снапшот из здоровой FullNode. Пути от Lite обратно к полной ноде нет, поэтому, если когда-нибудь понадобится полная история, начинайте с полного снапшота.

Потоки событий и gRPC

Опрос блоков по HTTP работает, но java-tron умеет и сам отправлять события. Механизм подписки на события включается в блоке event.subscribe файла main_net_config.conf. Он публикует триггеры для новых блоков, транзакций, логов контрактов и событий контрактов. В простых установках это встроенная очередь ZeroMQ, а для серьёзных конвейеров — плагины, которые пишут в Kafka или MongoDB.

Для обнаружения депозитов это заменяет сканирование блоков. Подпишитесь на события контрактов, отфильтруйте контракт USDT и сопоставьте получателя с адресами клиентов. Одна деталь определяет корректность. Обычные триггеры срабатывают, когда приходит блок, но блок TRON становится необратимым только после того, как достаточное число супер-представителей его подтвердит. Варианты триггеров для солидифицированных блоков срабатывают в этот момент, и именно по ним следует зачислять баланс клиентов. Депозит, зачисленный из неподтверждённого блока, в редких случаях может исчезнуть при реорганизации.

Второй машинный интерфейс — gRPC на порту 50051. Он предлагает те же операции кошелька, что и HTTP, но с типами protobuf и быстрее на вызов под нагрузкой, поэтому большинство индексаторов и бэкендов бирж в TRON использует именно его. Практическое разделение: gRPC для массовых чтений индексатора, HTTP для разовых проверок вроде curl-команд этого руководства, а solidity API (порт 8091, если он включён) — для запросов, которые должны видеть только необратимое состояние.

Сколько стоит нода TRON

Это путь расчёта, а не прайс-лист. Lite FullNode требует 8–16 ядер, 32 ГБ ОЗУ и примерно 500 ГБ NVMe. Это уровень верхнего среднего VPS или начального выделенного сервера. У европейских хостеров это, как порядок величины, сумма от средней двузначной до низкой трёхзначной в евро в месяц. Нода с полной историей требует класса 3 ТБ+ NVMe, то есть полноценного выделенного сервера в диапазоне от низкой до средней трёхзначной суммы.

Добавьте свои часы: полдня на установку по этому руководству, обновления java-tron раз в несколько месяцев и периодическое обновление снапшота после сбоя. Lite FullNode — редкий случай, когда собственная инфраструктура блокчейна действительно дешева, но только если ничей доход не зависит от того, что она работает в 3 часа ночи.

Мониторинг и проверки здоровья

Всё, что стоит проверять, находится за одним эндпоинтом. /wallet/getnodeinfo в одном вызове показывает версию клиента, число пиров, последний блок и последний солидифицированный блок:

Terminal window
curl -s http://127.0.0.1:8090/wallet/getnodeinfo | jq \
'{version: .configNodeInfo.codeVersion, peers: .currentConnectCount,
head: .block, solidified: .solidityBlock}'

Здоровая нода показывает высоту, которая растёт каждые 3 секунды, а солидифицированный блок отстаёт примерно на 19–20 блоков. Это глубина подтверждения двумя третями от 27 SR, около минуты времени цепочки. Для алертов сверяйте свою высоту с tronscan или второй нодой каждые несколько минут и поднимайте тревогу, когда разрыв превышает 40 блоков, то есть две минуты времени цепочки. systemctl is-active tron вместе с числом пиров из того же вызова покрывает проверку живости.

Поскольку нода — это JVM, следите за памятью отдельно. jstat -gcutil $(pgrep -f FullNode.jar) 10s показывает нагрузку сборщика мусора, и рост времени полных сборок появляется в этом выводе раньше, чем нода начинает отставать. Добавьте df -h /var/lib/tron с порогом 85 процентов. Lite-нода растёт медленно, но растёт, и то же задание cron, которое отправляет вам статус синхронизации, может бесплатно проверять и место на диске.

Обслуживание и обновления

Релизы java-tron выходят раз в один–три месяца. В примечаниях к каждой версии от v4.8.0.1 (январь 2026) до v4.8.2.4 (октябрь 2026) встречается слово «mandatory». Читайте примечания каждого релиза, чтобы понимать, какие обновления обязательны. Ноды на старых версиях могут оказаться не на той стороне изменения сетевых правил. Подпишитесь на ленту релизов java-tron и обновляйтесь в объявленные сроки.

Обновление сохраняет базу данных. Скачайте новый FullNode.jar, сравните sha256sum со страницей релиза, остановите сервис (systemd отправит SIGTERM, это документированное корректное завершение), замените jar в /opt/tron и запустите снова. Нода догонит несколько минут, которые пропустила, и вскоре вернётся к высоте сети.

В список стоит добавить две более медленные работы. База Lite растёт вместе с состоянием и накапливающимся хвостом блоков. Когда она становится слишком большой, восстановите свежий снапшот Lite. Это тот же ход, что и восстановление после сбоя, и причина, по которой эта схема делает восстановление дешёвым. Также следите за требованием к Java. Согласно документации по развёртыванию, сборки x86_64 используют JDK 8, а сборки ARM64, появившиеся в v4.8.1, — JDK 17.

Безопасность: два API-порта и никакой аутентификации

Порты 8090 (HTTP) и 50051 (gRPC) принимают любого, кто может до них достучаться: без токенов, без аккаунтов, без чего-либо. Нода, настроенная по этому руководству, не хранит приватных ключей, поэтому открытый порт не теряет средства напрямую. Но он всё равно раздаёт посторонним бесплатный RPC-сервис. Интенсивные циклы запросов к эндпоинтам блоков могут исчерпать дисковый ввод-вывод машины, пока ваше ПО не начнёт голодать. Считайте, что любой порт, доступный из интернета, сегодня уже сканируется.

Политика — файрвол из шага 5: ufw default deny incoming, затем SSH и 18888 (TCP и UDP) и больше ничего. Когда другим машинам нужен API, подключайтесь через WireGuard или SSH либо поставьте nginx с TLS и allowlist IP. И даже тогда пробрасывайте только те эндпоинты, которые реально вызываете. После каждого изменения конфигурации проверяйте, что реально слушает, командой ss -tlnp. java-tron может открыть дополнительные порты из файла конфигурации, в том числе solidity API на 8091. Забытый порт — это порт, который вы не закрыли файрволом.

Особый случай: если вы когда-либо положите ключ witness на машину, эта машина перестаёт быть инфраструктурой и становится горячим кошельком. Отделите её от обслуживания RPC, а файл конфигурации, который может содержать ключ открытым текстом, берегите с той же осторожностью, что и сам ключ.

Устранение неполадок

Запуск сразу падает с ошибкой версии Java

UnsupportedClassVersionError или похожая ошибка означает, что JVM версии 11 или новее. Выберите Java 8 командой sudo update-alternatives --config java или обойдите проблему целиком, использовав образ Docker.

OutOfMemoryError или паузы сборщика мусора по минуте

-Xmx выставлен неверно. Следуйте расчёту из документации по развёртыванию: около 40% ОЗУ на хостах с 32 ГБ и более, и оставьте память для файлового кеша ОС. Не размещайте рядом другие требовательные к памяти сервисы. На машине с 16 ГБ документация использует -Xmx12G.

Нода запускается, но остаётся на высоте снапшота

Нет пиров. Проверьте, открыт ли порт 18888 для TCP и UDP, посмотрите число пиров в /wallet/getnodeinfo и проверьте часы командой timedatectl: NTP должен быть активен. Сразу после первого запуска дайте обнаружению пиров несколько минут, прежде чем копать глубже.

Ошибки базы данных после сбоя или перезагрузки

kill -9, убийство по OOM или отключение питания повреждают базу данных. Самое быстрое решение — и оно же предусмотренное: удалите output-directory, восстановите свежий снапшот Lite и перезапустите. Именно за этим нужен маленький размер снапшота. Профилактика: всегда останавливайте ноду через systemd и держите достаточно свободной ОЗУ, чтобы ядро никогда не убивало Java по OOM.

Нода постоянно отстаёт от головы сети

Пиры подключены, блоки приходят, но разрыв с tronscan растёт. Проверяйте в таком порядке: задержка диска (бенчмарк случайного чтения fio; LevelDB на сетевом хранилище или SATA — классическая причина), давление сборщика мусора (jstat -gcutil, см. раздел мониторинга), затем конкуренция за CPU с соседними нагрузками. 3-секундный интервал TRON прощает короткие остановки. Отставание, которое растёт часами, означает, что машина не справляется, и никакой флаг конфигурации не исправит недостаточное железо.

Диск заполнился

df -h, затем du -h --max-depth=2 /var/lib/tron. Обычная находка — забытый архив снапшота: файл .tgz может соперничать по размеру с распакованной базой. Если сам output-directory перерос том, восстановите свежий снапшот Lite на больший диск. Восстановление одновременно сбрасывает накопленный хвост блоков. Алерт на 85 процентов из раздела мониторинга превращает это из отказа в пункт в календаре.

Зачем вообще запускать ноду TRON: USDT

Самая частая причина — USDT-TRC20. Блоки приходят каждые 3 секунды, а перевод стоит несколько TRX, поэтому TRON используют для платежей в USDT. Собственная нода позволяет наблюдать за депозитами клиентов и отправлять выплаты без посредника.

Механика заслуживает ещё одного уровня детализации, потому что она определяет архитектуру. Депозит USDT — это не перевод TRX, а вызов смарт-контракта USDT, поэтому он никогда не появляется в обычных запросах баланса TRX. Чтобы его обнаружить, нужно декодировать события Transfer TRC-20 из каждого блока или подписаться на них через описанный выше механизм событий. Зачислять нужно только после солидификации: примерно 19 блоков, около минуты, как описано в документации по консенсусу.

Выплаты имеют собственную экономику. Перевод USDT расходует Energy, а кошелёк без застейканных TRX платит за это сжиганием TRX. Наш калькулятор комиссий TRON оценивает примерно 6,4 TRX на адрес, который уже хранит USDT, и примерно 13,4 TRX на пустой адрес при цене Energy 100 Sun. Голосования в управлении сетью могут изменить цену, поэтому читайте её из GET /api/v2/tron/chainparameters, прежде чем строить на ней.

При больших объёмах операторы вместо этого стейкают TRX ради energy. Для этого и существуют механики freeze и delegate.

Но будьте ясны в том, что даёт голая нода: только HTTP- и gRPC-эндпоинты, и ничего больше. Обнаружение депозита USDT клиента означает сканирование каждого блока на события переводов TRC-20 по списку ваших адресов, а также самостоятельную обработку подтверждений и повторов. Система комиссий TRON (пропускная способность, energy, заморозка TRX, спонсирование комиссий для пользователей) — отдельная область знаний. Калькулятор комиссий TRON показывает, во что на самом деле обходится перевод USDT, прежде чем вы начнёте строить вокруг него.

Запускать свою ноду или использовать API?

Честное сравнение, поскольку Chaingateway продаёт альтернативу.

Запускайте ноду, когда читаете цепочку в больших объёмах: индексация, мониторинг сети за пределами ваших адресов, подача gRPC в собственный конвейер, либо когда политика запрещает сторонних посредников. Низкая стоимость Lite FullNode означает, что тяжёлые нагрузки на чтение быстро окупаются. Это один из самых дешёвых self-hosted вариантов среди крупных сетей.

Используйте API, когда нода была бы лишь трубопроводом для платежей. Поверх синхронизированной ноды вам всё равно придётся строить генерацию адресов для каждого клиента, обнаружение депозитов TRC-20, доставку вебхуков, хранение ключей и управление комиссиями. TRON API Chaingateway — этот слой в виде REST-эндпоинтов: импорт адресов (POST /api/v2/tron/addresses/import), отправка USDT и других токенов TRC-20 (POST /api/v2/tron/transactions/trc20) или активов TRC-10, заморозка и делегирование ресурсов ради energy (POST /api/v2/tron/freeze, POST /api/v2/tron/delegate) и получение подписанных HMAC вебхуков о депозитах. Неудачные доставки появляются по GET /api/v2/tron/webhooks/notifications/failed и могут быть отправлены повторно через эндпоинт повтора.

Точка безубыточности в виде арифметики: (сервер + обновления снапшота + ваши часы × ваша ставка) против тарифа на /pricing/. Для сценариев депозитов и выплат сторона API остаётся меньше до серьёзного масштаба. Для голого чтения цепочки сторона ноды выигрывает почти сразу. Быстрый старт и руководство по вебхукам описывают первый сквозной тест, а 7-дневный пробный период не требует KYC (регистрация).

Работаете и с EVM-сетями? Руководства по настройке для Ethereum и BNB Smart Chain.

Часто задаваемые вопросы

Lite FullNode стартует со снапшота, который составляет несколько процентов от полной базы; закладывайте 300–500 ГБ NVMe на рост. Полная FullNode с историей требует больше 3 ТБ. Сжатые архивы снапшотов на портале TRON developer hub в сентябре 2026 года составляли примерно от 3,3 до 4,4 ТБ, а официальная таблица оборудования рекомендует 4 ТБ и более SSD.

Официально java-tron нацелен на Linux и macOS. На Windows практичный путь — образ Docker, который фиксирует всё окружение, включая Java 8.

Нет. Награды за блоки получают 27 избранных супер-представителей и их избиратели через стейкинг. FullNode даёт независимый доступ к сети, а не доход.

JDK 8 для x86_64 и JDK 17 для ARM64, что java-tron поддерживает начиная с v4.8.1. Нода завершается, если JDK не соответствует архитектуре процессора. Это самая частая ошибка настройки, и именно поэтому в этом руководстве есть образ Docker.

Одно и то же ПО, другая база данных. Вариант Lite стартует со снапшота текущего состояния плюс последних 65 536 блоков и не может ответить на запросы о транзакциях до своего снапшота. Платежи работают; история блок-эксплорера — нет.

Как мы пишем эти статьи

Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API Tron для полного справочника по эндпоинтам.

C
Chaingateway Team
Эксперты по блокчейну

Команда Chaingateway стремится упростить интеграцию блокчейна для разработчиков по всему миру.