qBittorrent

Свободный BitTorrent клиент, написанный с использованием фреймворка Qt и библиотеки libtorrent.

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

При необходимости, в графических настройках можно указать сетевой интерфейс явно, что особенно полезно для изолированного от других сетей сидирования.

Для этого, достаточно указать интерфейс или адрес Yggdrasil из списка доступных:

Preferences → Advanced → Network interface или Optional IP address to bind to

Поскольку трафик между пирами Yggdrasil шифруется по-умолчанию, для снижения нагрузки, штатное шифрование можно отключить:

Preferences → BitTorrent → Privacy → Encription mode → Disable

Загружая файлы посредством протокола BitTorrent, принято делиться раздачей с другими.

Для этого достаточно открыть порт в фаервол:

ufw allow from 0200::/7 to any port [Listening Port]

[Listening Port] - автоматически выданный клиентом порт в разделе Preferences → Connections

Обратите внимание, что UPnP в контексте Yggdrasil не используется, поэтому включение этой опции никак не влияет на участие в сидинге.

Не забываем анонсировать свою раздачу как минимум одному трекеру в сети Yggrasil. Сделать это можно выбрав соответствующий файл, во вкладке Trackers → Add trackers…

Подробная настройка сид-сервера на базе qBittorrent, описана в разделе Сервер на базе qBittorrent

В клиенте qBittorrent имеется встроенный торрент-трекер, активировать который можно в разделе меню:

Advanced → Enable embedded tracker

Разрешаем покдключение к трекеру из сети Yggdrasil (по-умолчанию 9000):

ufw allow from 0200::/7 to any port 9000

Затем, можно поделиться ссылкой вида http://[address]:9000/announce с другими или добавить в список внутрисетевых сервисов

* Организовать легковесный торрент-трекер можно также с помощью специализированного ПО, например Opentracker

Клиент поддерживает альтернативные темы оформления в формате .qbttheme

Следует учитывать, что темы для десктоп клиента несовместимы с клиентом Web UI.
Для изменения внешнего вида Web UI, вместо файла .qbttheme, используются альтернативные клиенты.

Чтобы создать альтернативный Web UI, достаточно скопировать директорию

cp src/webui/www /somelocation/newtheme

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

/private - все страницы клиента, доступные после авторизации
/public - страница логина

После нужных изменений, путь к альтернативному клиенту можно в опции:

Preferences → Web UI → Use alternative Web UI

В последних версиях qBittorrent была убрана поддержка обработки мульти-язычных строк, поэтому придется удалить конструкции из файлов html авто-заменой

QBT_TR\((.*)\)QBT_TR\[CONTEXT=.*\]

Результатом можно поделиться на GitHub, добавив страницу проекта в список List of known alternate WebUIs

Для отправки PR в официальный репозиторий, чтобы исключить конфликты обновлений, желательно разбивать правки на отдельные ветки:

git checout master
git checkout -b my-webui-fix

Важно перед отправкой тестировать форматирование и валидность кода:

cd src/webui/www
npm install
npm run lint && npm run format

Актуальные инструкции по компиляции, описаны в файле INSTALL а также разделе официальной Wiki

При использовании последней версии из репозитория, с большой вероятностью, версии зависимостей в штатных репозиториях окажутся устаревшими.
В частности, может дополнительно понадобиться сборка последних версий libboost, libtorrent и Qt.

Для сборки серверного клиента без графической оболочки (qbittorrent-nox), есть удобная утилита qbittorrent-nox-static, которая соберет все зависимости автоматически.

Удобна тем, что также поддерживает различные платформы, в том числе ARM.

Официальная инструкция:

git clone --recursive https://github.com/boostorg/boost.git
cd boost
./bootstrap.sh
./b2

Главная ветка включает межверсионные изменения последней версии.
На практике, для разрешения зависимостей, используются релизы (это касается и остальных пакетов). Загружаем архив нужной версии и пропускаем шаг git/clone.

Для глобальной установки:

./b2 install

git clone --recurse-submodules https://github.com/arvidn/libtorrent.git
cd libtorrent
./configure
make

* возможно для конфигурации потребуется указать путь к boost, например ./configure –with-boost-libdir=/usr/lib/arm-linux-gnueabihf/

Для глобальной установки:

make install

Необходимую для qBittorrent версию проще всего установить из официального онлайн-установщика (для загрузки потребуется регистрация на сайте).

Также библиотеки (qtbase и qttools) можно загрузить из архива релизов и собрать вручную.

В таком случае, важно учитывать наличие доступных ресурсов - для сборки qtbase понадобится порядка 3Гб ОЗУ и до 5Гб дискового пространства.

