amneziawg-installer-tg-bot

KO | EN

gitlite — search

#deep-learning #openai #awesome #javascript #react-native #tensorflow #pytorch #cross-platform #database #video

amneziawg-installer-tg-bot

(★ 9)

Telegram бот для amneziawg-installer

File Explorer

ZIP Download

.env.example
awg-bot-read.sh
awg-telegram-route.service
awg-telegram-route.sh
awg-tg-bot.service
bot.py
install.sh
README.md
requirements.txt
sudoers-awg-tg-bot

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Telegram-бот для управления клиентами VPN-сервера, развёрнутого через
[bivlked/amneziawg-installer](https://github.com/bivlked/amneziawg-installer).
Полностью на кнопках: добавление постоянных и временных (гостевых)
клиентов, статус в реальном времени, статистика трафика, диагностика
сервера, бэкапы, перезапуск и пересборка DKMS-модуля — без единой ssh-сессии
после установки.

## Возможности

- **Клиенты одной кнопкой** — постоянные (сразу с `PresharedKey`) или
  гостевые с выбором срока действия (1 час / 12 часов / 1 день / 7 дней /
  30 дней / 4 недели). Гостевой доступ истекает и удаляется автоматически
  силами самого `amneziawg-installer` — бот только передаёт флаг.
- **Статус клиента** — онлайн/офлайн по свежести handshake, текущий
  внешний IP с городом/страной/провайдером (геолокация с ротацией
  сервисов), история последних подключений.
- **Файлы клиента по кнопке** — `.conf`, QR-код, `vpn://` ссылка, в любой
  момент, не только при создании.
- **Статистика трафика**, **краткая диагностика сервера** (не полный
  терминальный вывод, а сводка по каждой проверке), **бэкап одним
  нажатием**, **перезапуск и пересборка DKMS-модуля** — оба действия с
  обязательным подтверждением.
- **Работает и на входной ноде каскада** — если Telegram недоступен
  напрямую (типично для серверов в РФ), бот может направить свой трафик
  через уже настроенный тоннель на зарубежный exit-сервер.

## Требования

- Сервер с уже установленным и настроенным
  [amneziawg-installer](https://github.com/bivlked/amneziawg-installer)
  (Ubuntu/Debian).
- Root-доступ.
- Токен Telegram-бота от [@BotFather](https://t.me/BotFather) и свой
  Telegram ID от [@userinfobot](https://t.me/userinfobot).

## Установка

Одной командой:

```bash
curl -fsSL https://raw.githubusercontent.com/blindtechnique/amneziawg-installer-tg-bot/main/install.sh | sudo bash
```

Либо из клонированного репозитория:

```bash
git clone https://github.com/blindtechnique/amneziawg-installer-tg-bot.git
cd amneziawg-installer-tg-bot
sudo bash install.sh
```

Установщик спросит токен бота, ваш Telegram ID и (если применимо) нужна
ли маршрутизация Telegram через каскад — дальше всё делает сам: находит
`manage_amneziawg.sh` и нужные бинарники, создаёт системного пользователя
для бота, настраивает точечные sudo-права, systemd-автозапуск, проверяет
связь с Telegram и запускает бота.

### Каскад на зарубежный exit-сервер

Если `api.telegram.org` недоступен напрямую с этого сервера (частый
случай для входных нод в РФ) и у вас уже настроен каскад по
[CASCADE.md](https://github.com/bivlked/amneziawg-installer/blob/main/CASCADE.md),
ответьте `y` на вопрос установщика про каскад — трафик бота к Telegram
пойдёт через тот же тоннель (статический маршрут на официальные
IP-диапазоны Telegram, обновляется при каждом запуске маршрутизации).

Без каскада, если Telegram всё равно недоступен — укажите прокси в
`.env`: `AWG_BOT_PROXY_URL=socks5://...` или `http://...`.

## Структура репозитория

| Файл | Назначение |
|---|---|
| `install.sh` | установщик — качает остальные файлы сам, если запущен через `curl \| bash` |
| `bot.py` | сам бот |
| `requirements.txt` | зависимости Python |
| `awg-tg-bot.service` | systemd-юнит бота |
| `awg-bot-read.sh` | доверенный root-скрипт чтения файлов клиентов/бэкапов |
| `awg-telegram-route.sh`, `awg-telegram-route.service` | маршрутизация Telegram через каскад (опционально) |
| `sudoers-awg-tg-bot` | шаблон sudo-прав (для ручной установки) |
| `.env.example` | справочный список переменных окружения |

## Безопасность

Бот управляет доступом к VPN — токен и сам бот эквивалентны паролю от
сервера:

- работает от отдельного системного пользователя, не от `root`;
- sudo-права точечные: запуск `manage_amneziawg.sh`, чтение статуса
  интерфейса, чтение файлов клиентов/бэкапов через доверенный скрипт с
  канонизацией пути — ничего больше;
- systemd-песочница (`ProtectSystem=full` + явный список
  `ReadWritePaths`);
- доступ к боту — по списку Telegram ID администраторов, все остальные
  молча игнорируются;
- разрушительные действия (удаление клиента, перезапуск сервиса,
  пересборка DKMS) — всегда с подтверждением кнопкой;
- если токен где-то засветился — отзовите его через
  [@BotFather](https://t.me/BotFather) (`/mybots` → бот → `API Token` →
  `Revoke current token`) и обновите `.env`.

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

Полный список переменных с комментариями — в `.env.example`
(`install.sh` создаёт `.env` автоматически по ответам на вопросы,
редактировать вручную не обязательно). Основное:

| Переменная | Назначение |
|---|---|
| `AWG_BOT_TOKEN` | токен бота |
| `AWG_BOT_ADMIN_IDS` | Telegram ID администраторов через запятую |
| `AWG_MANAGE_SCRIPT`, `AWG_DIR` | пути к `manage_amneziawg.sh` и папке клиентов |
| `AWG_BIN`, `AWG_INTERFACE` | бинарник `awg` и интерфейс сервера |
| `AWG_BOT_GEOIP_ENABLED` | геолокация IP клиентов (1/0) |
| `AWG_BOT_BIND_IFACE`, `AWG_BOT_PROXY_URL` | альтернативные способы связи с Telegram, если каскад не используется |

## Устранение неполадок

**Бот не отвечает на `/start`.**
```bash
systemctl status awg-tg-bot
journalctl -u awg-tg-bot -n 100 --no-pager
sudo -u awgbot curl -s --max-time 8 https://api.telegram.org/bot<ТОКЕН>/getMe
```
Если `curl` зависает — сервер не видит Telegram напрямую, см. раздел про
каскад выше. Если возвращает `{"ok":true,...}` — сеть в порядке, причина
в логе (неверный `AWG_BOT_ADMIN_IDS`, токен от другого бота и т.д.).

**Карточка клиента или список долго грузится.**
Скорее всего geoip-сервисы недоступны напрямую с этого сервера. Бот сам
укладывается в таймаут (`AWG_BOT_INTERACTIVE_TIMEOUT`, по умолчанию 12
сек), но геолокацию можно отключить полностью:
```
AWG_BOT_GEOIP_ENABLED=0
```
в `.env`, затем `systemctl restart awg-tg-bot`.

**После правки `.env` или `.service` файлов.**
```bash
systemctl daemon-reload   # если менялся .service
systemctl restart awg-tg-bot
```

## Обновление

```bash
cd amneziawg-installer-tg-bot   # или заново git clone
git pull
sudo bash install.sh            # спросит про перезапись .env - можно отказаться
```

## Удаление

```bash
systemctl disable --now awg-tg-bot awg-telegram-route 2>/dev/null
rm -f /etc/systemd/system/awg-tg-bot.service /etc/systemd/system/awg-telegram-route.service
rm -f /etc/sudoers.d/awg-tg-bot
rm -f /root/awg/awg-bot-read.sh /root/awg/awg-telegram-route.sh
rm -rf /opt/awg-tg-bot
userdel -r awgbot
systemctl daemon-reload
```

## Лицензия и авторство

Бот не аффилирован с проектом
[amneziawg-installer](https://github.com/bivlked/amneziawg-installer) —
это независимая надстройка над его CLI (`manage_amneziawg.sh`).

amneziawg-installer-tg-bot

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README