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

如何搭建 Binance Smart Chain(BSC)节点

按官方方式搭建 BSC 节点:快照同步、bnb-chain geth 分支、systemd 服务单元、硬件表与成本,以及何时使用 API 更合适。同时说明 RPC 安全、监控、同步时长、状态修剪与版本升级,并附有常见故障排查。

章节
C
Chaingateway Team
区块链专家

审核: Maurice Sobiera

BSC 节点是运行 BNB Smart Chain 客户端的计算机。它下载并验证每个区块,并提供本地 JSON-RPC 端点,让软件无需第三方即可读取链数据、发送交易。该链在 2022 年 2 月前称为 Binance Smart Chain。

自 2026 年 1 月 14 日 Fermi 硬分叉以来,该链每 0.45 秒产出一个区块。Maxwell 升级已于 2025 年年中将出块间隔缩短至 0.75 秒。这样的速度对用户很友好,但对节点运营者要求很高:硬件选错或同步策略不当,节点就永远无法追上链头。

本指南是官方文档未能提供的复制即用版本。内容涵盖基于快照、使用 bnb-chain geth 分支的搭建方式、systemd 服务单元、RPC 节点的安全注意事项、同步时间与成本计算,以及根本不应自行运行节点的情形。版本号与大小已于 2026 年 11 月 5 日对照项目的 GitHub 仓库核对。

BSC 节点是什么,您需要哪种类型?

BSC 节点运行链客户端、验证区块,并提供与以太坊相同接口的本地 JSON-RPC 端点:eth_blockNumber、eth_call、eth_sendRawTransaction 等。在实践中,有四种类型值得关注。

  • 全节点保存近期状态并提供 RPC 服务。这是默认类型,也是本指南的主题。
  • 快速节点是以 --tries-verify-mode none 启动的全节点。官方文档建议在您较少关注状态一致性、而需要高性能时使用它。
  • 归档节点保存每一个历史状态。它需要多出数 TB 的存储,只适用于索引和分析场景。
  • 验证者负责产出区块。它必须通过质押 BNB 被选入一个规模很小的当选集合,这是一个独立的话题,超出了搭建指南的范围。

那轻节点呢?该分支继承了轻客户端代码,但实际上 BSC 上几乎没有节点为轻节点提供服务,因此应将“BSC 轻节点”视为不可用。如果连修剪过的全节点都超出了您的需要,那就是使用 API 的理由。参见最后一节。

下表以同样的方式列出了各类型,磁盘数据来自项目仓库(2026 年 11 月 5 日核对):

节点类型磁盘历史适用对象
修剪全节点快照压缩后约 1.9 TB;规划 4 TB NVMe近期区块需要自有 RPC 的任何人
快速节点(--tries-verify-mode none)与全节点相同近期区块高负载下提供 RPC 服务
归档节点约 7.8 TB(2026 年 11 月 2 日的 Reth-BSC 归档快照)完整索引器、分析平台
验证者本文不涉及近期区块仅限当选集合

BSC 与 Geth:同一套代码,两条链

BSC 的客户端是 go-ethereum 的一个分支,维护于 github.com/bnb-chain/bsc,其二进制文件的名称正是 geth。它使用相同的 JSON-RPC,接受大部分相同的参数,并增加了 BSC 特有的内容:Parlia 权益授权证明共识(整个节点只有一个进程,不像合并后的以太坊那样需要单独的共识客户端),以及 --tries-verify-mode 等参数。由此产生两个实际后果:

  • 您的以太坊工具无需修改即可对接 BSC 节点。
  • 您必须运行 bnb-chain 版本的构建。上游 Geth 无法同步 BSC,这是“bsc geth”最常见的新手错误。

BSC 节点硬件要求

基准配置来自 bnb-chain/bsc README。本表右侧一列是我们为高强度 RPC 使用提出的建议,并非官方数字。

