Update readme

2026-04-03 20:30:44 +04:00 · 2026-01-29 15:50:13 +04:00
parent 5b2b227601
commit e9d09ef2e9
15 changed files with 502 additions and 238 deletions
--- a/README.md
+++ b/README.md
@@ -1,50 +1,33 @@
 # Home Server Services

-> **Home Server Services** - это полный набор сервисов в Docker для организации домашнего сервера!
+> **Home Server Services** - это гайд по настройке и полный набор сервисов в Docker для организации домашнего роутера/сервера!
 >
-> Главное - это **модульность** и **воспроизводимая установка**. Можно развернуть за 15 минут!
+> Главное - это **модульность** и **воспроизводимая установка**. Можно развернуть за 30 минут!

 ![](./screenshots/grafana.jpg)
 ![](./screenshots/portainer.jpg)

 ## Мой сервер:

- CheckWay POS88
+- CheckWay Sherman Micro
  - [Intel Celeron J1900](https://technical.city/ru/cpu/Core-2-Duo-E8400-protiv-Celeron-J1900) @ 1.99GHz (64 bit)
-  - 4Gb RAM
+  - 8Gb RAM
  - 120Gb SSD
-  - Не греется, не шумит, мало потребляет
- Debian 13 (Trixie) Minimal
-  - [Docker](https://www.docker.com/)
-  - [Docker Compose](https://docs.docker.com/compose/)
-  - Политика частоты работы CPU - `ondemand`
-
-## Сервисы:
-
- [Portainer](./portainer/) - Управление контейнерами
- [Grafana](./grafana/) - Загруженность сервера
-  - [Prometheus](./grafana/prometheus.yml)
-  - [Node Exporter](./grafana/)
- [Proxy](./proxy/) - Reverse proxy
-  - [Nginx](./proxy/nginx/)
-  - [DDNS](./proxy/ddns/) - Автоматическое обновление DNS записей у регистратора [рег.ру](https://www.reg.ru)
-  - Let's Encrypt - Автоматическое обновление SSL сертификатов на все домены
- [Samba](./samba/) - Сетевой диск
- [Syncthing](./syncthing/) - Синхронизация данных между устройствами
- [Transmission](./transmission/) - BitTorrent клиент
- [AutoSSH](./autossh/) - SSH тунель
- [Gitea](./gitea/) - Git-сервер
- [Cloud](./cloud/) - FileBrowser - веб-интерфейс для управления файлами
- [Matrix](./matrix/) - сервер Matrix
-  - [Synapse](./matrix/create_config.sh) - Matrix сервер Synapse
-  - [Element](./matrix/docker-compose.yml) - Matrix веб-клиент Element
- [Pi-hole](./pihole/) - DNS фильтр (блокировка рекламы, слежки, защита от атак)
+  - 2x 1Gbps (WAN+LAN)
+- Proxmox VE 9.1.4
+  - OPNsense 25.7
+    - [CrowdSec](https://www.crowdsec.net)
+  - Debian 13 (Trixie) Minimal
+    - [Podman](https://podman.io)

 ## О проекте:

 - **Полнофункциональный домашний сервер**
- **Все сервисы настроены через Docker Compose** для легкого управления и быстрого запуска
- **Мониторинг системы через Grafana** с готовыми дашбордами
+- Две одновременно запущенные операционные системы запущенны в гипервизоре Proxmox
+  - OPNsense выполняет функции роутера, DHCP и NTP сервера, защищает домашнюю сеть от вторжений с CrowSec
+  - В Debian в Podman запущены контейнеры с сервисами
+- **Все сервисы настроены через Docker Compose (совместим с Podman)** для легкого управления и быстрого запуска
+- **Мониторинг системы через Grafana** с готовым дашбордом
 - **Файловый сервер Samba** для доступа к файлам по сети
  - Открытый диск только на чтение
  - Доступ на запись только после авторизации
@@ -56,172 +39,21 @@
 - **Nginx reverse proxy** для маршрутизации трафика к сервисам
  - Автоматическое получение и обновление SSL сертификатов через Let's Encrypt
  - Автоматическое обновление DNS записей у регистратора [рег.ру](https://www.reg.ru)
- **Git-сервер Gitea** для хостинга собственных репозиториев
+- **Git-сервер Gitea** для хостинга репозиториев
 - **FileBrowser** - веб-интерфейс для управления файлами через браузер
 - **Matrix Synapse** - собственный сервер для мессенджера Matrix с веб-клиентом Element
 - Блокировка рекламы, нежелательной слежки, частичная защита от атак с помощью **Pi-hole**
- Управление Docker через **Portainer с веб-интерфейсом**
- Скрипт для снижения энергопотребления
- Все **сервисы используют переменные окружения** для гибкой настройки и примеры конфигураций
- Автоматический перезапуск контейнеров при сбоях
+- Управление контейнерами через **Portainer**
+- Все **сервисы используют переменные окружения** для гибкой настройки и примеры конфигурации

 ## Подготовка:

 - Купить белый IP адрес у провайдера
- В настройках роутера пробросить 80 и 443 порт на сервер
 - Купить домен второго уровня у регистратора [рег.ру](https://www.reg.ru)
 - [В настройках API рег.ру](https://www.reg.ru/user/account/settings/api/) добавить CIDR вашего провайдера (чтобы при смене IP наш скрипт смог обновить DNS записи)
 - В настройках DNS-серверов зоны указать бесплатные DNS-серверы рег.ру: `ns1.reg.ru`, `ns2.reg.ru`

-## Запуск:
-
-### 1. Portainer
-
-```bash
-cd portainer
-cp .env.example .env && vim .env
-sudo docker compose up -d
-```
-
-### 2. Grafana
-
-```bash
-cd grafana
-cp .env.example .env && vim .env
-sudo docker compose up -d
-```
-
-### 3. AutoSSH
-
-```bash
-cd autossh
-cp .env.example .env && vim .env
-sudo docker compose up -d --build
-```
-
-### 4. Samba
-
-```bash
-cd samba
-cp .env.example .env && vim .env
-sudo docker compose up -d
-```
-
-### 5. Transmission
-
-```bash
-cd transmission
-cp .env.example .env && vim .env
-sudo docker compose up -d
-```
-
-### 6. Syncthing
-
-```bash
-cd syncthing
-cp .env.example .env && vim .env
-sudo docker compose up -d
-```
-
-### 7. Gitea
-
-```bash
-cd gitea
-cp .env.example .env && vim .env
-sudo docker compose up -d
-```
-
-> **Примечание:** Конфигурируется позже, уже в веб-форме.
-
-### 8. Cloud (FileBrowser)
-
-```bash
-cd cloud
-cp .env.example .env && vim .env
-touch filebrowser.db
-sudo docker compose up -d
-```
-
-### 9. Matrix
-
-```bash
-cd matrix
-cp .env.example .env && vim .env
-```
-
-Создаём конфиг [по примеру](./matrix/create_config.sh). Меняем базу данных на PostgreSQL:
-
-```yaml
-database:
-  name: psycopg2
-  args:
-    user: user
-    password: passw0rd
-    database: db
-    host: matrix-db
-    cp_min: 5
-    cp_max: 10
-```
-
-Запускаем:
-
-```bash
-sudo docker compose up -d
-```
-
-Создаём пользователя [по примеру](./matrix/create_user.sh).
-
-### 10. Pi-hole
-
-```bash
-cd pihole
-cp .env.example .env && vim .env
-sudo docker compose up -d
-```
-
-[Устанавливаем пароль](./pihole/set-password.sh) (оставить пустым для доступа без пароля)
-
-В разделе Settings > DNS выбираем вышестоящие DNS сервер. Включаем сверху расширенные настройки и в блоке interface settings выбираем пункт `Permit all origins`. В разделе Lists добавляем [списки доменов для блокировки](./pihole/block-lists.txt). Затем обновляем их в Tools > Update Gravity. В настройках ПК (роутера) устанавливаем в качестве DNS наш сервер.
-
-### 11. Nginx Reverse Proxy (Entrypoint)
-
-```bash
-cd proxy
-cp .env.example .env && vim .env
-```
-
-Создаём конфиг для DynDNS:
-
-```bash
-cp ddns/domains.txt.example ddns/domains.txt && vim ddns/domains.txt
-```
-
-Нужно указать ресурсные записи `@` и `www` для доступа к домену второго уровня напрямую. Также нужно добавить домены 3-го уровня для: gitea, cloud (filebrowser), matrix server (synapse), matrix client (element).
-
-В первый раз SSL сертификаты нужно создать вручную.
-
-Запускаем DDNS скрипт и HTTP сервер для Let's Encrypt:
-
-```bash
-sudo docker compose -f init-compose.yml up -d --build
-```
-
-Проверяем по логам в portainer и в личном кабинете рег.ру что ресурсные записи обновились. Ожидаем пока DNS обновит информацию о наших поддоменах (занимает от 15 минут до 24 часов). Затем создаём SSL сертификаты на каждый домен(-ы) [по примеру](./proxy/create-first-cert-example.sh).
-
-Настраиваем Nginx:
-
-```bash
-cd nginx/conf.d
-cp default.conf.example default.conf
-vim default.conf
-```
-
-Запускаем основной контейнер:
-
-```bash
-sudo docker compose -f init-compose.yml down
-sudo docker compose up -d --build
-```
+После этих шагов можно переходить к настройке сервера. **[Первым шагом установим гипервизор Proxmox](./Proxmox.md)**

 ## Использование: