← 博客
10 分钟阅读
|
发布于
|
更新于

如何搭建 TRON 节点(务实的方法)

无需 3 TB 硬盘即可运行 TRON 节点:从快照恢复 Lite FullNode,提供 systemd 与 Docker 两种部署方式、硬件对照表、成本估算,以及与 API 方案的盈亏平衡点。文章还说明日常监控、升级与安全要点。

章节
C
Chaingateway Team
区块链专家

审核: Maurice Sobiera

TRON 节点是运行 java-tron(参考客户端)的一个实例,它验证区块并转发交易。它在 8090 端口提供 HTTP API,在 50051 端口提供 gRPC API,应用通过这些接口查询链上状态并广播交易。Lite FullNode 从快照启动,所需硬盘远少于完整节点。

官方文档介绍的是用 JDK 工具链构建 java-tron。本指南采用一条更短的路线:使用发布页提供的预编译 FullNode.jar,再配合 Lite FullNode 快照。随后介绍 Docker 方式,它无需在本地安装 Java。最后给出同步时间、成本估算,以及与 API 方案的盈亏平衡分析。

什么是 TRON 节点?

TRON 节点运行 java-tron,并将你接入网络。网络每 3 秒产出一个区块。通过 HTTP 和 gRPC API,你可以部署和调用合约、转移 TRX 和代币,以及查询链上状态。TRON 开发者中心记录了节点类型和硬件要求。

java-tron 经常发布新版本。GitHub 上的 java-tron 发布页在撰写本文时列出 v4.8.1(Democritus,2026 年 2 月)、v4.8.1.1(Hypatia,2026 年 6 月)和 v4.8.2.4(Empedocles,2026 年 10 月 22 日)为最新版本。下载前请在该页面确认当前版本。

节点有三种角色:

  • FullNode 验证并转发区块,并回答 API 查询。几乎所有情况下,你需要的都是它。
  • 见证节点(witness)负责生产区块。这是为通过 TRX 投票当选的 27 位超级代表保留的,因此 --witness 参数对其他人毫无用处。
  • Lite FullNode 是相同的软件,但数据库更小。它从快照启动,快照包含当前状态以及最近的 65,536 个区块。

Lite FullNode 能满足支付后端的需求:当前状态、新区块、广播交易以及监控充值。它无法回答其快照之前的历史问题,因此通过交易 ID 查询旧交易会失败。浏览器和分析平台需要完整历史,而大多数集成并不需要。

三种角色并列对比如下:

Lite FullNodeFullNode(完整历史)见证(SR)节点
硬盘完整节点的几个百分点;预留 300–500 GB4 TB 或更大的 SSD(官方建议)4 TB 或更大的 SSD
历史从快照时点起自创世区块起完整完整
HTTP/gRPC API有有有
生产区块否否是,仅限当选的 27 位 SR
典型运营方支付后端、集成方浏览器、分析、合规归档当选的超级代表

TRON 节点需要什么硬件?

官方文档列出的最低配置为 8 个 CPU 核心、16 GB 内存、100 Mbit/s 带宽,以及 4 TB 或更大的 SSD。推荐配置如下:

组件FullNode(完整历史)Lite FullNode见证(SR)节点
CPU16 核16 核32 核
内存32 GB32 GB64 GB
硬盘4 TB+ SSD完整节点大小的几个百分点,并会增长4 TB+ SSD
网络100 Mbit/s100 Mbit/s100 Mbit/s

来源:TRON 开发者中心,部署 FullNode。该页面没有给出 Lite 版本的确切硬盘大小,因此请预留 300–500 GB 并自行测量。在 TRON 上,内存有两方面的作用:一是 JVM 堆,二是操作系统的文件缓存。

分步指南:使用发布版 jar 运行 Lite FullNode

以下命令假设使用 Ubuntu 24.04。

1. 安装 Java 8

在 x86_64 上,java-tron 只支持 JDK 8。在 ARM64 上,自 v4.8.1 起只支持 JDK 17。如果 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 和主网配置

无需 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 开发者中心的数据库快照页面列出了新加坡和美国的镜像,分为 LevelDB 和 RocksDB 两种版本。除非你的配置另有说明,请选择 LevelDB,因为数据库引擎必须与快照一致。该页面称 Lite 快照通常只占完整数据集的几个百分点。完整 FullNode 的归档包在 2026 年 9 月约为 3.3 TB(压缩后),因此 Lite 下载文件大小在数百 GB 之内。

选择离你的服务器最近的镜像,复制当前链接并运行:

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 TB 的归档就不必在磁盘上与其解压副本同时存在。对于 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 GB 或以上的主机,文档建议将 -Xmx 设为物理内存的约 40%,-Xms 从 9 GB 开始,然后在负载下调优。文档中 16 GB 的示例使用 -Xmx12G。

