Установка и настройка qBittorrent на TrueNAS: Пошаговое руководство | AdminWiki

truenas qbittorrent: Полное руководство по установке и настройке торрент-клиента

08 января 2026 7 мин. чтения #docker #nas #qbittorrent #torrent #truenas #настройка #установка

Представь, что твой TrueNAS — это не просто хранилище, а полноценная медиастанция, которая сама загружает контент по расписанию. Сегодня мы разберем, как установить и настроить qBittorrent на TrueNAS — мощный торрент-клиент с Web-интерфейсом, который превратит твой NAS в автономную загрузочную машину.

Почему именно qBittorrent на TrueNAS?

В отличие от встроенных решений, qBittorrent предлагает:

  • Полноценный Web-интерфейс с удаленным управлением
  • Поддержка RSS-фидов для автоматических загрузок
  • Гибкая настройка ограничений скорости
  • Встроенный поиск по трекерам
  • Поддержка категорий и тегов
Важно: Мы будем использовать Docker-контейнер через TrueNAS Apps (ранее TrueCharts). Это самый стабильный и удобный метод установки qBittorrent на TrueNAS.

Подготовка TrueNAS к установке qBittorrent

Перед тем как установить qBittorrent на TrueNAS, нужно подготовить систему:

1. Настройка путей и dataset'ов

Создадим отдельные dataset'ы для данных qBittorrent:

bash
# Рекомендуемая структура каталогов:
/mnt/pool/torrents/
├── downloads/     # Готовые загрузки
├── incomplete/    # Незавершенные загрузки
├── config/        # Конфигурация qBittorrent
└── watch/         # Папка для автоматических загрузок

2. Установка TrueCharts каталога

Если у тебя еще не установлен каталог TrueCharts:

  1. Зайди в "Apps" → "Manage Catalogs"
  2. Нажми "Add Catalog"
  3. Введи:
    • Name: truecharts
    • Repository: https://github.com/truecharts/catalog
    • Branch: main
  4. Нажми "Save" и дождись синхронизации

Установка qBittorrent на TrueNAS

Теперь перейдем к основной части — установке qBittorrent на TrueNAS через Apps:

Шаг 1: Поиск и настройка приложения

  1. Зайди в раздел "Apps"
  2. В поиске введи "qbittorrent"
  3. Выбери "qbittorrent" от TrueCharts
  4. Нажми "Install"

Шаг 2: Базовая конфигурация

В разделе "Application Name" укажи удобное имя, например qbittorrent-nas.

Внимание: Не используй пробелы в имени приложения. Используй дефисы или нижние подчеркивания.

Шаг 3: Настройка хранилищ (Storage)

Это самый важный этап настройки qBittorrent на TrueNAS. Добавь следующие mount points:

Тип Host Path Mount Path Назначение
Host Path /mnt/pool/torrents/config /config Конфигурация
Host Path /mnt/pool/torrents/downloads /downloads Завершенные загрузки
Host Path /mnt/pool/torrents/incomplete /incomplete Незавершенные загрузки

Шаг 4: Настройка сети и портов

Для работы торрентов нужно пробросить порты:

yaml
# В разделе Network Configuration:
Service Type: ClusterIP  # или NodePort для прямого доступа

# В разделе Port Forwarding добавь:
- containerPort: 8080    # Web-интерфейс
  hostPort: 8080         # Локальный порт
  name: web
  protocol: TCP

- containerPort: 6881    # Торрент-порт
  hostPort: 6881
  name: torrent
  protocol: TCP
Совет: Для внешнего доступа настрой проброс портов на роутере (6881 для торрентов, 8080 для Web-интерфейса) или используй VPN/WireGuard для безопасного доступа.

Шаг 5: Настройка переменных окружения

Добавь следующие переменные для кастомизации:

env
WEBUI_PORT=8080
PUID=1000          # UID пользователя TrueNAS
PGID=1000          # GID группы
TZ=Europe/Moscow   # Твоя временная зона

Шаг 6: Запуск и проверка

  1. Нажми "Install" и дождись развертывания (2-5 минут)
  2. После установки зайди в "Installed Applications"
  3. Найди qBittorrent и открой Web-интерфейс
  4. Стандартные учетные данные:
    • Логин: admin
    • Пароль: adminadmin

