добавлен импорт\экспорт сайтов для dnsmasq и функция отключения авторизации
This commit is contained in:
@@ -1,100 +1,159 @@
|
|||||||
# web-proxy-config
|
# Proxy Config
|
||||||
|
|
||||||
Небольшой локальный веб-интерфейс на Flask/Gunicorn для управления только участками между
|
Небольшой локальный веб-интерфейс на Flask/Gunicorn для управления Caddy и dnsmasq.
|
||||||
`#begin marker` и `#end marker` в файлах Caddyfile и dnsmasq.conf.
|
|
||||||
|
|
||||||
Поиск маркеров не зависит от регистра, поэтому вариант `#Begin marker` также поддерживается.
|
Приложение изменяет только участки между маркерами `#begin marker` и `#end marker` в `Caddyfile` и `dnsmasq.conf`. Содержимое файлов вне этих маркеров не изменяется.
|
||||||
|
|
||||||
## Важное правило безопасности
|
## Возможности
|
||||||
|
|
||||||
Приложению разрешено изменять текст **только между двумя маркерами**.
|
- добавление и удаление reverse proxy в Caddy;
|
||||||
|
- создание обычных и LAN-only proxy-блоков;
|
||||||
|
- добавление и удаление доменов dnsmasq;
|
||||||
|
- единый IP для всех новых dnsmasq-записей через `DNSMASQ_TARGET_IP`;
|
||||||
|
- импорт списка доменов dnsmasq из текстового файла;
|
||||||
|
- экспорт списка доменов dnsmasq в текстовый файл;
|
||||||
|
- опциональная HTTP Basic Auth;
|
||||||
|
- проверка конфигурации перед применением;
|
||||||
|
- автоматический reload/restart сервиса;
|
||||||
|
- резервная копия перед изменением;
|
||||||
|
- автоматический откат при ошибке проверки или применения.
|
||||||
|
|
||||||
При каждой записи приложение:
|
## Защита файлов вне маркеров
|
||||||
|
|
||||||
1. требует наличия ровно одного начального маркера и ровно одного конечного маркера;
|
Для каждого конфигурационного файла должна существовать ровно одна пара маркеров:
|
||||||
2. оставляет без изменений весь текст до начального маркера включительно;
|
|
||||||
3. оставляет без изменений строку с конечным маркером и весь текст после неё;
|
|
||||||
4. непосредственно перед записью выполняет дополнительную проверку и отменяет операцию,
|
|
||||||
если какая-либо часть файла вне маркеров отличается от исходной;
|
|
||||||
5. создаёт резервную копию файла с отметкой времени;
|
|
||||||
6. атомарно заменяет конфигурационный файл;
|
|
||||||
7. проверяет полную конфигурацию;
|
|
||||||
8. перезагружает или перезапускает соответствующий сервис;
|
|
||||||
9. восстанавливает исходный конфигурационный файл, если проверка или запуск сервиса завершились ошибкой.
|
|
||||||
|
|
||||||
Перегенерируется только управляемая часть между маркерами.
|
```text
|
||||||
|
#begin marker
|
||||||
|
|
||||||
Существующие окончания строк CRLF/LF вне управляемой части сохраняются без изменений,
|
... управляемая часть ...
|
||||||
так как чтение и запись выполняются с отключённым преобразованием окончаний строк.
|
|
||||||
|
#end marker
|
||||||
|
```
|
||||||
|
|
||||||
|
Регистр маркеров не важен, поэтому `#Begin marker` также поддерживается.
|
||||||
|
|
||||||
|
При изменении приложение:
|
||||||
|
|
||||||
|
1. требует ровно один начальный и один конечный маркер;
|
||||||
|
2. сохраняет строку начального маркера и весь текст до неё без изменений;
|
||||||
|
3. сохраняет строку конечного маркера и весь текст после неё без изменений;
|
||||||
|
4. перед записью дополнительно сравнивает обе внешние части с исходным файлом;
|
||||||
|
5. отменяет запись, если что-либо вне маркеров изменилось;
|
||||||
|
6. создаёт резервную копию;
|
||||||
|
7. атомарно записывает конфигурацию;
|
||||||
|
8. проверяет конфигурацию;
|
||||||
|
9. применяет её только после успешной проверки;
|
||||||
|
10. при ошибке восстанавливает исходный файл.
|
||||||
|
|
||||||
|
CRLF/LF вне управляемой части также сохраняются без пересборки.
|
||||||
|
|
||||||
## dnsmasq
|
## dnsmasq
|
||||||
|
|
||||||
В веб-форме требуется указать только домен.
|
Все новые записи используют один IP из `/etc/web-proxy-config.env`:
|
||||||
|
|
||||||
Все новые записи используют один общий IP-адрес, который задаётся в файле:
|
|
||||||
|
|
||||||
`/etc/web-proxy-config.env`
|
|
||||||
|
|
||||||
Например:
|
|
||||||
|
|
||||||
```ini
|
```ini
|
||||||
DNSMASQ_TARGET_IP=192.168.7.251
|
DNSMASQ_TARGET_IP=192.168.7.251
|
||||||
```
|
```
|
||||||
|
|
||||||
Если в форме указать:
|
В интерфейсе достаточно указать только домен, например:
|
||||||
|
|
||||||
```text
|
```text
|
||||||
.arm.com
|
.arm.com
|
||||||
```
|
```
|
||||||
|
|
||||||
будет создана запись:
|
Будет создана запись:
|
||||||
|
|
||||||
```text
|
```text
|
||||||
address=/.arm.com/192.168.7.251
|
address=/.arm.com/192.168.7.251
|
||||||
```
|
```
|
||||||
|
|
||||||
Существующие записи с другим IP-адресом также отображаются в интерфейсе и могут быть удалены,
|
Существующие записи с другим IP отображаются как есть. Они не переписываются автоматически.
|
||||||
но все новые записи всегда используют значение `DNSMASQ_TARGET_IP`.
|
|
||||||
|
### Импорт доменов
|
||||||
|
|
||||||
|
Для импорта используется текстовый UTF-8 файл, по одному домену на строку:
|
||||||
|
|
||||||
|
```text
|
||||||
|
ifconfig.me
|
||||||
|
.keil.arm.com
|
||||||
|
.arm.com
|
||||||
|
```
|
||||||
|
|
||||||
|
Пустые строки и строки, начинающиеся с `#`, игнорируются.
|
||||||
|
|
||||||
|
Импорт:
|
||||||
|
|
||||||
|
- принимает только доменные имена;
|
||||||
|
- не позволяет импортировать произвольные строки `dnsmasq.conf`;
|
||||||
|
- использует `DNSMASQ_TARGET_IP` для всех новых записей;
|
||||||
|
- пропускает домены, которые уже существуют;
|
||||||
|
- перед применением выполняет обычную проверку `dnsmasq --test`.
|
||||||
|
|
||||||
|
### Экспорт доменов
|
||||||
|
|
||||||
|
Кнопка экспорта создаёт файл `dnsmasq-sites.txt` в формате:
|
||||||
|
|
||||||
|
```text
|
||||||
|
ifconfig.me
|
||||||
|
.keil.arm.com
|
||||||
|
.arm.com
|
||||||
|
```
|
||||||
|
|
||||||
|
Экспортируется только список доменов из управляемой части, без IP-адресов.
|
||||||
|
|
||||||
|
## Авторизация
|
||||||
|
|
||||||
|
Авторизация управляется параметром:
|
||||||
|
|
||||||
|
```ini
|
||||||
|
AUTH_ENABLED=true
|
||||||
|
```
|
||||||
|
|
||||||
|
При включённой авторизации используются:
|
||||||
|
|
||||||
|
```ini
|
||||||
|
ADMIN_USER=admin
|
||||||
|
ADMIN_PASSWORD=CHANGE_ME_TO_A_LONG_RANDOM_PASSWORD
|
||||||
|
```
|
||||||
|
|
||||||
|
Если доступ к Proxy Config уже ограничен доверенной локальной сетью через Caddy, авторизацию можно отключить:
|
||||||
|
|
||||||
|
```ini
|
||||||
|
AUTH_ENABLED=false
|
||||||
|
```
|
||||||
|
|
||||||
|
При `AUTH_ENABLED=false` значения `ADMIN_USER` и `ADMIN_PASSWORD` не используются.
|
||||||
|
|
||||||
|
> Proxy Config может изменять Caddy и dnsmasq и перезапускать системные сервисы. Отключайте авторизацию только если доступ к `proxy.stadidisk.ru` действительно ограничен доверенными устройствами/сетями.
|
||||||
|
|
||||||
## Проверка и применение конфигурации
|
## Проверка и применение конфигурации
|
||||||
|
|
||||||
Для Caddy выполняется:
|
Для Caddy:
|
||||||
|
|
||||||
```bash
|
|
||||||
caddy validate
|
|
||||||
```
|
|
||||||
|
|
||||||
После успешной проверки:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
|
||||||
systemctl reload caddy
|
systemctl reload caddy
|
||||||
```
|
```
|
||||||
|
|
||||||
Для dnsmasq выполняется:
|
Для dnsmasq:
|
||||||
|
|
||||||
```bash
|
|
||||||
dnsmasq --test
|
|
||||||
```
|
|
||||||
|
|
||||||
После успешной проверки:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
dnsmasq --test --conf-file=/etc/dnsmasq.conf
|
||||||
systemctl restart dnsmasq
|
systemctl restart dnsmasq
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Установка и обновление
|
||||||
## Установка
|
|
||||||
|
|
||||||
### 1. Установка системных пакетов
|
### 1. Установка системных пакетов
|
||||||
|
|
||||||
На Debian 13 установите необходимые пакеты:
|
На Debian 13:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo apt update
|
sudo apt update
|
||||||
sudo apt install -y git python3-venv
|
sudo apt install -y git python3-venv
|
||||||
```
|
```
|
||||||
|
|
||||||
### 2. Обновление кода из Git
|
### 2. Обновление кода
|
||||||
|
|
||||||
Перейдите в каталог проекта:
|
Перейдите в каталог проекта:
|
||||||
|
|
||||||
@@ -102,7 +161,7 @@ sudo apt install -y git python3-venv
|
|||||||
cd /opt/web-proxy-config
|
cd /opt/web-proxy-config
|
||||||
```
|
```
|
||||||
|
|
||||||
Получите последние изменения из Git-репозитория:
|
Получите последнюю версию:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git pull
|
git pull
|
||||||
@@ -110,33 +169,27 @@ git pull
|
|||||||
|
|
||||||
### 3. Создание виртуального окружения
|
### 3. Создание виртуального окружения
|
||||||
|
|
||||||
Находясь в каталоге проекта, создайте виртуальное окружение `.venv`:
|
Из каталога проекта:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m venv .venv
|
python3 -m venv .venv
|
||||||
```
|
```
|
||||||
|
|
||||||
Активируйте его:
|
Активируйте окружение:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
source .venv/bin/activate
|
source .venv/bin/activate
|
||||||
```
|
```
|
||||||
|
|
||||||
После активации в начале командной строки обычно появится:
|
### 4. Установка зависимостей из venv
|
||||||
|
|
||||||
```text
|
После активации `.venv`:
|
||||||
(.venv)
|
|
||||||
```
|
|
||||||
|
|
||||||
### 4. Установка зависимостей
|
|
||||||
|
|
||||||
Находясь в активированном виртуальном окружении, установите зависимости:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip install -r requirements.txt
|
pip install -r requirements.txt
|
||||||
```
|
```
|
||||||
|
|
||||||
При необходимости после установки можно выйти из виртуального окружения:
|
После установки можно выйти из окружения:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
deactivate
|
deactivate
|
||||||
@@ -144,129 +197,90 @@ deactivate
|
|||||||
|
|
||||||
### 5. Настройка приложения
|
### 5. Настройка приложения
|
||||||
|
|
||||||
Скопируйте пример файла настроек:
|
Скопируйте пример настроек:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo cp web-proxy-config.env.example /etc/web-proxy-config.env
|
sudo cp web-proxy-config.env.example /etc/web-proxy-config.env
|
||||||
```
|
```
|
||||||
|
|
||||||
Откройте его для редактирования:
|
Откройте файл:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo nano /etc/web-proxy-config.env
|
sudo nano /etc/web-proxy-config.env
|
||||||
```
|
```
|
||||||
|
|
||||||
Пример настроек:
|
Пример:
|
||||||
|
|
||||||
```ini
|
```ini
|
||||||
|
AUTH_ENABLED=true
|
||||||
ADMIN_USER=admin
|
ADMIN_USER=admin
|
||||||
ADMIN_PASSWORD=замените_на_надёжный_пароль
|
ADMIN_PASSWORD=замените_на_надёжный_пароль
|
||||||
APP_SECRET=замените_на_случайную_строку
|
APP_SECRET=замените_на_случайную_строку
|
||||||
|
|
||||||
CADDYFILE=/etc/caddy/Caddyfile
|
CADDYFILE=/etc/caddy/Caddyfile
|
||||||
DNSMASQ_CONF=/etc/dnsmasq.conf
|
DNSMASQ_CONF=/etc/dnsmasq.conf
|
||||||
|
BACKUP_DIR=/var/backups/web-proxy-config
|
||||||
DNSMASQ_TARGET_IP=192.168.7.251
|
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
|
LAN_NETWORKS=192.168.7.0/24,10.10.10.0/24
|
||||||
MAX_BACKUPS=50
|
MAX_BACKUPS=50
|
||||||
|
MAX_IMPORT_BYTES=262144
|
||||||
```
|
```
|
||||||
|
|
||||||
Случайную строку для `APP_SECRET` можно создать командой:
|
Случайный `APP_SECRET`:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
openssl rand -hex 32
|
openssl rand -hex 32
|
||||||
```
|
```
|
||||||
|
|
||||||
Ограничьте доступ к файлу настроек:
|
Ограничьте доступ к настройкам:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo chmod 600 /etc/web-proxy-config.env
|
sudo chmod 600 /etc/web-proxy-config.env
|
||||||
```
|
```
|
||||||
|
|
||||||
### 6. Установка службы systemd
|
### 6. Установка systemd-службы
|
||||||
|
|
||||||
Находясь в каталоге проекта, скопируйте unit-файл:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo cp web-proxy-config.service /etc/systemd/system/web-proxy-config.service
|
sudo cp web-proxy-config.service /etc/systemd/system/web-proxy-config.service
|
||||||
```
|
|
||||||
|
|
||||||
Перечитайте конфигурацию systemd:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
sudo systemctl daemon-reload
|
sudo systemctl daemon-reload
|
||||||
```
|
|
||||||
|
|
||||||
Включите автозапуск и сразу запустите приложение:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
sudo systemctl enable --now web-proxy-config
|
sudo systemctl enable --now web-proxy-config
|
||||||
```
|
```
|
||||||
|
|
||||||
Проверьте состояние:
|
После обновления кода достаточно:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo systemctl status 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
|
||||||
```
|
```
|
||||||
|
|
||||||
При нормальной работе статус должен содержать:
|
Проверка состояния:
|
||||||
|
|
||||||
```text
|
|
||||||
Active: active (running)
|
|
||||||
```
|
|
||||||
|
|
||||||
### 7. Просмотр журналов
|
|
||||||
|
|
||||||
Для просмотра последних сообщений:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo journalctl -u web-proxy-config -n 100 --no-pager
|
systemctl status web-proxy-config
|
||||||
```
|
```
|
||||||
|
|
||||||
Для просмотра журнала в реальном времени:
|
Логи:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo journalctl -u web-proxy-config -f
|
journalctl -u web-proxy-config -f
|
||||||
```
|
```
|
||||||
|
|
||||||
### 8. Локальная проверка
|
## Доступ через Caddy
|
||||||
|
|
||||||
По умолчанию приложение должно быть доступно только на:
|
Приложение слушает только:
|
||||||
|
|
||||||
```text
|
```text
|
||||||
127.0.0.1:8090
|
127.0.0.1:8090
|
||||||
```
|
```
|
||||||
|
|
||||||
Проверить его с самого мини-ПК можно командой:
|
Пример LAN-only блока Caddy:
|
||||||
|
|
||||||
```bash
|
```caddyfile
|
||||||
curl http://127.0.0.1:8090
|
|
||||||
```
|
|
||||||
|
|
||||||
Если приложение отвечает, можно настраивать доступ к нему через Caddy.
|
|
||||||
|
|
||||||
|
|
||||||
## Доступ к веб-интерфейсу
|
|
||||||
|
|
||||||
Приложение должно слушать только локальный адрес:
|
|
||||||
|
|
||||||
```text
|
|
||||||
127.0.0.1
|
|
||||||
```
|
|
||||||
|
|
||||||
Доступ к нему рекомендуется организовать через Caddy с ограничением только для локальной сети.
|
|
||||||
|
|
||||||
Блок Caddy, который проксирует веб-интерфейс web-proxy-config, должен находиться **вне управляемых маркеров**,
|
|
||||||
чтобы приложение никогда не изменяло собственную точку доступа.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### Пример
|
|
||||||
|
|
||||||
|
|
||||||
```text
|
|
||||||
proxy.stadidisk.ru {
|
proxy.stadidisk.ru {
|
||||||
@lan remote_ip 192.168.7.0/24 10.10.10.0/24
|
@lan remote_ip 192.168.7.0/24 10.10.10.0/24
|
||||||
|
|
||||||
@@ -277,3 +291,5 @@ proxy.stadidisk.ru {
|
|||||||
respond "Forbidden" 403
|
respond "Forbidden" 403
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Этот блок рекомендуется размещать **вне управляемых маркеров**, чтобы Proxy Config никогда не изменял собственную точку входа.
|
||||||
|
|||||||
@@ -15,7 +15,7 @@ from datetime import datetime
|
|||||||
from pathlib import Path
|
from pathlib import Path
|
||||||
from urllib.parse import urlsplit
|
from urllib.parse import urlsplit
|
||||||
|
|
||||||
from flask import Flask, abort, flash, redirect, render_template_string, request, session, url_for
|
from flask import Flask, Response, abort, flash, redirect, render_template_string, request, session, url_for
|
||||||
|
|
||||||
|
|
||||||
# -----------------------------------------------------------------------------
|
# -----------------------------------------------------------------------------
|
||||||
@@ -26,19 +26,24 @@ CADDYFILE = Path(os.getenv("CADDYFILE", "/etc/caddy/Caddyfile")).resolve()
|
|||||||
DNSMASQ_CONF = Path(os.getenv("DNSMASQ_CONF", "/etc/dnsmasq.conf")).resolve()
|
DNSMASQ_CONF = Path(os.getenv("DNSMASQ_CONF", "/etc/dnsmasq.conf")).resolve()
|
||||||
BACKUP_DIR = Path(os.getenv("BACKUP_DIR", "/var/backups/web-proxy-config"))
|
BACKUP_DIR = Path(os.getenv("BACKUP_DIR", "/var/backups/web-proxy-config"))
|
||||||
|
|
||||||
try:
|
|
||||||
DNSMASQ_TARGET_IP = str(
|
|
||||||
ipaddress.ip_address(os.getenv("DNSMASQ_TARGET_IP", "192.168.7.251").strip())
|
|
||||||
)
|
|
||||||
except ValueError as exc:
|
|
||||||
raise RuntimeError("DNSMASQ_TARGET_IP is not a valid IPv4/IPv6 address.") from exc
|
|
||||||
|
|
||||||
BEGIN_MARKER = os.getenv("BEGIN_MARKER", "#begin marker")
|
BEGIN_MARKER = os.getenv("BEGIN_MARKER", "#begin marker")
|
||||||
END_MARKER = os.getenv("END_MARKER", "#end marker")
|
END_MARKER = os.getenv("END_MARKER", "#end marker")
|
||||||
|
|
||||||
|
def env_bool(name: str, default: bool) -> bool:
|
||||||
|
raw = os.getenv(name)
|
||||||
|
if raw is None:
|
||||||
|
return default
|
||||||
|
return raw.strip().lower() in {"1", "true", "yes", "on"}
|
||||||
|
|
||||||
|
|
||||||
|
AUTH_ENABLED = env_bool("AUTH_ENABLED", True)
|
||||||
ADMIN_USER = os.getenv("ADMIN_USER", "admin")
|
ADMIN_USER = os.getenv("ADMIN_USER", "admin")
|
||||||
ADMIN_PASSWORD = os.getenv("ADMIN_PASSWORD", "")
|
ADMIN_PASSWORD = os.getenv("ADMIN_PASSWORD", "")
|
||||||
APP_SECRET = os.getenv("APP_SECRET", secrets.token_urlsafe(48))
|
APP_SECRET = os.getenv("APP_SECRET", secrets.token_urlsafe(48))
|
||||||
|
DNSMASQ_TARGET_IP = str(
|
||||||
|
ipaddress.ip_address(os.getenv("DNSMASQ_TARGET_IP", "192.168.7.251").strip())
|
||||||
|
)
|
||||||
|
MAX_IMPORT_BYTES = int(os.getenv("MAX_IMPORT_BYTES", str(256 * 1024)))
|
||||||
LAN_NETWORKS = [
|
LAN_NETWORKS = [
|
||||||
x.strip()
|
x.strip()
|
||||||
for x in os.getenv("LAN_NETWORKS", "192.168.7.0/24,10.10.10.0/24").split(",")
|
for x in os.getenv("LAN_NETWORKS", "192.168.7.0/24,10.10.10.0/24").split(",")
|
||||||
@@ -62,9 +67,10 @@ DNSMASQ_VALIDATE_CMD = [
|
|||||||
]
|
]
|
||||||
DNSMASQ_APPLY_CMD = ["/usr/bin/systemctl", "restart", "dnsmasq"]
|
DNSMASQ_APPLY_CMD = ["/usr/bin/systemctl", "restart", "dnsmasq"]
|
||||||
|
|
||||||
if not ADMIN_PASSWORD:
|
if AUTH_ENABLED and not ADMIN_PASSWORD:
|
||||||
raise RuntimeError(
|
raise RuntimeError(
|
||||||
"ADMIN_PASSWORD is not configured. Set it in the systemd EnvironmentFile."
|
"AUTH_ENABLED is true, but ADMIN_PASSWORD is not configured. "
|
||||||
|
"Set ADMIN_PASSWORD or disable authentication with AUTH_ENABLED=false."
|
||||||
)
|
)
|
||||||
|
|
||||||
app = Flask(__name__)
|
app = Flask(__name__)
|
||||||
@@ -107,80 +113,62 @@ def _hash_id(text: str) -> str:
|
|||||||
return hashlib.sha256(text.encode("utf-8")).hexdigest()[:16]
|
return hashlib.sha256(text.encode("utf-8")).hexdigest()[:16]
|
||||||
|
|
||||||
|
|
||||||
@dataclass(frozen=True)
|
def _find_marker_line(text: str, marker: str) -> list[re.Match[str]]:
|
||||||
class ManagedSection:
|
pattern = re.compile(
|
||||||
# prefix includes the complete begin-marker line and its original newline.
|
rf"(?im)^[ \t]*{re.escape(marker.strip())}[ \t]*(?:\r\n|\n|\r|$)"
|
||||||
# suffix starts at the end-marker line. Both are copied verbatim when a
|
|
||||||
# managed section is changed, so text outside the markers cannot be altered.
|
|
||||||
prefix: str
|
|
||||||
managed_text: str
|
|
||||||
suffix: str
|
|
||||||
|
|
||||||
|
|
||||||
def _marker_pattern(marker: str) -> re.Pattern[str]:
|
|
||||||
marker = marker.strip()
|
|
||||||
if not marker:
|
|
||||||
raise ValueError("Marker cannot be empty.")
|
|
||||||
# A marker must occupy a whole logical line. Case is ignored so existing
|
|
||||||
# '#Begin marker' and '#begin marker' variants are both accepted.
|
|
||||||
return re.compile(
|
|
||||||
rf"(?im)^[ \t]*{re.escape(marker)}[ \t]*(?:\r?\n|$)"
|
|
||||||
)
|
)
|
||||||
|
return list(pattern.finditer(text))
|
||||||
|
|
||||||
|
|
||||||
def split_managed_section(text: str) -> ManagedSection:
|
def split_managed_section(text: str) -> tuple[str, str, str, str]:
|
||||||
begin_matches = list(_marker_pattern(BEGIN_MARKER).finditer(text))
|
"""Return prefix, managed text, suffix and preferred newline.
|
||||||
end_matches = list(_marker_pattern(END_MARKER).finditer(text))
|
|
||||||
|
|
||||||
if len(begin_matches) != 1 or len(end_matches) != 1:
|
Prefix includes the begin-marker line and its line ending. Suffix starts with
|
||||||
|
the end-marker line. Therefore prefix and suffix can be copied byte-for-byte
|
||||||
|
(at the decoded text level) without being rebuilt.
|
||||||
|
"""
|
||||||
|
begins = _find_marker_line(text, BEGIN_MARKER)
|
||||||
|
ends = _find_marker_line(text, END_MARKER)
|
||||||
|
if len(begins) != 1 or len(ends) != 1:
|
||||||
raise ValueError(
|
raise ValueError(
|
||||||
"Config must contain exactly one begin marker and exactly one end marker. "
|
f"Expected exactly one '{BEGIN_MARKER}' and one '{END_MARKER}' marker."
|
||||||
f"Found begin={len(begin_matches)}, end={len(end_matches)}."
|
|
||||||
)
|
)
|
||||||
|
begin = begins[0]
|
||||||
begin = begin_matches[0]
|
end = ends[0]
|
||||||
end = end_matches[0]
|
|
||||||
if end.start() < begin.end():
|
if end.start() < begin.end():
|
||||||
raise ValueError("End marker must appear after begin marker.")
|
raise ValueError("End marker is before the begin marker.")
|
||||||
|
|
||||||
return ManagedSection(
|
prefix = text[: begin.end()]
|
||||||
prefix=text[: begin.end()],
|
managed = text[begin.end() : end.start()]
|
||||||
managed_text=text[begin.end() : end.start()],
|
suffix = text[end.start() :]
|
||||||
suffix=text[end.start() :],
|
|
||||||
)
|
if prefix.endswith("\r\n"):
|
||||||
|
newline = "\r\n"
|
||||||
|
elif prefix.endswith("\n"):
|
||||||
|
newline = "\n"
|
||||||
|
elif prefix.endswith("\r"):
|
||||||
|
newline = "\r"
|
||||||
|
else:
|
||||||
|
newline = "\n"
|
||||||
|
return prefix, managed, suffix, newline
|
||||||
|
|
||||||
|
|
||||||
def get_managed_lines(text: str) -> list[str]:
|
def get_managed_lines(text: str) -> list[str]:
|
||||||
return split_managed_section(text).managed_text.splitlines()
|
_, managed, _, _ = split_managed_section(text)
|
||||||
|
return managed.splitlines()
|
||||||
|
|
||||||
|
|
||||||
def replace_managed_lines(text: str, managed: list[str]) -> str:
|
def replace_managed_lines(text: str, managed: list[str]) -> str:
|
||||||
section = split_managed_section(text)
|
prefix, _, suffix, newline = split_managed_section(text)
|
||||||
|
body = newline.join(managed)
|
||||||
# Only the text BETWEEN markers is generated. Prefix and suffix are reused
|
if body:
|
||||||
# byte-for-byte at the Unicode text level from the original file.
|
body += newline
|
||||||
newline = (
|
return prefix + body + suffix
|
||||||
"\r\n"
|
|
||||||
if "\r\n" in section.managed_text or section.prefix.endswith("\r\n")
|
|
||||||
else "\n"
|
|
||||||
)
|
|
||||||
managed_text = newline.join(managed)
|
|
||||||
if managed_text:
|
|
||||||
# The end marker must remain on its own line. This newline is still
|
|
||||||
# inside the managed section, immediately before the end marker.
|
|
||||||
managed_text += newline
|
|
||||||
|
|
||||||
return section.prefix + managed_text + section.suffix
|
|
||||||
|
|
||||||
|
|
||||||
def assert_outside_markers_unchanged(old_text: str, new_text: str) -> None:
|
def read_text_exact(path: Path) -> str:
|
||||||
old = split_managed_section(old_text)
|
with path.open("r", encoding="utf-8", newline="") as fh:
|
||||||
new = split_managed_section(new_text)
|
return fh.read()
|
||||||
if old.prefix != new.prefix or old.suffix != new.suffix:
|
|
||||||
raise ValueError(
|
|
||||||
"Safety check failed: content outside the managed markers changed. "
|
|
||||||
"Nothing was written."
|
|
||||||
)
|
|
||||||
|
|
||||||
|
|
||||||
def _brace_delta(line: str) -> int:
|
def _brace_delta(line: str) -> int:
|
||||||
@@ -359,6 +347,13 @@ def validate_dns_domain(value: str) -> str:
|
|||||||
return ("." if leading_dot else "") + bare
|
return ("." if leading_dot else "") + bare
|
||||||
|
|
||||||
|
|
||||||
|
def validate_ip(value: str) -> str:
|
||||||
|
value = value.strip()
|
||||||
|
try:
|
||||||
|
return str(ipaddress.ip_address(value))
|
||||||
|
except ValueError as exc:
|
||||||
|
raise ValueError("Invalid IP address.") from exc
|
||||||
|
|
||||||
|
|
||||||
def build_caddy_block(site: str, upstream: str, comment: str, lan_only: bool) -> list[str]:
|
def build_caddy_block(site: str, upstream: str, comment: str, lan_only: bool) -> list[str]:
|
||||||
lines: list[str] = []
|
lines: list[str] = []
|
||||||
@@ -389,13 +384,6 @@ def build_caddy_block(site: str, upstream: str, comment: str, lan_only: bool) ->
|
|||||||
# -----------------------------------------------------------------------------
|
# -----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
|
||||||
def read_text_exact(path: Path) -> str:
|
|
||||||
# newline="" disables universal-newline conversion, preserving CRLF/LF
|
|
||||||
# exactly as stored in the source file.
|
|
||||||
with path.open("r", encoding="utf-8", newline="") as fh:
|
|
||||||
return fh.read()
|
|
||||||
|
|
||||||
|
|
||||||
def run_cmd(cmd: list[str], timeout: int = 20) -> tuple[bool, str]:
|
def run_cmd(cmd: list[str], timeout: int = 20) -> tuple[bool, str]:
|
||||||
try:
|
try:
|
||||||
cp = subprocess.run(
|
cp = subprocess.run(
|
||||||
@@ -472,10 +460,12 @@ def apply_transaction(
|
|||||||
if old_text == new_text:
|
if old_text == new_text:
|
||||||
return True, "No changes were necessary."
|
return True, "No changes were necessary."
|
||||||
|
|
||||||
# Defence in depth: even if a future route constructs new_text
|
# Hard safety boundary: content outside the managed markers must be
|
||||||
# incorrectly, refuse to write unless everything outside the markers
|
# exactly identical before a write is allowed.
|
||||||
# is exactly unchanged.
|
old_prefix, _, old_suffix, _ = split_managed_section(old_text)
|
||||||
assert_outside_markers_unchanged(old_text, new_text)
|
new_prefix, _, new_suffix, _ = split_managed_section(new_text)
|
||||||
|
if old_prefix != new_prefix or old_suffix != new_suffix:
|
||||||
|
return False, "Safety check failed: text outside the markers changed; nothing was written."
|
||||||
|
|
||||||
stat = path.stat()
|
stat = path.stat()
|
||||||
backup = create_backup(path, old_text)
|
backup = create_backup(path, old_text)
|
||||||
@@ -527,11 +517,11 @@ def _auth_ok() -> bool:
|
|||||||
|
|
||||||
@app.before_request
|
@app.before_request
|
||||||
def require_auth():
|
def require_auth():
|
||||||
if not _auth_ok():
|
if AUTH_ENABLED and not _auth_ok():
|
||||||
return (
|
return (
|
||||||
"Authentication required",
|
"Authentication required",
|
||||||
401,
|
401,
|
||||||
{"WWW-Authenticate": 'Basic realm="NAS Config"'},
|
{"WWW-Authenticate": 'Basic realm="Proxy Config"'},
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|
||||||
@@ -584,6 +574,7 @@ def index():
|
|||||||
dns_status=state[5],
|
dns_status=state[5],
|
||||||
lan_networks=", ".join(LAN_NETWORKS),
|
lan_networks=", ".join(LAN_NETWORKS),
|
||||||
dns_target_ip=DNSMASQ_TARGET_IP,
|
dns_target_ip=DNSMASQ_TARGET_IP,
|
||||||
|
auth_enabled=AUTH_ENABLED,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|
||||||
@@ -692,6 +683,94 @@ def dns_delete():
|
|||||||
return redirect(url_for("index"))
|
return redirect(url_for("index"))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
@app.post("/dns/import")
|
||||||
|
def dns_import():
|
||||||
|
require_csrf()
|
||||||
|
try:
|
||||||
|
upload = request.files.get("file")
|
||||||
|
if upload is None or not upload.filename:
|
||||||
|
raise ValueError("Выберите текстовый файл со списком доменов.")
|
||||||
|
|
||||||
|
data = upload.stream.read(MAX_IMPORT_BYTES + 1)
|
||||||
|
if len(data) > MAX_IMPORT_BYTES:
|
||||||
|
raise ValueError(f"Файл слишком большой. Максимальный размер: {MAX_IMPORT_BYTES} байт.")
|
||||||
|
try:
|
||||||
|
imported_text = data.decode("utf-8-sig")
|
||||||
|
except UnicodeDecodeError as exc:
|
||||||
|
raise ValueError("Файл импорта должен быть в кодировке UTF-8.") from exc
|
||||||
|
|
||||||
|
domains: list[str] = []
|
||||||
|
seen_import: set[str] = set()
|
||||||
|
errors: list[str] = []
|
||||||
|
for lineno, raw_line in enumerate(imported_text.splitlines(), start=1):
|
||||||
|
line = raw_line.strip()
|
||||||
|
if not line or line.startswith("#"):
|
||||||
|
continue
|
||||||
|
try:
|
||||||
|
domain = validate_dns_domain(line)
|
||||||
|
except ValueError:
|
||||||
|
errors.append(f"строка {lineno}: {line}")
|
||||||
|
continue
|
||||||
|
key = domain.lower()
|
||||||
|
if key not in seen_import:
|
||||||
|
seen_import.add(key)
|
||||||
|
domains.append(domain)
|
||||||
|
|
||||||
|
if errors:
|
||||||
|
preview = "; ".join(errors[:8])
|
||||||
|
if len(errors) > 8:
|
||||||
|
preview += f"; ещё {len(errors) - 8}"
|
||||||
|
raise ValueError(f"В файле есть некорректные домены: {preview}")
|
||||||
|
if not domains:
|
||||||
|
raise ValueError("В файле не найдено ни одного домена.")
|
||||||
|
|
||||||
|
old = read_text_exact(DNSMASQ_CONF)
|
||||||
|
managed = get_managed_lines(old)
|
||||||
|
records = parse_dns_records(managed)
|
||||||
|
existing = {r.domain.lower() for r in records}
|
||||||
|
|
||||||
|
added = 0
|
||||||
|
skipped = 0
|
||||||
|
for domain in domains:
|
||||||
|
if domain.lower() in existing:
|
||||||
|
skipped += 1
|
||||||
|
continue
|
||||||
|
managed.append(f"address=/{domain}/{DNSMASQ_TARGET_IP}")
|
||||||
|
existing.add(domain.lower())
|
||||||
|
added += 1
|
||||||
|
|
||||||
|
if not added:
|
||||||
|
flash(f"Новых доменов нет. Пропущено существующих: {skipped}.", "success")
|
||||||
|
return redirect(url_for("index"))
|
||||||
|
|
||||||
|
new = replace_managed_lines(old, managed)
|
||||||
|
ok, message = apply_transaction(DNSMASQ_CONF, old, new, DNSMASQ_VALIDATE_CMD, DNSMASQ_APPLY_CMD)
|
||||||
|
if ok:
|
||||||
|
message = f"Импорт завершён: добавлено {added}, пропущено существующих {skipped}.\n{message}"
|
||||||
|
flash(message, "success" if ok else "error")
|
||||||
|
except Exception as exc:
|
||||||
|
flash(str(exc), "error")
|
||||||
|
return redirect(url_for("index"))
|
||||||
|
|
||||||
|
|
||||||
|
@app.get("/dns/export")
|
||||||
|
def dns_export():
|
||||||
|
try:
|
||||||
|
text = read_text_exact(DNSMASQ_CONF)
|
||||||
|
records = parse_dns_records(get_managed_lines(text))
|
||||||
|
content = "\n".join(r.domain for r in records)
|
||||||
|
if content:
|
||||||
|
content += "\n"
|
||||||
|
return Response(
|
||||||
|
content,
|
||||||
|
mimetype="text/plain; charset=utf-8",
|
||||||
|
headers={"Content-Disposition": "attachment; filename=dnsmasq-sites.txt"},
|
||||||
|
)
|
||||||
|
except Exception as exc:
|
||||||
|
flash(str(exc), "error")
|
||||||
|
return redirect(url_for("index"))
|
||||||
|
|
||||||
@app.get("/health")
|
@app.get("/health")
|
||||||
def health():
|
def health():
|
||||||
return {"ok": True}
|
return {"ok": True}
|
||||||
@@ -707,7 +786,7 @@ TEMPLATE = r"""
|
|||||||
<head>
|
<head>
|
||||||
<meta charset="utf-8">
|
<meta charset="utf-8">
|
||||||
<meta name="viewport" content="width=device-width,initial-scale=1">
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
||||||
<title>NAS Config</title>
|
<title>Proxy Config</title>
|
||||||
<style>
|
<style>
|
||||||
:root { color-scheme: dark; --bg:#101318; --card:#171b22; --muted:#8f99a8; --line:#2b313c; --good:#35c46a; --bad:#ff5d66; --accent:#5b9cff; }
|
:root { color-scheme: dark; --bg:#101318; --card:#171b22; --muted:#8f99a8; --line:#2b313c; --good:#35c46a; --bad:#ff5d66; --accent:#5b9cff; }
|
||||||
* { box-sizing:border-box; }
|
* { box-sizing:border-box; }
|
||||||
@@ -730,6 +809,9 @@ TEMPLATE = r"""
|
|||||||
.check { display:flex; gap:8px; align-items:center; color:#dce3eb; }
|
.check { display:flex; gap:8px; align-items:center; color:#dce3eb; }
|
||||||
button { border:0; border-radius:8px; padding:9px 12px; color:#fff; background:var(--accent); cursor:pointer; font-weight:600; }
|
button { border:0; border-radius:8px; padding:9px 12px; color:#fff; background:var(--accent); cursor:pointer; font-weight:600; }
|
||||||
button.delete { background:transparent; color:#ff8c92; border:1px solid #65343a; padding:6px 9px; }
|
button.delete { background:transparent; color:#ff8c92; border:1px solid #65343a; padding:6px 9px; }
|
||||||
|
.button-link { display:inline-block; border-radius:8px; padding:9px 12px; color:#fff; background:#394456; text-decoration:none; font-weight:600; text-align:center; }
|
||||||
|
input[type=file] { width:100%; margin-top:5px; color:#cdd6e3; }
|
||||||
|
.dns-tools { display:grid; grid-template-columns:1fr auto; gap:10px; margin-bottom:16px; padding:13px; background:#12161c; border:1px solid var(--line); border-radius:11px; align-items:end; }
|
||||||
table { width:100%; border-collapse:collapse; }
|
table { width:100%; border-collapse:collapse; }
|
||||||
th { text-align:left; font-size:11px; text-transform:uppercase; letter-spacing:.05em; color:var(--muted); padding:8px 7px; border-bottom:1px solid var(--line); }
|
th { text-align:left; font-size:11px; text-transform:uppercase; letter-spacing:.05em; color:var(--muted); padding:8px 7px; border-bottom:1px solid var(--line); }
|
||||||
td { padding:10px 7px; border-bottom:1px solid #242a33; vertical-align:top; }
|
td { padding:10px 7px; border-bottom:1px solid #242a33; vertical-align:top; }
|
||||||
@@ -746,8 +828,9 @@ TEMPLATE = r"""
|
|||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
<main>
|
<main>
|
||||||
<h1>NAS Config</h1>
|
<h1>Proxy Config</h1>
|
||||||
<div class="muted">Управляемые секции Caddy и dnsmasq. Перед применением конфигурация проверяется, при ошибке выполняется откат.</div>
|
<div class="muted">Управляемые секции Caddy и dnsmasq. Перед применением конфигурация проверяется, при ошибке выполняется откат.</div>
|
||||||
|
<div class="muted">Авторизация: {{ 'включена' if auth_enabled else 'отключена' }}.</div>
|
||||||
|
|
||||||
{% with messages = get_flashed_messages(with_categories=true) %}
|
{% with messages = get_flashed_messages(with_categories=true) %}
|
||||||
{% for category, message in messages %}<div class="flash {{ category }}">{{ message }}</div>{% endfor %}
|
{% for category, message in messages %}<div class="flash {{ category }}">{{ message }}</div>{% endfor %}
|
||||||
@@ -757,7 +840,7 @@ TEMPLATE = r"""
|
|||||||
<section class="card">
|
<section class="card">
|
||||||
<div class="head">
|
<div class="head">
|
||||||
<h2>Caddy</h2>
|
<h2>Caddy</h2>
|
||||||
<span class="status"><span class="dot {{ 'ok' if caddy_ok else '' }}"></span>{{ 'config OK' if caddy_ok else 'config ERROR' }}</span>
|
<span class="status"><span class="dot {{ 'ok' if caddy_ok else '' }}"></span>{{ 'конфигурация OK' if caddy_ok else 'ошибка конфигурации' }}</span>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<form class="add" method="post" action="{{ url_for('caddy_add') }}">
|
<form class="add" method="post" action="{{ url_for('caddy_add') }}">
|
||||||
@@ -793,16 +876,23 @@ TEMPLATE = r"""
|
|||||||
<section class="card">
|
<section class="card">
|
||||||
<div class="head">
|
<div class="head">
|
||||||
<h2>dnsmasq</h2>
|
<h2>dnsmasq</h2>
|
||||||
<span class="status"><span class="dot {{ 'ok' if dns_ok else '' }}"></span>{{ 'config OK' if dns_ok else 'config ERROR' }}</span>
|
<span class="status"><span class="dot {{ 'ok' if dns_ok else '' }}"></span>{{ 'конфигурация OK' if dns_ok else 'ошибка конфигурации' }}</span>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<form class="add" method="post" action="{{ url_for('dns_add') }}">
|
<form class="add" method="post" action="{{ url_for('dns_add') }}">
|
||||||
<input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
|
<input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
|
||||||
<label class="wide">Домен<input type="text" name="domain" required placeholder="example.com или .example.com"></label>
|
<label class="wide">Домен<input type="text" name="domain" required placeholder="example.com или .example.com"></label>
|
||||||
<div class="muted wide">Все новые записи направляются на <code>{{ dns_target_ip }}</code> (настройка DNSMASQ_TARGET_IP).</div>
|
<div class="wide muted">Все новые записи направляются на {{ dns_target_ip }}.</div>
|
||||||
<button class="wide" type="submit">Добавить DNS-запись</button>
|
<button class="wide" type="submit">Добавить DNS-запись</button>
|
||||||
</form>
|
</form>
|
||||||
|
|
||||||
|
<form class="dns-tools" method="post" action="{{ url_for('dns_import') }}" enctype="multipart/form-data">
|
||||||
|
<input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
|
||||||
|
<label>Импорт списка доменов (.txt, один домен на строку)<input type="file" name="file" accept=".txt,text/plain" required></label>
|
||||||
|
<button type="submit">Импортировать</button>
|
||||||
|
</form>
|
||||||
|
<p><a class="button-link" href="{{ url_for('dns_export') }}">Экспортировать список доменов</a></p>
|
||||||
|
|
||||||
<table>
|
<table>
|
||||||
<thead><tr><th>Domain</th><th>IP</th><th></th></tr></thead>
|
<thead><tr><th>Domain</th><th>IP</th><th></th></tr></thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
ADMIN_USER=admin
|
ADMIN_USER=admin
|
||||||
ADMIN_PASSWORD=CHANGE_ME_TO_A_LONG_RANDOM_PASSWORD
|
ADMIN_PASSWORD=CHANGE_ME_TO_A_LONG_RANDOM_PASSWORD
|
||||||
APP_SECRET=CHANGE_ME_TO_ANOTHER_LONG_RANDOM_SECRET
|
APP_SECRET=CHANGE_ME_TO_ANOTHER_LONG_RANDOM_SECRET
|
||||||
|
AUTH_ENABLED=false
|
||||||
|
|
||||||
CADDYFILE=/etc/caddy/Caddyfile
|
CADDYFILE=/etc/caddy/Caddyfile
|
||||||
DNSMASQ_CONF=/etc/dnsmasq.conf
|
DNSMASQ_CONF=/etc/dnsmasq.conf
|
||||||
|
|||||||
Reference in New Issue
Block a user