组件修剪全节点(README)高强度 RPC(我们的建议)
CPU16 核16 核,高主频
内存64 GB128 GB
磁盘3 TB SSD(README 数字来自 2023 年 12 月;规划 4 TB),8k IOPS,500 MB/s,读取延迟低于 1 ms,快照同步需要 NVMe4 TB 以上 NVMe,≥10k IOPS
网络上下行各 5 MB/s(约 40 Mbit/s)100 Mbit/s 以上,不限流量

导致大多数搭建失败的并非容量,而是 IOPS。区块间隔为 0.45 秒,节点会持续写入数据。默认 IOPS 的云块存储会落后于链头,并且再也追不上。README 的参考配置是 AWS gp3 并提供 8,000 IOPS 与亚毫秒级读取延迟,实例为 m5zn.6xlarge 或 r7iz.4xlarge(Google Cloud 上为 c2-standard-16)。专用服务器中的本地 NVMe 硬盘可以轻松达到该标准,并留有余量。

分步操作:从官方快照搭建 BSC 全节点

从创世区块开始同步是可行的,但并不明智。全节点文档明确表示不推荐这样做:它需要更强的硬件,并且耗时极长。受支持的路径是:下载链数据快照,在其之上启动节点,然后让它追赶到最新状态。以下命令假定系统为 Ubuntu 24.04。

1. 准备服务器

Terminal window
sudo apt update && sudo apt install -y aria2 lz4 unzip jq
sudo useradd --no-create-home --shell /usr/sbin/nologin bsc
sudo mkdir -p /var/lib/bsc
sudo chown bsc:bsc /var/lib/bsc
sudo ufw allow 30311 comment 'bsc p2p'

端口 30311 是 BSC 的点对点端口,也是唯一应该对外开放的区块链端口。RPC 端口则仅限本机访问。

2. 下载 bnb-chain geth 二进制文件

Terminal window
cd /tmp
curl -s https://api.github.com/repos/bnb-chain/bsc/releases/latest \
| jq -r '.assets[] | select(.name=="geth_linux") | .browser_download_url' \
| xargs wget -O geth_linux
chmod +x geth_linux
sudo mv geth_linux /usr/local/bin/geth-bsc
geth-bsc version

将二进制文件重命名为 geth-bsc,可以防止一个经典错误:用发行版自带的上游 geth 去启动 BSC 数据。

3. 获取 config.toml 与 genesis.json

Terminal window
cd /tmp
curl -s https://api.github.com/repos/bnb-chain/bsc/releases/latest \
| jq -r '.assets[] | select(.name=="mainnet.zip") | .browser_download_url' \
| xargs wget -O mainnet.zip
unzip -o mainnet.zip
sudo mv config.toml genesis.json /var/lib/bsc/
sudo chown bsc:bsc /var/lib/bsc/config.toml /var/lib/bsc/genesis.json

注意:只有从创世区块同步时才需要 geth-bsc init genesis.json。走快照路径时,应跳过 init,因为快照本身就携带数据库。

4. 下载并解压快照

快照存放在官方的 bsc-snapshots 仓库中。截至 2026 年 11 月 5 日,该仓库列出了主网的两套数据,均来自 2026 年 10 月 9 日的快照,并且都要求 BSC v1.7.2 或更高版本:

快照大小(压缩后)用途
修剪版(...-pruneancient)约 1.9 TB仅保存近期区块。适合本指南。
完整版约 7.4 TB完整的区块历史。

该仓库还链接了其他来源的快照,例如来自 BNB48 Club 的约 900 GB 修剪全节点快照,以及面向 Reth 客户端的 Reth-BSC 快照。仓库中提供了 fetch-snapshot.sh,可以一条命令完成下载、校验 MD5 校验和(-c)并解压。使用 -p 选项获取修剪版快照。下面的手动方式展示了该脚本的内部步骤。以下两种方式可将归档文件放到磁盘上:

Terminal window
cd /var/lib/bsc
# Option A: resumable download, needs space for archive + extracted data
sudo -u bsc aria2c -x8 -s8 -c '<PASTE_SNAPSHOT_URL>'
sudo -u bsc bash -c "lz4 -cd geth.tar.lz4 | tar -x"
# Option B: stream-extract, needs space only once, but no resume
sudo -u bsc bash -c "wget -qO- '<PASTE_SNAPSHOT_URL>' | lz4 -d | tar -x"

aria2c 通过八个连接下载,并能在中断后继续(-c)。若使用普通的 wget,多 TB 的下载一旦中断就必须从头开始。解压之后,链数据库必须位于 /var/lib/bsc/geth/chaindata。不同代快照的归档目录结构有所变化,因此如有需要,请将内部的 geth 文件夹移动到该位置。

解压之前先校验:对照快照页面上的 MD5,或交给 fetch-snapshot.sh -c 处理。一个出现比特翻转的 TB 级归档,会让您损失一整天。

选项 A 需要同时为归档文件和解压后的数据留出空间。这正是推荐 4 TB 硬盘的真正原因。

5. systemd 服务单元

创建 /etc/systemd/system/bsc.service:

[Unit]
Description=BSC full node (bnb-chain geth fork)
After=network-online.target
Wants=network-online.target
[Service]
User=bsc
Group=bsc
Type=simple
Restart=always
RestartSec=5
TimeoutStopSec=600
LimitNOFILE=65536
ExecStart=/usr/local/bin/geth-bsc \
--config /var/lib/bsc/config.toml \
--datadir /var/lib/bsc \
--cache 8000 \
--tries-verify-mode none \
--history.transactions 0 \
--rpc.allow-unprotected-txs \
--http --http.addr 127.0.0.1 --http.port 8545 \
--http.api eth,net,web3
[Install]
WantedBy=multi-user.target

--tries-verify-mode none 是官方文档中的“快速节点”开关,适用于您接受状态一致性取舍、用于提供 RPC 服务的场景。如果要运行普通的修剪全节点,请将其删除。--history.transactions 0 会为数据库所保存区块中的每笔交易建立索引;较早的指南为同一目的使用已弃用的 --txlookuplimit 0。

bsc-snapshots 的 README 为修剪版快照建议了不同的保留参数:--syncmode=full --history.transactions=600000 --history.blocks=600000 --history.logs=600000 --tries-verify-mode=local。按 0.45 秒的区块间隔计算,600,000 个区块约为 3.1 天的历史。该文件还指出,旧的 --pruneancient 参数已被弃用。请根据您的应用需要回溯多远来选择保留策略。TimeoutStopSec=600 让节点在关闭时有十分钟时间刷写数据。强制终止迟早会损坏数据库。

6. 启动并验证

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

正常的输出是持续不断的 “Imported new chain segment” 日志行。请将您的区块高度与公共区块浏览器进行比对:

Terminal window
curl -s -X POST -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
http://127.0.0.1:8545

将返回的十六进制结果转换为十进制,并与 bscscan.com 核对。当 eth_syncing 返回 false 且高度一致时,节点即已正常运行。

如何保护 BSC RPC 节点?

上面的服务单元将 RPC 绑定到 127.0.0.1,这对于只供本地软件使用的节点来说是正确的。如果其他机器需要访问,请不要将 8545 端口直接暴露到互联网上。应在前面加上带 TLS 的 nginx 或 Caddy,并配置认证令牌或 IP 白名单以及速率限制。请将 --http.api 保持为 eth,net,web3,切勿在可访问的节点上暴露 admin、debug 或 txpool。开放的 RPC 端口会吸引滥用,而对宽广区块范围进行不受限制的 eth_getLogs 调用,即使是性能强劲的硬件也可能不堪重负。P2P 端口 30311 仍然是唯一开放的区块链端口。