UseConcMarkSweepGC 参数适用于 x86_64 上的 JDK 8。systemd 以 SIGTERM 停止服务,这与文档中的 kill -15 指令一致。切勿对 TRON 节点执行 kill -9;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 还会显示对等节点数量和同步状态。当你的高度与浏览器一致时,节点即已上线。

关于区块生产,官方文档用了好几页介绍,这里简单说明:见证节点只对当选的 27 位超级代表有意义。其机制,--witness 参数加上 main_net_config.conf 中 localwitness 列表里的 SR 私钥,或者如果你拒绝明文密钥,则使用 keystore 加密码的变体,在上游文档中有详细说明。对于其他所有人,普通的 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

卷挂载复用了第 4 步中的 Lite 快照,因此启动容器不是重新同步。将 8090 和 50051 绑定到 127.0.0.1,可以让 API 保持私有,而 P2P 端口仍可访问。如需自定义设置,可将你的 main_net_config.conf 挂载到容器中,并以命令参数的形式传入 -c;否则镜像会使用主网的默认配置。如果你的主机已经在使用其他容器,这是更清晰的部署方式:只需升级一个镜像,就能替换整个 Java 运行环境。

同步时间与快照处理

以下是算术,而非承诺。例如,一个 150 GB 的 Lite 归档,在持续 50 MB/s 的速度下约 50 分钟可下载完成,在 NVMe 上解压再增加几分钟。TRON 按 3 秒的间隔每天产出约 28,800 个区块。节点导入区块的速度快于实时,因此从几天前的快照追赶上来,只需几分钟到几小时。一个正常工作的 Lite FullNode 可以在一个下午内搭建完成。

对于完整历史的节点,同样的计算就很痛苦了。3.3 TB 的归档以 100 MB/s 的速度下载,还未开始解压就要约 9 小时。若不使用快照而从创世区块同步,耗时会长得多。需要知道的一个不对称之处是:文档中描述了一个 Lite FullNode 剪枝工具,可从一个健康的 FullNode 生成 Lite 快照。但没有从 Lite 恢复到完整节点的路径,因此如果将来需要完整历史,请从完整快照开始。

事件流与 gRPC

通过 HTTP 轮询区块是可行的,但 java-tron 也可以主动推送。事件订阅机制在 main_net_config.conf 的 event.subscribe 块中启用,它会为新区块、交易、合约日志和合约事件发布触发器。对于轻量部署,事件进入内置的 ZeroMQ 队列;对于真正的数据管道,则可通过插件推送到 Kafka 或 MongoDB。

对于充值检测,它取代了逐块扫描:订阅合约事件,筛选 USDT 合约,并将接收方与你的客户地址进行匹配。有一个细节决定正确性。普通触发器在区块到达时即触发,但 TRON 区块只有在足够多的超级代表确认之后才变得不可逆;已固化触发器的变体会在那个时点触发,而且应当依据它们来为客户余额入账。基于未固化区块入账的充值,极少数情况下可能因重组而消失。

第二种机器接口是 50051 端口上的 gRPC:与 HTTP 提供相同的钱包操作,但采用 protobuf 类型定义,在高负载下每次调用更快,这也是 TRON 上大多数索引器和交易所后端使用它的原因。一种实用的分工是:索引器的批量读取使用 gRPC;如本指南中的 curl 检查等临时探测使用 HTTP;而只应看到不可逆状态的查询,则使用 solidity API(启用后位于 8091 端口)。

TRON 节点的成本

这是一种计算路径,而不是价目表。Lite FullNode 需要 8–16 个核心、32 GB 内存,以及约 500 GB 的 NVMe。它属于中高端 VPS 或入门级独立服务器的范畴。在欧洲的主机商处,按数量级估计,这大约是每月几十欧元到一百多欧元的水平。完整历史的节点需要 3 TB 以上的 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 位超级代表中三分之二的确认深度,约相当于一分钟的链上时间。对于告警,每隔几分钟将你的链头与 tronscan 或第二个节点进行比较,当差距超过 40 个区块(约两分钟的链上时间)时发出提醒。systemctl is-active tron 加上同一调用中的对等节点数,即可覆盖存活性检查。

由于该节点是 JVM 程序,请单独关注内存:jstat -gcutil $(pgrep -f FullNode.jar) 10s 可显示垃圾回收压力,全量 GC 时间上升会在节点开始落后之前出现在该输出中。另外,用 df -h /var/lib/tron 设置 85% 的阈值,Lite 节点增长缓慢,但它确实在增长;那个给你发送同步状态邮件的同一个定时任务,可以顺带检查磁盘使用情况。

