Установка Transmission на QNAP: полное руководство

Установка Transmission на QNAP чаще всего упирается в одну и ту же проблему: пакет торрент-клиента отсутствует в App Center конкретной модели NAS или версии QTS, и стандартный поиск по магазину приложений ничего не находит. Это не неисправность — доступность пакета зависит от версии прошивки, региона и политики QNAP, поэтому рабочих пути установки два: через App Center (если пакет доступен) и через Container Station с официальным Docker-образом, который работает практически на любой модели с поддержкой контейнеров.

Ниже разобраны оба способа с настройкой папок загрузок, доступа к веб-интерфейсу и типичными ошибками вроде недоступного порта 9091 или отказа в записи в общую папку. Инструкция ориентирована на QTS и QuTS hero; точные названия пунктов меню могут немного отличаться между версиями системы — сверяйтесь с интерфейсом своего устройства.

Что потребуется перед установкой

Перед началом убедитесь, что NAS обновлён до актуальной версии прошивки и у вас есть учётная запись с правами администратора. Для способа через контейнеры дополнительно потребуется установленное приложение Container Station — оно бесплатно и ставится из App Center в один клик.

Также заранее создайте общую папку для загрузок, например Downloads, через Панель управления → Общие папки. Transmission должен иметь права на запись в эту папку — это самая частая причина ошибок после установки.

• 📦 Актуальная версия QTS или QuTS hero на NAS
• 👤 Учётная запись администратора
• 📁 Отдельная общая папка под загрузки с правами записи
• 🐳 Container Station — для установки через Docker

Способ 1: установка через App Center

Самый простой вариант — проверить, есть ли Transmission в штатном магазине приложений. Откройте App Center, введите в поиске Transmission и посмотрите результат. Если пакет найден, нажмите «Установить» и дождитесь завершения — дальше останется только настроить папки.

Если поиск ничего не дал, возможны два варианта: пакет недоступен для вашей версии прошивки, либо он распространяется через сторонние репозитории QPKG. Подключение сторонних репозиториев — рискованный шаг: используйте только источники, которым доверяете, и понимайте, что пакеты из них не проходят проверку QNAP.

⚠️ Внимание: установка QPKG-пакетов из непроверенных репозиториев может привести к компрометации NAS. Сторонний пакет получает широкие права в системе. Если сомневаетесь в источнике — используйте способ с Container Station, где приложение изолировано в контейнере.

Способ 2: установка через Container Station (Docker)

Этот метод универсален и предпочтителен: контейнер изолирован от системы, легко обновляется и не конфликтует с пакетами QTS. Откройте Container Station, перейдите на вкладку создания приложения и найдите образ lscr.io/linuxserver/transmission — это поддерживаемая сборка от команды LinuxServer.io, либо официальный образ transmissionbt/transmission.

При создании контейнера ключевое — правильно пробросить порты и смонтировать папки. Веб-интерфейс Transmission по умолчанию работает на порту 9091, а для обмена данными с пирами используются порты 51413 (TCP и UDP). Папку загрузок на NAS нужно подключить внутрь контейнера как том /downloads.

docker run -d \
--name=transmission \
-p 9091:9091 \
-p 51413:51413 \
-p 51413:51413/udp \
-v /share/Downloads:/downloads \
-v /share/Container/transmission:/config \
--restart unless-stopped \
lscr.io/linuxserver/transmission

После запуска контейнера подождите пару минут — образ скачивается и инициализирует конфигурацию. Проверить статус можно на вкладке «Контейнеры» в Container Station: статус должен быть «Запущен», а в журнале не должно быть повторяющихся ошибок.

Настройка веб-интерфейса и доступа

Веб-интерфейс открывается в браузере по адресу http://IP-адрес-NAS:9091. Если страница не открывается, проверьте три вещи: запущен ли контейнер, не занят ли порт другим приложением и не блокирует ли брандмауэр QTS входящие подключения (раздел Панель управления → Безопасность, если такая функция включена в вашей версии).

