Загрузить файлы в «/»

README.md

@@ -0,0 +1,137 @@
+# TorrentStack
+
+Простой и воспроизводимый стек для работы с торрентами и управления загрузками.
+
+Включает в себя:
+
+- qBittorrent — торрент-клиент
+- Flood — современный веб-интерфейс
+
+---
+
+## 🚀 Быстрый старт
+
+### 1. Узнать UID и GID
+
+```bash
+id -u
+id -g
+```
+
+Если используете NFS-share — для дальнейшей настройки указывайте значения из mapall user / mapall group
+
+---
+
+### 2. Настроить .env
+
+Скопируйте файл `example.env` в файл `.env` и заполните, открыв файл в текстовом редакторе
+
+```bash
+mv example.env .env
+nano .env
+```
+
+Обязательно: `UID`, `GID`, `TZ`
+Опционально: `QBT_WEBUI_PORT`, `FLOOD_WEBUI_PORT`
+
+- UID / GID — пользователь, от которого будут работать контейнеры
+- TZ — временная зона (например Europe/Moscow)
+- QBT_WEBUI_PORT — внешний порт доступа к веб-интерфейсу qBittorrent
+- FLOOD_WEBUI_PORT — внешний порт доступа к веб-интерфейсу Flood
+
+
+---
+
+### 3. Проверить структуру директорий
+
+Убедитесь, что структура директорий на хосте **создана** верно:
+
+```
+torrent/
+├── config
+├── data
+│   ├── flood
+│   └── qbittorrent
+└── media
+    ├── downloads
+    │   ├── complete
+    │   └── incomplete
+    ├── films
+    └── series
+```
+
+Важно:
+- директории должны быть созданы заранее
+- владелец должен соответствовать UID:GID
+
+Пример:
+
+```bash
+mkdir -p torrent/config
+mkdir -p torrent/data/{flood,qbittorrent}
+mkdir -p torrent/media/{downloads,films,series}
+mkdir -p torrent/media/downloads/{complete,incomplete}
+
+sudo chown -R $(id -u):$(id -g) torrent/
+```
+
+---
+
+### 4. Запуск
+
+Перейдите в директорию с docker-compose.yml:
+
+```bash
+cd torrent/config
+docker compose up -d
+```
+
+Либо:
+
+```bash
+docker compose -f path/to/torrent/config/docker-compose.yml up -d
+```
+
+---
+
+## ⚙️ Первичная настройка сервисов
+
+### qBittorrent
+
+1. Перейти по адресу `http://IP:QBT_WEBUI_PORT`
+
+2. Получить Логин/пароль:
+
+```bash
+docker logs qbittorrent
+```
+
+3. Поменять пароль
+`settings → WebUI → Password`
+
+4. Указать папку загрузок:
+`/media/downloads/complete`
+
+---
+
+### Flood
+
+1. Перейти по адресу `http://IP:FLOOD_WEBUI_PORT`
+2. Создайте аккаунт администратора
+3. Укажите данные от входа в qBittorrent
+
+---
+
+## ⚠️ Важные замечания
+
+- /media должен быть одинаковым в обоих контейнерах
+- не создавайте директории от root при использовании UID/GID
+- при NFS внимательно следите за правами
+
+---
+
+Проверено на версиях:
+qbittorrent: linuxserver/qbittorrent:5.1.4-libtorrentv1
+flood: jesec/flood:4.13.0
+
+Если что-то сломалось — используйте конкретные версии вместо latest.