Встановлення BTCPay Server на VPS з Lightning та Bitcoin Core

Розгортання BTCPay Server

Ви втрачаєте до 3% обороту на комісіях Stripe та ризикуєте блокуванням рахунку за криптоплатежі? Self-hosted BTCPay Server вирішує обидві проблеми: ви контролюєте ключі та не платите посередникам. Але деплой цього стеку — не docker compose up. Bitcoin Core (600+ GB диска), NBXplorer, PostgreSQL, LND та nginx з Let's Encrypt — кожну частину потрібно налаштувати під ваш VPS.

Ми допомагаємо замовникам розгорнути BTCPay Server за 2–4 години базового встановлення. З Lightning — до трьох днів з урахуванням синхронізації mainnet. Нижче — технічні деталі та наш підхід, який економить до 30% на комісіях та виключає залежність від платіжних шлюзів. Наприклад, при обороті $50 000 на місяць комісії Stripe становитимуть $1 500, а прийом через BTCPay — лише мережеві комісії (~$10) — економія $1 490 щомісячно.

Проблеми, які ми вирішуємо

Синхронізація Bitcoin Core гальмує запуск на 48 годин. Без оптимізації pruned-режиму або snapshot ви чекаєте завантаження всього блокчейну через p2p. Ми використовуємо попередньо синхронізовані ноди та паралельне завантаження, скорочуючи час до 6–12 годин.

Lightning Network потребує вхідної ліквідності. Щоб приймати платежі через канали, потрібні вхідні. Ми налаштовуємо peer-з'єднання з ACINQ, WalletOfSatoshi та через сервіси типу Lightning Pool — ви отримуєте працюючий вузол без додаткових витрат.

Без автоматизації бекапів ви втратите канали. Static Channel Backup (SCB) має копіюватися щогодини. Ми підіймаємо cron-скрипти, які вивантажують channel.backup в S3 — автоматично та з версіонуванням. Дані з офіційної документації LND.

Як ми розгортаємо стек

Базове встановлення через офіційний скрипт — один блок команд:

# Встановлення залежностей та завантаження інсталятора
apt-get update && apt-get install -y curl git
curl -sSL https://btcpayserver.org/install.sh | sudo bash -s -- -c mainnet -l lnd -r nginx

Але краще робити вручну — повний контроль над версіями та параметрами:

git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker
export BTCPAY_HOST="pay.yourdomain.com"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_LIGHTNING="lnd"
export BTCPAYGEN_REVERSEPROXY="nginx"
. ./btcpay-setup.sh -i

Ми додаємо фрагмент opt-save-storage для pruned-режиму, якщо не потрібна повна нода.

Конфігурація DNS та HTTPS

До деплою переконайтеся, що DNS A-запис для pay.yourdomain.com вказує на ваш VPS. Перевірити: dig +short pay.yourdomain.com. Let's Encrypt отримає сертифікат автоматично — nginx reverse proxy в конфігу вже налаштований.

Як прискорити синхронізацію Bitcoin Core?

Основний час при деплої — це завантаження блокчейну. Звичайна p2p-синхронізація займає 48 годин при 100 Мбіт/с. Використовуйте pruned-режим (256 МБ замість 650 ГБ) або завантажте snapshot з довіреного джерела — так можна скоротити до 6 годин. Ми у своїй практиці застосовуємо готові образи VPS з попередньо синхронізованим Bitcoin Core.

Чому self-hosted BTCPay?

Ви повністю контролюєте приватні ключі та дані клієнтів. Немає щомісячних комісій платіжного шлюзу — лише вартість VPS та комісії мережі Bitcoin (Lightning Network дозволяє приймати миттєві мікроплатежі з комісією менше 1 сатоші). Крім того, BTCPay інтегрується з Lightning Network — протоколом другого рівня для миттєвих транзакцій.

Вибір Lightning-реалізації: LND vs CLN

Для більшості проєктів ми вибираємо LND: більше готових бібліотек та повна підтримка BTCPay. CLN — для кастомних сценаріїв.

Покроковий процес встановлення (спрощений)

1. Підготовка VPS: Ubuntu 22.04, користувач sudo, налаштування firewall (порти 80, 443, 9735).
2. Деплой BTCPay: виконати команди вище, дочекатися завершення btcpay-setup.sh.
3. Ініціалізація Lightning: створити гаманець, отримати адресу та поповнити баланс.
4. Відкриття каналів: підключитися до хабів, направити ліквідність.
5. Налаштування моніторингу: health check (curl https://pay.yourdomain.com/health) та uptime-алерти.

docker exec -it $(docker ps -q -f name=lnd) lncli --network=mainnet openchannel --node_key=03... --local_amt=1000000