TorrServer на Mac OS часто не запускается с первого раза из-за того, что macOS блокирует исполняемый файл, скачанный из интернета, — система помечает его карантинным атрибутом, и при двойном клике ничего не происходит либо появляется ошибка о неизвестном разработчике. Это самая частая причина, с которой сталкиваются пользователи при первом запуске Matrix-сервера на macOS.
Ниже разберём, как правильно установить и запустить TorrServer на Mac, какие существуют способы установки, как подключить сервер к плеерам и что делать, если веб-интерфейс по адресу 127.0.0.1:8090 не открывается. Инструкция подходит для компьютеров как на процессорах Intel, так и на чипах Apple Silicon (M1, M2, M3 и новее) — важно лишь скачать сборку под свою архитектуру.
Что такое TorrServer и зачем он нужен на Mac
TorrServer (также известен как Matrix) — это локальный сервер, который принимает торрент-ссылки и magnet-ссылки, скачивает содержимое и отдаёт его в виде обычного HTTP-потока. Благодаря этому видео можно смотреть в любом плеере, не дожидаясь полной загрузки файла, и без установки классического торрент-клиента с интерфейсом.
На Mac сервер работает в фоне как консольный процесс. Управление происходит через браузер: веб-интерфейс доступен по адресу http://127.0.0.1:8090. Оттуда добавляются торренты, копируются ссылки на потоки и настраивается кэш.
- 🎬 Просмотр фильмов и сериалов без полной загрузки файла на диск
- 📺 Интеграция с плеерами VLC, IINA и приложениями на телевизоре в одной сети
- 🔁 Раздача потока на другие устройства домашней сети по локальному IP
- 🧩 Совместимость с медиацентрами и трекер-агрегаторами через API
Способы установки TorrServer на macOS
Существует два основных пути: готовый исполняемый файл со страницы релизов проекта на GitHub или установка через пакетный менеджер Homebrew. Первый способ проще для тех, кто не пользуется терминалом регулярно, второй удобнее для обновлений.
При ручной установке важно выбрать правильную сборку: для Mac на чипах Apple нужен файл с пометкой arm64 (darwin-arm64), для старых Mac на Intel — amd64 (darwin-amd64). Узнать архитектуру можно в меню → Об этом Mac: там будет указан либо чип Apple, либо процессор Intel.
brew install torrserverПосле установки через Homebrew сервер обычно запускается командой torrserver в терминале. При ручной установке файл нужно сделать исполняемым и снять карантинный атрибут:
chmod +x TorrServer-darwin-arm64
xattr -d com.apple.quarantine TorrServer-darwin-arm64
./TorrServer-darwin-arm64
⚠️ Внимание: скачивайте сборку только с официального репозитория проекта на GitHub. Файлы с посторонних сайтов могут содержать вредоносный код, а сервер получает доступ к сети и диску вашего Mac.
Первый запуск и обход блокировки Gatekeeper
Если при запуске macOS выдаёт сообщение, что программу невозможно открыть, потому что разработчик не может быть проверен, — это работа Gatekeeper. Есть два безопасных способа обойти ограничение для конкретного файла, не отключая защиту системы целиком.
Первый вариант — открыть Системные настройки → Конфиденциальность и безопасность сразу после неудачного запуска: внизу появится кнопка «Всё равно открыть» для заблокированного приложения. Второй вариант — команда xattr -d com.apple.quarantine, показанная выше, которая снимает карантинную метку вручную.
☑️ Проверка перед первым запуском
После успешного запуска в терминале появится лог работы сервера. Окно терминала нельзя закрывать — вместе с ним завершится и процесс. Для проверки откройте в браузере адрес http://127.0.0.1:8090: если загрузился веб-интерфейс, сервер работает.
Настройка сервера и подключение плееров
В веб-интерфейсе добавление торрента происходит через кнопку добавления: вставьте magnet-ссылку или загрузите torrent-файл. После того как сервер получит метаданные, станут доступны ссылки на поток для каждого файла внутри раздачи. Эти ссылки копируются в любой плеер, поддерживающий сетевые потоки.
На Mac удобнее всего использовать VLC или IINA: в VLC откройте Файл → Открыть сеть и вставьте скопированную ссылку. Если нужно смотреть на телевизоре или другом устройстве в той же сети, замените в ссылке 127.0.0.1 на локальный IP вашего Mac — узнать его можно в Системные настройки → Wi-Fi.
Стоит учитывать, что скорость воспроизведения напрямую зависит от количества раздающих и качества соединения с ними. Если раздача «мёртвая» и сидеров нет, никакие настройки сервера не заставят поток работать — это ограничение самого протокола BitTorrent, а не TorrServer.
Автозапуск TorrServer при включении Mac
По умолчанию сервер нужно запускать вручную после каждой перезагрузки. Чтобы он стартовал автоматически, используется штатный механизм macOS — launchd с plist-файлом агента в папке ~/Library/LaunchAgents. Точный синтаксис plist зависит от пути, куда установлен сервер, поэтому актуальный шаблон лучше брать из документации проекта или формул Homebrew.
При установке через Homebrew часто доступна штатная команда управления службой:
brew services start torrserverЭтот способ предпочтительнее ручного plist: менеджер служб Homebrew сам следит за перезапуском процесса при сбое. Проверить, работает ли служба, можно командой brew services list.
Где TorrServer хранит настройки и кэш
Конфигурация и база торрентов обычно располагаются рядом с исполняемым файлом или в домашней папке пользователя, в зависимости от способа установки. Если при обновлении вы заменяете бинарный файл, настройки сохраняются, пока вы не удаляете сопутствующие файлы данных. Перед экспериментами имеет смысл сделать копию папки с сервером.
Типичные ошибки и их решение
Большинство проблем сводится к нескольким повторяющимся сценариям. Ниже — таблица с симптомами и направлениями диагностики.
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| Браузер не открывает 127.0.0.1:8090 | Сервер не запущен или упал с ошибкой | Лог в окне терминала, наличие процесса в Мониторинге системы |
| Ошибка «разработчик не может быть проверен» | Карантинный атрибут Gatekeeper | Кнопка «Всё равно открыть» в настройках безопасности или команда xattr |
| «Address already in use» при запуске | Порт 8090 занят другим процессом | Завершить старый процесс TorrServer или сменить порт в настройках |
| Поток буферизуется и прерывается | Мало сидеров или маленький кэш | Число пиров в веб-интерфейсе, размер кэша предзагрузки |
| Плеер на другом устройстве не видит поток | Используется адрес 127.0.0.1 или блокирует брандмауэр | Локальный IP Mac и разрешение входящих соединений в брандмауэре |
⚠️ Внимание: если включён брандмауэр macOS (Системные настройки → Сеть → Брандмауэр), при первом запуске система спросит, разрешить ли серверу принимать входящие соединения. Без этого разрешения поток будет доступен только на самом Mac, но не на других устройствах сети.
Когда сервер запущен, но торрент долго не получает метаданные, возможная причина — блокировка трекеров или DHT вашим провайдером либо сетевым фильтром. Проверьте, открывается ли тот же торрент в обычном клиенте: если и там нет соединения, проблема вне TorrServer.
Обновление и удаление TorrServer
При установке через Homebrew обновление выполняется стандартно: brew upgrade torrserver. При ручной установке достаточно скачать новую сборку и заменить старый исполняемый файл, предварительно остановив сервер. Настройки при этом, как правило, сохраняются, поскольку хранятся отдельно от бинарного файла.
Для полного удаления при ручной установке удалите исполняемый файл и папку с данными сервера, а также plist-агент из ~/Library/LaunchAgents, если вы его создавали. При установке через Homebrew используйте brew uninstall torrserver и при необходимости остановите службу командой brew services stop torrserver перед удалением.
Часто задаваемые вопросы
Работает ли TorrServer на Mac с чипом M1/M2/M3?
Да, для процессоров Apple Silicon выпускаются отдельные сборки с пометкой darwin-arm64. Скачайте именно её — сборка для Intel на таких машинах либо не запустится, либо будет работать через транслятор Rosetta с потерей эффективности.
Нужно ли держать окно терминала открытым?
Да, если сервер запущен вручную из терминала: закрытие окна завершает процесс. Чтобы этого избежать, настройте автозапуск через brew services или launchd — тогда сервер будет работать в фоне без открытого окна.
Можно ли смотреть поток с Mac на телевизоре?
Можно, если оба устройства в одной локальной сети. В ссылке на поток замените 127.0.0.1 на локальный IP-адрес Mac и убедитесь, что брандмауэр разрешает входящие соединения для TorrServer. Далее ссылку можно открыть в плеере на телевизоре или в приложении, поддерживающем сетевые потоки.
Чем TorrServer отличается от обычного торрент-клиента?
Обычный клиент скачивает файлы на диск для последующего использования, а TorrServer отдаёт содержимое как HTTP-поток, который можно воспроизводить сразу в любом плеере и на других устройствах сети. Это удобно для просмотра без ожидания полной загрузки.
Сервер запускается, но торрент не загружается. Что делать?
Проверьте число сидеров у раздачи — при их отсутствии поток работать не будет. Также убедитесь, что провайдер или сетевой фильтр не блокирует соединения с трекерами: для проверки попробуйте тот же торрент в обычном клиенте. Если и там соединения нет, причина вне TorrServer.