docs: инфраструктура VM Сервисы + архитектура pulse-api и pulse-web

2026-04-02 10:43:44 +00:00
parent d4f3a10d0d
commit 20e1f3fa6c
31 changed files with 1843 additions and 0 deletions
--- a/Инфраструктура/Сервисы/README.md
+++ b/Инфраструктура/Сервисы/README.md
@@ -0,0 +1,112 @@
+# Сервисы VM 192.168.31.60
+
+Все Docker-сервисы развёрнуты в `/opt/digital-home/` на VM Сервисы.
+Общая сеть: `services_proxy` (создана в `services/docker-compose.yml`).
+Внешний трафик: Nginx Proxy Manager → домены `*.digital-home.site`.
+
+## Сводная таблица
+
+| Сервис | Папка | Домен | Порты (внешние) | Статус |
+|--------|-------|-------|-----------------|--------|
+| Nginx Proxy Manager | services/ | — (точка входа) | 80, 81, 443 | ✅ Up |
+| Gitea | gitea/ | git.digital-home.site | — (NPM) | ✅ Up |
+| Gitea Runner | gitea-runner/ | — | — | ✅ Up |
+| Homepage | homepage/ | home.digital-home.site | — (NPM) | ✅ Up |
+| Jellyfin | media/ | — | — (NPM) | ✅ Up |
+| qBittorrent | media/ | — | 6881 | ❌ Stopped |
+| Nextcloud | nextcloud/ | cloud.digital-home.site | 5433 (db) | ✅ Up |
+| Immich | photo/ | — | — (NPM) | ✅ Up |
+| Portainer | portainer/ | portainer.digital-home.site | — (NPM) | ✅ Up |
+| Uptime Kuma | uptime-kuma/ | — | — (NPM) | ✅ Up |
+| Vaultwarden | vault/ | vault.digital-home.site | — (NPM) | ✅ Up |
+| Vikunja | vikunja/ | tasks.digital-home.site | — (NPM) | ✅ Up |
+| Menu Bot | bots/menu/ | — | — | ❓ Unknown |
+| Review Bot | review-bot/ | — | 3300 | ✅ Up |
+| Cosmo Studio | cosmo-studio/ | — | — (NPM) | ✅ Up |
+| Pulse API | homelab-api/ | api.digital-home.site | 8081 (dev) | ✅ Up |
+| Pulse Web | pulse-web/ | pulse.digital-home.site | 5174 (dev) | ✅ Up |
+| Storybook | storybook/ | — | 6006 | ✅ Up |
+| Health Webhook | health-webhook/ | health.digital-home.site | 3200 | ✅ Up |
+| IT Tools | it-tools/ | — | — (NPM) | ✅ Up |
+| Savings | savings/ | — | — (NPM) | ❌ Stopped |
+| AdventureLog | adventurelog/ | — | — | ❌ Stopped |
+| LangLearn | langlearn/ | — | — | ❌ Stopped |
+| Lingua Learn | lingua-learn/ | — | — | ❌ Stopped |
+| My Game (Своя Игра) | my-game/ | — | — | ❌ Stopped |
+| Japan App | japan-app/ | — | — | ❌ Stopped |
+| VPN Invite | vpn-invite/ | — | 3500 | ✅ Up |
+| VPN Router | vpn-router/ | — | host network | ❌ Stopped |
+| Webhook Deploy | webhook-deploy/ | — | 9000 | ❓ Unknown |
+
+## Запущенные сервисы (docker ps)
+
+Статус на момент документирования (02.04.2026):
+
+```
+homelab-api          Up 19 hours
+vpn-invite           Up 21 hours
+cosmo-studio (x2)    Up 3 days
+uptime-kuma          Up 5 days  (healthy)
+jellyfin             Up 6 days  (healthy)
+gitea-runner         Up 6 days
+review-bot           Up 6 days
+health-webhook       Up 7 days
+pulse-web            Up 12 days
+pulse-web-dev        Up 4 weeks
+pulse-api-dev        Up 4 weeks
+storybook            Up 4 weeks
+nginx_proxy_manager  Up 26 hours
+homelab-db           Up 4 weeks (healthy)
+it-tools             Up 4 weeks
+homepage             Up 4 weeks (healthy)
+immich_server        Up 4 weeks (healthy)
+immich_redis         Up 4 weeks
+immich_postgres      Up 4 weeks
+immich_ml            Up 4 weeks (healthy)
+vikunja              Up 4 weeks
+vikunja_db           Up 4 weeks
+vaultwarden          Up 4 weeks (healthy)
+portainer            Up 4 weeks
+nextcloud_app        Up 4 weeks
+nextcloud_db         Up 4 weeks
+nextcloud_redis      Up 4 weeks
+gitea                Up 4 weeks
+```
+
+## Архитектура сети
+
+```
+Интернет
+    ↓
+Nginx Proxy Manager (80/443)
+    ↓ (services_proxy network)
+┌───────────────────────────────┐
+│  Все сервисы в одной сети     │
+│  services_proxy               │
+│                               │
+│  git.* → gitea:3000           │
+│  home.* → homepage:3000       │
+│  cloud.* → nextcloud_app:80   │
+│  vault.* → vaultwarden:80     │
+│  tasks.* → vikunja:3456       │
+│  portainer.* → portainer:9000 │
+│  api.* → homelab-api:8080     │
+│  pulse.* → pulse-web:80       │
+│  health.* → health-webhook:3200│
+└───────────────────────────────┘
+```
+
+## Паттерн добавления сервиса
+
+```bash
+mkdir /opt/digital-home/<name>
+cd /opt/digital-home/<name>
+
+# docker-compose.yml с сетью:
+networks:
+  services_proxy:
+    external: true
+
+docker compose up -d
+# Добавить proxy host в NPM UI (порт 81)
+```