
- Создайте коннектор
Проект → иконка «Hangar VPC» на левой панели → «Новый коннектор». Укажите имя и порты, например 5432 для PostgreSQL.
- Запустите агент
Кнопка «Команда агента» показывает команду docker run со своим токеном. Запустите её на своём сервере — входящие порты открывать не нужно.
- Используйте адрес
Когда статус станет «Агент подключён», сервисы окружения обращаются к
vpc-<имя>:<порт>.
Как это работает#
Hangar VPC — закрытый проход от сервисов проекта к вашему серверу, API или базе данных, которые не должны быть доступны из интернета. На вашем сервере работает маленький агент (открытый chisel 1.12.1): он сам подключается к Hangar по HTTPS, входящие порты открывать не нужно. Внутри окружения появляется адрес vpc-<имя>:<порт>, по которому к серверу обращаются сервисы окружения. Снаружи сервер по-прежнему не виден.
Пример для qala-maps: Meilisearch работает на вашем VPS и закрыт от прямого доступа. Создайте коннектор search с портом 7700 и запустите агент на VPS. API в Hangar принимает запрос пользователя, проверяет его и ходит в http://vpc-search:7700. Пользователь получает результаты, но до поискового сервера напрямую не добирается.
Где: проект → иконка «Hangar VPC» на левой панели. Коннектор принадлежит окружению; у каждого порта есть цель на вашей стороне (по умолчанию 127.0.0.1:<порт>, можно указать другой адрес вашей сети, например 10.0.0.5:5432). Статус «Агент подключён» обновляется сам.
# на вашем сервере (команда со своим токеном есть в панели: «Команда агента»)
docker run -d --name hangar-vpc-search --restart unless-stopped --network host \
jpillora/chisel:1.12.1 client --auth hangar:<токен> --keepalive 25s \
https://vpc-<id>.apps.hangar.rest R:7700:127.0.0.1:7700
# в сервисе Hangar
MEILI_URL=http://vpc-search:7700Безопасность и лимиты#
Безопасность: токен в команде агента разрешает открыть только порты этого коннектора, проброс в обратную сторону запрещён. Если токен утёк, нажмите «Токен» — старый перестанет работать. VPC даёт сетевой доступ, но не заменяет авторизацию и ограничения запросов в самом приложении. До 10 коннекторов на окружение и до 16 портов в каждом.
API#
GET /v1/environments/{id}/vpc # коннекторы, статус, команды агента
POST /v1/environments/{id}/vpc {"name": "search", "ports": [{"port": 7700, "label": "Meilisearch"}]}
PATCH /v1/vpc/{connectorID} {"name", "ports"}
POST /v1/vpc/{connectorID}/rotate-token
DELETE /v1/vpc/{connectorID}
