Параметры серверной установки

Серверные параметры задаются в .env каталога deploy. Настройки форм, ролей и процессов меняются в продукте. Эти уровни не заменяют друг друга.

Основные параметры

Параметр	Назначение
APP_IMAGE	Проверенный неизменяемый образ приложения
COMPOSE_PROJECT_NAME	Уникальное имя установки, определяющее её ресурсы Docker
DOMAIN	Домен без протокола, например helpdesk.example.com
ATTACHMENTS_STORAGE	disk или s3
POSTGRES_IMAGE	Закреплённый образ PostgreSQL 17 из комплекта
CADDY_IMAGE	Закреплённый образ HTTPS-прокси
NDESK_TRUSTED_PROXY_IPS	Точные доверенные IP прокси для аудита, когда требуется

runtime содержит сгенерированные секреты и сертификаты. Не копируйте его поверх другой установки. Ключ шифрования существующих данных нельзя заменять новым.

В этом комплекте используйте простой формат KEY=value: без export, кавычек, повторяющихся ключей и пробелов по краям значения. Например, ATTACHMENTS_STORAGE=disk, а не ATTACHMENTS_STORAGE="disk". Операторские команды дополнительно проверяют этот формат; возможности произвольного dotenv-файла здесь не обещаются.

Для COMPOSE_PROJECT_NAME выберите не менее двух символов: строчные латинские буквы, цифры, _ и -, начиная с буквы или цифры. Это ограничение операторского комплекта. Не меняйте имя существующей установки ради её переименования: команда обратится к другому набору ресурсов.

Как применить изменение

Сделайте копию, согласуйте окно и отредактируйте только нужные параметры. sh ngensia.sh start применяет подготовленную конфигурацию приложения; для S3 оболочка подключает дополнительный Compose-файл. Это не универсальная команда обновления всех частей установки.

• После изменения DOMAIN нужно обновить приложение и отдельно проверить/перезапустить proxy по инструкции HTTPS, иначе адрес входа и ожидаемый AUTH_ORIGIN могут различаться. Команда start сама не пересоздаёт proxy.
• APP_IMAGE меняйте через проверенный сценарий обновления, а не как обычную настройку. Для POSTGRES_IMAGE и CADDY_IMAGE требуется отдельная проверка инфраструктурного комплекта и совместимости; обновление приложения не обещает обновление базы или прокси.
• ATTACHMENTS_STORAGE меняйте только по сценарию переноса файлов, не одним редактированием .env.

Изменение места хранения

Смена disk на s3 не переносит вложения. Смена имени Compose-проекта не переносит базу. Сначала выполните отдельный сценарий миграции.

Границы безопасности

Не публикуйте порт PostgreSQL. Не давайте приложению DDL-права. Доступ к Docker считайте административным. Храните .env, приватные ключи и конфигурацию копий вне Git и публичной документации.

Сертификаты внутреннего PostgreSQL имеют срок действия; включите его в эксплуатационный контроль, не ждите отказа соединения.

Домен и HTTPS · S3 · Безопасность