# Сервисы 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)
```
