Торрент-клиент на TrueNAS чаще всего разворачивают через приложение qBittorrent или Transmission из каталога приложений, и первая типичная проблема — загруженные файлы не появляются в общей папке из-за неверно смонтированных путей hostPath внутри контейнера. Проверить это просто: если в веб-интерфейсе клиента закачка завершена, а в датасете пусто, значит путь загрузки внутри приложения не совпадает с примонтированным каталогом пула.
TrueNAS существует в двух актуальных ветках — CORE (на базе FreeBSD, использует плагины и джейлы) и SCALE (на базе Linux, использует контейнеры и Kubernetes). Подход к установке торрент-клиента в них различается, поэтому ниже инструкции разделены. Общий принцип один: клиент работает в изолированном окружении, а файлы сохраняются в датасет ZFS, доступный по SMB или NFS.
Выбор торрент-клиента для TrueNAS
Для NAS-сервера подходят клиенты с веб-интерфейсом, поскольку у TrueNAS нет графического рабочего стола. Фактически выбор сводится к нескольким проверенным вариантам, каждый из которых доступен в виде готового приложения или контейнера.
- 🧲 qBittorrent — самый популярный выбор: веб-интерфейс, поддержка RSS, категорий, поисковых плагинов и ограничений скорости по расписанию.
- 📡 Transmission — легковесный клиент с минимальным потреблением ресурсов, подходит для слабого железа.
- 🌀 Deluge — гибкий клиент с плагинами, но менее распространён в готовых образах.
- 🎬 Sonarr/Radarr-связки — не клиенты сами по себе, а медиаменеджеры, которые управляют qBittorrent или Transmission как «загрузчиком».
Если нужен один универсальный вариант — берите qBittorrent. Он стабилен в контейнерах, активно поддерживается сообществом, а его веб-интерфейс удобен даже с телефона. Transmission имеет смысл выбирать, когда сервер слабый и важна экономия оперативной памяти.
Подготовка: датасеты и права доступа
До установки приложения создайте отдельный датасет под загрузки. В веб-интерфейсе TrueNAS откройте Storage → Pools, выберите пул и добавьте датасет, например downloads. Внутри него удобно сразу создать подкаталоги complete и incomplete — так клиент сможет разделять завершённые и текущие загрузки.
Ключевой момент — права доступа. Приложения в SCALE обычно работают от служебного пользователя внутри контейнера, и если у него нет прав записи в датасет, загрузки будут падать с ошибкой. Откройте настройки ACL датасета и убедитесь, что пользователь, под которым работает приложение, имеет полный доступ. Точный UID зависит от образа приложения — сверьтесь с его документацией в каталоге TrueNAS.
⚠️ Внимание: не назначайте права «всем всё» (777) ради простоты. Это создаёт риск случайного удаления файлов другими сервисами и пользователями. Лучше один раз корректно настроить владельца и группу датасета.
Установка qBittorrent на TrueNAS SCALE
В SCALE установка выполняется через раздел Apps → Discover Apps (в разных версиях интерфейса названия пунктов могут отличаться). Найдите qBittorrent в каталоге и нажмите «Install». В форме настройки важны три блока: сетевые порты, хранилище и учётные данные.
В разделе хранилища добавьте монтирование Host Path: укажите путь к вашему датасету, например /mnt/pool/downloads, и путь внутри контейнера, например /downloads. Именно этот внутренний путь затем прописывается в настройках самого qBittorrent как каталог загрузок по умолчанию.
☑️ Проверка после установки qBittorrent
После запуска откройте веб-интерфейс по адресу http://IP-сервера:порт. Пароль по умолчанию зависит от конкретного образа — во многих современных сборках временный пароль генерируется и выводится в лог контейнера при первом старте. Посмотрите логи приложения в разделе Apps, найдите строку с временным паролем и сразу смените его в настройках веб-интерфейса.
# Пример просмотра логов приложения в SCALE (через оболочку)
k3s kubectl logs -n ix-qbittorrent deployment/qbittorrent
Установка через плагины на TrueNAS CORE
На CORE торрент-клиенты ставятся как плагины или вручную в джейлах. Откройте раздел Plugins, найдите нужный клиент (в каталоге исторически присутствовали Transmission и qBittorrent) и нажмите «Install». Система автоматически создаст джейл и сеть для него.
После установки необходимо примонтировать хранилище внутрь джейла: остановите плагин, откройте Jails → точки монтирования (Mount Points) и свяжите датасет downloads с каталогом внутри джейла, например /mnt/downloads. Затем запустите джейл и в веб-интерфейсе клиента укажите этот путь как каталог загрузок.
Почему нельзя хранить загрузки внутри джейла или контейнера
Данные внутри изолированного окружения удаляются при переустановке или обновлении приложения. Кроме того, они не попадают в снапшоты пула и недоступны по SMB. Монтирование внешнего датасета решает все три проблемы сразу.
Сравнение популярных клиентов
Таблица ниже поможет выбрать клиент под ваши задачи. Характеристики приведены в общем виде — конкретное потребление ресурсов зависит от числа активных торрентов и настроек.
| Клиент | Веб-интерфейс | Потребление ресурсов | RSS и автоматизация | Связка с Sonarr/Radarr |
|---|---|---|---|---|
| qBittorrent | Есть | Умеренное | Полная поддержка | Отлично |
| Transmission | Есть | Низкое | Базовая | Хорошо |
| Deluge | Есть (через плагин) | Умеренное | Через плагины | Хорошо |
| rTorrent/rutorrent | Есть (rutorrent) | Низкое | Через плагины | Ограниченно |
Сеть: порты, скорость и VPN
Для нормальной раздачи торрентов нужен открытый входящий порт. В настройках клиента зафиксируйте один порт (например, в диапазоне 40000–65000), пробросьте его на роутере на IP сервера и убедитесь, что в настройках приложения TrueNAS этот же порт опубликован наружу. Проверить открытость можно встроенной проверкой порта в qBittorrent или любым онлайн-сканером портов.
Если провайдер выдаёт «серый» IP (CGNAT), проброс портов не сработает — раздача будет идти только через исходящие соединения, что снижает скорость и количество пиров. В этом случае помогает либо покупка белого IP у провайдера, либо VPN с поддержкой проброса портов.
Многие пользователи запускают торрент-клиент на NAS через VPN. Для этого используются образы со встроенным VPN-клиентом (часто на базе Gluetun) или отдельный контейнер, через который маршрутизируется трафик. Учтите: если VPN обрывается, а защиты от утечек нет, клиент продолжит работу через реальный IP. Ищите образы с функцией kill switch.
⚠️ Внимание: при использовании VPN проверяйте, что веб-интерфейс клиента остаётся доступен из локальной сети. Обычно для этого в настройках VPN-контейнера указывают локальные подсети, которые должны идти мимо туннеля.
Типичные проблемы и их решение
Разберём частые сценарии, с которыми сталкиваются после установки.
- 🔒 Ошибка записи / Permission denied — у пользователя контейнера нет прав на датасет. Проверьте ACL и владельца каталога.
- 🌐 Веб-интерфейс не открывается — проверьте, что приложение запущено, порт не занят другим сервисом и не блокируется файрволом.
- 🐢 Низкая скорость — закрыт входящий порт, CGNAT у провайдера или ограничения в настройках самого клиента.
- 📁 Файлы не видны по SMB — путь загрузки в клиенте не совпадает с примонтированным каталогом, либо SMB-шара смотрит на другой датасет.
Отдельно стоит сказать про обновления приложений. При обновлении контейнера настройки клиента сохраняются, если каталог конфигурации вынесен в постоянное хранилище (PVC или hostPath). Если конфигурация хранилась внутри контейнера — после пересоздания она будет потеряна, и клиент придётся настраивать заново.
⚠️ Внимание: не храните incomplete-загрузки на том же датасете, который раздаётся медиасервером (Plex, Jellyfin). Недокачанные файлы могут попасть в медиатеку и вызвать ошибки воспроизведения. Разделяйте каталогиincompleteиcomplete.
FAQ: частые вопросы
Какой торрент-клиент лучше для TrueNAS SCALE?
Для большинства сценариев — qBittorrent: у него удобный веб-интерфейс, поддержка RSS, категорий и интеграция с Sonarr/Radarr. Transmission подходит, если важна экономия ресурсов на слабом железе.
Почему qBittorrent пишет, что пароль по умолчанию не подходит?
Во многих современных образах при первом запуске генерируется временный пароль, который выводится в лог контейнера. Откройте логи приложения в разделе Apps, найдите строку с паролем, войдите и сразу задайте собственный.
Нужно ли пробрасывать порты для торрент-клиента на NAS?
Для скачивания — не обязательно, но для полноценной раздачи и хорошей скорости входящий порт нужен. Если провайдер использует CGNAT, проброс не сработает — потребуется белый IP или VPN с поддержкой port forwarding.
Можно ли запустить торрент-клиент через VPN на TrueNAS?
Да. Обычно используют образы со встроенным VPN-клиентом или связку с контейнером Gluetun, через который идёт трафик клиента. Обязательно включайте kill switch, чтобы при обрыве туннеля клиент не работал через реальный IP.
Файлы скачались, но не видны в сетевой папке. Что проверить?
В первую очередь — совпадение путей: каталог загрузок в настройках клиента должен указывать на примонтированный путь внутри контейнера, а SMB-шара — на тот же датасет. Во вторую — права доступа: у вашего SMB-пользователя должны быть права чтения на файлы, созданные контейнером.