Files

T

viktor 11b52cf5ad Обновление зависимостей, устранение хардкода, оплата через Telegram

Библиотеки:
- миграция с aiogram 2.25.2 (EOL) на aiogram 3.31: aiohttp обновился
  с 3.8.6 до 3.14.3, так как aiogram 2 жёстко требовал aiohttp<3.9
- самодельный словарь состояний заменён на FSM aiogram (MemoryStorage);
  это убирает падение на user_state.startswith(), когда состояния нет
- из requirements убраны неиспользуемые пакеты (Babel 2.9.1, humanize,
  aiofiles, yookassa, YooMoney); оставлены только прямые зависимости

Хардкод:
- пути вычисляются от расположения файлов бота (awg/config.py), больше
  нет привязки к /root/amnezia-bot и к запуску из конкретного каталога
- вместо 'python3.11' используется sys.executable; awg-decode.py
  переименован в awg_decode.py и импортируется напрямую вместо запуска
  через subprocess
- newclient.sh и removeclient.sh определяют каталог по своему
  расположению, а не по cwd
- install.sh: каталог, репозиторий, ветка и Python настраиваются
  переменными окружения, зависимости ставятся из requirements.txt
- секреты можно задавать переменными окружения вместо config.json

Оплата (встроенные платежи Telegram, провайдер ЮKassa):
- счёт, pre_checkout_query и successful_payment; публичный HTTPS-адрес
  и вебхук не нужны
- обработчик платежей вынесен в отдельный роутер и подключён первым:
  successful_payment приходит без текста и иначе перехватывался бы
  обработчиком, ожидающим ввода в FSM
- выдача ключа идемпотентна по id платежа, повторная доставка апдейта
  не создаёт второй ключ
- если после оплаты ключ создать не удалось, уведомляются администраторы
- промокоды разделены на validate/consume: использование засчитывается
  только после фактической выдачи ключа, а не при проверке кода
- поддержаны скидочные промокоды, уменьшающие сумму счёта
- опциональные чеки по 54-ФЗ через provider_data

Исправленные ошибки:
- db.root_add и db.deactive_user_db передавали скриптам 2 аргумента
  вместо 4, из-за чего создание и удаление клиентов всегда падало;
  публичный ключ для удаления теперь вычисляется из конфига клиента
- в create_backup не был импортирован zipfile (NameError при бэкапе)
- планировщик запускался без задач, подписки никогда не истекали;
  добавлена ежечасная проверка с отключением доступа и уведомлением
- callback_data вида renew_period_<имя>_<период> разбирался неверно для
  имён с подчёркиваниями; разделителем стало двоеточие
- статус клиента брался из status.json, который никто не создавал;
  теперь используется wg show latest-handshakes
- продление подписки сбрасывало остаток, теперь период добавляется к нему
- Markdown-разметка ломалась на именах с подчёркиваниями; используется
  HTML с экранированием
- vpn:// ключ уходит отдельным сообщением, а не в подписи к файлу,
  где мог не поместиться в лимит 1024 символа
- блокирующие вызовы docker и скриптов вынесены в отдельные потоки
- при удалении клиента связь с Telegram ID удаляется, а не пишется None

Удалён мёртвый код: awg/wg.py (нигде не импортировался, содержал
подсеть 10.0.0.0/24 вместо используемой 10.8.1.0/24) и
handlers/add_client.py (импортировал несуществующий модуль loader).

2026-09-04 14:44:26 +00:00

8.5 KiB

Исходник Ответственный История

AmneziaVPN Telegram Bot

Телеграм-бот на Python для управления AmneziaVPN. Этот бот позволяет легко управлять клиентами и продавать доступ через встроенные платежи Telegram.

Используется библиотека aiogram версии 3.x. Требуется Python 3.10 или новее. Протестировано на Ubuntu 20.04, 22.04, 24.04.

Возможности

Роли: администраторы, модераторы и обычные пользователи
Добавление и удаление клиентов
Создание ключа в формате vpn:// при генерации нового клиента (и при получении конфигурации), для использования в AmneziaVPN
Статус клиента онлайн/офлайн по реальному времени последнего handshake
Подписки на 1, 3, 6 и 12 месяцев с автоматическим отключением по истечении срока
Продление подписки на период или до произвольной даты; остаток активной подписки не сгорает
Оплата подписки прямо в Telegram (провайдер — ЮKassa), с чеками по 54-ФЗ при необходимости
Промокоды двух видов: выдающие ключ бесплатно и дающие скидку при оплате
Настраиваемые цены из интерфейса бота
Создание резервной копии

