Andrey 53769e6832 Update architecture and backup documentation to include Healthchecks integration
Add Healthchecks service details to architecture and backup documentation, including its role as a Dead man's switch for backups. Update backup scripts to utilize systemd timers instead of cron for improved scheduling. Enhance network topology documentation to reflect Healthchecks integration in the VPS Miran setup. This update clarifies backup processes and enhances overall system reliability.
2026-02-28 15:43:39 +03:00
2026-02-25 21:01:06 +03:00

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

Описание домашнего контура: 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).

Description
Основная документация по моим сервисам и контуру
Readme 679 KiB
Languages
Shell 84.2%
HTML 8.2%
Python 7.6%