Files
web-proxy-config/README.md
T

279 lines
7.8 KiB
Markdown

# 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
}
```