Домены и SSL

Домены есть только у Web-сервисов — они принимают трафик из интернета. Worker домена не получает.

Поддомен по умолчанию

При создании Web-сервиса вы выбираете имя, и сервис сразу получает адрес вида:

<имя>.apps.hostim.app

Сертификат TLS для него выпускается автоматически (Let's Encrypt) при первом успешном деплое — сервис доступен по HTTPS без каких-либо действий с вашей стороны.

Собственный домен

Чтобы сервис отвечал на вашем домене (например, example.com), нужно два шага: направить домен на платформу через DNS и добавить его в настройках сервиса.

Шаг 1. Настройте DNS

Добавьте у своего DNS-провайдера запись, которую платформа показывает при добавлении домена. Как правило:

• для корневого домена (example.com) — A-запись на IP-адрес платформы;
• для поддомена (app.example.com) — CNAME на ваш адрес <имя>.apps.hostim.app.

Точные значения указаны в панели — используйте их.

Шаг 2. Добавьте домен в сервисе

В настройках сервиса добавьте свой домен. Сертификат TLS выпустится автоматически, как только домен начнёт указывать на платформу. Отдельно покупать или загружать сертификат не нужно.

Порядок имеет значение. Настройте DNS до добавления домена — тогда сертификат выпустится с первой попытки. Если добавить домен раньше, чем DNS распространится, платформа продолжит проверять его и активирует HTTPS автоматически, как только домен начнёт резолвиться на неё.

Добавление домена перезапускает сервис

Добавление и удаление собственного домена применяются немедленно и перезапускают контейнер сервиса. Это нужно, чтобы перегенерировать конфигурацию маршрутизации и выпустить сертификат. Перезапуск короткий, но на его время сервис недоступен — планируйте изменение домена на момент низкой нагрузки. Поддомена по умолчанию это не касается (он настраивается при первом деплое).

Статусы сертификата

• pending — сертификат ещё не выпущен. Обычно означает, что DNS пока не указывает на платформу или запись не успела распространиться.
• active — сертификат выпущен, домен работает по HTTPS.

Переход из pending в active происходит автоматически — платформа периодически перепроверяет домены в ожидании.

Частые ошибки

Дальше

• Web или Worker — что выбрать
• Архитектура платформы
• Почему падает деплой или контейнер