与以太坊的一个区别是:这里没有 Engine API,也没有 JWT 密钥,因为 Parlia 不需要单独的共识客户端。防火墙与本机绑定构成了全部安全边界,因此两者都必须配置正确。

如何监控 BSC 节点?

BSC 节点通常以一种方式出问题:进程一直在运行,但节点已经落后于链头。进程级的运行时间检查完全无法发现这种情况,因此应改为检查同步状态和高度。

Terminal window
# false = at the head; a sync object = still catching up
curl -s -X POST -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}' \
http://127.0.0.1:8545
# peer count as hex
curl -s -X POST -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":1}' \
http://127.0.0.1:8545

更严格的探测方式,是每隔几分钟将您的 eth_blockNumber 与第二个来源(公共端点或区块浏览器)进行比对,并在差距扩大时告警。阈值应根据 BSC 的节奏进行校准:400 个区块听起来很多,但按 0.45 秒的区块间隔计算,只相当于三分钟的链上时间。直接照搬以太坊工具的阈值在这里会过于宽松。

该分支继承了 Geth 的指标体系。从 --metrics 开始(Prometheus 端点位于 6060 端口,请将其限制在本机),标准的 Geth Grafana 仪表板大多无需修改即可使用。在配置任何仪表板之前,先设置两条告警:磁盘使用率超过 85%,以及本地区块高度五分钟内没有变化。每天通过 cron 邮件发送一次 journalctl -u bsc --since -24h | grep -ci error,可以补全监控。错误数量呈上升趋势,通常会在多日之前预示大多数故障。

BSC 节点同步需要多长时间?

用计算代替承诺:1.9 TB 的修剪快照在持续 100 MB/s 的速度下约需 5.3 小时下载,在 50 MB/s 下约需 10.5 小时。解压受磁盘速度限制,在 NVMe 上会额外增加几个小时。快照相对链头落后数天至数周,具体取决于您开始的时间,而健康的节点导入速度是实时速度的数倍。合计规划一个工作日即可。

作为对比,从创世区块同步需要强得多的硬件,并且耗时极长。这就是官方推荐快照的原因。

BSC 节点增长有多快,如何修剪?

数据库在第一天之后仍会持续增长:每个新合约和账户都会增加状态,而区块数据则按 0.45 秒区块的节奏累积。确切的增长速度取决于网络活动。与其相信一个固定数字,不如每周运行一次 du -sh /var/lib/bsc/geth/chaindata,并建立您自己的趋势线。可以预期的规律是:每季度增长数百 GB,而不是每年。

有三种工具可以控制大小。geth-bsc snapshot prune-state 是内置的离线修剪工具:它会丢弃不再被任何状态引用的状态节点,在多 TB 的数据库上需要数小时,且在此期间节点不提供服务。另一种方式是清空并恢复,许多运营者更倾向于此:每隔几个月删除数据目录,并恢复最新的修剪快照。总停机时间往往比修剪更短,并且还能得到一个新压缩过的数据库作为额外收益。

第三种工具是增量快照,规范见 BEP-593。无需每次刷新都重新下载完整的修剪快照,而是将小型增量快照合并到每月的基础快照上。BEP 文本将约 120 GB 的月度增量快照与超过 1.0 TB 的 prune-ancient 快照进行了比较。在据此规划之前,请先查看 bsc-snapshots README,确认增量文件目前是否已发布。

Erigon 在 BSC 上发生了什么?

bsc-erigon 是 NodeReal 对 Erigon 的移植,多年来一直是归档客户端。其 README 现在带有停止维护的通知:开发与维护已于 2025 年底结束,该仓库已归档。通知建议运营者转向 Reth-BSC,这是由 bnb-chain 维护的、基于 Rust 的后继项目。

截至 2026 年 11 月 5 日,bsc-snapshots README 在 geth 快照旁边列出了 Reth-BSC 快照。2026 年 11 月 2 日的主网归档快照为 7,789.76 GB,完整节点快照为 3,621.42 GB,快速节点快照为 840.42 GB。

