docs: add persistent project context and NPM deployment notes

This commit is contained in:
2026-04-13 20:15:51 +00:00
parent 89f705c533
commit 6095d53854
3 changed files with 141 additions and 2 deletions

View File

@@ -164,6 +164,38 @@ docker compose logs -f api traefik
https://<PUBLIC_HOST>/admin
```
## 5.2 Вариант С Nginx Proxy Manager (NPM)
Если на сервере уже используется NPM, внешний трафик можно вести через него, а Traefik оставить только внутренним роутером проекта.
В этом репозитории уже настроены внутренние порты:
- `127.0.0.1:2288 -> traefik:443` (HTTPS upstream)
- `127.0.0.1:8288 -> traefik:80` (HTTP upstream, технический)
Важно: Traefik убирать нельзя, он нужен для динамических маршрутов сессий (`/s/*`, `/svc/*`).
Как настроить NPM:
1. Создать `Proxy Host` для домена (например `stend.example.com`):
- `Forward Hostname / IP`: `127.0.0.1`
- `Forward Port`: `2288`
- `Scheme`: `https`
- включить `Websockets Support`
2. На вкладке SSL в NPM выпустить/подключить сертификат для домена.
3. В `.env` проекта оставить:
- `PUBLIC_HOST=stend.example.com`
4. Перезапустить проект:
```bash
docker compose up -d --build
```
После этого вход в портал и сессии будут работать через NPM, а Traefik останется внутренним компонентом.
## 6. Примеры admin API
1) Создать сервис WEB: