Как настроить ноду Binance Smart Chain (BSC)
Как официально настроить BSC-ноду: синхронизация по снапшоту, форк bnb-chain geth, systemd-юнит, таблица оборудования, расходы и когда лучше выбрать API.
Проверил(а) Maurice Sobiera
Нода BSC — это компьютер, на котором работает клиент BNB Smart Chain. Она загружает и проверяет каждый блок и открывает локальный JSON-RPC эндпоинт, поэтому ваше ПО может читать сеть и отправлять транзакции без третьей стороны. До февраля 2022 года BNB Smart Chain называлась Binance Smart Chain.
С 14 января 2026 года, с хард-форка Fermi, сеть производит блок каждые 0,45 секунды. Maxwell сократил интервал до 0,75 секунды ещё в середине 2025 года. Такая скорость удобна пользователям и требовательна к операторам нод: неподходящее железо или неверная стратегия синхронизации дают ноду, которая никогда не догоняет головную часть цепочки.
Этот гайд — версия «скопировать и вставить» того, чего не хватает официальной документации. Он описывает настройку на основе снапшота с форком geth от bnb-chain, systemd-юнит, замечания по безопасности RPC-нод, расчёт времени синхронизации и стоимости, а также случаи, когда ноду запускать не стоит вовсе. Номера версий и размеры проверены по репозиториям проекта на GitHub 5 ноября 2026 года.
Что такое нода BSC и какой тип нужен?
Нода BSC запускает клиент сети, проверяет блоки и предоставляет локальный JSON-RPC эндпоинт с тем же интерфейсом, что и у Ethereum: eth_blockNumber, eth_call, eth_sendRawTransaction и остальные. На практике важны четыре варианта.
- Full-нода хранит недавнее состояние и обслуживает RPC. Это вариант по умолчанию и предмет этого гайда.
- Fast-нода — это full-нода, запущенная с
--tries-verify-mode none. Официальная документация рекомендует её для высокой производительности, если согласованность состояния волнует мало. - Архивная нода хранит все исторические состояния. Ей нужны ещё несколько терабайт, и она имеет смысл только для индексации и аналитики.
- Валидатор создаёт блоки. Чтобы попасть в небольшой избранный набор, нужен застейканный BNB и голосование, это отдельная тема, выходящая за рамки гайда по настройке.
А лёгкая нода? Форк geth унаследовал код light-клиента, но на практике почти никто в сети BSC не обслуживает light-пиров, поэтому считайте «лёгкую ноду BSC» недоступной. Если даже обрезанная full-нода вам избыточна, пора переходить к API. См. последний раздел.
Тот же выбор в виде таблицы, с размерами дисков из репозиториев проекта (проверено 5 ноября 2026 года):
| Тип ноды | Диск | История | Кому подходит |
|---|---|---|---|
| Обрезанная full-нода | снапшот около 1,9 ТБ в сжатом виде; планируйте NVMe на 4 ТБ | недавние блоки | тем, кому нужен собственный RPC |
Fast-нода (--tries-verify-mode none) | как у full-ноды | недавние блоки | обслуживание RPC под высокой нагрузкой |
| Архивная нода | около 7,8 ТБ (архивный снапшот Reth-BSC от 2 ноября 2026 года) | полная | индексаторы, аналитические платформы |
| Валидатор | здесь не рассматривается | недавние блоки | только избранный набор |
BSC и Geth: одна кодовая база, две сети
Клиент BSC — это форк go-ethereum, который поддерживается на github.com/bnb-chain/bsc, а бинарник буквально называется geth. Он говорит на том же JSON-RPC, принимает большинство тех же флагов и добавляет специфику BSC: консенсус Parlia (proof-of-staked-authority), при котором один процесс — это вся нода, без отдельного consensus-клиента, как у Ethereum после слияния, и флаги вроде --tries-verify-mode. Из этого на практике следуют два вывода:
- Ваши инструменты для Ethereum работают с нодой BSC без изменений.
- Нужно запускать сборку bnb-chain. Обычный Geth не может синхронизировать BSC, и это самая частая ошибка новичков с «bsc geth».
Требования к железу для ноды BSC
Базовые значения взяты из README bnb-chain/bsc. Правая колонка в таблице — наше предложение для интенсивного использования RPC, а не официальная цифра.
| Компонент | Обрезанная full-нода (README) | Интенсивный RPC (наше предложение) |
|---|---|---|
| CPU | 16 ядер | 16 ядер, высокая тактовая частота |
| RAM | 64 ГБ | 128 ГБ |
| Диск | SSD 3 ТБ (цифра из README на декабрь 2023 года; планируйте 4 ТБ), 8k IOPS, 500 МБ/с, задержка чтения менее 1 мс, NVMe для snap sync | NVMe 4 ТБ+, не менее 10k IOPS |
| Сеть | 5 МБ/с (около 40 Мбит/с) на приём и на отдачу | 100 Мбит/с+, без учёта трафика |
Строка, на которой спотыкается большинство установок, — это IOPS, а не ёмкость. При блоках по 0,45 секунды нода постоянно пишет данные. Облачное блочное хранилище с IOPS по умолчанию отстаёт от головы цепочки и уже не догоняет. Ориентир README — AWS gp3 с 8 000 IOPS и задержкой чтения менее миллисекунды на инстансе m5zn.6xlarge или r7iz.4xlarge (в Google Cloud — c2-standard-16). Локальный NVMe-диск в выделенном сервере проходит этот порог с запасом.
Пошагово: full-нода BSC из официального снапшота
Синхронизация с генезис-блока возможна, но это плохая идея. Документация по full-ноде не рекомендует её: она требует более мощного железа и очень много времени. Поддерживаемый путь такой: скачать снапшот данных цепочки, запустить ноду поверх него и дать ей догнать сеть. Команды рассчитаны на 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 — это порт peer-to-peer для BSC и единственный блокчейн-порт, который должен быть открыт. Порт RPC остаётся на localhost.
2. Скачайте бинарник geth от bnb-chain
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. На 5 ноября 2026 года там два набора данных для мейннета, оба от снапшота 9 октября 2026 года, и оба требуют BSC v1.7.2 или новее:
| Снапшот | Размер (в сжатом виде) | Применение |
|---|---|---|
Обрезанный (...-pruneancient) | около 1,9 ТБ | Только недавние блоки. Подходит для этого гайда. |
| Полный | около 7,4 ТБ | Полная история блоков. |
В репозитории также есть ссылки на снапшоты из других источников, например на снапшот обрезанной full-ноды размером около 900 ГБ от BNB48 Club и снапшоты Reth-BSC для клиента Reth. В репозитории есть скрипт fetch-snapshot.sh, который скачивает архив, проверяет контрольную сумму MD5 (-c) и распаковывает его одной командой. Для обрезанного снапшота используйте -p. Ручной путь ниже показывает, что скрипт делает под капотом. Есть два способа положить архив на диск:
cd /var/lib/bsc# Вариант A: докачиваемая загрузка, нужно место под архив и распакованные данныеsudo -u bsc aria2c -x8 -s8 -c '<PASTE_SNAPSHOT_URL>'sudo -u bsc bash -c "lz4 -cd geth.tar.lz4 | tar -x"
# Вариант B: потоковая распаковка, место нужно только один раз, но докачки нетsudo -u bsc bash -c "wget -qO- '<PASTE_SNAPSHOT_URL>' | lz4 -d | tar -x"aria2c качает в восемь соединений и продолжает после обрывов (-c). При обычном wget прерванная загрузка на несколько терабайт начинается заново. После распаковки база цепочки должна лежать в /var/lib/bsc/geth/chaindata. Структура архива менялась между поколениями снапшотов, поэтому при необходимости переместите внутреннюю папку geth туда.
Проверьте до распаковки: сравните MD5 со страницей снапшота или позвольте fetch-snapshot.sh -c сделать это. Архив на терабайт с одним перевёрнутым битом стоит вам целого дня.
Вариант A требует места под архив и распакованные данные одновременно. Именно поэтому рекомендуется диск на 4 ТБ.
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 — это переключатель «fast-ноды» из официальной документации для обслуживания RPC, если вы принимаете компромисс по согласованности состояния. Уберите его, чтобы запустить обычную обрезанную full-ноду. --history.transactions 0 индексирует каждую транзакцию в блоках, которые хранит ваша база данных; в старых гайдах для той же цели используется устаревший --txlookuplimit 0.
README bsc-snapshots предлагает другие флаги хранения для обрезанного снапшота: --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Переведите результат из hex и сверьте его с bscscan.com. Когда eth_syncing возвращает false и высота совпадает, нода работает.
Как защитить RPC-ноду BSC?
Юнит выше привязывает RPC к 127.0.0.1, что правильно для ноды, которой пользуется только локальное ПО. Если к ней нужен доступ с других машин, не открывайте порт 8545 напрямую в интернет. Поставьте перед ним nginx или Caddy с TLS, токеном аутентификации или списком разрешённых IP и ограничением частоты запросов. Оставляйте --http.api равным eth,net,web3: никогда не открывайте admin, debug или txpool на доступной ноде. Открытый RPC-порт притягивает злоупотребления, а неограниченные вызовы eth_getLogs по широким диапазонам блоков могут перегрузить даже мощное железо. Порт P2P 30311 остаётся единственным открытым блокчейн-портом.
Одно отличие от Ethereum: здесь нет engine API и нет JWT-секрета, потому что Parlia не требует отдельного consensus-клиента. Файрвол и привязка к localhost — это весь периметр, поэтому они должны быть настроены верно.
Как мониторить ноду BSC?
Нода BSC выходит из строя обычно одним способом: процесс продолжает работать, а нода отстаёт от головы цепочки. Проверки аптайма процесса этого не замечают, поэтому проверяйте состояние синхронизации и высоту.
# false = на головной части; объект sync = ещё догоняет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
# число пиров в 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 секунды. Пороги, скопированные из инструментов для Ethereum, здесь слишком мягкие.
Форк унаследовал стек метрик Geth. Начните с --metrics (эндпоинт Prometheus на порту 6060, держите его на localhost), и стандартные дашборды Grafana для Geth в основном работают без изменений. Прежде чем строить дашборды, настройте два оповещения: использование диска выше 85 процентов и высота локального блока, которая не меняется пять минут. Ежедневная команда journalctl -u bsc --since -24h | grep -ci error в cron-письме завершает картину: рост числа ошибок предшествует большинству сбоев за дни.
Сколько времени занимает синхронизация ноды BSC?
Арифметика вместо обещаний: обрезанный снапшот в 1,9 ТБ при постоянной скорости 100 МБ/с скачивается около 5,3 часа, при 50 МБ/с — около 10,5 часа. Распаковка ограничена скоростью диска и на NVMe добавляет несколько часов. Снапшот отстаёт от головы цепочки на дни или недели в зависимости от момента старта, а здоровая нода импортирует блоки в несколько раз быстрее реального времени. В сумме планируйте один рабочий день.
Синхронизация с генезис-блока, для сравнения, требует гораздо более мощного железа и очень много времени. Поэтому официальная рекомендация — снапшот.
Как быстро растёт нода BSC и как её обрезать?
База данных продолжает расти после первого дня: состояние с каждым новым контрактом и аккаунтом, данные блоков в темпе, который задают блоки по 0,45 секунды. Точный рост зависит от активности в сети. Вместо доверия к фиксированной цифре раз в неделю выполняйте du -sh /var/lib/bsc/geth/chaindata и стройте собственный график тренда. Ожидаемая картина: сотни гигабайт за квартал, а не за год.
Три инструмента помогают держать размер под контролем. geth-bsc snapshot prune-state — это встроенная офлайн-обрезка: она удаляет узлы состояния, на которые ничто больше не ссылается. Она занимает много часов на базе в несколько терабайт, и всё это время нода ничего не обслуживает. Альтернатива, которую многие операторы предпочитают, — стереть и восстановить: раз в несколько месяцев удалить datadir и восстановить самый новый обрезанный снапшот. Общий простой часто меньше, чем при обрезке, а в награду вы получаете свежесжатую базу данных.
Третий инструмент — инкрементальные снапшоты, описанные в BEP-593. Вместо повторной загрузки полного обрезанного снапшота при каждом обновлении вы объединяете небольшие инкрементальные снапшоты с ежемесячным базовым. В тексте BEP месячный инкрементальный снапшот около 120 ГБ сравнивается с снапшотом prune-ancient более 1,0 ТБ. Прежде чем планировать с ними работу, проверьте в README bsc-snapshots, публикуются ли инкрементальные файлы сейчас.
Что случилось с Erigon в BSC?
bsc-erigon, порт Erigon от NodeReal, много лет был архивным клиентом. Теперь в его README стоит уведомление о прекращении поддержки: разработка и обслуживание остановились в конце 2025 года, а репозиторий архивирован. В уведомлении операторов направляют на Reth-BSC, преемника на Rust, который поддерживает bnb-chain.
На 5 ноября 2026 года README bsc-snapshots перечисляет снапшоты Reth-BSC рядом со снапшотами geth. Архивный снапшот мейннета от 2 ноября 2026 года весит 7 789,76 ГБ, полный снапшот ноды — 3 621,42 ГБ, а снапшот fast-ноды — 840,42 ГБ.
Для обрезанной RPC-ноды из этого гайда эталоном остаётся официальный форк geth. Для архивных задач сначала оцените Reth-BSC. Любую оставшуюся машину с bsc-erigon считайте миграцией, которая ждёт своего часа: неподдерживаемый клиент пропустит следующий хард-форк.
Сколько стоит нода BSC?
Относитесь к этому как к способу расчёта, а не к прайс-листу. Класс 16 ядер / 64 ГБ / NVMe 4 ТБ — это территория выделенных серверов, и ни один обычный тариф VPS его не покрывает. Запросите расценки у двух-трёх хостингов выделенных серверов с этими характеристиками. Облачная конфигурация с 8k провизионированных IOPS (ориентир AWS из README) тарифицирует IOPS отдельно, поэтому выделите эту строку в расчёте явно.
Затем добавьте свои часы. Планируйте один рабочий день на первичную настройку по этому гайду и несколько часов в месяц на хард-форки и обновления снапшотов. Умножьте на свою почасовую ставку и поставьте результат рядом с предложением хостинга.
Как поддерживать ноду BSC в актуальном состоянии?
BSC проводит хард-форки в темпе, который удивляет операторов Ethereum. Только в 2025 году были Lorentz (29 апреля) и Maxwell (30 июня), которые сократили интервал блоков сначала до 1,5, а потом до 0,75 секунды. Fermi последовал 14 января 2026 года и снизил блоки с 0,75 до 0,45 секунды. У каждого форка есть минимальная версия клиента. Для Fermi это v1.6.4, и нода ниже неё останавливается на блоке форка. Последний релиз на 5 ноября 2026 года — v1.8.2, а текущие снапшоты требуют не ниже v1.7.2.
Поэтому подпишитесь на ленту релизов bnb-chain/bsc на GitHub и считайте обновления рутиной, а не событиями. Процедура короткая: скачайте новый geth_linux, проверьте его, остановите сервис, замените /usr/local/bin/geth-bsc, запустите снова. База данных переходит без изменений. В примечаниях к релизам отмечают изменения конфигурации, а BSC переименовывает флаги чаще, чем upstream Geth, поэтому просмотрите их до перезапуска, а не после. Закладывайте четверть часа на релиз и ожидайте форк каждые несколько месяцев.
Для сред разработки локальную приватную сеть можно поднять с помощью набора BSC-Deploy, а не запуском нод мейннета.
Устранение неполадок
Нода импортирует блоки, но постоянно отстаёт от головы цепочки
Почти всегда дело в IOPS диска. Замерьте fio и сравните с ориентиром 8k IOPS; обычный виновник — сетевое хранилище с IOPS по умолчанию. Убедитесь, что задан --tries-verify-mode none. Если железо ниже таблицы требований, никакой флаг не закроет разрыв.
Ошибки «missing trie node» или нода начинает синхронизацию с блока 0 после восстановления из снапшота
Неверная структура datadir. База цепочки должна лежать в <datadir>/geth/chaindata. Если в логе есть «Writing custom genesis block», geth нашёл пустой datadir и начал с нуля. Остановите сервис, переместите распакованную папку geth в нужное место и запустите снова.
Число пиров остаётся около нуля
Проверьте, открыт ли и проброшен ли порт 30311. Второй кандидат — устаревший config.toml: списки загрузочных и статичных нод меняются со временем, поэтому заново скачайте mainnet.zip из последнего релиза. Для домашних подключений перепроверьте NAT.
lz4 сообщает «Decoding error» при распаковке
Архив неполный. Продолжите загрузку через aria2c -c и сравните размер файла с указанным на странице снапшота, прежде чем распаковывать снова. Помните, что вариант A требует свободного места под архив и распакованные данные одновременно.
OOM-killer завершает ноду
journalctl -k | grep -i oom решает вопрос. Юнит задаёт --cache 8000, а реальное потребление памяти во время догоняния сильно превышает значение кэша. На рекомендуемых 64 ГБ это нормально, на урезанном железе — нет. Сначала уменьшите --cache, прежде чем трогать что-либо ещё, оставьте swap включённым как буфер на случай сбоя, и помните: нода, убитая OOM-killer, ничего не сбрасывает, и при следующем запуске вас может встретить случай «missing trie node» из раздела выше.
Диск заполнен
Сначала df -h, затем du -h --max-depth=2 /var/lib/bsc, чтобы найти рост. Чаще всего находят забытые архивы снапшотов: один только обрезанный .tar.lz4 занимает около 1,9 ТБ, и вариант A оставляет его на диске, если пропустить очистку. Если проблема в самом chaindata, обновите его из самого свежего обрезанного снапшота или выполните офлайн-обрезку (см. раздел о росте состояния). При такой кривой роста BSC заполненный диск — это ошибка планирования, а не невезение. Оповещение на 85 процентов из раздела мониторинга нужно, чтобы выиграть нужную неделю.
Собственная нода или API?
Chaingateway продаёт альтернативу, поэтому вот сравнение с его слабыми сторонами.
Запускайте ноду, если вы потребляете сырой JSON-RPC в большом и постоянном объёме: индексация, бэктестинг, сканирование логов по миллионам блоков, или если между вами и сетью не должна стоять третья сторона. Выделенный сервер — это фиксированная статья расходов без оплаты за каждый запрос, и при большом числе вызовов он может оказаться дешевле тарифа с оплатой по объёму.
Используйте API, если нода была бы просто инфраструктурой для платежей. Синхронизированная full-нода BSC даёт вам eth_sendRawTransaction и логи. Всё, что платёжной системе действительно нужно, — адреса для депозитов по клиентам, обнаружение входящих переводов BEP-20, подписанные вебхуки, хранение ключей, повторные попытки — это ПО, которое вы напишете поверх и будете поддерживать. Учтите эти инженерные часы в сравнении, по ставке из раздела о стоимости.
API BNB Smart Chain от Chaingateway покрывает этот слой как REST: импорт адресов (POST /api/v2/bsc/addresses/import), отправка токенов BEP-20 (POST /api/v2/bsc/transactions/bep20) и получение вебхуков о депозитах. Вебхуки несут HMAC-заголовок X-Signature, когда вы задали личный секрет (руководство по проверке). Неудачные доставки не повторяются автоматически: GET /api/v2/bsc/webhooks/notifications/failed выводит их списком, и каждое можно отправить заново через эндпоинт повтора. Точка безубыточности в одной строке: выделенный сервер плюс ваши часы на сборку и эксплуатацию против тарифа на /pricing/. Быстрый старт и руководство по вебхукам приводят к первому тесту за минуты, а 7-дневный пробный период не требует KYC (регистрация).
Если вы также работаете с другими сетями, см. гайды по настройке для Ethereum и TRON.
Часто задаваемые вопросы
Да. Сеть переименовали из Binance Smart Chain в BNB Smart Chain в феврале 2022 года. Документация, бинарники и этот гайд описывают одну и ту же сеть; изменился только брендинг.
Официальный обрезанный снапшот занимает около 1,9 ТБ в сжатом виде, полный снапшот — около 7,4 ТБ (bsc-snapshots, снапшот от 9 октября 2026 года, проверено 5 ноября 2026 года). При распаковке архив и распакованные данные должны одновременно находиться на диске, поэтому реалистичный размер — NVMe-диск на 4 ТБ.
Нет. BSC использует консенсус Parlia и собственные правила протокола; синхронизировать сеть может только форк на github.com/bnb-chain/bsc. Одинаковое имя бинарника и вызывает эту путаницу, поэтому на шаге 2 его переименовывают в geth-bsc.
Практически нет. Код light-клиента есть в форке, но сеть почти не обслуживает light-пиров. Ваши реалистичные варианты — обрезанная full-нода, fast-нода или API.
Нет. Награды за блоки получает избранный набор валидаторов, для которого нужен значительный застейканный BNB и голоса сообщества. Full-нода даёт независимый доступ к сети, а не доход.
Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API Binance Smart Chain для полного справочника по эндпоинтам.