Установка TorrServer через opkg: подробная инструкция

Команда opkg install torrserver завершается ошибкой «Unknown package» на большинстве роутеров, потому что пакет TorrServer отсутствует в стандартных репозиториях OpenWrt — его нужно либо ставить из подключённого стороннего репозитория Entware, либо разворачивать вручную из бинарного файла под архитектуру вашего процессора. Прежде чем вводить команду, проверьте, какой пакетный менеджер реально работает на устройстве: opkg встречается и в чистой OpenWrt, и в среде Entware на прошивках Keenetic, Asuswrt-Merlin и Padavan, а набор доступных пакетов у них разный.

В этой инструкции разберём подготовку роутера, установку TorrServer через opkg и вручную, настройку автозапуска и типичные ошибки. Материал ориентирован на пользователей, которые уже умеют подключаться к роутеру по SSH.

Что такое TorrServer и зачем он на роутере

TorrServer (проект известен как Matrix или TorrServer Matrix) — это серверное приложение, которое принимает magnet-ссылки и отдаёт видеопоток по HTTP. Телевизор, приставка или плеер подключаются к нему как к обычному онлайн-кинотеатру, а раздачу и буферизацию берёт на себя сам сервер.

Установка на роутер удобна тем, что устройство работает круглосуточно и не требует включённого компьютера. Однако стоит учитывать ограничения:

  • 🧠 Оперативная память — на роутерах с малым объёмом RAM сервер может падать при больших торрентах; рекомендуется устройство с запасом памяти.
  • 💾 Накопитель — для кэша нужен USB-диск или флешка, запись во внутреннюю флеш-память роутера быстро изнашивает её.
  • ⚙️ Процессор — архитектура (mipsel, arm, aarch64, x86) определяет, какой бинарный файл подойдёт.
  • 🌐 Скорость сети — комфортный просмотр требует стабильного канала и быстрого USB-порта.

Подготовка: SSH, opkg и подключение накопителя

Сначала убедитесь, что у вас есть доступ к командной строке роутера. Подключение выполняется по SSH, например из терминала компьютера:

ssh root@192.168.1.1

Адрес может отличаться в зависимости от вашей сети. После входа проверьте, какой пакетный менеджер доступен и откуда он тянет пакеты — команда opkg print-architecture покажет поддерживаемые архитектуры, а содержимое конфигурации (обычно /etc/opkg.conf или файлы в /opt/etc/opkg/ для Entware) — список репозиториев.

Далее обновите списки пакетов — без этого любая установка может завершиться ошибкой:

opkg update
⚠️ Внимание: кэш TorrServer нельзя держать во внутренней флеш-памяти роутера — постоянная перезапись сокращает её ресурс. Подключите USB-накопитель и смонтируйте его, например в /opt или отдельный каталог, до начала настройки.

Установка через opkg install torrserver

Если ваша среда Entware собрана с репозиторием, где присутствует пакет torrserver (такие сборки встречаются в некоторых сообществах для Keenetic и OpenWrt), установка сводится к двум командам:

opkg update

opkg install torrserver

После завершения проверьте, что пакет установился: opkg list-installed | grep torr. Если пакет найден и установлен, обычно вместе с ним появляется скрипт автозапуска в /opt/etc/init.d/ — его имя зависит от сборки пакета, посмотрите содержимое каталога командой ls /opt/etc/init.d/.

☑️ Проверка после установки через opkg

Выполнено: 0 / 5

Если же opkg install torrserver выдаёт «Unknown package» — значит, в подключённых репозиториях пакета нет. Это нормальная ситуация для стандартной OpenWrt, и дальше есть два пути: найти репозиторий сообщества для вашей архитектуры (проверяйте актуальность источника и доверяйте только известным проектам) или установить сервер вручную.

📊 На какой прошивке вы устанавливаете TorrServer?
Keenetic (Entware)
OpenWrt
Asuswrt-Merlin
Padavan / другая

Ручная установка бинарного файла

Ручной способ универсален: вы скачиваете готовый исполняемый файл под архитектуру процессора и кладёте его на накопитель. Узнать архитектуру поможет команда:

uname -m

Типичные результаты: mipsel — многие роутеры на чипах MediaTek, armv7l или aarch64 — устройства на ARM. Далее на компьютере скачайте соответствующую сборку TorrServer со страницы релизов официального репозитория проекта на GitHub (именно официального — сторонние сборки могут содержать вредоносный код), распакуйте архив и скопируйте бинарник на роутер, например через scp или файловый менеджер с поддержкой SFTP.

После копирования сделайте файл исполняемым и проверьте запуск:

chmod +x /opt/torrserver/TorrServer

