From 6018107a79bf08df3211883108e5984cba368c57 Mon Sep 17 00:00:00 2001 From: Fedorov Dmitriy Date: Wed, 30 Sep 2026 22:23:20 +0300 Subject: [PATCH] =?UTF-8?q?=D0=B5=D1=89=D0=B5=20=D0=BF=D1=80=D0=B0=D0=B2?= =?UTF-8?q?=D0=BA=D0=B8=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 69 ++++++++++++++++++++++++++++++++----------------------- 1 file changed, 40 insertions(+), 29 deletions(-) diff --git a/README.md b/README.md index bb7614e..ddf4979 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# NAS Config Web +# web-proxy-config Небольшой локальный веб-интерфейс на Flask/Gunicorn для управления только участками между `#begin marker` и `#end marker` в файлах Caddyfile и dnsmasq.conf. @@ -91,52 +91,63 @@ systemctl restart dnsmasq ```bash sudo apt update -sudo apt install -y python3-venv unzip +sudo apt install -y git python3-venv ``` -### 2. Размещение приложения +### 2. Обновление кода из Git -Распакуйте архив приложения и разместите его в `/opt/nas-config-web`. - -Например: +Перейдите в каталог проекта: ```bash -sudo mkdir -p /opt/nas-config-web -sudo unzip nas-config-web.zip -d /opt/ +cd /opt/web-proxy-config ``` -После распаковки в каталоге `/opt/nas-config-web` должны находиться как минимум: +Получите последние изменения из Git-репозитория: + +```bash +git pull +``` + +### 3. Создание виртуального окружения + +Находясь в каталоге проекта, создайте виртуальное окружение `.venv`: + +```bash +python3 -m venv .venv +``` + +Активируйте его: + +```bash +source .venv/bin/activate +``` + +После активации в начале командной строки обычно появится: ```text -app.py -requirements.txt -nas-config-web.service -nas-config-web.env.example -README.md +(.venv) ``` -### 3. Создание Python-окружения +### 4. Установка зависимостей -Создайте виртуальное окружение: +Находясь в активированном виртуальном окружении, установите зависимости: ```bash -sudo python3 -m venv /opt/nas-config-web/venv +pip install -r requirements.txt ``` -Установите зависимости: +При необходимости после установки можно выйти из виртуального окружения: ```bash -sudo /opt/nas-config-web/venv/bin/pip install \ - -r /opt/nas-config-web/requirements.txt +deactivate ``` -### 4. Настройка приложения +### 5. Настройка приложения Скопируйте пример файла настроек: ```bash -sudo cp /opt/nas-config-web/nas-config-web.env.example \ - /etc/nas-config-web.env +sudo cp nas-config-web.env.example /etc/nas-config-web.env ``` Откройте его для редактирования: @@ -174,13 +185,12 @@ openssl rand -hex 32 sudo chmod 600 /etc/nas-config-web.env ``` -### 5. Установка службы systemd +### 6. Установка службы systemd -Скопируйте unit-файл: +Находясь в каталоге проекта, скопируйте unit-файл: ```bash -sudo cp /opt/nas-config-web/nas-config-web.service \ - /etc/systemd/system/nas-config-web.service +sudo cp nas-config-web.service /etc/systemd/system/nas-config-web.service ``` Перечитайте конфигурацию systemd: @@ -207,7 +217,7 @@ sudo systemctl status nas-config-web Active: active (running) ``` -### 6. Просмотр журналов +### 7. Просмотр журналов Для просмотра последних сообщений: @@ -221,7 +231,7 @@ sudo journalctl -u nas-config-web -n 100 --no-pager sudo journalctl -u nas-config-web -f ``` -### 7. Локальная проверка +### 8. Локальная проверка По умолчанию приложение должно быть доступно только на: @@ -251,6 +261,7 @@ curl http://127.0.0.1:8090 Блок Caddy, который проксирует веб-интерфейс NAS Config Web, должен находиться **вне управляемых маркеров**, чтобы приложение никогда не изменяло собственную точку доступа. + ### Пример