对于本指南中的修剪 RPC 节点,官方 geth 分支仍是参考标准。对于归档类工作负载,应首先评估 Reth-BSC。请将仍在运行的 bsc-erigon 机器视为一项迟早要迁移的任务:未维护的客户端会错过下一次硬分叉。

BSC 节点成本是多少?

请将其视为一种计算方法,而非价目表。16 核 / 64 GB / 4 TB NVMe 这一级别属于专用服务器的范畴,普通的 VPS 套餐无法满足。请向两到三家专用服务器提供商索取符合这些配置的报价。云端方案若配置 8k 预置 IOPS(README 中的 AWS 参考),IOPS 会单独计费,因此应明确将这一项计入成本。

然后加上您的人工时间。按照本指南完成初始搭建,规划一个工作日;此后每月还需几个小时用于硬分叉升级和快照刷新。乘以您的时薪,再与托管报价并列比较。

如何保持 BSC 节点更新?

BSC 的硬分叉节奏让以太坊运营者感到惊讶。仅 2025 年就进行了 Lorentz(4 月 29 日)和 Maxwell(6 月 30 日)两次升级,分别将区块间隔缩短至 1.5 秒,然后是 0.75 秒。Fermi 于 2026 年 1 月 14 日到来,将区块间隔从 0.75 秒进一步缩短至 0.45 秒。每次分叉都有最低客户端版本要求。对于 Fermi,要求的版本是 v1.6.4,低于该版本的节点会在分叉区块处停滞。截至 2026 年 11 月 5 日,最新发布的版本是 v1.8.2,而当前的快照要求至少为 v1.7.2。

因此,请在 GitHub 上订阅 bnb-chain/bsc 的发布动态,并将升级视为例行工作,而非突发事件。流程很简短:下载新的 geth_linux,进行校验,停止服务,替换 /usr/local/bin/geth-bsc,然后重新启动。数据库会被保留。发布说明会提示配置变更,而且 BSC 重命名参数的频率高于上游 Geth,因此应在重启前而非重启后浏览这些说明。每次发布预留一刻钟,并预期每隔几个月会有一次分叉。

对于开发环境,可以通过 BSC-Deploy 工具包搭建本地私有网络,而无需运行主网节点。

故障排查

节点能导入区块,但持续落后于链头

几乎总是磁盘 IOPS 不足。使用 fio 进行基准测试,并与 8k IOPS 的参考值对比;采用默认 IOPS 的网络存储是常见的罪魁祸首。确认已设置 --tries-verify-mode none。如果硬件低于要求表中的标准,任何参数都无法弥补差距。

出现 “missing trie node” 错误,或快照恢复后节点从区块 0 开始同步

数据目录的结构有误。链数据库必须位于 <datadir>/geth/chaindata。如果日志显示 “Writing custom genesis block”,说明 geth 发现数据目录为空,并从头开始。请停止服务,将解压出的 geth 文件夹移动到正确位置,然后重新启动。

对等节点数量长期接近零

检查 30311 端口是否已开放并已正确转发。过期的 config.toml 是第二个嫌疑对象:引导节点和静态节点列表会随时间变化,因此请从最新版本重新下载 mainnet.zip。在家庭宽带环境中,请再次检查 NAT。

解压时 lz4 报告 “Decoding error”

归档文件不完整。请使用 aria2c -c 继续下载,并在重新解压之前,将文件大小与快照页面上的大小进行比对。请记住,选项 A 需要同时为归档文件和解压后的数据提供空闲空间。

节点被 OOM Killer 终止

journalctl -k | grep -i oom 可以确认问题。服务单元设置了 --cache 8000,而在追赶区块期间,实际内存占用会远超缓存数值。在推荐的 64 GB 内存下没有问题,但在精简配置的硬件上就会出问题。应先降低 --cache,然后再调整其他参数,并保留交换分区作为崩溃缓冲。请记住,被 OOM 终止的节点不会刷写任何数据:下一次启动时可能会遇到上面提到的 “missing trie node” 情况。