Установка

Установите AmneziaVPN (без данного шага бот РАБОТАТЬ НЕ БУДЕТ).
Пройдите первоначальную инициализацию, выбрав протокол AmneziaWG, в клиенте AmneziaVPN.
Создайте бота в Telegram:

Откройте Telegram и найдите бота BotFather.
Начните диалог, отправив команду /start.
Введите команду /newbot, чтобы создать нового бота.
Следуйте инструкциям BotFather, чтобы:
- Придумать имя для вашего бота (например, AmneziaWGBot).
- Придумать уникальное имя пользователя для бота (например, AmneziaWGManagerBot_bot). Оно должно оканчиваться на _bot.
После создания бота BotFather отправит вам токен для доступа к API. Его запросит бот во время первоначальной инициализации.

Получите ваш Telegram ID с помощью Get My ID, просто написав боту.
Загрузите и запустите скрипт install.sh, с помощью которого будет автоматически установлен бот, со всеми зависимостями, в том числе, в качестве системной службы (автозапуск):
```
curl -O https://raw.githubusercontent.com/viktor138irk/amnezia-bot/main/install.sh && chmod +x install.sh && ./install.sh
```

Настройка оплаты

Оплата работает на встроенных платежах Telegram, поэтому боту не нужен публичный HTTPS-адрес, домен или сертификат — Telegram сам подтверждает платёж.

Откройте BotFather → /mybots → ваш бот → Payments.
Выберите провайдера ЮKassa и подключите свой магазин.
BotFather выдаст токен провайдера (для тестов — с пометкой TEST).
Положите его в awg/files/config.json как payment_provider_token либо задайте переменной окружения AWG_PAYMENT_PROVIDER_TOKEN.

Если токен не задан, бот работает без оплаты: кнопка «Купить ключ» скрывается, ключи выдаются только по промокодам.

Минимальная сумма счёта в Telegram — 60 ₽, бот не даст выставить счёт меньше.

Для чеков по 54-ФЗ включите блок payment_receipt в конфигурации — тогда бот будет запрашивать email покупателя и передавать данные чека в ЮKassa.

Конфигурация

Настройки лежат в awg/files/config.json, образец — в awg/files/config.json.example.

Любую настройку можно переопределить переменной окружения, чтобы не хранить секреты в файле:

Переменная	Назначение
`AWG_BOT_HOME`	Каталог с данными бота (по умолчанию — каталог `awg/`)
`AWG_BOT_TOKEN`	Токен бота
`AWG_PAYMENT_PROVIDER_TOKEN`	Токен платёжного провайдера
`AWG_PAYMENT_CURRENCY`	Валюта счетов (по умолчанию `RUB`)
`AWG_ENDPOINT`	Адрес VPN-сервера
`AWG_DOCKER_CONTAINER`	Имя контейнера Amnezia
`AWG_WG_CONFIG_FILE`	Путь к конфигу WireGuard внутри контейнера
`AWG_LOG_LEVEL`	Уровень логирования (по умолчанию `INFO`)

Каталог установки больше не зашит в код: пути вычисляются относительно расположения файлов бота. install.sh тоже понимает AWG_BOT_HOME, AWG_PYTHON_BIN, AWG_REPO_URL и AWG_REPO_BRANCH.

Промокоды

Формат добавления: <код> <скидка%> <дней_действия> <макс_использований|none> <период|none>

FREE1M 100 30 10 1_month — бесплатный ключ на месяц, 10 активаций, промокод живёт 30 дней
SALE20 20 30 none none — скидка 20% при оплате, без ограничения по количеству

Использование промокода засчитывается только после фактической выдачи ключа.

Запуск

Добавьте бота в Telegram и отправьте команду /start или /help для начала работы.

Заметки

Для обновления бота, необходимо запустить скрипт install.sh. В меню, необходимо выбрать пункт Проверить обновления.

При создании резервной копии, в архив добавляется директория users (конфигурации клиентов), files (настройки, промокоды, платежи, сроки подписок) и скрипты бота.

Подписки проверяются раз в час: по истечении срока клиент удаляется с сервера, а его владелец получает уведомление.

Поддержка

Если у вас возникли вопросы или проблемы с установкой и использованием бота, создайте issue в этом репозитории или обратитесь к разработчику.

8.5 KiB Исходник Ответственный История