Proxy Config

Небольшой локальный веб-интерфейс на Flask/Gunicorn для управления Caddy и dnsmasq.

Приложение изменяет только участки между маркерами #begin marker и #end marker в Caddyfile и dnsmasq.conf. Содержимое файлов вне этих маркеров не изменяется.

Возможности

  • добавление и удаление reverse proxy в Caddy;
  • создание обычных и LAN-only proxy-блоков;
  • добавление и удаление доменов dnsmasq как единой пары address= + local=;
  • единый IP для всех новых dnsmasq-записей через DNSMASQ_TARGET_IP;
  • импорт списка доменов dnsmasq из текстового файла;
  • экспорт списка доменов dnsmasq в текстовый файл;
  • опциональная HTTP Basic Auth;
  • проверка конфигурации перед применением;
  • автоматический reload/restart сервиса;
  • резервная копия перед изменением;
  • автоматический откат при ошибке проверки или применения.

Защита файлов вне маркеров

Для каждого конфигурационного файла должна существовать ровно одна пара маркеров:

#begin marker

... управляемая часть ...

#end marker

Регистр маркеров не важен, поэтому #Begin marker также поддерживается.

При изменении приложение:

  1. требует ровно один начальный и один конечный маркер;
  2. сохраняет строку начального маркера и весь текст до неё без изменений;
  3. сохраняет строку конечного маркера и весь текст после неё без изменений;
  4. перед записью дополнительно сравнивает обе внешние части с исходным файлом;
  5. отменяет запись, если что-либо вне маркеров изменилось;
  6. создаёт резервную копию;
  7. атомарно записывает конфигурацию;
  8. проверяет конфигурацию;
  9. применяет её только после успешной проверки;
  10. при ошибке восстанавливает исходный файл.

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
local=/.arm.com/

address= возвращает заданный IPv4-адрес. local= запрещает dnsmasq отправлять запросы этого домена вышестоящим DNS-серверам. В актуальных версиях dnsmasq это используется вместе с IPv4-only address= для того, чтобы AAAA-запросы не уходили во внешний DNS и клиент не получил внешний IPv6-адрес.

Существующие старые записи, в которых есть только address=, продолжают отображаться. Если такой домен повторно добавить вручную или импортировать, Proxy Config добавит недостающую строку local=. При удалении домена удаляются обе строки.

Импорт доменов

Для импорта используется текстовый UTF-8 файл, по одному домену на строку:

ifconfig.me
.keil.arm.com
.arm.com

Пустые строки и строки, начинающиеся с #, игнорируются.

Импорт:

  • принимает только доменные имена;
  • не позволяет импортировать произвольные строки dnsmasq.conf;
  • использует DNSMASQ_TARGET_IP для всех новых address= записей;
  • для каждого нового домена создаёт пару address= + local=;
  • если существует только одна строка из пары, добавляет недостающую;
  • пропускает домены, у которых обе строки уже существуют;
  • перед применением выполняет обычную проверку dnsmasq --test.

Экспорт доменов

Кнопка экспорта создаёт файл dnsmasq-sites.txt в формате:

ifconfig.me
.keil.arm.com
.arm.com

Экспортируется только список доменов из управляемой части, без IP-адресов и без служебных строк address=/local=. При повторном импорте для каждого домена будет создана или восстановлена полная пара записей.

Авторизация

Авторизация управляется параметром:

AUTH_ENABLED=true

При включённой авторизации используются:

ADMIN_USER=admin
ADMIN_PASSWORD=CHANGE_ME_TO_A_LONG_RANDOM_PASSWORD

Если доступ к Proxy Config уже ограничен доверенной локальной сетью через Caddy, авторизацию можно отключить:

AUTH_ENABLED=false

При AUTH_ENABLED=false значения ADMIN_USER и ADMIN_PASSWORD не используются.

Proxy Config может изменять Caddy и dnsmasq и перезапускать системные сервисы. Отключайте авторизацию только если доступ к proxy.stadidisk.ru действительно ограничен доверенными устройствами/сетями.

Проверка и применение конфигурации

Для Caddy:

caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
systemctl reload caddy

Для dnsmasq:

dnsmasq --test --conf-file=/etc/dnsmasq.conf
systemctl restart dnsmasq

Установка и обновление

1. Установка системных пакетов

На Debian 13:

sudo apt update
sudo apt install -y git python3-venv

2. Обновление кода

Перейдите в каталог проекта:

cd /opt/web-proxy-config

Получите последнюю версию:

git pull

3. Создание виртуального окружения

Из каталога проекта:

python3 -m venv .venv

Активируйте окружение:

source .venv/bin/activate

4. Установка зависимостей из venv

После активации .venv:

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

Пример:

AUTH_ENABLED=true
ADMIN_USER=admin
ADMIN_PASSWORD=замените_на_надёжный_пароль
APP_SECRET=замените_на_случайную_строку

CADDYFILE=/etc/caddy/Caddyfile
DNSMASQ_CONF=/etc/dnsmasq.conf
BACKUP_DIR=/var/backups/web-proxy-config
DNSMASQ_TARGET_IP=192.168.7.251

LAN_NETWORKS=192.168.7.0/24,10.10.10.0/24
MAX_BACKUPS=50
MAX_IMPORT_BYTES=262144

Случайный APP_SECRET:

openssl rand -hex 32

Ограничьте доступ к настройкам:

sudo chmod 600 /etc/web-proxy-config.env

6. Установка systemd-службы

sudo cp web-proxy-config.service /etc/systemd/system/web-proxy-config.service
sudo systemctl daemon-reload
sudo systemctl enable --now web-proxy-config

После обновления кода достаточно:

cd /opt/web-proxy-config
git pull
source .venv/bin/activate
pip install -r requirements.txt
deactivate
sudo systemctl restart web-proxy-config

Проверка состояния:

systemctl status web-proxy-config

Логи:

journalctl -u web-proxy-config -f

Доступ через Caddy

Приложение слушает только:

127.0.0.1:8090

Пример LAN-only блока Caddy:

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
}

Этот блок рекомендуется размещать вне управляемых маркеров, чтобы Proxy Config никогда не изменял собственную точку входа.

S
Description
No description provided
Readme
121 KiB
Languages
Python 100%