Initial homelab docs

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-02-23 16:47:17 +03:00
commit ce731c28da
53 changed files with 6943 additions and 0 deletions

View File

@@ -0,0 +1,49 @@
# Проверка маршрута к доменам (VPN / Ethernet)
Скрипт проверяет, идёт ли трафик к заданным доменам через VPN (10.8.1.0) или через Ethernet. Результаты отдаются по HTTP и обновляются **каждые 15 минут** без ручного запуска.
## Быстрый старт (один раз настроил — дальше всё само)
**Шаг 1.** С хоста Proxmox скопировать папку в контейнер 100 и запустить контейнер:
```bash
# С Mac скопировать папку на Proxmox (если репо только на Mac):
scp -r /Users/andrejkatyhin/Work/plantUML/homelab/vpn-route-check root@192.168.1.150:/root/
# Зайти на Proxmox и запустить развёртывание:
ssh root@192.168.1.150
bash /root/vpn-route-check/deploy-on-proxmox.sh
```
Если репо уже есть на Proxmox (например в `/root/plantUML`):
```bash
ssh root@192.168.1.150
cd /root/plantUML/homelab/vpn-route-check
bash deploy-on-proxmox.sh
```
Контейнер поднимется, проверка будет запускаться при старте и **каждые 15 минут**, страница отдаётся на порту **8765** на 192.168.1.100.
**Шаг 2 (опционально).** Когда сервис доступен по http://192.168.1.100:8765 — можно добавить виджет в Homepage (фрагмент в `homepage-widget.yaml`). Сейчас виджет из дашборда убран: страница 8765 недоступна.
**Итоговая страница (в локальной сети):** **http://192.168.1.100:8765**
---
## Список доменов
По умолчанию проверяются домены из `domains.txt` в образе. Чтобы менять список без пересборки, раскомментируй в `docker-compose.yml` volume для `domains.txt` и перезапусти контейнер.
---
## Локальный запуск (без Docker)
Для разовой проверки с Mac:
```bash
python3 check_routes.py
# Результаты в output/index.html и output/results.json
```
Требуется: `traceroute`, `dig` (dnsutils).