维护与升级

java-tron 每一到三个月发布一次新版本。从 v4.8.0.1(2026 年 1 月)到 v4.8.2.4(2026 年 10 月)的每个版本的发布说明中都包含“mandatory”一词。请阅读每个版本的说明,以确认哪些升级是必需的,因为运行旧版本的节点可能会在网络规则变更时落在错误的一方。订阅 java-tron 发布源,并在公布的时间窗口内完成升级。

升级过程会保留数据库。下载新的 FullNode.jar,将 sha256sum 与发布页比对,停止服务(systemd 发送 SIGTERM,这是文档所述的正常关闭方式),将 /opt/tron 中的 jar 替换,然后重新启动。节点会重放它错过的几分钟,并很快回到链头。

还有两项较慢的日常维护工作需要列入清单。Lite 数据库会随着状态及其不断累积的区块尾部而增长;当它大到超出舒适范围时,恢复一份新的 Lite 快照,这与崩溃恢复是同一操作,也正是这种部署方式能保持恢复成本低的原因。另外,请留意 Java 版本要求。根据部署文档,x86_64 构建使用 JDK 8,而自 v4.8.1 起新增的 ARM64 构建使用 JDK 17。

安全:两个 API 端口,零身份验证

8090(HTTP)和 50051(gRPC)端口会接受任何能访问到它们的人,无需令牌、无需账户,什么都不需要。按本指南搭建的节点不持有任何私钥,因此端口暴露并不会直接导致资金损失。但它仍会把免费的 RPC 服务交给陌生人。针对区块端点的大量查询,可能耗尽机器的磁盘 I/O,直到你自己的软件无法运行。应假定任何可从互联网访问的端口当下都正在被扫描。

第 5 步中的防火墙就是策略本身:ufw default deny incoming,然后仅放行 SSH 和 18888(TCP 与 UDP),其余一律不开放。当其他机器需要访问 API 时,请通过 WireGuard 或 SSH 隧道连接,或者在前面部署带 TLS 和 IP 白名单的 nginx,并且即便如此,也只转发你实际调用的端点。每次修改配置后,都要用 ss -tlnp 检查实际监听的端口:java-tron 可以根据配置文件开放额外端口,其中包括 8091 端口上的 solidity API,而被你忘记的端口就是没有防火墙保护的端口。

有一种特殊情况。如果你在某台机器上放置了见证节点密钥,那么这台机器就不再是基础设施,而成了热钱包。应将其与 RPC 服务分开,并且要像对待密钥本身一样谨慎地对待其配置文件,配置文件中可能以明文保存着密钥。

故障排查

启动时立即因 Java 版本错误而退出

UnsupportedClassVersionError 或类似错误说明 JVM 版本为 11 或更高。使用 sudo update-alternatives --config java 选择 Java 8,或直接使用 Docker 镜像避开该问题。

OutOfMemoryError 或长达数分钟的 GC 停顿

-Xmx 设置不当。请遵循部署文档中的内存配置,在内存为 32 GB 或以上的主机上约为内存的 40%,并为操作系统的文件缓存留出空间。不要与其他耗内存的服务共用主机。在 16 GB 的机器上,文档使用的是 -Xmx12G。

节点已启动但停留在快照高度

没有对等节点。检查 18888 端口是否对 TCP 和 UDP 都已开放,查看 /wallet/getnodeinfo 中的对等节点数,并用 timedatectl 验证时钟,必须启用 NTP。刚启动后,请先给对等节点发现过程几分钟时间,再深入排查。

崩溃或重启后出现数据库错误

kill -9、OOM 杀进程或断电都会损坏数据库。最快的修复方式也正是设计者的预期:清空 output-directory,恢复一份新的 Lite 快照,然后重启,这正是小快照体积的回报。预防措施包括:始终通过 systemd 停止服务,并保留足够的空闲内存,使内核永远不会因 OOM 杀死 Java 进程。

节点持续落后于链头

对等节点已连接,区块也在到达,但与 tronscan 的差距却越拉越大。按以下顺序排查:磁盘延迟(用 fio 做随机读基准测试,网络存储或 SATA 上的 LevelDB 是典型原因)、GC 压力(jstat -gcutil,见监控一节),然后是同机其他负载造成的 CPU 争用。TRON 的 3 秒节奏可以容忍短暂停顿;如果延迟在数小时内持续增长,说明机器跟不上,没有任何配置参数能修复配置不足的硬件。

磁盘写满