Если есть возможность подключения внешнего накопителя, буфер памяти можно увеличить через файл подкачки:

fallocate -l 4G /mount/swapfile
chmod 600 /mount/swapfile
mkswap /mount/swapfile
swapon /mount/swapfile

по завершению:

swapoff /mount/swapfile
rm /mount/swapfile

При монтировании дополнительного дискового пространства посредством /etc/fstab, важно добавить флаги user,exec иначе при сборке cmake выдаст ошибку «Permission denied».

Процесс компиляции выглядит примерно так:

cd /mount/qtbase-everywhere-src-6.5.3
cmake -B build
cmake --build build --parallel 4

* 4 - количество потоков

Можно указать параметры для отдельных дистрибутивов, например Debian/Ubuntu

-DCMAKE_BUILD_TYPE=RelWithDebInfo 
-DCMAKE_INSTALL_PREFIX=/usr/local

В этом примере, собранные файлы будут расположены в директории

/mount/qtbase-everywhere-src-6.5.3/build/lib/cmake

Для глобальной установки:

cd /mount/qtbase-everywhere-src-6.5.3/build
cmake --install .

Как указано в файле dependencies.yaml, сборка требует предустановленной библиотеки qtbase, приступаем только если выполнили предыдущий шаг.

cd /mount/qttools-everywhere-src-6.5.3
qt-configure-module .
cmake --build .

Для глобальной установки:

cmake --install .

Для сборки серверной версии с помощью cmake - отключаем графическую среду флагом

-DGUI=OFF

Если пакеты Qt не установлены глобально, при компиляции qBittorrent с помощью cmake, нужно указать дополнительный флаг c префиксом директории:

-DCMAKE_PREFIX_PATH='/home/USERNAME/Qt/6.5.3/gcc_64/lib/cmake'

Подробнее о доступных опциях сборки и их значениями по-умолчанию, можно почитать в разделе Compilation

git clone https://github.com/qbittorrent/qBittorrent.git
cd qBittorrent
cmake -B build -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DGUI=OFF
cmake --build build

Готовый бинарный пакет qbittorrent-nox будет доступен в директории /build

При большом количестве раздач, в qBittorrent 4, наблюдается проблема повышенного расхода памяти с активным использованием swap и зависанием интерфейса.

Чтобы избежать перебоев в работе других служб, можно добавить лимиты на процесс, указав объем доступной памяти:

nano /etc/systemd/system/qbittorrent-nox.service

* qbittorrent-nox - серверный клиент qbittorrent

[Service]
MemoryHigh=256M
MemoryMax=512M
MemorySwapMax=512M

В версии 5 (из ветки unstable) проблема пока что не наблюдалась.

Установить альфа версию для требуемого дистрибутива можно из списка на официальной странице загрузок, раздел «Other Binary Packages»
Например, репозиторий Ubuntu:

add-apt-repository ppa:qbittorrent-team/qbittorrent-unstable 

qBittorrent по-умолчанию генерирует торрент-файлы гибридного формата.

Клиенты (например, Transmission) не имеющие поддержку протокола 2 версии, не смогут открыть файл.

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

Автоматически сгенерированный из magnet ссылки .torrent файл (при включенной опции авто-сохранения .torrent файлов), может не содержать фрагментов (pieces) что сделает его не совместимым при импорте.

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

В 4 версии клиента замечено зависание (stalled) при скачивании файлов. Частой причиной этому может быть использование только первого трекера (оффлайн) из списка доступных.

Решение описано в официальной инструкции по дополнительным настройкам:

Preferences → Advanced → Always announce to all trackers

Также можно отметить

Preferences → Advanced → Always announce to all trackers in a tier

В большинстве случаев связано с настройками MIME.

В дистрибутивах Linux, можно попробовать очистить кеш в директории

/home/USERNAME/local/share/mime

При использовании приватных трекеров или таких, что требуют авторизации для осуществления поиска, следует:

• Зайти на сайт и авторизироваться из браузера, возможно есть запрос Captcha
• Перезапустить сервис клиента - причиной может быть внутреннее кеширование клиентом предыдущих настроек

Официальный сайт qBittorrent
Частые вопросы
Альтернативные темы (Десктоп)
Альтернативные клиенты (Web UI)
Поисковые плагины

• Внутрисетевые:
  • YGGtracker - (Реестр узлов)
  • Порты qBt_SE:
    • Rutor (http://[321:c99a:91a1:cd2c::16]/)
    • Rutracker (http://[321:c99a:91a1:cd2c::18]/forum/) - для поиска необходима авторизация