First commit. Вайб кодинг сделал сервис v1.0
This commit is contained in:
@@ -0,0 +1,96 @@
|
||||
# NAS Config Web
|
||||
|
||||
Небольшой локальный веб-интерфейс на Flask/Gunicorn для управления только участками между
|
||||
`#begin marker` и `#end marker` в файлах Caddyfile и dnsmasq.conf.
|
||||
|
||||
Поиск маркеров не зависит от регистра, поэтому вариант `#Begin marker` также поддерживается.
|
||||
|
||||
## Важное правило безопасности
|
||||
|
||||
Приложению разрешено изменять текст **только между двумя маркерами**.
|
||||
|
||||
При каждой записи приложение:
|
||||
|
||||
1. требует наличия ровно одного начального маркера и ровно одного конечного маркера;
|
||||
2. оставляет без изменений весь текст до начального маркера включительно;
|
||||
3. оставляет без изменений строку с конечным маркером и весь текст после неё;
|
||||
4. непосредственно перед записью выполняет дополнительную проверку и отменяет операцию,
|
||||
если какая-либо часть файла вне маркеров отличается от исходной;
|
||||
5. создаёт резервную копию файла с отметкой времени;
|
||||
6. атомарно заменяет конфигурационный файл;
|
||||
7. проверяет полную конфигурацию;
|
||||
8. перезагружает или перезапускает соответствующий сервис;
|
||||
9. восстанавливает исходный конфигурационный файл, если проверка или запуск сервиса завершились ошибкой.
|
||||
|
||||
Перегенерируется только управляемая часть между маркерами.
|
||||
|
||||
Существующие окончания строк CRLF/LF вне управляемой части сохраняются без изменений,
|
||||
так как чтение и запись выполняются с отключённым преобразованием окончаний строк.
|
||||
|
||||
## dnsmasq
|
||||
|
||||
В веб-форме требуется указать только домен.
|
||||
|
||||
Все новые записи используют один общий IP-адрес, который задаётся в файле:
|
||||
|
||||
`/etc/nas-config-web.env`
|
||||
|
||||
Например:
|
||||
|
||||
```ini
|
||||
DNSMASQ_TARGET_IP=192.168.7.251
|
||||
```
|
||||
|
||||
Если в форме указать:
|
||||
|
||||
```text
|
||||
.arm.com
|
||||
```
|
||||
|
||||
будет создана запись:
|
||||
|
||||
```text
|
||||
address=/.arm.com/192.168.7.251
|
||||
```
|
||||
|
||||
Существующие записи с другим IP-адресом также отображаются в интерфейсе и могут быть удалены,
|
||||
но все новые записи всегда используют значение `DNSMASQ_TARGET_IP`.
|
||||
|
||||
## Проверка и применение конфигурации
|
||||
|
||||
Для Caddy выполняется:
|
||||
|
||||
```bash
|
||||
caddy validate
|
||||
```
|
||||
|
||||
После успешной проверки:
|
||||
|
||||
```bash
|
||||
systemctl reload caddy
|
||||
```
|
||||
|
||||
Для dnsmasq выполняется:
|
||||
|
||||
```bash
|
||||
dnsmasq --test
|
||||
```
|
||||
|
||||
После успешной проверки:
|
||||
|
||||
```bash
|
||||
systemctl restart dnsmasq
|
||||
```
|
||||
|
||||
## Доступ к веб-интерфейсу
|
||||
|
||||
Приложение должно слушать только локальный адрес:
|
||||
|
||||
```text
|
||||
127.0.0.1
|
||||
```
|
||||
|
||||
Доступ к нему рекомендуется организовать через Caddy с ограничением только для локальной сети.
|
||||
|
||||
Блок Caddy, который проксирует веб-интерфейс NAS Config Web, должен находиться **вне управляемых маркеров**,
|
||||
чтобы приложение никогда не изменяло собственную точку доступа.
|
||||
Reference in New Issue
Block a user