- Updated the reverse proxy to redirect `GET` requests for `/api/{alias}/users` to `/v1/stats/users`, ensuring compatibility with Telemt builds that handle these requests differently.
- Added tests to verify that `GET` and `HEAD` requests to `/api/{alias}/users` are correctly rewritten, while `POST` requests and user-specific retrievals remain unchanged.
- Improved documentation in GATEWAY_RUN.md to clarify the behavior of the API routing and the importance of using the correct base URL.
Telemt Panel (Web UI)
SvelteKit + shadcn-svelte. В production статика собирается и встраивается в образ шлюза (Dockerfile в корне репозитория): панель и API на одном порту (например http://127.0.0.1:8080/ — UI, /api/… — шлюз).
Переменная PUBLIC_TELEMT_GATEWAY_URL
| Значение | Когда |
|---|---|
| (пусто) | Тот же хост и порт, что у страницы (Docker-образ шлюза, npm run build в Dockerfile с ENV PUBLIC_TELEMT_GATEWAY_URL=) |
http://127.0.0.1:8080 |
Локальная разработка: Vite на :5173, шлюз на :8080 |
Скопируйте .env.example в .env и при необходимости задайте URL.
Разработка (Vite отдельно от Go)
cd web
npm install
npm run dev
Откройте http://localhost:5173. В конфиге шлюза включите CORS для этого origin:
cors_allowed_origins:
- "http://localhost:5173"
Сборка только фронта
npm run build
Артефакт — каталог build/, при сборке Docker-образа шлюза он копируется в internal/webui/static/ и попадает в бинарник через embed.
Типы из OpenAPI агрегатов
npm run gen:api
Источник: ../docs/AGGREGATE_OPENAPI.yaml.
Ограничения
- Секреты upstream к Telemt задаются на шлюзе (
authorization_env), не в браузере. - Для мутаций из другого origin шлюз отдаёт нужные заголовки CORS (в т.ч. методы
POST,PATCH,DELETE).