web-proxy-config
Небольшой локальный веб-интерфейс на Flask/Gunicorn для управления только участками между
#begin marker и #end marker в файлах Caddyfile и dnsmasq.conf.
Поиск маркеров не зависит от регистра, поэтому вариант #Begin marker также поддерживается.
Важное правило безопасности
Приложению разрешено изменять текст только между двумя маркерами.
При каждой записи приложение:
- требует наличия ровно одного начального маркера и ровно одного конечного маркера;
- оставляет без изменений весь текст до начального маркера включительно;
- оставляет без изменений строку с конечным маркером и весь текст после неё;
- непосредственно перед записью выполняет дополнительную проверку и отменяет операцию, если какая-либо часть файла вне маркеров отличается от исходной;
- создаёт резервную копию файла с отметкой времени;
- атомарно заменяет конфигурационный файл;
- проверяет полную конфигурацию;
- перезагружает или перезапускает соответствующий сервис;
- восстанавливает исходный конфигурационный файл, если проверка или запуск сервиса завершились ошибкой.
Перегенерируется только управляемая часть между маркерами.
Существующие окончания строк CRLF/LF вне управляемой части сохраняются без изменений, так как чтение и запись выполняются с отключённым преобразованием окончаний строк.
dnsmasq
В веб-форме требуется указать только домен.
Все новые записи используют один общий IP-адрес, который задаётся в файле:
/etc/web-proxy-config.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 git python3-venv
2. Обновление кода из Git
Перейдите в каталог проекта:
cd /opt/web-proxy-config
Получите последние изменения из Git-репозитория:
git pull
3. Создание виртуального окружения
Находясь в каталоге проекта, создайте виртуальное окружение .venv:
python3 -m venv .venv
Активируйте его:
source .venv/bin/activate
После активации в начале командной строки обычно появится:
(.venv)
4. Установка зависимостей
Находясь в активированном виртуальном окружении, установите зависимости:
pip install -r requirements.txt
При необходимости после установки можно выйти из виртуального окружения:
deactivate
5. Настройка приложения
Скопируйте пример файла настроек:
sudo cp web-proxy-config.env.example /etc/web-proxy-config.env
Откройте его для редактирования:
sudo nano /etc/web-proxy-config.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/web-proxy-config
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/web-proxy-config.env
6. Установка службы systemd
Находясь в каталоге проекта, скопируйте unit-файл:
sudo cp web-proxy-config.service /etc/systemd/system/web-proxy-config.service
Перечитайте конфигурацию systemd:
sudo systemctl daemon-reload
Включите автозапуск и сразу запустите приложение:
sudo systemctl enable --now web-proxy-config
Проверьте состояние:
sudo systemctl status web-proxy-config
При нормальной работе статус должен содержать:
Active: active (running)
7. Просмотр журналов
Для просмотра последних сообщений:
sudo journalctl -u web-proxy-config -n 100 --no-pager
Для просмотра журнала в реальном времени:
sudo journalctl -u web-proxy-config -f
8. Локальная проверка
По умолчанию приложение должно быть доступно только на:
127.0.0.1:8090
Проверить его с самого мини-ПК можно командой:
curl http://127.0.0.1:8090
Если приложение отвечает, можно настраивать доступ к нему через Caddy.
Доступ к веб-интерфейсу
Приложение должно слушать только локальный адрес:
127.0.0.1
Доступ к нему рекомендуется организовать через Caddy с ограничением только для локальной сети.
Блок Caddy, который проксирует веб-интерфейс web-proxy-config, должен находиться вне управляемых маркеров, чтобы приложение никогда не изменяло собственную точку доступа.
Пример
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
}