amnezia-bot/README.md

# amnezia-bot (форк)

Telegram-бот на Python для управления сервером AmneziaVPN / AmneziaWG: выдача и отзыв клиентских конфигов, срок действия подписки, промокоды, резервные копии. Бот работает на том же сервере, где развёрнут AmneziaWG в Docker-контейнере, и управляет им через `docker exec` и правку `wg0.conf`.

Форк сделан как резервная копия исходного проекта [stevefoxru/amnezia-bot](https://github.com/stevefoxru/amnezia-bot) в самохостовом Gitea — чтобы код оставался доступен независимо от судьбы репозитория на GitHub.

Документация оригинала (установка, возможности, поддержка) сохранена в [README.upstream.md](README.upstream.md).

## Отличия от оригинала

Изменений нет. Все 85 коммитов принадлежат автору оригинала (`stevefoxru`), собственных правок владельца форка в истории нет. Форк взят как резервная копия.

## Стек

- Python 3.11
- aiogram 2.25.2 (Telegram Bot API, inline-меню, FSM)
- aiohttp 3.8.6, aiofiles — HTTP-запросы и асинхронный файловый ввод-вывод
- APScheduler 3.10.4 — планировщик (истечение срока подписок)
- pytz, humanize, Babel — время и форматирование
- yookassa 2.4.0, YooMoney 0.1.0 — заявлены в `requirements.txt`, в коде не используются
- Bash-скрипты + Docker CLI + `wg`/`awg` для управления WireGuard/AmneziaWG
- Хранение данных — JSON-файлы (не БД)

## Структура

| Путь | Назначение |
|---|---|
| `awg/bot_manager.py` | Точка входа бота (`executor.start_polling`), ~1000 строк: inline-меню, все callback-обработчики (добавление/удаление клиентов, список, конфиги, промокоды, бэкапы, настройки цен, админы/модераторы) |
| `awg/db.py` | Слой данных: чтение/запись JSON-файлов `files/config.json`, `files/user_expiration.json`, `files/user_telegram.json`, `files/promocodes.json`; работа со списком клиентов и промокодами |
| `awg/wg.py` | Генерация пары ключей WireGuard, выделение IP из подсети `10.0.0.0/24`, добавление пира в `wg0.conf`, `wg syncconf` внутри контейнера `amnezia-awg` |
| `awg/awg-decode.py` | Кодирование/декодирование конфига в ссылку формата `vpn://` (Qt-совместимое zlib-сжатие + base64) для импорта в клиент AmneziaVPN |
| `awg/newclient.sh` | Создание клиента: аргументы `CLIENT_NAME ENDPOINT WG_CONFIG_FILE DOCKER_CONTAINER`, генерация `.conf` |
| `awg/removeclient.sh` | Удаление клиента из конфигурации сервера |
| `handlers/add_client.py` | Отдельный FSM-обработчик `/add_client` с выбором протокола WireGuard/XRay; **не подключён** к боту (импортирует несуществующий модуль `loader`) |
| `install.sh` | Bash-скрипт: клонирование репозитория в `/root/amnezia-bot`, проверка обновлений через GitHub API, самообновление, пересоздание venv, перезапуск службы `awg_bot` |
| `requirements.txt` | Пиннутые версии Python-зависимостей |
| `LICENSE` | GPL-3.0 |

Каталог `awg/files/` (конфиги, JSON-состояние, `wg0.conf`) в репозиторий не входит и создаётся на сервере при работе.

## Как собрать/запустить

Предполагается уже установленный и инициализированный AmneziaVPN с протоколом AmneziaWG.

Установка/обновление через штатный скрипт (от root):

```bash
curl -O https://raw.githubusercontent.com/stevefoxru/amnezia-bot/main/install.sh
chmod +x install.sh
./install.sh              # интерактивная проверка обновлений
./install.sh --check-update   # то же без вопросов
```

Скрипт требует `git`, `curl`, `jq`, `python3.11`, работает с каталогом `/root/amnezia-bot` и службой systemd `awg_bot`.

Ручной запуск:

```bash
python3.11 -m venv myenv
source myenv/bin/activate
pip install -r requirements.txt
cd awg && python3.11 bot_manager.py
```

Перед запуском должен существовать `awg/files/config.json` — без обязательных полей бот завершается с ошибкой.

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

Все настройки — в `awg/files/config.json` (в репозиторий не входит). Обязательные поля:

| Ключ | Назначение |
|---|---|
| `bot_token` | Токен Telegram-бота от BotFather — реальное значение хранить только в `config.json` на сервере |
| `admin_ids` | Список Telegram ID администраторов (полный доступ) |
| `moderator_ids` | Список Telegram ID модераторов (ограниченное меню) |
| `wg_config_file` | Путь к конфигурации WireGuard/AmneziaWG на сервере |
| `docker_container` | Имя Docker-контейнера AmneziaWG (в коде `wg.py` жёстко `amnezia-awg`) |
| `endpoint` | Внешний адрес сервера, подставляемый в клиентские конфиги |
| `pricing` | Необязательный словарь цен: `1_month`, `3_months`, `6_months`, `12_months` (по умолчанию 1000/2500/4500/8000) |

Прочие файлы состояния в `awg/files/`: `user_expiration.json` (сроки и лимиты трафика), `user_telegram.json` (привязка клиента к Telegram ID), `promocodes.json` (промокоды).

Пути `/root/amnezia-bot/...` захардкожены в `wg.py` и `install.sh` — при установке в другой каталог потребуется правка кода.

Секретов в репозитории нет: токены и ключи в код не закоммичены.

## Состояние

Рабочий, но заброшенный: 85 коммитов, последний — 28.04.2025 (`stevefoxru`, «Update install.sh»). Собственных коммитов владельца форка нет, поэтому дата последней своей правки отсутствует.

## Что не доделано

- `handlers/add_client.py` — нерабочий: импортирует модуль `loader`, которого в репозитории нет; ветка XRay (`amnezia client add --proto xray`) нигде больше не используется. Фактически заготовка.
- `install.sh` в текущем виде только клонирует репозиторий и проверяет обновления. Он не создаёт systemd-юнит `awg_bot` и не формирует `files/config.json`, хотя README оригинала описывает его как полноценный установщик с интерактивной инициализацией (первая версия скрипта была на 305 строк против нынешних 190).
- В `install.sh` список пакетов при обновлении зависимостей задан отдельно от `requirements.txt` и с другими версиями (`aiogram==2.25.1`, `humanize==4.9.0`, `pytz==2023.3.post1`) — рассинхронизация.
- `yookassa` и `YooMoney` в `requirements.txt` не используются ни в одном модуле: оплата подписок, судя по коду, не реализована (есть только цены и промокоды).
- Явных меток TODO/FIXME в коде нет.