еще правки описания

This commit is contained in:
2026-09-30 22:23:20 +03:00
parent 822a64a992
commit 6018107a79
+40 -29
View File
@@ -1,4 +1,4 @@
# NAS Config Web # web-proxy-config
Небольшой локальный веб-интерфейс на Flask/Gunicorn для управления только участками между Небольшой локальный веб-интерфейс на Flask/Gunicorn для управления только участками между
`#begin marker` и `#end marker` в файлах Caddyfile и dnsmasq.conf. `#begin marker` и `#end marker` в файлах Caddyfile и dnsmasq.conf.
@@ -91,52 +91,63 @@ systemctl restart dnsmasq
```bash ```bash
sudo apt update 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 ```bash
sudo mkdir -p /opt/nas-config-web cd /opt/web-proxy-config
sudo unzip nas-config-web.zip -d /opt/
``` ```
После распаковки в каталоге `/opt/nas-config-web` должны находиться как минимум: Получите последние изменения из Git-репозитория:
```bash
git pull
```
### 3. Создание виртуального окружения
Находясь в каталоге проекта, создайте виртуальное окружение `.venv`:
```bash
python3 -m venv .venv
```
Активируйте его:
```bash
source .venv/bin/activate
```
После активации в начале командной строки обычно появится:
```text ```text
app.py (.venv)
requirements.txt
nas-config-web.service
nas-config-web.env.example
README.md
``` ```
### 3. Создание Python-окружения ### 4. Установка зависимостей
Создайте виртуальное окружение: Находясь в активированном виртуальном окружении, установите зависимости:
```bash ```bash
sudo python3 -m venv /opt/nas-config-web/venv pip install -r requirements.txt
``` ```
Установите зависимости: При необходимости после установки можно выйти из виртуального окружения:
```bash ```bash
sudo /opt/nas-config-web/venv/bin/pip install \ deactivate
-r /opt/nas-config-web/requirements.txt
``` ```
### 4. Настройка приложения ### 5. Настройка приложения
Скопируйте пример файла настроек: Скопируйте пример файла настроек:
```bash ```bash
sudo cp /opt/nas-config-web/nas-config-web.env.example \ sudo cp nas-config-web.env.example /etc/nas-config-web.env
/etc/nas-config-web.env
``` ```
Откройте его для редактирования: Откройте его для редактирования:
@@ -174,13 +185,12 @@ openssl rand -hex 32
sudo chmod 600 /etc/nas-config-web.env sudo chmod 600 /etc/nas-config-web.env
``` ```
### 5. Установка службы systemd ### 6. Установка службы systemd
Скопируйте unit-файл: Находясь в каталоге проекта, скопируйте unit-файл:
```bash ```bash
sudo cp /opt/nas-config-web/nas-config-web.service \ sudo cp nas-config-web.service /etc/systemd/system/nas-config-web.service
/etc/systemd/system/nas-config-web.service
``` ```
Перечитайте конфигурацию systemd: Перечитайте конфигурацию systemd:
@@ -207,7 +217,7 @@ sudo systemctl status nas-config-web
Active: active (running) 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 sudo journalctl -u nas-config-web -f
``` ```
### 7. Локальная проверка ### 8. Локальная проверка
По умолчанию приложение должно быть доступно только на: По умолчанию приложение должно быть доступно только на:
@@ -251,6 +261,7 @@ curl http://127.0.0.1:8090
Блок Caddy, который проксирует веб-интерфейс NAS Config Web, должен находиться **вне управляемых маркеров**, Блок Caddy, который проксирует веб-интерфейс NAS Config Web, должен находиться **вне управляемых маркеров**,
чтобы приложение никогда не изменяло собственную точку доступа. чтобы приложение никогда не изменяло собственную точку доступа.
### Пример ### Пример