Безопасность и бэкапы
Сервер держит горячие ключи. Значит, под риском только то, что на них лежит. Холодный кошелёк на сервер не попадает никогда.
Кто что знает
| Что | Где лежит | Что будет при утечке |
|---|---|---|
| Холодные кошельки | У вас, офлайн | Ничего. Сервер знает только публичный адрес. |
| Ключи адресов счетов | База, AES-256-GCM, привязка к сети и адресу | Горячие: неслитый остаток каждого адреса. |
| Газовые кошельки | База, так же зашифрованы | Горячие: TRX и BNB, что вы туда положили. |
DEPOSIT_KEY_SECRET | /etc/beast-kluk.env (root, 0600) и одна офлайн-копия | Вместе с копией базы открывает все ключи. |
| Бэкапы базы | Сервер и ваша машина | Без секрета бесполезны. |
| Токен API | В env только SHA-256 | Можно создавать и читать счета. Больше ничего. Число открытых счетов и ttl ограничены, так что квоту TronGrid этим не выжечь. |
| Токен админки | В env только SHA-256 | Можно запустить слив. Но только на ваши холодные кошельки. |
| Провайдеры данных сети | TronGrid и BSC_RPC_URL, по желанию второй провайдер | Денег не украсть. Но можно выдать ложную оплату, если второго провайдера нет. |
Итог. Полный взлом сервера стоит вам неслитых остатков и газовых кошельков. Поэтому: сливайте часто, газа держите на пару сливов.
Почему деньги нельзя увести через админку
- Единственный адрес назначения для USDT в коде это холодный кошелёк из файла настроек. Он проверяется при старте: base58check для TRON, EIP-55 для BSC.
- Транзакцию TRON собирает узел, но сервис пересобирает её сам и сверяет байт в байт. Узел подменил получателя? Подписи не будет.
- Ключи расшифровываются только на момент подписи, буфер сразу стирается.
- Ключи не попадают в логи, ответы API, админку, журнал, вебхуки и тексты ошибок. Тесты проверяют каждый из этих каналов.
Второй провайдер
Была ли оплата, сервис узнаёт от API сети. Один провайдер на сеть это одна точка доверия. Взломанный, сломанный или подменённый провайдер может сказать «деньги пришли», когда их нет. Счёт станет paid, и вы отдадите товар даром. Украсть деньги он не может: слив идёт только на холодные кошельки.
Защита: TRON_VERIFY_URL и BSC_VERIFY_RPC_URL. Это второй, независимый провайдер другой компании. Покрытый счёт станет оплаченным, только если его баланс USDT на адресе вместе с уже слитым не меньше зачисленного.
- Расхождение: счёт не оплачен, в логе
ALERT … NOT marked paid, проверка на каждом проходе. - Расхождение дольше суток после последнего зачисления: проверка прекращается, в логе
ALERT … verify gave up, в аудитеverify.gaveup. Проверьте адрес сами. - Отстающий второй провайдер только задержит оплату. Поставить её он не может.
- Вебхук уходит после подтверждения вторым провайдером.
- Без них сервис стартует с
WARNINGи верит основному. Для сумм больше карманных ставьте обязательно.
TRON: база HTTP API java-tron, нужен /wallet/triggerconstantcontract. BSC: адрес JSON-RPC. Оба только https.
Сервер
- Сервис не запускается от root. Юнит systemd с отдельным пользователем,
ProtectSystem=strict,NoNewPrivileges, фильтром системных вызовов и без прав. - Админка только на loopback. Порт 8830 никогда не проксируйте.
- Наружу только
/v1/и/pay/через nginx с TLS и лимитом на/pay/. - Все внешние адреса только https.
http://останавливает запуск. - Токены сравниваются по SHA-256 за постоянное время.
DEPOSIT_KEY_SECRET
Это главный ключ. Он шифрует все ключи адресов и газовых кошельков.
- Сделайте офлайн-копию один раз. Менеджер паролей или бумага в надёжном месте.
- Не храните рядом с бэкапами базы. База и секрет вместе открывают все ключи.
- Потеряли секрет: потеряли неслитые деньги. Восстановить ключи без него нельзя.
- Не меняйте его на живой базе. Первый старт записывает в базу метку. С другим секретом сервис откажется стартовать: «DEPOSIT_KEY_SECRET does not match the one this database was made with». Так ключи никогда не окажутся зашифрованы двумя разными секретами.
Бэкапы
Сервис делает согласованные копии базы (VACUUM INTO) в /var/lib/beast-kluk/backups/. Файлы 0640, папка 0750, папка состояния 0710. Живая база 0600: её не читает никто, кроме сервиса.
| Копия | Когда | Хранит |
|---|---|---|
beast-kluk-daily-* | каждую ночь в 03:00 UTC | 14 |
beast-kluk-hourly-* | в течение часа после любого нового ключа | 48 |
Так на сервере всегда есть копия каждого ключа старше часа. Но копии лежат на том же диске. Умер диск: пропали ключи после последней копии, что ушла с сервера, и их неслитые деньги.
Поэтому запускайте backup.sh каждый час с другой машины, через cron или launchd. Он забирает самую свежую копию.
Заходит он отдельным пользователем beast-kluk-backup, не root. Этот пользователь в группе beast-kluk: читает папку бэкапов и больше ничего. Один раз на сервере:
sudo useradd --system --create-home --shell /bin/sh -G beast-kluk beast-kluk-backup
sudo install -d -o beast-kluk-backup -m 700 ~beast-kluk-backup/.ssh
echo 'restrict ssh-ed25519 AAAA… mac' | sudo tee ~beast-kluk-backup/.ssh/authorized_keys
sudo chown beast-kluk-backup ~beast-kluk-backup/.ssh/authorized_keys
sudo chmod 600 ~beast-kluk-backup/.ssh/authorized_keys
На Mac:
BEAST_KLUK_HOST=beast-kluk-backup@host ./backup.sh # в ~/Backups/beast-kluk
BEAST_KLUK_HOST=beast-kluk-backup@host ./backup.sh /путь/куда
# crontab -e: каждый час в 5 минут
5 * * * * BEAST_KLUK_HOST=beast-kluk-backup@host /путь/к/beast-kluk/backup.sh
Ключи из базы не удаляются никогда, даже после слива. На старый адрес может прийти поздний платёж.
Восстановление
sudo systemctl stop beast-kluk
sudo install -o beast-kluk -m 600 beast-kluk-daily-20261116-030000.db /var/lib/beast-kluk/beast-kluk.db
sudo rm -f /var/lib/beast-kluk/beast-kluk.db-wal /var/lib/beast-kluk/beast-kluk.db-shm
# в /etc/beast-kluk.env тот же DEPOSIT_KEY_SECRET
sudo systemctl start beast-kluk
С другим секретом сервис не стартует. Это защита, а не поломка.
Смена токенов
Сделайте новый токен через beast-kluk token, впишите его SHA-256 в файл настроек и перезапустите сервис. Старый токен перестанет работать сразу.
Смена WEBHOOK_SECRET работает так же. Неотправленные события после перезапуска уйдут уже с новой подписью: обновите секрет у получателя одновременно.
Юридически
Приём криптовалюты в оплату запрещён или ограничен в ряде стран. Например, для резидентов РФ это ст. 14 закона 259-ФЗ. Перед запуском спросите местного юриста.