如何搭建 Binance Smart Chain(BSC)节点
按官方方式搭建 BSC 节点:快照同步、bnb-chain geth 分支、systemd 服务单元、硬件表与成本,以及何时使用 API 更合适。同时说明 RPC 安全、监控、同步时长、状态修剪与版本升级,并附有常见故障排查。
审核: 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(我们的建议) |
|---|---|---|
| CPU | 16 核 | 16 核,高主频 |
| 内存 | 64 GB | 128 GB |
| 磁盘 | 3 TB SSD(README 数字来自 2023 年 12 月;规划 4 TB),8k IOPS,500 MB/s,读取延迟低于 1 ms,快照同步需要 NVMe | 4 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. 准备服务器
sudo apt update && sudo apt install -y aria2 lz4 unzip jqsudo useradd --no-create-home --shell /usr/sbin/nologin bscsudo mkdir -p /var/lib/bscsudo chown bsc:bsc /var/lib/bscsudo ufw allow 30311 comment 'bsc p2p'端口 30311 是 BSC 的点对点端口,也是唯一应该对外开放的区块链端口。RPC 端口则仅限本机访问。
2. 下载 bnb-chain geth 二进制文件
cd /tmpcurl -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_linuxchmod +x geth_linuxsudo mv geth_linux /usr/local/bin/geth-bscgeth-bsc version将二进制文件重命名为 geth-bsc,可以防止一个经典错误:用发行版自带的上游 geth 去启动 BSC 数据。
3. 获取 config.toml 与 genesis.json
cd /tmpcurl -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.zipunzip -o mainnet.zipsudo 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 选项获取修剪版快照。下面的手动方式展示了该脚本的内部步骤。以下两种方式可将归档文件放到磁盘上:
cd /var/lib/bsc# Option A: resumable download, needs space for archive + extracted datasudo -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 resumesudo -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.targetWants=network-online.target
[Service]User=bscGroup=bscType=simpleRestart=alwaysRestartSec=5TimeoutStopSec=600LimitNOFILE=65536ExecStart=/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. 启动并验证
sudo systemctl daemon-reloadsudo systemctl enable --now bscjournalctl -fu bsc正常的输出是持续不断的 “Imported new chain segment” 日志行。请将您的区块高度与公共区块浏览器进行比对:
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 节点通常以一种方式出问题:进程一直在运行,但节点已经落后于链头。进程级的运行时间检查完全无法发现这种情况,因此应改为检查同步状态和高度。
# false = at the head; a sync object = still catching upcurl -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 hexcurl -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(注册)。
准备好自己动手构建了吗? 获取你的 API key — 7 天试用,无需信用卡 — 或查看 Binance Smart Chain API 获取完整的 endpoint 参考。