Files
gotelegram_pro/gotelegram-bot/README.md

71 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# GoTelegram MTProxy Bot
Telegram-бот для управления MTProxy на сервере — те же функции, что и у CLI `gotelegram`, но через бота.
## Команды
| Команда | Описание |
|--------|----------|
| `/start`, `/help` | Справка |
| `/install` | Установить или обновить прокси (выбор домена и порта) |
| `/status` | Статус и данные подключения (IP, порт, secret, ссылка) |
| `/link` | Только ссылка `tg://proxy` |
| `/restart` | Перезапустить контейнер |
| `/logs` | Последние логи контейнера |
| `/remove` | Удалить прокси |
| `/promo` | Промо хостинга |
## Установка на сервер
### Публичный репозиторий (одной командой)
```bash
curl -sL https://raw.githubusercontent.com/anten-ka/gotelegram_pro/main/install_gotelegram_bot.sh -o /tmp/install_gotelegram_bot.sh && sudo bash /tmp/install_gotelegram_bot.sh
```
При установке скрипт запросит **BOT_TOKEN** (получить у [@BotFather](https://t.me/BotFather)).
### Закрытый репозиторий (установка по ключу)
Для **приватного** репо используется клонирование по **SSH-ключу** или по **токену (PAT)**. Подробно: **[INSTALL_PRIVATE.md](../INSTALL_PRIVATE.md)** в корне репозитория.
Кратко:
- **По SSH:** скопируйте `bootstrap_install.sh` на сервер, затем
`GIT_REPO_SSH=git@github.com:USER/REPO.git sudo bash bootstrap_install.sh`
- **По токену:**
`GITHUB_TOKEN=ghp_xxx GIT_REPO_HTTPS=https://github.com/USER/REPO.git sudo -E bash bootstrap_install.sh`
- Или клонируйте репо вручную и запустите:
`sudo ./install_gotelegram_bot.sh`
### Локально (файлы уже рядом со скриптом)
```bash
sudo ./install_gotelegram_bot.sh
```
## Конфигурация
Файл: `/opt/gotelegram-bot/.env`
- **BOT_TOKEN** — токен от @BotFather (обязательно).
- **ALLOWED_IDS** — опционально. Список ID пользователей через запятую; если не задан, бот доступен всем.
После изменения `.env` перезапуск сервиса:
```bash
sudo systemctl restart gotelegram-bot
```
## Требования на сервере
- Linux (systemd), Docker, Python 3.
- Перед использованием бота на сервере должен быть установлен Docker (бот сам поднимает контейнер `nineseconds/mtg:2` по команде `/install`).
## Управление сервисом
```bash
sudo systemctl status gotelegram-bot
sudo systemctl restart gotelegram-bot
journalctl -u gotelegram-bot -f
```