How to Wiki Database (change log) http://[222:a8e4:50cd:55c:788e:b0a5:4e2f:a92c]
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

338 lines
17 KiB

10 months ago
====== qBittorrent ======
Свободный [[yggdrasil:bittorrent:bittorrent|BitTorrent]] клиент, написанный с использованием фреймворка Qt и библиотеки libtorrent.
===== Пиринг в Yggdrasil =====
По-умолчанию, клиент прослушивает все сетевые интерфейсы и отлично подходит для обмена файлами в сети [[yggdrasil:yggdrasil|Yggdrasil]].
При необходимости, в графических настройках можно указать сетевой интерфейс явно, что особенно полезно для изолированного от других сетей сидирования.
Для этого, достаточно указать интерфейс или адрес Yggdrasil из списка доступных:
**Preferences → Advanced → Network interface** или **Optional IP address to bind to**
Поскольку трафик между пирами Yggdrasil шифруется по-умолчанию, для снижения нагрузки, штатное шифрование можно отключить:
**Preferences → BitTorrent → Privacy → Encription mode → Disable**
===== Сидирование =====
Загружая файлы посредством протокола BitTorrent, принято делиться раздачей с другими.
Для этого достаточно открыть порт в фаервол:
<code>
ufw allow from 0200::/7 to any port [Listening Port]
</code>
[Listening Port] - автоматически выданный клиентом порт в разделе **Preferences** → **Connections**
Обратите внимание, что UPnP в контексте Yggdrasil не используется, поэтому включение этой опции никак не влияет на участие в сидинге.
Не забываем анонсировать свою раздачу как минимум одному [[yggdrasil:sites_and_services:other_network_services#torrent|трекеру в сети Yggrasil]]. Сделать это можно выбрав соответствующий файл, во вкладке **Trackers** → **Add trackers...**
Подробная настройка сид-сервера на базе qBittorrent, описана в разделе [[yggdrasil:bittorrent:seedbox#сервер_на_базе_qbittorrent|Сервер на базе qBittorrent]]
===== Встроенный трекер =====
В клиенте qBittorrent имеется встроенный торрент-трекер, активировать который можно в разделе меню:
**Advanced → Enable embedded tracker**
Разрешаем покдключение к трекеру из сети Yggdrasil (по-умолчанию 9000):
<code>
ufw allow from 0200::/7 to any port 9000
</code>
Затем, можно поделиться ссылкой вида http://[address]:9000/announce с другими или добавить в список [[yggdrasil:sites_and_services:other_network_services#torrent|внутрисетевых сервисов]]
* Организовать легковесный торрент-трекер можно также с помощью специализированного ПО, например [[yggdrasil:bittorrent:opentracker|Opentracker]]
===== Темы оформления =====
Клиент поддерживает [[https://github.com/qbittorrent/qBittorrent/wiki/List-of-known-qBittorrent-themes|альтернативные темы]] оформления в формате .qbttheme
Следует учитывать, что темы для десктоп клиента несовместимы с клиентом Web UI.\\
Для изменения внешнего вида Web UI, вместо файла .qbttheme, используются [[https://github.com/qbittorrent/qBittorrent/wiki/List-of-known-alternate-WebUIs|альтернативные клиенты]].
==== Альтернативный Web UI ====
Чтобы создать альтернативный Web UI, достаточно скопировать директорию
<code>
cp src/webui/www /somelocation/newtheme
</code>
Минимальный набор файлов представлен директориями:
<code>
/private - все страницы клиента, доступные после авторизации
/public - страница логина
</code>
После нужных изменений, путь к альтернативному клиенту можно в опции:
**Preferences → Web UI → Use alternative Web UI**
В последних версиях qBittorrent была убрана поддержка обработки мульти-язычных строк, поэтому придется удалить конструкции из файлов html авто-заменой
<code>
QBT_TR\((.*)\)QBT_TR\[CONTEXT=.*\]
</code>
Результатом можно поделиться на GitHub, добавив страницу проекта в список [[https://github.com/qbittorrent/qBittorrent/wiki/List-of-known-alternate-WebUIs|List of known alternate WebUIs]]
==== Контрибуция ====
Для отправки PR в официальный репозиторий, чтобы исключить конфликты обновлений, желательно разбивать правки на отдельные ветки:
<code>
git checout master
git checkout -b my-webui-fix
</code>
Важно перед отправкой тестировать форматирование и валидность кода:
<code>
cd src/webui/www
npm install
npm run lint && npm run format
</code>
===== Сборка из исходников =====
Актуальные инструкции по компиляции, описаны в файле [[https://raw.githubusercontent.com/qbittorrent/qBittorrent/master/INSTALL|INSTALL]] а также разделе официальной [[https://github.com/qbittorrent/qBittorrent/wiki#compilation|Wiki]]
При использовании последней версии из репозитория, с большой вероятностью, версии зависимостей в штатных репозиториях окажутся устаревшими.\\
В частности, может дополнительно понадобиться сборка последних версий [[https://www.boost.org/|libboost]], [[https://www.libtorrent.org/|libtorrent]] и [[https://www.qt.io|Qt]].
==== Автоматическая сборка ====
Для сборки серверного клиента без графической оболочки (qbittorrent-nox), есть удобная утилита [[https://github.com/userdocs/qbittorrent-nox-static|qbittorrent-nox-static]], которая соберет все зависимости автоматически.
Удобна тем, что также поддерживает различные платформы, в том числе ARM.
==== Ручная сборка ====
=== libboost ===
Официальная инструкция:
<code>
git clone --recursive https://github.com/boostorg/boost.git
cd boost
./bootstrap.sh
./b2
</code>
Главная ветка включает межверсионные изменения последней версии.\\
На практике, для разрешения зависимостей, используются [[https://github.com/boostorg/boost/releases|релизы]] (это касается и остальных пакетов).
Загружаем архив нужной версии и пропускаем шаг git/clone.
Для глобальной установки:
<code>
./b2 install
</code>
=== libtorrent ===
<code>
git clone --recurse-submodules https://github.com/arvidn/libtorrent.git
cd libtorrent
./configure
make
</code>
//* возможно для конфигурации потребуется указать путь к boost, например ./configure --with-boost-libdir=/usr/lib/arm-linux-gnueabihf///
Для глобальной установки:
<code>
make install
</code>
=== qt ===
Необходимую для qBittorrent версию проще всего установить из официального онлайн-установщика (для загрузки потребуется регистрация на сайте).
Также библиотеки (qtbase и qttools) можно загрузить [[https://download.qt.io/official_releases/qt/|из архива релизов]] и собрать вручную.
В таком случае, важно учитывать наличие доступных ресурсов - для сборки qtbase понадобится порядка 3Гб ОЗУ и до 5Гб дискового пространства.
Если есть возможность подключения внешнего накопителя, буфер памяти можно увеличить через файл подкачки:
<code>
fallocate -l 4G /mount/swapfile
chmod 600 /mount/swapfile
mkswap /mount/swapfile
swapon /mount/swapfile
</code>
по завершению:
<code>
swapoff /mount/swapfile
rm /mount/swapfile
</code>
При монтировании дополнительного дискового пространства посредством /etc/fstab, важно добавить флаги user,exec иначе при сборке cmake выдаст ошибку "Permission denied".\\
== qtbase ==
Процесс компиляции выглядит примерно так:
<code>
cd /mount/qtbase-everywhere-src-6.5.3
cmake -B build
cmake --build build --parallel 4
</code>
//* 4 - количество потоков//\\
Можно указать параметры для отдельных дистрибутивов, например Debian/Ubuntu
<code>
-DCMAKE_BUILD_TYPE=RelWithDebInfo
-DCMAKE_INSTALL_PREFIX=/usr/local
</code>
В этом примере, собранные файлы будут расположены в директории
<code>
/mount/qtbase-everywhere-src-6.5.3/build/lib/cmake
</code>
Для глобальной установки:
<code>
cd /mount/qtbase-everywhere-src-6.5.3/build
cmake --install .
</code>
== qttools ==
Как указано в файле dependencies.yaml, сборка требует предустановленной библиотеки qtbase, приступаем только если выполнили [[yggdrasil:bittorrent:qbittorrent#qtbase|предыдущий шаг]].
<code>
cd /mount/qttools-everywhere-src-6.5.3
qt-configure-module .
cmake --build .
</code>
Для глобальной установки:
<code>
cmake --install .
</code>
=== qbittorrent-nox ===
Для сборки серверной версии с помощью cmake - отключаем графическую среду флагом
<code>
-DGUI=OFF
</code>
Если пакеты Qt не установлены глобально, при компиляции qBittorrent с помощью cmake, нужно указать дополнительный флаг c префиксом директории:
<code>
-DCMAKE_PREFIX_PATH='/home/USERNAME/Qt/6.5.3/gcc_64/lib/cmake'
</code>
Подробнее о доступных опциях сборки и их значениями по-умолчанию, можно почитать в разделе [[https://github.com/qbittorrent/qBittorrent/wiki/#compilation|Compilation]]
<code>
git clone https://github.com/qbittorrent/qBittorrent.git
cd qBittorrent
cmake -B build -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DGUI=OFF
cmake --build build
</code>
Готовый бинарный пакет qbittorrent-nox будет доступен в директории /build
===== Решение проблем =====
==== Потребление памяти ====
При большом количестве раздач, в qBittorrent 4, [[https://github.com/qbittorrent/qBittorrent/issues/16612|наблюдается]] проблема повышенного расхода памяти с активным использованием swap и зависанием интерфейса.
Чтобы избежать перебоев в работе других служб, можно добавить лимиты на процесс, указав объем доступной памяти:
<code>
nano /etc/systemd/system/qbittorrent-nox.service
</code>
* qbittorrent-nox - серверный клиент qbittorrent
<code>
[Service]
MemoryHigh=256M
MemoryMax=512M
MemorySwapMax=512M
</code>
В версии 5 (из ветки unstable) проблема пока что не наблюдалась.
Установить альфа версию для требуемого дистрибутива можно из списка на [[https://www.qbittorrent.org/download|официальной странице загрузок]], раздел "Other Binary Packages"\\
Например, репозиторий Ubuntu:
<code>
add-apt-repository ppa:qbittorrent-team/qbittorrent-unstable
</code>
==== Совместимость ====
=== Протоколы ===
qBittorrent по-умолчанию генерирует торрент-файлы гибридного формата.
Клиенты (например, [[yggdrasil:bittorrent:transmission|Transmission]]) не имеющие поддержку протокола 2 версии, не смогут открыть файл.
Таким образом, при создании торрент-файлов лучше явно указывать формат версии 1.
=== Magnet ===
Автоматически сгенерированный из magnet ссылки .torrent файл (при включенной опции авто-сохранения .torrent файлов), может не содержать фрагментов (pieces) что сделает его не совместимым при импорте.
В качестве решения, для раздач лучше генерировать новый .torrent файл после загрузки содержимого.
==== Зависание скачиваний ====
В 4 версии клиента замечено зависание (stalled) при скачивании файлов. Частой причиной этому может быть использование только первого трекера (оффлайн) из списка доступных.
Решение описано в [[https://github.com/qbittorrent/qBittorrent/wiki/Frequently-Asked-Questions#Only_one_tracker_is_working_The_others_arent_contacted_yet|официальной инструкции]] по дополнительным настройкам:
**Preferences → Advanced → Always announce to all trackers**
Также можно отметить
**Preferences → Advanced → Always announce to all trackers in a tier**
==== WebUI открывается как файл ====
В большинстве случаев связано с настройками MIME.
В дистрибутивах Linux, можно попробовать очистить кеш в директории
<code>
/home/USERNAME/local/share/mime
</code>
==== Ошибка авторизации плагинов ====
При использовании приватных трекеров или таких, что требуют авторизации для осуществления поиска, следует:
* Зайти на сайт и авторизироваться из браузера, возможно есть запрос Captcha
* Перезапустить сервис клиента - причиной может быть внутреннее кеширование клиентом предыдущих настроек
===== Ссылки =====
[[https://www.qbittorrent.org/|Официальный сайт qBittorrent]]\\
[[https://github.com/qbittorrent/qBittorrent/wiki/Frequently-Asked-Questions|Частые вопросы]]\\
[[https://github.com/qbittorrent/qBittorrent/wiki/List-of-known-qBittorrent-themes|Альтернативные темы (Десктоп)]]\\
[[https://github.com/qbittorrent/qBittorrent/wiki/List-of-known-alternate-WebUIs|Альтернативные клиенты (Web UI)]]\\
[[https://github.com/qbittorrent/search-plugins/wiki/Unofficial-search-plugins|Поисковые плагины]]
* Внутрисетевые:
* [[https://github.com/YGGverse/qbittorrent-yggtracker-search-plugin|YGGtracker]] - ([[https://github.com/YGGverse/qbittorrent-yggtracker-search-plugin/blob/main/nodes.json|Реестр узлов]])
* Порты [[https://github.com/imDMG/qBt_SE|qBt_SE]]:
* [[https://raw.githubusercontent.com/YGGverse/qBt_SE/yggdrasil/engines/rutor_yggdrasil_321_c99a_91a1_cd2c__16.py|Rutor]] (http://[321:c99a:91a1:cd2c::16]/)
* [[https://raw.githubusercontent.com/YGGverse/qBt_SE/yggdrasil/engines/rutracker_yggdrasil_321_c99a_91a1_cd2c__18.py|Rutracker]] (http://[321:c99a:91a1:cd2c::18]/forum/) - для поиска необходима авторизация