# Документация инфраструктуры

Описание домашнего контура: Proxmox, контейнеры, сервисы, VPN, домены и способы подключения.

**Точка входа:** [Архитектура и подключение](docs/architecture/architecture.md) — схема сети, IP, домены, таблица всех хостов.  
**Топология и риски:** [Схема сети и зависимости](docs/network/network-topology.md) — узлы, маршруты NPM, зависимости сервисов, единые точки отказа (SPOF).  
**Приоритет №1:** [Бэкапы Proxmox (фаза 1)](docs/backup/proxmox-phase1-backup.md) — стратегия бэкапов LXC/VM и /etc/pve, тестовое восстановление.

---

## Homelab: контейнеры и ВМ

Подробные инструкции по каждому хосту (сервисы, конфиги, порты, бэкапы, TODO).

| Документ | Что внутри |
|----------|------------|
| [Контейнер 100](docs/containers/container-100.md) | NPM, AdGuard, log-dashboard, vpn-route-check |
| [Контейнер 101](docs/containers/container-101.md) | Nextcloud, PostgreSQL, Redis, хранилище «Игры» |
| [Контейнер 103](docs/containers/container-103.md) | Gitea, PostgreSQL, act_runner, CouchDB (Obsidian), Vaultwarden, Homepage, Wallos |
| [Контейнер 104](docs/containers/container-104.md) | Paperless-ngx, PostgreSQL, Redis |
| [Контейнер 105](docs/containers/container-105.md) | RAG API (mini-lm), модели, векторы |
| [Контейнер 107](docs/containers/container-107.md) | Invidious, Companion, PostgreSQL |
| [Контейнер 108](docs/containers/container-108.md) | Galene (видеозвонки), call.katykhin.ru |
| [ВМ 200](docs/containers/container-200.md) | Immich, PostgreSQL, Redis, ML (CUDA), deduper |

**Интеграции:** [Paperless + Ollama](docs/containers/paperless-ollama.md) — вопросы к документам Paperless через локальную LLM.

---

## Сеть, VPN и внешние серверы

| Документ | О чём |
|----------|--------|
| [Роутер Netcraze Speedster](docs/network/router-netcraze-speedster.md) | Доступ к роутеру, два VPN, маршрутизация, DNS |
| [VPN-сервер (VPS, AmneziaWG)](docs/vps/vpn-vps-amneziawg.md) | VPS для обхода блокировок, AmneziaWG, подключение клиента |
| [Перенос конфигурации AmneziaWG](docs/vps/vpn-migrate-config.md) | Миграция конфига между серверами DE/USA |
| [VPS Миран: боты и STUN/TURN](docs/vps/vps-miran-bots.md) | Telegram-боты, prod, coTURN для Galene |

---

## SSL и прокси

| Документ | О чём |
|----------|--------|
| [Let's Encrypt (DNS-01)](docs/network/ssl-letsencrypt-dns01.md) | Certbot, Beget API, выдача и продление сертификатов, интеграция с NPM |

Скрипты для NPM и сертификатов лежат в каталоге [scripts/](scripts/) (например `npm-cert-cloud.sh`, `npm-add-proxy.sh`).