131 lines
7.7 KiB
Markdown
131 lines
7.7 KiB
Markdown
# VPS Миран (СПБ): боты и STUN/TURN
|
||
|
||
VPS в ЦОД Миран (Санкт-Петербург). Развёрнуты два Telegram-бота (telegram-helper-bot, anonBot), инфраструктура prod (мониторинг, метрики), а также сервер STUN/TURN для Galene (call.katykhin.ru).
|
||
|
||
---
|
||
|
||
## Доступ и логины
|
||
|
||
- **SSH:** `ssh -p 15722 deploy@185.147.80.190` (пользователь deploy, в группе docker). IP: 185.147.80.190, хостнейм vm220416.vds.miran.ru, ОС Ubuntu.
|
||
- **S3 (контент ботов):** URL https://api.s3.miran.ru, порт 443. Access key: `j3tears100@gmail.com`, Secret key: `wQ1-6sZEPs92sbZTSf96` (полная таблица — в разделе «S3» ниже).
|
||
- **Админка Миран (панель хостинга VPS):** логин `j3tears100@gmail.com`, пароль `gonPok-xifrys-4nuxde`.
|
||
- **Grafana, Uptime Kuma, админки ботов:** логины и пароли — в `.env` проекта prod или в менеджере паролей.
|
||
|
||
---
|
||
|
||
## Что развёрнуто
|
||
|
||
### 1. Боты и prod (Docker Compose)
|
||
|
||
Проект в `/home/prod/`: `docker-compose.yml`, каталоги `bots/`, `infra/`, CI (GitHub Actions в `.github/`). Запуск от пользователя deploy.
|
||
|
||
| Сервис | Образ / контейнер | Порт | Назначение |
|
||
|------------------|---------------------|-------|--------------------------|
|
||
| telegram-bot | prod-telegram-bot | 8080 | telegram-helper-bot |
|
||
| anon-bot | prod-anon-bot | 8081 | anonBot |
|
||
| prometheus | prom/prometheus | 9090 | Метрики |
|
||
| alertmanager | prom/alertmanager | 9093 | Алерты |
|
||
| grafana | grafana/grafana | 3000 | Дашборды |
|
||
| uptime-kuma | louislam/uptime-kuma| 3001 | Мониторинг доступности |
|
||
|
||
Сеть контейнеров: `prod_bots_network` (bridge). Переменные окружения и секреты — в `.env` и настройках сервисов (в доку не дублируются).
|
||
|
||
### 2. STUN/TURN (Galene)
|
||
|
||
**coTURN** — системный сервис `coturn`, конфиг `/etc/turnserver.conf`.
|
||
|
||
- **Порты:** 3478/UDP (STUN/TURN), TLS/DTLS отключены (`no-tls`, `no-dtls`).
|
||
- **Realm:** call.katykhin.ru
|
||
- **External IP:** 185.147.80.190
|
||
- **Диапазон портов для релея:** 49152–49252
|
||
- Учётные данные для Galene заданы в конфиге (user/realm); на сервере Galene (контейнер 108) в настройках указывается этот TURN-сервер для обхода NAT.
|
||
|
||
Трафик с Galene (домашний сервер 192.168.1.108, call.katykhin.ru) уходит на этот VPS для STUN/TURN, чтобы видеозвонки работали при симметричном NAT и ограничениях провайдера.
|
||
|
||
### 3. S3 (контент ботов)
|
||
|
||
Объектное хранилище Миран (S3-совместимый API) для контента, который отдают боты (медиа, файлы). Доступ по HTTPS.
|
||
|
||
| Параметр | Значение |
|
||
|-------------|----------|
|
||
| URL | https://api.s3.miran.ru |
|
||
| Порт | 443 (HTTPS) |
|
||
| Access key | j3tears100@gmail.com |
|
||
| Secret key | wQ1-6sZEPs92sbZTSf96 |
|
||
|
||
В ботаx (переменные окружения prod) заданы `S3_ENDPOINT_URL=https://api.s3.miran.ru`, регион и креды для загрузки/выдачи контента. Для локальной разработки или других клиентов использовать те же endpoint и ключи.
|
||
|
||
**Бакет контента бота:** в S3 Miran используется бакет с именем `9829-telegram-helper-bot` (переменная `S3_BUCKET_NAME` в .env бота).
|
||
|
||
### 4. Остальное на хосте
|
||
|
||
- **nginx** — порты 80 и 443; по умолчанию отдаёт статику из `/var/www/html`.
|
||
- **prometheus-node-exporter** — порт 9100, метрики хоста для Prometheus.
|
||
- **vps-metrics** — systemd-сервис, API метрик для виджета Homepage (порт 3497).
|
||
- **cron** — по расписанию при необходимости.
|
||
|
||
---
|
||
|
||
## Порты (сводка)
|
||
|
||
| Порт | Служба / контейнер | Протокол |
|
||
|--------|--------------------------|----------|
|
||
| 15722 | SSH | TCP |
|
||
| 80, 443| nginx | TCP |
|
||
| 3478 | coturn (STUN/TURN) | UDP |
|
||
| 3497 | vps-metrics (Homepage) | TCP |
|
||
| 8080 | telegram-bot | TCP |
|
||
| 8081 | anon-bot | TCP |
|
||
| 9090 | Prometheus | TCP |
|
||
| 9093 | Alertmanager | TCP |
|
||
| 9100 | node-exporter | TCP |
|
||
| 3000 | Grafana | TCP |
|
||
| 3001 | Uptime Kuma | TCP |
|
||
|
||
---
|
||
|
||
## Управление ботами и prod
|
||
|
||
Рабочий каталог Compose: `/home/prod/`. От пользователя deploy:
|
||
|
||
```bash
|
||
cd /home/prod
|
||
docker compose ps
|
||
docker compose up -d
|
||
docker compose logs -f telegram-bot
|
||
```
|
||
|
||
Образы ботов собираются из репозитория (Dockerfile в проекте); деплой через Makefile / CI при необходимости.
|
||
|
||
---
|
||
|
||
## Связь с домашним контуром
|
||
|
||
- **Galene** (контейнер 108, call.katykhin.ru): в настройках сервера Galene указан TURN-сервер 185.147.80.190:3478 (realm call.katykhin.ru), чтобы клиенты за NAT могли устанавливать медиа-сессии через этот VPS.
|
||
- **Homepage** (контейнер 100): виджет метрик может показывать данные с vps-metrics (185.147.80.190:3497).
|
||
|
||
Остальные узлы homelab (Proxmox, NPM и т.д.) описаны в [архитектуре](../architecture/architecture.md).
|
||
|
||
---
|
||
|
||
## Бэкап VPS (telegram-helper-bot)
|
||
|
||
Бэкап выполняется **с хоста Proxmox** скриптом `backup-vps-miran.sh` (cron 01:00). Копируются:
|
||
|
||
1. **БД:** `/home/prod/bots/telegram-helper-bot/database/tg-bot-database.db` → `/mnt/backup/vps/miran/db/` (с датой в имени, хранение 14 дней).
|
||
2. **Голосовые сообщения:** `/home/prod/bots/telegram-helper-bot/voice_users/` → `/mnt/backup/vps/miran/voice_users/` (rsync).
|
||
3. **S3 (Miran):** полная выгрузка бакета `9829-telegram-helper-bot` → `/mnt/backup/vps/miran/s3/` (через `aws s3 sync`).
|
||
|
||
**Что нужно на Proxmox:**
|
||
|
||
- **SSH:** с хоста (root) должен работать вход без пароля на `deploy@185.147.80.190 -p 15722` (добавить публичный ключ хоста в `~/.ssh/authorized_keys` пользователя deploy на VPS).
|
||
- **S3:** установить `awscli` (`apt install awscli`) и создать файл `/root/.vps-miran-s3.env` с содержимым (подставить свои креды):
|
||
```bash
|
||
S3_ACCESS_KEY=j3tears100@gmail.com
|
||
S3_SECRET_KEY=...
|
||
S3_BUCKET_NAME=9829-telegram-helper-bot
|
||
```
|
||
Файл читается только root; в репозиторий не коммитить.
|
||
|
||
Подробности и восстановление — в [Бэкапы: как устроены и как восстанавливать](../backup/backup-howto.md).
|