From 21798c0cc2564deae7033d9eee3054ae7fcb8ac3 Mon Sep 17 00:00:00 2001
From: zailon <zailon@bk.ru>
Date: Tue, 14 Apr 2026 14:08:28 +0500
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?=
 =?UTF-8?q?=D1=8C=20README.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a8d920f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,55 @@
+# Домашний сервер Olimp
+
+Документация по инфраструктуре домашнего сервера, работающего под управлением Proxmox VE, с набором LXC-контейнеров и виртуальных машин. Основная цель — создание независимой мультимедийной платформы с доступом из внешней сети через домен `zailon.ru`.
+
+**Ansible-репозиторий** обеспечивает автоматизированное развертывание и обслуживание всех сервисов. Вся конфигурация описана в коде и может быть воспроизведена за несколько команд.
+
+## 📖 Содержание
+
+### Железо и гипервизор
+- [Железо](docs/01-hardware.md)
+- [Гипервизор Proxmox](docs/02-hypervisor.md)
+- [Виртуальные машины и LXC](docs/03-vms-lxcs.md)
+
+### Сеть и доступ
+- [Сеть и доступ](docs/04-network.md)
+- [OlimpVPN — внешний VPN-сервер](docs/04b-olimpvpn.md)
+- [Проксирование и SSL (NPM)](docs/07-proxy-ssl.md)
+
+### Сервисы и данные
+- [Samba – файловые шары](docs/05-samba.md)
+- [Сервисы и порты](docs/06-services.md) *(в разработке)*
+- [Мониторинг и логирование](docs/08-monitoring.md)
+
+### Управление конфигурацией (Ansible)
+- [Общее описание репозитория](docs/09-ansible-overview.md)
+- [Переменные и окружение](docs/09-ansible-variables.md)
+- [Плейбуки и запуск](docs/09-ansible-playbooks.md)
+- [Роли (roles)](docs/09-ansible-roles.md)
+- [Архивные роли](docs/09-ansible-archive-roles.md)
+- [Инвентарь](docs/09-ansible-inventory.md)
+- [Защищённые данные (vault)](docs/09-ansible-vault.md)
+
+### Эксплуатация
+- [Безопасность](docs/10-security.md)
+- [Резервное копирование](docs/11-backup.md)
+- [Решение проблем](docs/12-troubleshooting.md)
+- [Плановое обслуживание](docs/13-maintenance.md)
+
+---
+
+## 🚀 Краткий обзор
+
+- **Гипервизор**: Proxmox VE 9.0 на Intel Core i7-8700, 12 потоков, 32 ГБ ОЗУ.
+- **Хранилище**: RAID6 (4×8 ТБ) через LSI MegaRAID 9260-8i, логические тома для ВМ и LXC.
+- **Сеть**: локальная подсеть 192.168.1.0/24, VPN-подсеть 192.168.45.0/24 (OpenVPN).
+- **Домен**: zailon.ru → внешний IP 188.73.191.202.
+- **Внешний VPN**: OlimpVPN (VLESS + Reality) на VPS 2.27.50.20 (Финляндия) — обход блокировок.
+- **Основные сервисы**: Jellyfin, Immich, Nextcloud, Bitwarden, GitLab, Grafana и др.
+- **Автоматизация**: Ansible, все роли используют Docker Compose, шаблоны Jinja2, обработчики, переменные разделены на `group_vars/all.yml` и `vault.yml`.
+
+---
+
+## 📝 Статус
+
+Документация актуальна на 25 марта 2026 года. Регулярно обновляется по мере изменений в инфраструктуре.
\ No newline at end of file