7.5 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
Установка
1. Установка системных пакетов
На Debian 13 установите необходимые пакеты:
sudo apt update
sudo apt install -y python3-venv unzip
2. Размещение приложения
Распакуйте архив приложения и разместите его в /opt/nas-config-web.
Например:
sudo mkdir -p /opt/nas-config-web
sudo unzip nas-config-web.zip -d /opt/
После распаковки в каталоге /opt/nas-config-web должны находиться как минимум:
app.py
requirements.txt
nas-config-web.service
nas-config-web.env.example
README.md
3. Создание Python-окружения
Создайте виртуальное окружение:
sudo python3 -m venv /opt/nas-config-web/venv
Установите зависимости:
sudo /opt/nas-config-web/venv/bin/pip install \
-r /opt/nas-config-web/requirements.txt
4. Настройка приложения
Скопируйте пример файла настроек:
sudo cp /opt/nas-config-web/nas-config-web.env.example \
/etc/nas-config-web.env
Откройте его для редактирования:
sudo nano /etc/nas-config-web.env
Пример настроек:
ADMIN_USER=admin
ADMIN_PASSWORD=замените_на_надёжный_пароль
APP_SECRET=замените_на_случайную_строку
CADDYFILE=/etc/caddy/Caddyfile
DNSMASQ_CONF=/etc/dnsmasq.conf
DNSMASQ_TARGET_IP=192.168.7.251
BACKUP_DIR=/var/backups/nas-config-web
LAN_NETWORKS=192.168.7.0/24,10.10.10.0/24
MAX_BACKUPS=50
Случайную строку для APP_SECRET можно создать командой:
openssl rand -hex 32
Ограничьте доступ к файлу настроек:
sudo chmod 600 /etc/nas-config-web.env
5. Установка службы systemd
Скопируйте unit-файл:
sudo cp /opt/nas-config-web/nas-config-web.service \
/etc/systemd/system/nas-config-web.service
Перечитайте конфигурацию systemd:
sudo systemctl daemon-reload
Включите автозапуск и сразу запустите приложение:
sudo systemctl enable --now nas-config-web
Проверьте состояние:
sudo systemctl status nas-config-web
При нормальной работе статус должен содержать:
Active: active (running)
6. Просмотр журналов
Для просмотра последних сообщений:
sudo journalctl -u nas-config-web -n 100 --no-pager
Для просмотра журнала в реальном времени:
sudo journalctl -u nas-config-web -f
7. Локальная проверка
По умолчанию приложение должно быть доступно только на:
127.0.0.1:8090
Проверить его с самого мини-ПК можно командой:
curl http://127.0.0.1:8090
Если приложение отвечает, можно настраивать доступ к нему через Caddy.
Доступ к веб-интерфейсу
Приложение должно слушать только локальный адрес:
127.0.0.1
Доступ к нему рекомендуется организовать через Caddy с ограничением только для локальной сети.
Блок Caddy, который проксирует веб-интерфейс NAS Config Web, должен находиться вне управляемых маркеров, чтобы приложение никогда не изменяло собственную точку доступа.
Пример
proxy.stadidisk.ru {
@lan remote_ip 192.168.7.0/24 10.10.10.0/24
handle @lan {
reverse_proxy 127.0.0.1:8090
}
respond "Forbidden" 403
}