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

Например:

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
}
S
Description
No description provided
Readme
121 KiB
Languages
Python 100%