Установка и запуск Bitcoin Core на Debian Linux

Кратко

Bitcoin Core — официальный Bitcoin-узел и кошелёк. В этой инструкции показано, как установить зависимости, собрать из исходников и запустить bitcoind/bitcoin-qt на Debian. Если вам нужен только безголовый узел без кошелька — пропустите часть про Berkeley DB 4.8.

Что такое Bitcoin Core

Bitcoin Core — это полная реализация протокола Bitcoin. Она позволяет запускать полный узел, хранить кошелёк и участвовать в валидации блоков. Полный узел скачивает всю историю блокчейна и требует дискового пространства и сети.

Требования и пояснения

• Полный узел хранит весь блокчейн — это обычно десятки или сотни гигабайт диска. Подготовьте свободное место и стабильное подключение к Интернету.
• Berkeley DB 4.8 требуется только если вы собираете поддержку встроенного кошелька. Для только-узла можно пропустить установку BDB и отключить wallet при сборке.
• Сборка из исходников даёт контроль и актуальность, но требует времени и инструментов сборки.

Важно: для операций сборки используйте непривилегированного пользователя или root только при необходимости. Не запускайте биткоин-демона под root.

Установка зависимостей

Перед сборкой установите инструменты и библиотеки, от которых зависит Bitcoin Core.

Для bitcoin-core

sudo apt-get install build-essential autoconf libssl-dev libboost-dev libboost-chrono-dev libboost-filesystem-dev libboost-program-options-dev libboost-system-dev libboost-test-dev libboost-thread-dev

Для bitcoin-qt (графический интерфейс)

Если нужен графический интерфейс, дополнительно установите:

sudo apt-get install libqt4-dev libprotobuf-dev protobuf-compiler libqrencode-dev

Если вы собираете только демона (bitcoind) — этот шаг не обязателен.

Установка Berkeley DB 4.8 (только для кошелька)

Сборка с поддержкой встроенного кошелька требует Berkeley DB 4.8. В современных репозиториях её может не быть. Если не нужен кошелёк, пропустите этот раздел.

1. Измените /etc/apt/sources.list, чтобы временно использовать squeeze (пример)

Отредактируйте файл:

vi /etc/apt/sources.list

Добавьте строки в начало файла:

deb http://[your favorite repository]/debian/ squeeze main contrib non-free
deb-src http://[your favorite repository]/debian/ squeeze main contrib non-free

2. Установите Berkeley DB 4.8

apt-get install libdb4.8++-dev libdb4.8-dev

Примечание: вместо изменения системных репозиториев можно собрать Berkeley DB из исходников или использовать контейнер / chroot для изоляции старых пакетов.

Загрузка и компиляция Bitcoin Core

Перейдите на страницу веток проекта Bitcoin Core, найдите последний релиз и замените “0.11” в команде ниже на актуальную версию.

cd /root git clone -b 0.11 https://github.com/bitcoin/bitcoin.git cd bitcoin/

Совет: лучше клонировать репозиторий отдельной командой, например: git clone -b <версия> https://github.com/bitcoin/bitcoin.git && cd bitcoin

Конфигурация системы для сборки

./autogen.sh

Если не нужен GUI, используйте:

./configure --without-gui

Иначе:

./configure

Если вы пропустили Berkeley DB 4.8 и не нужен кошелёк, добавьте опцию –disable-wallet к ./configure.

Сборка

make

Сборка займёт время в зависимости от CPU и памяти. На слабых машинах процесс может длиться долго.

Установка и запуск

make install

После установки доступны бинарные файлы:

• bitcoind — текстовый бэкенд (демон)
• bitcoin-qt — графический интерфейс
• bitcoin-cli — клиент командной строки

Запуск в фоне (демон)

bitcoind -daemon

Проверка синхронизации

echo `bitcoin-cli getblockcount 2>&1`/`wget -O - http://blockchain.info/q/getblockcount 2>/dev/null`

Полезные команды (примеры)

Чтобы получить список адресов и их балансов:

bitcoin-cli listreceivedbyaddress 0 true

Привязать адрес к учётной записи:

bitcoin-cli setaccount 1GBykdD628RbYPr3MUhANiWchoCcE52eW2 myfirstaccount

Отправить монеты (пример):

bitcoin-cli sendfrom myfirstaccount 1AYJyqQHCixxxxxxffevxxxxQosCWqn1bT 0.15

Когда этот подход не подходит (контрпримеры)

• Если вы хотите быстро настроить узел для тестирования — предпочтительнее использовать Docker-контейнер или готовые пакеты. Сборка из исходников даёт контроль, но сложнее.
• Если нужен только лёгкий кошелёк на рабочем столе — рассмотрите SPV-клиенты или аппаратные кошельки, чтобы не хранить весь блокчейн.

Альтернативные подходы

• Установить бинарные пакеты из репозиториев или PPA, если они доступны для вашей версии Debian.
• Использовать Docker-образ официального или проверенного поставщика, чтобы избежать сложностей со сборкой и зависимостями.
• Запустить удалённый полнофункциональный узел и использовать локальный лёгкий кошелёк (например Electrum) для приватности и удобства.

Модель принятия решений (умозрительная подсказка)

• Нужен полный контроль и актуальные патчи → Сборка из исходников.
• Нужна простота и быстрая установка → Пакеты / Docker.
• Нужен только кошелёк без узла → SPV/аппаратный кошелёк.

Безопасность и жёсткая настройка

• Шифруйте wallet.dat командой bitcoin-cli walletpassphrase или через GUI.
• Держите бинарники и исходники из проверенных источников. Проверяйте подписи релизов, если доступно.
• Разрешите доступ к RPC только локально или через TLS/ssh-туннель. Настройте rpcbind и rpcallowip в bitcoin.conf.
• Ограничьте сетевое окружение брандмауэром и наблюдайте за исходящим трафиком.
• Не храните ключи на машинах с общим доступом; используйте резервное копирование и безопасное хранение.

Контроль совместимости и миграция

• Berkeley DB 4.8 нужна только для старой модели кошелька. Новые кошельки могут использовать другие форматы. При миграции кошелька делайте резервные копии.
• На новых версиях Debian используйте контейнер или статические сборки, если отсутствуют нужные старые библиотеки в репозитории.

Роль-based чек-листы

• Серверный администратор:
  • Убедиться в наличии свободного диска и резервного питания.
  • Ограничить доступ к RPC и открыть порты P2P только при необходимости.
  • Настроить автоматический запуск сервиса и логи.
• Домашний пользователь:
  • Решить, нужен ли полный узел или лёгкий кошелёк.
  • Составить резервную копию wallet.dat и хранить вне сети.
  • Обновлять ПО регулярно.

Критерии приёмки

• bitcoind запускается без ошибок.
• bitcoin-cli getblockcount возвращает положительное число и растёт по мере синхронизации.
• При включённом кошельке адреса и балансы доступны через bitcoin-cli.
• Сеть и дисковое пространство стабильны при полной синхронизации.

Краткое резюме

• Установите зависимости, решите, нужен ли кошелёк. Если нужен — поставьте Berkeley DB 4.8 или используйте контейнер/изолированную среду.
• Клонируйте репозиторий, выполните ./autogen.sh, ./configure и make.
• Установите и запустите bitcoind; следите за синхронизацией и безопасностью.

Дополнительные заметки

• Если что-то идёт не так, изучите лог-файлы Bitcoin Core и вывод make. Часто помогает обновление библиотек, запуск make clean и повторная конфигурация.
• Рассмотрите использование готовых сборок или Docker, чтобы упростить развертывание.

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