По умолчанию доступ к веб-интерфейсу может быть открыт без пароля либо с базовой аутентификацией — это зависит от выбранного образа. Обязательно задайте логин и пароль в настройках Transmission (раздел RPC в файле settings.json или через переменные окружения контейнера), особенно если планируете доступ извне локальной сети.

⚠️ Внимание: не пробрасывайте порт 9091 наружу через роутер без крайней необходимости. Для удалённого доступа безопаснее использовать VPN-сервер на самом NAS (например, QVPN) — веб-интерфейс торрент-клиента, открытый в интернет, регулярно становится целью сканеров и ботов.

Настройка папок и прав доступа

Классическая ошибка после установки — Transmission запущен, торрент добавлен, но загрузка не начинается, а в журнале ошибка вида «Permission denied». Причина почти всегда в правах: процесс внутри контейнера работает от своего пользователя, которому не разрешена запись в вашу общую папку.

Решается это двумя способами. Первый — задать переменные окружения PUID и PGID при создании контейнера, указав идентификаторы пользователя NAS, у которого есть права на папку загрузок (для образов LinuxServer.io). Второй — выдать права на запись для всех на конкретную папку через File Station, что проще, но менее строго с точки зрения безопасности.

Как узнать PUID и PGID пользователя на QNAP

Подключитесь к NAS по SSH и выполните команду id имя_пользователя — в выводе будут поля uid и gid. Их значения укажите в переменных PUID и PGID при создании контейнера. Для административной учётной записи uid обычно отличается от стандартного, поэтому проверяйте командой, а не угадывайте.

Сравнение способов установки

Чтобы выбрать подходящий вариант, сравните их по ключевым параметрам:

Как видно, контейнерный вариант выигрывает по совокупности: он требует чуть больше действий на старте, но избавляет от зависимости от магазина приложений и упрощает дальнейшее сопровождение.

Типичные проблемы и их решение

Разберём ошибки, с которыми чаще всего сталкиваются после установки. Если веб-интерфейс открывается, но раздачи стоят на месте — проверьте, открыт ли порт 51413 на роутере: закрытый порт не блокирует загрузку полностью, но снижает скорость и число доступных пиров. Проверить состояние порта можно прямо в настройках Transmission, в разделе «Сеть».

Ещё одна ситуация: после перезагрузки NAS контейнер не стартует автоматически. Убедитесь, что при создании контейнера задана политика перезапуска unless-stopped или always — без неё Container Station не поднимет приложение после ребута.

• 🚫 Ошибка «Permission denied» — настройте PUID/PGID или права на папку
• 🐢 Низкая скорость — проверьте проброс порта 51413 на роутере
• 🔌 Веб-интерфейс недоступен — проверьте статус контейнера и брандмауэр QTS
• 🔄 Контейнер не стартует после перезагрузки — задайте restart policy

FAQ: частые вопросы

Почему Transmission нет в App Center моего QNAP?

Доступность пакета зависит от версии QTS, модели устройства и региона. Если поиск не даёт результата, используйте установку через Container Station — этот способ не зависит от магазина приложений.

На каком порту работает веб-интерфейс Transmission?

По умолчанию используется порт 9091. Адрес для доступа: http://IP-адрес-NAS:9091. Порт можно изменить при создании контейнера, пробросив любой свободный порт NAS на порт 9091 внутри контейнера.

Безопасно ли использовать сторонние QPKG-репозитории?

Пакеты из сторонних источников не проходят проверку QNAP и получают широкие права в системе. Если источник не вызывает полного доверия, предпочтительнее контейнерный способ установки — он изолирует приложение от QTS.

Загрузки не начинаются, хотя торрент добавлен. Что проверить?

В первую очередь — права на запись в папку загрузок (ошибка «Permission denied» в журнале). Затем проверьте состояние порта 51413 в настройках Transmission и наличие свободного места на томе NAS.

Как обновить Transmission, установленный в контейнере?

Остановите и удалите старый контейнер, скачайте свежий образ и создайте контейнер заново с теми же томами и портами. Настройки сохранятся, если папка конфигурации была вынесена на общий ресурс NAS при первоначальной настройке.