先执行 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 余额查询中。检测它意味着需要从每个区块中解码 TRC-20 Transfer 事件,或者通过上文的事件机制订阅它们,并且只在固化之后入账:大约 19 个区块,约一分钟,如共识文档所述。

付款的经济性则另有考量。一笔 USDT 转账会消耗能量(Energy),而没有质押 TRX 的钱包需要通过燃烧 TRX 来支付。我们的 TRON 手续费计算器估算:在能量价格为 100 Sun 的情况下,向已持有 USDT 的地址转账约需 6.4 TRX,向空地址转账约需 13.4 TRX。治理投票可以改变该价格,因此在依赖它之前,请从 GET /api/v2/tron/chainparameters 读取当前值。

大规模运营的场景则会质押 TRX 以获取能量,这正是冻结和委托机制存在的原因。

但应当清楚,原始节点只提供给你 HTTP 和 gRPC 端点,仅此而已。检测客户的 USDT 充值意味着要针对你的地址列表扫描每个区块中的 TRC-20 转账事件,并自行处理确认和重试。而 TRON 的手续费体系,带宽、能量、冻结 TRX、为用户代付手续费,本身就是一门专门的学问;在围绕它进行构建之前,TRON 手续费计算器可以显示一笔 USDT 转账的真实成本。

常见问题

TRON 节点需要多少硬盘空间?

Lite FullNode 从占完整数据库几个百分点的快照开始,建议预留 300–500 GB NVMe 以应对增长。完整历史的 FullNode 需要 3 TB 以上。TRON 开发者中心列出的压缩快照包在 2026 年 9 月约为 3.3 TB 至 4.4 TB,官方硬件表建议 4 TB 或更大的 SSD。

可以在 Windows 上运行 TRON 节点吗?

官方 java-tron 面向 Linux 和 macOS。在 Windows 上,较为可行的方式是使用 Docker 镜像,它已经固定了包括 Java 8 在内的整个运行环境。

运行 TRON 节点能赚取 TRX 吗?

不能。出块奖励通过质押分配给 27 位当选的超级代表及其投票者。FullNode 给你的是独立的链上访问能力,而不是收入。

java-tron 需要哪个 Java 版本?

x86_64 使用 JDK 8,ARM64 使用 JDK 17,后者自 v4.8.1 起受 java-tron 支持。如果 JDK 与 CPU 架构不匹配,节点会直接退出。这是最常见的部署失败原因,也是本指南提供 Docker 镜像的原因。

FullNode 与 Lite FullNode 有什么区别?

软件相同,数据库不同。Lite 版本从当前状态加最近 65,536 个区块的快照开始,无法回答快照之前的交易查询。支付功能正常工作,但区块浏览器的历史记录无法查询。

自己运行节点还是使用 API?

这是一个坦率的比较,因为 Chaingateway 销售的正是另一种方案。

当你需要大规模读取链上数据时,例如建立索引、监控你自己地址之外的网络,或将 gRPC 数据接入你自己的管道,或者当政策不允许第三方参与时,应自行运行节点。Lite FullNode 成本低,因此大量读取的工作负载能很快摊薄成本;在主流公链中,这是最便宜的自建节点之一。

当节点只是支付的基础管道时,应使用 API。即使节点已同步,你仍需自行构建按客户生成地址、检测 TRC-20 充值、投递 Webhook、保管密钥以及管理手续费。Chaingateway 的 TRON API 就是这一层,以 REST 端点的形式提供:导入地址(POST /api/v2/tron/addresses/import)、发送 USDT 及其他 TRC-20 代币(POST /api/v2/tron/transactions/trc20)或 TRC-10 资产、为获取能量而冻结和委托资源(POST /api/v2/tron/freeze、POST /api/v2/tron/delegate),以及接收经 HMAC 签名的充值 Webhook;失败的投递会出现在 GET /api/v2/tron/webhooks/notifications/failed 中,并可通过重试端点重新发送。

盈亏平衡可以按如下算术计算:(服务器费用 + 快照刷新 + 你的工时 × 你的时薪)与 /pricing/ 上的套餐进行比较。对于充值与付款的场景,在达到大规模之前,API 方案的成本通常更低;而对于纯粹的链上数据读取,自建节点几乎立即占优。快速入门和 Webhook 指南涵盖了首次端到端测试,7 天试用无需 KYC(注册)。

如果你还要运行 EVM 链,可参阅 Ethereum 和 BNB Smart Chain 的搭建指南。

我们如何撰写这些文章

准备好自己动手构建了吗? 获取你的 API key — 7 天试用,无需信用卡 — 或查看 Tron API 获取完整的 endpoint 参考。

C
Chaingateway Team
区块链专家

Chaingateway 团队致力于为全球开发者简化区块链集成。