/opt/torrserver/TorrServer --help

Если вместо справки вы видите ошибку вида «not found» при существующем файле — почти наверняка бинарник собран под другую архитектуру или другую libc (например, glibc вместо musl, используемой в OpenWrt). Вернитесь к выбору сборки и возьмите вариант, подходящий именно вашей системе.

Как понять, какая libc используется в системе

Выполните команду ls /lib/ и посмотрите наличие каталогов или файлов с именами вроде ld-musl-*.so (это musl, характерна для OpenWrt) или ld-linux.so / libc.so.6 (это glibc, характерна для Entware на некоторых платформах). Бинарник должен быть собран под ту же библиотеку, иначе он не запустится даже при совпадающей архитектуре процессора.

Автозапуск и базовая настройка

Чтобы сервер стартовал после перезагрузки роутера, нужен init-скрипт. В OpenWrt службы оформляются через procd в каталоге /etc/init.d/, в Entware — через скрипты в /opt/etc/init.d/ с префиксом S и номером. Точный синтаксис зависит от системы, поэтому сверяйтесь с документацией вашей прошивки; общий принцип — скрипт запускает бинарник с нужными параметрами и умеет его останавливать.

После запуска откройте веб-интерфейс в браузере по адресу роутера с портом сервера (по умолчанию у TorrServer используется порт 8090, но проверьте в настройках вашей сборки):

http://192.168.1.1:8090

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

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

Разберём проблемы, с которыми чаще всего сталкиваются при установке через opkg и ручном развёртывании.

СимптомВероятная причинаЧто проверить
Unknown package при opkg installПакета нет в репозиторияхИсточники в opkg.conf; ручная установка
ошибка «not found» при запускеНеверная архитектура или libcuname -m, тип системной библиотеки
Сервер запускается и сразу падаетНехватка оперативной памятиfree -m, логи сервера
Веб-интерфейс не открываетсяПорт закрыт или сервер слушает другой интерфейсnetstat -tlnp, настройки брандмауэра
Кэш не пишется на дискНет прав или диск не смонтированmount, права на каталог кэша

Отдельно отметим переполнение флеш-памяти роутера при установке пакетов во внутренний раздел — если opkg сообщает о нехватке места, проверьте свободное пространство командой df -h и перенесите установку на внешний накопитель либо удалите лишние пакеты.

⚠️ Внимание: не скачивайте бинарные файлы TorrServer со сторонних файлообменников и форумных вложений. Используйте только официальный репозиторий проекта — исполняемый файл с root-правами на роутере имеет полный доступ к вашей сети.

Обновление и удаление TorrServer

Если пакет ставился через opkg, обновление выполняется стандартно: opkg update, затем opkg upgrade torrserver. При ручной установке обновление — это замена бинарного файла на новую версию с сохранением каталога настроек и базы данных.

Для удаления пакетной версии используйте opkg remove torrserver. При ручной установке достаточно остановить службу, удалить бинарник и скрипт автозапуска, а затем при желании стереть каталог с настройками и кэшем.

⚠️ Внимание: перед обновлением остановите сервер через его init-скрипт. Замена бинарного файла «на ходу» может привести к повреждению кэша активных торрентов.

Частые вопросы

Почему opkg не находит пакет torrserver?

Пакета нет в стандартных репозиториях OpenWrt и большинства сборок Entware. Либо подключите репозиторий сообщества, где он собран под вашу архитектуру, либо установите бинарный файл вручную с официальной страницы релизов проекта.

Как узнать архитектуру процессора роутера?

Выполните в SSH команду uname -m. Результаты вроде mipsel, armv7l, aarch64 укажут, какую сборку скачивать. Дополнительно проверьте тип системной библиотеки (musl или glibc) — от этого тоже зависит выбор бинарника.

Можно ли установить TorrServer без USB-накопителя?

Технически сервер запустится, но кэш будет писаться во внутреннюю флеш-память или оперативную память. Первое изнашивает флеш, второе быстро исчерпывает RAM и приводит к падениям. Для постоянной работы внешний накопитель практически обязателен.

Веб-интерфейс открывается, но видео не воспроизводится на телевизоре. Что проверить?

Убедитесь, что телевизор и роутер в одной сети, плеер указывает правильный адрес и порт сервера, а на роутере брандмауэр не блокирует локальные подключения к порту. Также проверьте, что торрент набрал достаточную скорость — при медленной раздаче буфер не успевает наполниться.

Нужен ли root-доступ для установки?

Да, установка пакетов через opkg, создание init-скриптов и запуск служб на роутере выполняются от пользователя root. Если ваша прошивка ограничивает SSH-доступ, сначала включите его в настройках администрирования роутера.