Оптимальная настройка qBittorrent на TrueNAS

После входа в Web-интерфейс выполни следующие настройки:

1. Смена пароля и безопасность

Зайди в "Tools" → "Options" → "Web UI":

  • Смени пароль администратора
  • Включи "Authentication"
  • Настрой "Alternative UI" если нужно (например, VueTorrent)

2. Настройка путей загрузки

В разделе "Downloads":

config
Default Save Path: /downloads
Keep Incomplete In: /incomplete
Append .!qB Extension: Да
Pre-allocate Disk Space: Да

3. Оптимизация скорости

В разделе "Speed":

Параметр Значение Описание
Global Rate Limits По необходимости Чтобы не забить канал
Upload Slots per Torrent 4 Оптимально для HDD
Connections per Torrent 100 Баланс скорости и нагрузки

4. Настройка RSS и автоматизации

Для автоматических загрузок:

  1. Зайди в "RSS" → "Add Subscription"
  2. Укажи RSS-ленту трекера
  3. Настрой фильтры по ключевым словам
  4. Укажи папку для автоматической загрузки

Решение частых проблем

Проблема 1: Нет доступа к Web-интерфейсу

Решение:

bash
# Проверь статус приложения:
1. Apps → Installed Applications
2. Найди qBittorrent → три точки → Details
3. Проверь статус контейнера

# Если контейнер не запускается:
1. Проверь логи (три точки → Logs)
2. Убедись, что пути к dataset'ам существуют
3. Проверь права доступа (chmod 777 для теста)

Проблема 2: Медленная скорость загрузки

  • Проверь проброс порта 6881 на роутере
  • Включи DHT, PeX и Local Peer Discovery
  • Попробуй разные порты (6881-6889)
  • Проверь ограничения провайдера

Проблема 3: Ошибки записи на диск

Скорее всего проблема с правами:

bash
# На TrueNAS через Shell:
sudo chown -R 1000:1000 /mnt/pool/torrents/
sudo chmod -R 755 /mnt/pool/torrents/

Интеграция с медиа-серверами

Чтобы автоматически добавлять загруженный контент в Plex/Jellyfin:

bash
# 1. Настрой категории в qBittorrent:
Movies → /downloads/movies
TV Shows → /downloads/tv

# 2. Настрой автоматическую сортировку через:
Tools → Options → Downloads

# 3. Укажи пути в Plex/Jellyfin:
/mnt/pool/torrents/downloads/movies
/mnt/pool/torrents/downloads/tv
Продвинутый совет: Используй скрипты post-processing (например, с FileBot) для автоматического переименования файлов и организации библиотеки.

Безопасность и лучшие практики

  • Используй VPN: Настрой контейнер с поддержкой VPN (например, gluetun) для маршрутизации трафика qBittorrent
  • Регулярные бэкапы: Экспортируй настройки qBittorrent через Web-интерфейс
  • Мониторинг: Настрой уведомления о завершении загрузок (Telegram бот)
  • Обновления: Регулярно обновляй контейнер через TrueNAS Apps

Альтернативные методы установки

Если метод с TrueCharts не работает, можно использовать:

1. Docker Compose вручную

docker-compose.yml
version: '3.8'
services:
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Moscow
      - WEBUI_PORT=8080
    volumes:
      - /mnt/pool/torrents/config:/config
      - /mnt/pool/torrents/downloads:/downloads
      - /mnt/pool/torrents/incomplete:/incomplete
    ports:
      - 8080:8080
      - 6881:6881
      - 6881:6881/udp
    restart: unless-stopped

2. Плагин (устаревший метод)

Внимание: Плагины устарели в TrueNAS Scale. Используй Apps (Docker) для лучшей совместимости и поддержки.

Итог

Теперь у тебя есть полностью настроенный qBittorrent на TrueNAS, который:

  • Работает 24/7 без нагрузки на основной компьютер
  • Имеет Web-интерфейс для управления с любого устройства
  • Поддерживает автоматические загрузки через RSS
  • Интегрируется с медиа-серверами
  • Защищен правильной настройкой прав доступа

Остались вопросы? Проверь FAQ ниже или напиши в комментариях — разберем конкретные кейсы!

Поделиться:
Сохранить гайд? В закладки браузера