磁盘写满

先运行 df -h,然后运行 du -h --max-depth=2 /var/lib/bsc 查找增长来源。被遗忘的快照归档是最常见的发现:仅修剪版的 .tar.lz4 就约有 1.9 TB,如果跳过清理步骤,选项 A 会将其留在磁盘上。如果问题出在 chaindata 本身,请从最新的修剪快照刷新,或运行离线修剪(参见状态增长一节)。按 BSC 的增长曲线,磁盘写满是调度失误,而非运气不好;监控一节中 85% 的告警正是为了给您争取所需的那一周时间。

常见问题

Binance Smart Chain 节点与 BNB Smart Chain 节点是同一种吗?

是的。该链于 2022 年 2 月从 Binance Smart Chain 更名为 BNB Smart Chain。文档、二进制文件和本指南描述的都是同一个网络,只是品牌名称发生了变化。

2026 年 BSC 全节点有多大?

官方修剪快照压缩后约为 1.9 TB,完整快照约为 7.4 TB(bsc-snapshots,2026 年 10 月 9 日快照,2026 年 11 月 5 日核对)。解压时归档文件与解压后的数据需要同时存放在磁盘上,因此 4 TB 的 NVMe 硬盘是较为现实的容量。

我能用普通的以太坊 Geth 运行 BSC 节点吗?

不能。BSC 使用 Parlia 共识及其自有的协议规则,只有 github.com/bnb-chain/bsc 上的分支才能同步它。二进制文件名相同造成了这种混淆,因此在第 2 步中将其重命名为 geth-bsc。

BSC 有轻节点吗?

实际上没有。轻客户端代码存在于该分支中,但网络几乎不为轻节点提供服务。您现实的选择是修剪过的全节点、快速节点或 API。

运行全节点能赚取 BNB 吗?

不能。区块奖励归属于当选的验证者集合,这需要大量质押的 BNB 以及社区投票。全节点为您提供的是独立访问链的能力,而不是收入。

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

Chaingateway 本身销售的是另一种方案,因此下面的比较也会说明它的弱点。

当您需要以高强度、持续的规模消费原始 JSON-RPC 数据时,例如索引、回测、跨数百万区块的日志扫描,或者不允许任何第三方介于您与链之间时,请运行节点。专用服务器是固定成本,不按请求计费,在调用量很高时可能比按量计费的套餐更划算。

当节点只是支付的底层管道时,请使用 API。一个已同步的 BSC 全节点为您提供 eth_sendRawTransaction 和日志;而支付系统真正需要的一切,例如为每位客户分配的充值地址、识别入账的 BEP-20 转账、带签名的 Webhook、密钥存储以及重试,都是您需要在其之上构建并持续运行的软件。在比较中请计入这些工程时间,并按成本一节中的费率折算。

Chaingateway 的 BNB Smart Chain API 以 REST 形式提供这一层:导入地址(POST /api/v2/bsc/addresses/import)、发送 BEP-20 代币(POST /api/v2/bsc/transactions/bep20),并接收充值 Webhook。设置个人密钥后,Webhook 会携带 X-Signature HMAC 请求头(校验指南)。失败的投递不会自动重试:GET /api/v2/bsc/webhooks/notifications/failed 会列出它们,并且每一条都可以通过重试端点重新发送。临界点可以用一句话概括:专用服务器加上您搭建和运维的工时,与 /pricing/ 上的套餐相比较。快速入门和 Webhook 指南可以让您在几分钟内完成首次测试,7 天试用无需 KYC(注册)。

如果您还运行其他链,请参阅 以太坊 和 TRON 的搭建指南。

我们如何撰写这些文章

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

C
Chaingateway Team
区块链专家

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