Files
homelab-docs/README.md
Andrey 16c254510a Update documentation to centralize Vaultwarden integration details and enhance backup scripts
Refactor README, architecture, and backup documentation to emphasize the use of Vaultwarden for credential management across various services. Update scripts for Nextcloud, Gitea, Paperless, and others to reference Vaultwarden for sensitive information. Remove outdated references to previous backup strategies and ensure clarity on credential retrieval processes. This improves security practices and streamlines backup operations.
2026-02-28 00:52:56 +03:00

3.3 KiB
Raw Blame History

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

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

Точка входа: Архитектура и подключение — схема сети, IP, домены, таблица всех хостов.
Топология и риски: Схема сети и зависимости — узлы, маршруты NPM, зависимости сервисов, единые точки отказа (SPOF).
Приоритет №1: Бэкапы: как устроены и как восстанавливать — что бэкапится, куда, когда и как восстановить.


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

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

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

Интеграции: Paperless + Ollama — вопросы к документам Paperless через локальную LLM.


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

Документ О чём
Роутер Netcraze Speedster Доступ к роутеру, два VPN, маршрутизация, DNS
VPN-сервер (VPS, AmneziaWG) VPS для обхода блокировок, AmneziaWG, подключение клиента
Перенос конфигурации AmneziaWG Миграция конфига между серверами DE/USA
VPS Миран: боты и STUN/TURN Telegram-боты, prod, coTURN для Galene

SSL и прокси

Документ О чём
Let's Encrypt (DNS-01) Certbot, Beget API, выдача и продление сертификатов, интеграция с NPM

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