Добавил в readme как установить

This commit is contained in:
2026-09-30 22:10:38 +03:00
parent aad200dd82
commit 822a64a992
+171
View File
@@ -82,6 +82,162 @@ dnsmasq --test
systemctl restart dnsmasq systemctl restart dnsmasq
``` ```
## Установка
### 1. Установка системных пакетов
На Debian 13 установите необходимые пакеты:
```bash
sudo apt update
sudo apt install -y python3-venv unzip
```
### 2. Размещение приложения
Распакуйте архив приложения и разместите его в `/opt/nas-config-web`.
Например:
```bash
sudo mkdir -p /opt/nas-config-web
sudo unzip nas-config-web.zip -d /opt/
```
После распаковки в каталоге `/opt/nas-config-web` должны находиться как минимум:
```text
app.py
requirements.txt
nas-config-web.service
nas-config-web.env.example
README.md
```
### 3. Создание Python-окружения
Создайте виртуальное окружение:
```bash
sudo python3 -m venv /opt/nas-config-web/venv
```
Установите зависимости:
```bash
sudo /opt/nas-config-web/venv/bin/pip install \
-r /opt/nas-config-web/requirements.txt
```
### 4. Настройка приложения
Скопируйте пример файла настроек:
```bash
sudo cp /opt/nas-config-web/nas-config-web.env.example \
/etc/nas-config-web.env
```
Откройте его для редактирования:
```bash
sudo nano /etc/nas-config-web.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/nas-config-web
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/nas-config-web.env
```
### 5. Установка службы systemd
Скопируйте unit-файл:
```bash
sudo cp /opt/nas-config-web/nas-config-web.service \
/etc/systemd/system/nas-config-web.service
```
Перечитайте конфигурацию systemd:
```bash
sudo systemctl daemon-reload
```
Включите автозапуск и сразу запустите приложение:
```bash
sudo systemctl enable --now nas-config-web
```
Проверьте состояние:
```bash
sudo systemctl status nas-config-web
```
При нормальной работе статус должен содержать:
```text
Active: active (running)
```
### 6. Просмотр журналов
Для просмотра последних сообщений:
```bash
sudo journalctl -u nas-config-web -n 100 --no-pager
```
Для просмотра журнала в реальном времени:
```bash
sudo journalctl -u nas-config-web -f
```
### 7. Локальная проверка
По умолчанию приложение должно быть доступно только на:
```text
127.0.0.1:8090
```
Проверить его с самого мини-ПК можно командой:
```bash
curl http://127.0.0.1:8090
```
Если приложение отвечает, можно настраивать доступ к нему через Caddy.
## Доступ к веб-интерфейсу ## Доступ к веб-интерфейсу
Приложение должно слушать только локальный адрес: Приложение должно слушать только локальный адрес:
@@ -94,3 +250,18 @@ systemctl restart dnsmasq
Блок Caddy, который проксирует веб-интерфейс NAS Config Web, должен находиться **вне управляемых маркеров**, Блок Caddy, который проксирует веб-интерфейс NAS Config Web, должен находиться **вне управляемых маркеров**,
чтобы приложение никогда не изменяло собственную точку доступа. чтобы приложение никогда не изменяло собственную точку доступа.
### Пример
```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
}
```