Змінні середовища

Більшість налаштувань є у вебінтерфейсі в Settings. А ці задаються в середовищі.

Змінні середовища

Змінна	За замовчуванням	Що робить
PORT	5173	Порт вебінтерфейсу.
TIMEZONE	UTC	Твій часовий пояс, наприклад America/New_York.
LOCAL_NETWORKS	порожньо	Додаткові мережі CIDR, яким не треба входити. Через кому.
TRUSTED_PROXIES	порожньо	Мережі CIDR зворотних проксі, яким довіряють задавати X-Forwarded-For та X-Real-IP.
APP_SECRET	авто	Корінь шифрування для збережених облікових даних. Якщо не задано, під час першого запуску генерується в /config/app_secret. Задай його, щоб ключ не лежав на диску з конфігурацією.
DOCS_ENABLED	true	Віддає документацію API на /api/docs, /api/redoc та /api/openapi.json. false її прибирає.
SECURITY_HEADERS_CSP_ENABLED	true	Надсилає заголовок Content-Security-Policy, який обмежує інтерфейс власними скриптами, стилями та API ABM, плюс обкладинками через HTTPS. false його прибирає. Вбудовування у фрейми заблоковано в будь-якому разі.
MAX_REQUEST_BODY_BYTES	10485760	Найбільше тіло запиту, яке приймає ендпоінт (10 MiB). Більше отримає HTTP 413. Відновлення з резервної копії та завантаження обкладинки мають власні ліміти.

Локальні мережі

Loopback, приватні діапазони (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16), link-local та унікальні локальні адреси IPv6 уже вважаються локальними. Коли Authentication Required стоїть у режимі для локальних адрес, запит із них не потребує входу. Щоб додати ще, перелічи їх:

LOCAL_NETWORKS=203.0.113.0/24

Зворотний проксі

Якщо ABM стоїть за nginx, Traefik чи чимось подібним, задай TRUSTED_PROXIES як адресу проксі:

TRUSTED_PROXIES=172.20.0.5

• Тримай її якомога вужчою. Вказуй адресу самого проксі, а не широку підмережу Docker.
• Проксі на тому самому хості потребує TRUSTED_PROXIES=127.0.0.1.
• Клієнтом вважається лише той, кого проксі називає в X-Forwarded-For чи X-Real-IP.
• Передавай оригінальний заголовок Host (nginx: proxy_set_header Host $host;) або надсилай X-Forwarded-Host. Запит із браузера, який щось змінює, відхиляється, якщо його походження не збігається з адресою, за якою відкрито ABM, або з доменом зі списку дозволених доменів CORS.
• Проксі, який не надсилає заголовків пересилання, виглядає як локальний клієнт. Якщо в тебе такий, задай Authentication Required як Enabled.

Якщо вхід вимагається тоді, коли не мав би, дивись Усунення несправностей.

Більше

• Режими входу, ключі API та політика безпеки вмісту: Безпека та вхід.
• Повний покроковий опис проксі: Зворотний проксі.
• BACKUP_RESTORE_UPLOAD_MAX_BYTES (за замовчуванням 500 MiB) обмежує завантаження для відновлення з резервної копії.
• Усе інше є в застосунку в Settings. Дивись Огляд налаштувань.