4.0 KiB
NAS Config Web
Небольшой локальный веб-интерфейс на Flask/Gunicorn для управления только участками между
#begin marker и #end marker в файлах Caddyfile и dnsmasq.conf.
Поиск маркеров не зависит от регистра, поэтому вариант #Begin marker также поддерживается.
Важное правило безопасности
Приложению разрешено изменять текст только между двумя маркерами.
При каждой записи приложение:
- требует наличия ровно одного начального маркера и ровно одного конечного маркера;
- оставляет без изменений весь текст до начального маркера включительно;
- оставляет без изменений строку с конечным маркером и весь текст после неё;
- непосредственно перед записью выполняет дополнительную проверку и отменяет операцию, если какая-либо часть файла вне маркеров отличается от исходной;
- создаёт резервную копию файла с отметкой времени;
- атомарно заменяет конфигурационный файл;
- проверяет полную конфигурацию;
- перезагружает или перезапускает соответствующий сервис;
- восстанавливает исходный конфигурационный файл, если проверка или запуск сервиса завершились ошибкой.
Перегенерируется только управляемая часть между маркерами.
Существующие окончания строк CRLF/LF вне управляемой части сохраняются без изменений, так как чтение и запись выполняются с отключённым преобразованием окончаний строк.
dnsmasq
В веб-форме требуется указать только домен.
Все новые записи используют один общий IP-адрес, который задаётся в файле:
/etc/nas-config-web.env
Например:
DNSMASQ_TARGET_IP=192.168.7.251
Если в форме указать:
.arm.com
будет создана запись:
address=/.arm.com/192.168.7.251
Существующие записи с другим IP-адресом также отображаются в интерфейсе и могут быть удалены,
но все новые записи всегда используют значение DNSMASQ_TARGET_IP.
Проверка и применение конфигурации
Для Caddy выполняется:
caddy validate
После успешной проверки:
systemctl reload caddy
Для dnsmasq выполняется:
dnsmasq --test
После успешной проверки:
systemctl restart dnsmasq
Доступ к веб-интерфейсу
Приложение должно слушать только локальный адрес:
127.0.0.1
Доступ к нему рекомендуется организовать через Caddy с ограничением только для локальной сети.
Блок Caddy, который проксирует веб-интерфейс NAS Config Web, должен находиться вне управляемых маркеров, чтобы приложение никогда не изменяло собственную точку доступа.