refactor: split into two stacks - searchFilms/ (NL) and app/ (RU)
This commit is contained in:
vrubelroman
parent
6ef3a10d0d
commit
51348a9d23
36 changed files with 326 additions and 1271 deletions
540
README.md
540
README.md
|
|
@ -1,469 +1,79 @@
|
|||
# 🎬 searchTorrentDownl
|
||||
# findFilms — поиск и скачивание фильмов
|
||||
|
||||
**Полнофункциональная система для поиска и загрузки фильмов через торренты с Telegram ботом**
|
||||
|
||||
[](https://www.docker.com/)
|
||||
[](https://python.org/)
|
||||
[](https://fastapi.tiangolo.com/)
|
||||
[](https://telegram.org/)
|
||||
|
||||
## 🎯 Описание проекта
|
||||
|
||||
**searchTorrentDownl** - это современная система для поиска и загрузки фильмов, которая объединяет:
|
||||
- 🌐 **Веб-интерфейс** с адаптивным дизайном
|
||||
- 🤖 **Telegram бот** с полной функциональностью
|
||||
- 🔍 **Поиск фильмов** через TMDB API
|
||||
- 🎬 **Поиск торрентов** на популярных трекерах
|
||||
- ⬇️ **Автоматическое добавление** в qBittorrent
|
||||
- 🔔 **Уведомления** о завершении загрузки
|
||||
|
||||
### ✨ Основные возможности
|
||||
|
||||
- **🎬 Поиск фильмов** - интеллектуальный поиск с постерами и описаниями
|
||||
- **🔍 Поиск торрентов** - на всех популярных трекерах (RuTracker, Kinozal, RuTor, NoNameClub)
|
||||
- **📱 Telegram бот** - полная функциональность в мессенджере
|
||||
- **🌐 Веб-интерфейс** - удобный поиск и навигация
|
||||
- **⬇️ Автоматическая загрузка** - добавление торрентов в qBittorrent одним кликом
|
||||
- **🔔 Уведомления** - сообщения о завершении загрузки в Telegram
|
||||
- **🐳 Docker** - полная контейнеризация для простого развертывания
|
||||
|
||||
## 🏗️ Архитектура системы
|
||||
|
||||
```
|
||||
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
|
||||
│ Telegram Bot │ │ Web Interface │ │ qBittorrent │
|
||||
│ (Docker) │ │ (Docker) │ │ (Host) │
|
||||
└─────────┬───────┘ └─────────┬───────┘ └─────────┬───────┘
|
||||
│ │ │
|
||||
└──────────────────────┼──────────────────────┘
|
||||
│
|
||||
┌─────────────┴─────────────┐
|
||||
│ FastAPI App │
|
||||
│ (Movie Search API) │
|
||||
└─────────────┬─────────────┘
|
||||
│
|
||||
┌─────────────┴─────────────┐
|
||||
│ TMDB API │
|
||||
│ (Movie Information) │
|
||||
└─────────────┬─────────────┘
|
||||
│
|
||||
┌─────────────┴─────────────┐
|
||||
│ TorAPI │
|
||||
│ (Torrent Search) │
|
||||
└───────────────────────────┘
|
||||
```
|
||||
|
||||
### 🔧 Компоненты системы
|
||||
|
||||
1. **FastAPI приложение** (Docker) - основной веб-сервис и API
|
||||
2. **Telegram Bot** (Docker) - бот для мессенджера
|
||||
3. **TorAPI-Search** (Docker) - поиск торрентов по названию
|
||||
4. **TorAPI-qBittorrent** (Docker) - получение magnet ссылок
|
||||
5. **qBittorrent-nox** (Host) - клиент для загрузки торрентов
|
||||
|
||||
## 📋 Системные требования
|
||||
|
||||
### Минимальные требования
|
||||
- **ОС**: Linux (Ubuntu 20.04+, Debian 11+)
|
||||
- **RAM**: 2GB
|
||||
- **Диск**: 10GB свободного места
|
||||
- **CPU**: 2 ядра
|
||||
|
||||
### Необходимое ПО
|
||||
- **Docker**: 20.10+
|
||||
- **Docker Compose**: 2.0+
|
||||
- **qBittorrent-nox**: 4.6.7+
|
||||
|
||||
## 🚀 Быстрый старт
|
||||
|
||||
### 1️⃣ Автоматическое развертывание (рекомендуется)
|
||||
|
||||
```bash
|
||||
# Клонируйте репозиторий
|
||||
git clone <repository-url>
|
||||
cd searchTorrentDownl
|
||||
|
||||
# Запустите скрипт развертывания
|
||||
chmod +x deploy.sh
|
||||
./deploy.sh
|
||||
```
|
||||
|
||||
Скрипт автоматически:
|
||||
- Установит все зависимости
|
||||
- Настроит qBittorrent
|
||||
- Запустит все сервисы
|
||||
- Покажет статус системы
|
||||
|
||||
### 2️⃣ Ручное развертывание
|
||||
|
||||
#### Шаг 1: Установка зависимостей
|
||||
|
||||
```bash
|
||||
# Обновление системы
|
||||
sudo apt update && sudo apt upgrade -y
|
||||
|
||||
# Установка Docker
|
||||
curl -fsSL https://get.docker.com -o get-docker.sh
|
||||
sudo sh get-docker.sh
|
||||
sudo usermod -aG docker $USER
|
||||
|
||||
# Установка Docker Compose
|
||||
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
|
||||
sudo chmod +x /usr/local/bin/docker-compose
|
||||
|
||||
# Установка qBittorrent
|
||||
sudo apt install -y qbittorrent-nox
|
||||
```
|
||||
|
||||
#### Шаг 2: Настройка qBittorrent
|
||||
|
||||
```bash
|
||||
# Создание пользователя
|
||||
sudo useradd -r -s /bin/false qbittorrent
|
||||
|
||||
# Создание systemd сервиса
|
||||
sudo tee /etc/systemd/system/qbittorrent.service > /dev/null <<EOF
|
||||
[Unit]
|
||||
Description=qBittorrent-nox
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
User=qbittorrent
|
||||
Group=qbittorrent
|
||||
ExecStart=/usr/bin/qbittorrent-nox --webui-port=8080
|
||||
Restart=always
|
||||
RestartSec=5
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
EOF
|
||||
|
||||
# Запуск сервиса
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl enable qbittorrent
|
||||
sudo systemctl start qbittorrent
|
||||
```
|
||||
|
||||
#### Шаг 3: Настройка проекта
|
||||
|
||||
```bash
|
||||
# Создание Docker сети
|
||||
docker network create torrentvideo_default
|
||||
|
||||
# Копирование конфигурации
|
||||
cp env.example .env
|
||||
|
||||
# Редактирование конфигурации
|
||||
nano .env
|
||||
```
|
||||
|
||||
#### Шаг 4: Запуск сервисов
|
||||
|
||||
```bash
|
||||
# Запуск всех сервисов
|
||||
docker compose up -d --build
|
||||
|
||||
# Проверка статуса
|
||||
docker ps
|
||||
```
|
||||
|
||||
## ⚙️ Конфигурация
|
||||
|
||||
### 🔑 Получение API ключей
|
||||
|
||||
#### TMDB API Key
|
||||
1. Зарегистрируйтесь на [themoviedb.org](https://www.themoviedb.org/)
|
||||
2. Перейдите в [Settings > API](https://www.themoviedb.org/settings/api)
|
||||
3. Создайте новый API ключ
|
||||
4. Скопируйте ключ в файл `.env`
|
||||
|
||||
#### Telegram Bot Token
|
||||
1. Найдите [@BotFather](https://t.me/BotFather) в Telegram
|
||||
2. Отправьте команду `/newbot`
|
||||
3. Следуйте инструкциям для создания бота
|
||||
4. Скопируйте токен в файл `.env`
|
||||
|
||||
### 📝 Файл конфигурации (.env)
|
||||
|
||||
```bash
|
||||
# TMDB API Key
|
||||
TMDB_API_KEY=your_tmdb_api_key_here
|
||||
|
||||
# Telegram Bot Token
|
||||
TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here
|
||||
|
||||
# qBittorrent настройки
|
||||
QBITTORRENT_USERNAME=admin
|
||||
QBITTORRENT_PASSWORD=admin
|
||||
QBITTORRENT_HOST=host.docker.internal
|
||||
QBITTORRENT_PORT=8080
|
||||
|
||||
# TorAPI настройки
|
||||
TORRENT_SEARCH_URL=http://host.docker.internal:8443
|
||||
TORRENT_ADD_URL=http://host.docker.internal:8088
|
||||
```
|
||||
|
||||
## 🌐 Использование
|
||||
|
||||
### Веб-интерфейс
|
||||
1. Откройте http://localhost:8089
|
||||
2. Введите название фильма
|
||||
3. Выберите фильм из результатов
|
||||
4. Выберите торрент для скачивания
|
||||
5. Торрент автоматически добавится в qBittorrent
|
||||
|
||||
### Telegram Bot
|
||||
1. Найдите вашего бота в Telegram
|
||||
2. Отправьте команду `/start` или `/find`
|
||||
3. Введите название фильма
|
||||
4. Выберите фильм из списка
|
||||
5. Нажмите "Найти торренты"
|
||||
6. Выберите нужный торрент
|
||||
7. Получите уведомление о завершении загрузки
|
||||
|
||||
### qBittorrent
|
||||
- **Веб-интерфейс**: http://localhost:8080
|
||||
- **Логин по умолчанию**: admin / admin
|
||||
- **Настройка папок**: Settings > Downloads
|
||||
|
||||
## 📁 Структура проекта
|
||||
|
||||
```
|
||||
searchTorrentDownl/
|
||||
├── app.py # Основное FastAPI приложение
|
||||
├── telegram_bot.py # Telegram бот
|
||||
├── run_telegram_bot.py # Скрипт запуска бота
|
||||
├── deploy.sh # Скрипт автоматического развертывания
|
||||
├── start_all.sh # Скрипт запуска (локально)
|
||||
├── requirements.txt # Python зависимости
|
||||
├── env.example # Пример конфигурации
|
||||
├── Dockerfile # Docker образ основного приложения
|
||||
├── Dockerfile.telegram # Docker образ Telegram бота
|
||||
├── docker-compose.yml # Docker Compose конфигурация
|
||||
├── templates/ # HTML шаблоны
|
||||
│ ├── index.html # Главная страница
|
||||
│ ├── results.html # Результаты поиска фильмов
|
||||
│ ├── torrents.html # Результаты поиска торрентов
|
||||
│ └── error.html # Страница ошибок
|
||||
├── README.md # Основная документация
|
||||
├── TELEGRAM_BOT_README.md # Документация Telegram бота
|
||||
└── PROJECT_SUMMARY.md # Сводка проекта
|
||||
```
|
||||
|
||||
## 🔧 Управление сервисами
|
||||
|
||||
### Основные команды
|
||||
|
||||
```bash
|
||||
# Запуск всех сервисов
|
||||
docker compose up -d
|
||||
|
||||
# Остановка всех сервисов
|
||||
docker compose down
|
||||
|
||||
# Перезапуск сервисов
|
||||
docker compose restart
|
||||
|
||||
# Просмотр логов
|
||||
docker compose logs -f
|
||||
|
||||
# Просмотр статуса
|
||||
docker ps
|
||||
```
|
||||
|
||||
### Управление отдельными сервисами
|
||||
|
||||
```bash
|
||||
# Запуск только веб-приложения
|
||||
docker compose up -d movie-search
|
||||
|
||||
# Запуск только Telegram бота
|
||||
docker compose up -d telegram-bot
|
||||
|
||||
# Перезапуск TorAPI
|
||||
docker compose restart torapi-search torapi-qbittorrent
|
||||
```
|
||||
|
||||
### Управление qBittorrent
|
||||
|
||||
```bash
|
||||
# Запуск
|
||||
sudo systemctl start qbittorrent
|
||||
|
||||
# Остановка
|
||||
sudo systemctl stop qbittorrent
|
||||
|
||||
# Статус
|
||||
sudo systemctl status qbittorrent
|
||||
|
||||
# Логи
|
||||
sudo journalctl -u qbittorrent -f
|
||||
```
|
||||
|
||||
## 🐛 Устранение неполадок
|
||||
|
||||
### Проблемы с Docker
|
||||
|
||||
```bash
|
||||
# Проверка статуса контейнеров
|
||||
docker ps -a
|
||||
|
||||
# Просмотр логов
|
||||
docker logs <container_name>
|
||||
|
||||
# Пересборка контейнеров
|
||||
docker compose up -d --build --force-recreate
|
||||
```
|
||||
|
||||
### Проблемы с qBittorrent
|
||||
|
||||
```bash
|
||||
# Проверка статуса
|
||||
sudo systemctl status qbittorrent
|
||||
|
||||
# Перезапуск
|
||||
sudo systemctl restart qbittorrent
|
||||
|
||||
# Проверка портов
|
||||
netstat -tlnp | grep 8080
|
||||
```
|
||||
|
||||
### Проблемы с сетью
|
||||
|
||||
```bash
|
||||
# Проверка Docker сетей
|
||||
docker network ls
|
||||
|
||||
# Создание сети заново
|
||||
docker network rm torrentvideo_default
|
||||
docker network create torrentvideo_default
|
||||
```
|
||||
|
||||
### Проблемы с API
|
||||
|
||||
```bash
|
||||
# Проверка TMDB API
|
||||
curl "https://api.themoviedb.org/3/movie/550?api_key=YOUR_API_KEY"
|
||||
|
||||
# Проверка Telegram Bot
|
||||
curl "https://api.telegram.org/botYOUR_BOT_TOKEN/getMe"
|
||||
|
||||
# Проверка TorAPI
|
||||
curl "http://localhost:8443/api/provider/list"
|
||||
```
|
||||
|
||||
## 📊 Мониторинг
|
||||
|
||||
### Логи сервисов
|
||||
|
||||
```bash
|
||||
# Все сервисы
|
||||
docker compose logs -f
|
||||
|
||||
# Конкретный сервис
|
||||
docker logs -f movie-search
|
||||
docker logs -f telegram-bot
|
||||
docker logs -f TorAPI-Search
|
||||
docker logs -f TorAPI-qBittorrent
|
||||
```
|
||||
|
||||
### Мониторинг ресурсов
|
||||
|
||||
```bash
|
||||
# Использование ресурсов контейнерами
|
||||
docker stats
|
||||
|
||||
# Использование диска
|
||||
df -h
|
||||
|
||||
# Использование памяти
|
||||
free -h
|
||||
```
|
||||
|
||||
## 🔒 Безопасность
|
||||
|
||||
### Рекомендации
|
||||
|
||||
1. **Измените пароли по умолчанию**
|
||||
```bash
|
||||
# В файле .env
|
||||
QBITTORRENT_PASSWORD=your_secure_password
|
||||
```
|
||||
|
||||
2. **Настройте файрвол**
|
||||
```bash
|
||||
sudo ufw allow 8080 # qBittorrent
|
||||
sudo ufw allow 8089 # Web interface
|
||||
sudo ufw enable
|
||||
```
|
||||
|
||||
3. **Используйте HTTPS в продакшене**
|
||||
- Настройте reverse proxy (nginx)
|
||||
- Получите SSL сертификат
|
||||
|
||||
4. **Регулярно обновляйте зависимости**
|
||||
```bash
|
||||
docker compose pull
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
## 🚀 Развертывание в продакшене
|
||||
|
||||
### Настройка reverse proxy (nginx)
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name your-domain.com;
|
||||
|
||||
location / {
|
||||
proxy_pass http://localhost:8089;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Использование Docker Swarm
|
||||
|
||||
```bash
|
||||
# Инициализация Swarm
|
||||
docker swarm init
|
||||
|
||||
# Развертывание стека
|
||||
docker stack deploy -c docker-compose.yml searchtorrentdownl
|
||||
```
|
||||
|
||||
## 🤝 Вклад в проект
|
||||
|
||||
1. Форкните репозиторий
|
||||
2. Создайте ветку для новой функции
|
||||
3. Внесите изменения
|
||||
4. Создайте Pull Request
|
||||
|
||||
## 📄 Лицензия
|
||||
|
||||
Этот проект распространяется под лицензией MIT. См. файл [LICENSE](LICENSE) для подробностей.
|
||||
|
||||
## 🆘 Поддержка
|
||||
|
||||
При возникновении проблем:
|
||||
|
||||
1. Проверьте [раздел устранения неполадок](#-устранение-неполадок)
|
||||
2. Изучите логи сервисов
|
||||
3. Создайте issue в репозитории
|
||||
4. Опишите проблему и приложите логи
|
||||
|
||||
## 📈 Планы развития
|
||||
|
||||
- [ ] Поддержка дополнительных трекеров
|
||||
- [ ] Веб-интерфейс для управления ботом
|
||||
- [ ] Система уведомлений по email
|
||||
- [ ] API для интеграции с другими приложениями
|
||||
- [ ] Поддержка сериалов и аниме
|
||||
- [ ] Мобильное приложение
|
||||
Двухстековая архитектура: **searchFilms/** на NL-хосте (Голландия, без блокировок), **app/** на RU-хосте (Россия). Между собой общаются по HTTP через интернет.
|
||||
|
||||
---
|
||||
|
||||
**Создано с ❤️ для удобного поиска и загрузки фильмов**
|
||||
## Архитектура
|
||||
|
||||
```
|
||||
searchFilms/ (NL, 72.56.91.135) internet app/ (RU, 192.168.8.173)
|
||||
┌─────────────────────────┐ HTTP ┌─────────────────────────────┐
|
||||
│ tmdb-proxy (:8001) │ ←──────────→ │ movie-search (:8089) │
|
||||
│ torapi-search (:8443) │ поиск │ telegram-bot │
|
||||
│ │ │ qBittorrent (:8080) │
|
||||
└─────────────────────────┘ └─────────────────────────────┘
|
||||
```
|
||||
|
||||
**Поток данных:**
|
||||
1. Пользователь ищет фильм → movie-search делает запрос к **tmdb-proxy** (NL)
|
||||
2. Пользователь ищет торренты → movie-search делает запрос к **torapi-search** (NL)
|
||||
3. Пользователь добавляет торрент → movie-search отдаёт magnet-ссылку в **qBittorrent** (локально)
|
||||
|
||||
NL-хосту **не нужен** доступ к RU — только RU ходит к NL.
|
||||
|
||||
---
|
||||
|
||||
## Быстрый старт
|
||||
|
||||
### 🌍 SearchFilms Stack — на голландском хосте (72.56.91.135)
|
||||
|
||||
```bash
|
||||
cd searchFilms
|
||||
cp .env.example .env # указать TMDB_API_KEY
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
Откроет порты:
|
||||
- `:8001` — TMDB API Proxy
|
||||
- `:8443` — TorAPI Search
|
||||
|
||||
### 🏠 App Stack — на хосте в России
|
||||
|
||||
```bash
|
||||
cd app
|
||||
cp .env.example .env # указать TELEGRAM_BOT_TOKEN
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
Откроет:
|
||||
- `:8089` — веб-интерфейс
|
||||
- Telegram бот (ждёт команды `/start`)
|
||||
|
||||
### Переменные окружения
|
||||
|
||||
| Переменная | Где | Назначение |
|
||||
|---|---|---|
|
||||
| `NL_HOST` | `app/.env` | IP голландского хоста (по умолч. `72.56.91.135`) |
|
||||
| `TELEGRAM_BOT_TOKEN` | `app/.env` | Токен бота от @BotFather |
|
||||
| `TMDB_API_KEY` | `search/.env` | Ключ TMDB API |
|
||||
| `QBITTORRENT_USERNAME` | `app/.env` | Логин qBittorrent |
|
||||
| `QBITTORRENT_PASSWORD` | `app/.env` | Пароль qBittorrent |
|
||||
|
||||
---
|
||||
|
||||
## Структура
|
||||
|
||||
```
|
||||
findFilms/
|
||||
├── README.md ← этот файл
|
||||
├── PROJECT_SUMMARY.md ← архитектура
|
||||
├── searchFilms/ ← NL-стек
|
||||
│ ├── docker-compose.yml
|
||||
│ ├── .env.example
|
||||
│ └── tmdb-proxy/ ← build-зависимость
|
||||
└── app/ ← RU-стек
|
||||
├── docker-compose.yml
|
||||
├── .env.example
|
||||
├── app.py / telegram_bot.py / templates / Dockerfile / ...
|
||||
```
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue