truenas torrserver: Полное руководство по установке и настройке медиасервера на TrueNAS

Что такое TorrServer и зачем он нужен на TrueNAS?

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

Вместо того чтобы скачивать весь файл, TorrServer на TrueNAS позволяет начинать просмотр практически мгновенно, буферизируя и раздавая контент по мере загрузки. Это идеальное решение для домашнего медиасервера.

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

Давай разберем, что нужно сделать перед установкой. Выбор метода зависит от твоей версии TrueNAS:

Общие шаги подготовки

• Убедись, что у тебя создан Dataset для хранения конфигурации TorrServer. Например, /mnt/pool/apps/torrserver.
• Проверь наличие статического IP в твоей сети для сервера TrueNAS.
• Реши, на каком порту будет работать веб-интерфейс TorrServer (по умолчанию предлагается 8090).

Метод 1: Установка TorrServer на TrueNAS Scale через TrueCharts

Это самый простой и рекомендуемый способ для TrueNAS Scale.

Шаг 1: Добавление каталога TrueCharts

Если ты еще не добавил каталог TrueCharts, сделай это:

1. Зайди в раздел Apps.
2. Нажми Manage Catalogs -> Add Catalog.
3. Заполни поля:
   • Имя: truecharts
   • Репозиторий: https://github.com/truecharts/catalog
   • Ветка: main
4. Нажми Save и дождись синхронизации.

Шаг 2: Поиск и установка TorrServer

1. В разделе Available Applications найди Torrserver (можно использовать поиск).
2. Нажми Install.

Шаг 3: Базовая конфигурация приложения

Заполни ключевые параметры в мастере установки:

# Основные настройки TorrServer в TrueNAS Scale
Application Name: torrserver  # Имя экземпляра
Version: latest               # Версия образа

# Конфигурация сети
Network Configuration:
  Service Type: NodePort      # Или LoadBalancer, если есть
  Host Port: 8090             # Порт веб-интерфейса
  Container Port: 8090        # Внутренний порт контейнера

# Настройки хранилища
Storage:
  - Type: Host Path
    Path: /mnt/pool/apps/torrserver/config
    Mount Path: /config       # Путь к конфигам внутри контейнера
  - Type: Host Path
    Path: /mnt/pool/media/torrents
    Mount Path: /torrents     # Путь для кэша торрентов (опционально)

# Переменные среды (Environment Variables)
Env Variables:
  - Name: TS_LOG
    Value: "true"            # Включить логирование
  - Name: TS_PORT
    Value: "8090"            # Порт (дублирует настройку сети)

Шаг 4: Запуск и доступ к веб-интерфейсу

1. Нажми Save и дождись развертывания контейнера (это может занять несколько минут).
2. После запуска статус изменится на Active.
3. Открой веб-интерфейс по адресу: http://<IP_ТВОЕГО_TRUENAS>:8090.

Метод 2: Установка через Docker Compose в TrueNAS Scale (продвинутый)

Если ты хочешь больше контроля или в TrueCharts нет нужной версии, используй этот метод.

Шаг 1: Активация Docker Compose через приложение

Установи приложение Docker Compose из каталога TrueCharts (официальное). Это создаст среду для запуска docker-compose.yml файлов.

Шаг 2: Создание docker-compose.yml файла

Создай файл конфигурации в своем Dataset (например, /mnt/pool/apps/torrserver/docker-compose.yml).

version: '3.8'

services:
  torrserver:
    image: ghcr.io/yourok/torrserver:latest
    container_name: torrserver
    restart: unless-stopped
    ports:
      - "8090:8090"          # Веб-интерфейс
      - "8091:8091"          # Потоковый порт (для клиентов)
    environment:
      - TS_PORT=8090
      - TS_LOG=true
      - TZ=Europe/Moscow     # Укажи свою таймзону
    volumes:
      - /mnt/pool/apps/torrserver/config:/config   # Конфиги
      - /mnt/pool/media/torrents:/torrents         # Кэш торрентов
    networks:
      - truenas_net

# Создай сеть, если ее нет (docker network create truenas_net)
networks:
  truenas_net:
    external: true

Шаг 3: Запуск через Shell или задание Cron

Подключись к TrueNAS по SSH или используй встроенный Shell:

# Перейди в директорию с docker-compose.yml
cd /mnt/pool/apps/torrserver

# Запусти контейнер в фоновом режиме
docker-compose up -d

# Проверь статус
docker-compose ps

# Просмотр логов в реальном времени
docker-compose logs -f torrserver

Настройка TorrServer после установки

После успешного запуска открой веб-интерфейс. Первая настройка критически важна.

1. Настройка папок и кэша

• В веб-интерфейсе (Настройки -> Папки) укажи путь для Torrents и Cache. Это должны быть пути внутри контейнера (/torrents, /cache), которые ты смонтировал на этапе установки.
• Установи лимит кэша (например, 20-50 ГБ), чтобы не забить диск TrueNAS.

2. Добавление торрент-файлов или магнит-ссылок

Есть несколько способов:

1. Через веб-интерфейс: Просто перетащи торрент-файл в окно браузера.
2. Через API: Используй сторонние приложения (например, TorrServe-мат для Android), которые умеют подключаться к твоему серверу.
3. Автоматически: Настрой интеграцию с Jackett или Prowlarr для автоматической загрузки по RSS.

3. Интеграция с медиаклиентами (Jellyfin, Plex, Kodi)

Это «фишка» связки truenas torrserver. TorrServer выступает как источник потока, а медиасервер — как красивый фронтенд.

# Пример URL потока из TorrServer для добавления в Jellyfin
http://<IP_TORRSERVER>:8091/stream/fname?link=<магнит_ссылка_или_инфохеш>

# Или для прямого просмотра в VLC/MPC-HC
http://<IP_TORRSERVER>:8091/stream/fname?link=...&play

В Jellyfin или Plex создай библиотеку типа «Видео» и укажи в качестве источника папку, куда ты сохраняешь .strm файлы (это маленькие текстовые файлы, содержащие ссылку на поток из TorrServer).

Безопасность и оптимизация работы TorrServer на TrueNAS

Рекомендации по оптимизации:

• Ограничь скорость загрузки/отдачи в настройках TorrServer, чтобы не перегрузить канал.
• Используй VPN-контейнер (например, Gluetun) в связке с TorrServer, если требуется анонимность. Настрой его через Docker сеть в Compose.
• Регулярно обновляй образ TorrServer через интерфейс TrueCharts или командой docker-compose pull && docker-compose up -d.
• Настрой периодическую очистку кэша для старых/неиспользуемых торрентов.

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

Проблема 1: Контейнер не запускается или сразу останавливается

Решение: Проверь логи. В TrueNAS Scale зайди в приложение TorrServer и нажми Logs. Или используй команду в Shell:

# Просмотр логов конкретного контейнера
docker logs -f torrserver

# Частая причина — проблема с правами доступа к смонтированным папкам.
# Убедись, что у пользователя/группы, от которой работает контейнер (обычно 568), есть права на запись.
chmod -R 775 /mnt/pool/apps/torrserver/config
chown -R 568:568 /mnt/pool/apps/torrserver/config

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

• Проверь, что порт 8090 не занят другим приложением на TrueNAS.
• Убедись, что в настройках приложения (TrueCharts) или в docker-compose.yml правильно указаны порты.
• Проверь firewall на самом TrueNAS и на роутере (если пытаешься получить доступ извне).

Проблема 3: Торренты не начинают загружаться

Решение:

1. Проверь, есть ли сидеры у выбранного торрента.
2. Убедись, что TorrServer имеет выход в интернет (особенно актуально при использовании VPN).
3. Попробуй добавить торрент через магнит-ссылку вместо файла.