На этой странице
Hangar VPC
Коннектор office-erp: два порта на сервере компании, адреса vpc-office-erp:5432 и :8069 для сервисов окружения.
  1. Создайте коннектор

    Проект → иконка «Hangar VPC» на левой панели → «Новый коннектор». Укажите имя и порты, например 5432 для PostgreSQL.

  2. Запустите агент

    Кнопка «Команда агента» показывает команду docker run со своим токеном. Запустите её на своём сервере — входящие порты открывать не нужно.

  3. Используйте адрес

    Когда статус станет «Агент подключён», сервисы окружения обращаются к 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}