# web-proxy-config Небольшой локальный веб-интерфейс на 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/web-proxy-config.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 ``` ## Установка ### 1. Установка системных пакетов На Debian 13 установите необходимые пакеты: ```bash sudo apt update sudo apt install -y git python3-venv ``` ### 2. Обновление кода из Git Перейдите в каталог проекта: ```bash cd /opt/web-proxy-config ``` Получите последние изменения из Git-репозитория: ```bash git pull ``` ### 3. Создание виртуального окружения Находясь в каталоге проекта, создайте виртуальное окружение `.venv`: ```bash python3 -m venv .venv ``` Активируйте его: ```bash source .venv/bin/activate ``` После активации в начале командной строки обычно появится: ```text (.venv) ``` ### 4. Установка зависимостей Находясь в активированном виртуальном окружении, установите зависимости: ```bash pip install -r requirements.txt ``` При необходимости после установки можно выйти из виртуального окружения: ```bash deactivate ``` ### 5. Настройка приложения Скопируйте пример файла настроек: ```bash sudo cp web-proxy-config.env.example /etc/web-proxy-config.env ``` Откройте его для редактирования: ```bash sudo nano /etc/web-proxy-config.env ``` Пример настроек: ```ini 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` можно создать командой: ```bash openssl rand -hex 32 ``` Ограничьте доступ к файлу настроек: ```bash sudo chmod 600 /etc/web-proxy-config.env ``` ### 6. Установка службы systemd Находясь в каталоге проекта, скопируйте unit-файл: ```bash sudo cp web-proxy-config.service /etc/systemd/system/web-proxy-config.service ``` Перечитайте конфигурацию systemd: ```bash sudo systemctl daemon-reload ``` Включите автозапуск и сразу запустите приложение: ```bash sudo systemctl enable --now web-proxy-config ``` Проверьте состояние: ```bash sudo systemctl status web-proxy-config ``` При нормальной работе статус должен содержать: ```text Active: active (running) ``` ### 7. Просмотр журналов Для просмотра последних сообщений: ```bash sudo journalctl -u web-proxy-config -n 100 --no-pager ``` Для просмотра журнала в реальном времени: ```bash sudo journalctl -u web-proxy-config -f ``` ### 8. Локальная проверка По умолчанию приложение должно быть доступно только на: ```text 127.0.0.1:8090 ``` Проверить его с самого мини-ПК можно командой: ```bash curl http://127.0.0.1:8090 ``` Если приложение отвечает, можно настраивать доступ к нему через Caddy. ## Доступ к веб-интерфейсу Приложение должно слушать только локальный адрес: ```text 127.0.0.1 ``` Доступ к нему рекомендуется организовать через Caddy с ограничением только для локальной сети. Блок Caddy, который проксирует веб-интерфейс web-proxy-config, должен находиться **вне управляемых маркеров**, чтобы приложение никогда не изменяло собственную точку доступа. ### Пример ```text 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 } ```