69 lines
2.9 KiB
Markdown
69 lines
2.9 KiB
Markdown
# Stage UI в Cursor Browser
|
||
|
||
Chromium / Cursor IDE Browser часто **не резолвят** `*.eventhub.local` (mDNS), даже если Windows/`nslookup` через OpenWRT уже видят stage.
|
||
|
||
Для агентов и ручного просмотра stage используем **локальный alias + HTTP-прокси**.
|
||
|
||
## URL
|
||
|
||
| Открывать в браузере | Upstream |
|
||
|----------------------|----------|
|
||
| `http://ui.stage.eventhub.test:8787` | `https://ui.stage.eventhub.local` → `195.208.119.190` |
|
||
|
||
## Одноразовая настройка hosts
|
||
|
||
В `C:\Windows\System32\drivers\etc\hosts` (или WSL `/etc/hosts` не помогает Cursor на Windows):
|
||
|
||
```text
|
||
127.0.0.1 ui.stage.eventhub.test
|
||
```
|
||
|
||
## Прокси
|
||
|
||
Скрипт в репозитории: [`scripts/stage-browser-alias-proxy.mjs`](scripts/stage-browser-alias-proxy.mjs)
|
||
|
||
Копия для быстрого старта агента: `~/.cursor/eventhub/stage-browser-alias-proxy.mjs` (если есть — можно любой из двух).
|
||
|
||
**Важно:** процесс должен слушать на **Windows** `127.0.0.1:8787` (Node из Windows). Прокси только в WSL Cursor с Windows часто не достучится.
|
||
|
||
```powershell
|
||
Start-Process -FilePath "C:\Program Files\nodejs\node.exe" `
|
||
-ArgumentList "$env:USERPROFILE\.cursor\eventhub\stage-browser-alias-proxy.mjs" `
|
||
-WindowStyle Hidden
|
||
```
|
||
|
||
Или из Spec (если скрипт уже скопирован в `~/.cursor/eventhub/`):
|
||
|
||
```powershell
|
||
# из корня EventHubSpec
|
||
Start-Process -FilePath "C:\Program Files\nodejs\node.exe" `
|
||
-ArgumentList (Resolve-Path ".\scripts\stage-browser-alias-proxy.mjs") `
|
||
-WindowStyle Hidden
|
||
```
|
||
|
||
Проверка: открыть `http://ui.stage.eventhub.test:8787/login`.
|
||
|
||
Переменные окружения (опционально):
|
||
|
||
| Env | Default |
|
||
|-----|---------|
|
||
| `ALIAS_LISTEN_HOST` | `127.0.0.1` |
|
||
| `ALIAS_LISTEN_PORT` | `8787` |
|
||
| `STAGE_IP` | `195.208.119.190` |
|
||
| `STAGE_UI_HOST` | `ui.stage.eventhub.local` |
|
||
| `ALIAS_HOST` | `ui.stage.eventhub.test` |
|
||
|
||
## Auth
|
||
|
||
Same-origin через прокси: `/v1/login`, `/v1/register`, logout — как на настоящем stage.
|
||
|
||
- Smoke: `~/.cursor/secrets/eventhub-stage.env` (`SMOKE_USER_*`).
|
||
- IFT e2e: только `~/.cursor/secrets/eventhub-ift.env` (не подмешивать stage).
|
||
- Прокси **не** подставляет пользователя: только Host/SNI rewrite на Traefik.
|
||
|
||
## Что не делать
|
||
|
||
- Не ждать, что Cursor Browser сам пойдёт на `https://ui.stage.eventhub.local`.
|
||
- Не поднимать прокси только в WSL, если агентский браузер на Windows.
|
||
- Не коммитить пароли/токены из smoke env.
|