qBittorrent — свободный BitTorrent-клиент на Qt и libtorrent, который ценят за отсутствие рекламы, встроенных покупок и навязанных расширений. На Linux он работает как обычное приложение с графическим интерфейсом или как headless-сервис с веб-панелью. Ниже — установка, базовая настройка, разумные ограничения и диагностика. Сразу оговорюсь: клиент предназначен для легального контента — дистрибутивов Linux, открытых данных, Creative Commons и собственных файлов. Инструкций по скачиванию пиратских материалов здесь нет и быть не может.
Установка: пакет, Flatpak или nox
В репозиториях Debian и Ubuntu есть qbittorrent с GUI и qbittorrent-nox без интерфейса. Пакет из репозитория может отставать от upstream, зато обновляется вместе с системой. Flatpak даёт свежую версию и изоляцию.
sudo apt install qbittorrent
sudo apt install qbittorrent-nox
flatpak install flathub org.qbittorrent.qBittorrent
qbittorrent-nox --version
Для домашней машины достаточно GUI-версии. Для мини-сервера или NAS выбирайте nox: он не тянет графические библиотеки и управляется через браузер. Запускать его от root не нужно — создайте отдельного пользователя или используйте свою учётную запись.
Headless-режим и веб-интерфейс
При первом запуске nox печатает временный пароль в журнал. Найдите его и сразу смените в настройках Web UI.
qbittorrent-nox --webui-port=8080
journalctl --user -u qbittorrent-nox -n 50 --no-pager
systemctl --user daemon-reload
systemctl --user enable --now qbittorrent-nox
Юнит для пользовательского systemd можно описать так:
[Unit]
Description=qBittorrent nox
After=network-online.target
[Service]
ExecStart=/usr/bin/qbittorrent-nox --webui-port=8080
Restart=on-failure
[Install]
WantedBy=default.target
Чтобы сервис работал после выхода из сеанса, включите loginctl enable-linger $USER. Панель по умолчанию слушает порт 8080; не выставляйте её в интернет без TLS и пароля. Безопасный вариант — SSH-туннель: ssh -L 8080:127.0.0.1:8080 user@server, затем открыть адрес на локальной машине.
В настройках Web UI включите проверку Host-заголовка, защиту от CSRF и кликджекинга, задайте сложный пароль. Опция «обходить аутентификацию для localhost» удобна, но только если на машине нет других пользователей.
Что настроить в первую очередь
- Порт. По умолчанию 6881; для входящих соединений нужен проброс TCP и UDP на роутере. Без него клиент работает, но видит меньше пиров.
- Лимиты. Ограничьте число соединений и активных раздач, если канал или диск слабые. Это снижает нагрузку и делает поведение предсказуемым.
- Очередь. Включите автозапуск не более 2–3 загрузок одновременно, остальные держите в очереди.
- Шифрование. Режим «Prefer encryption» совместимее, чем «Require»: второй может отсечь часть пиров.
- Раздача. Задайте лимит по ratio или времени, чтобы не держать диск занятым бесконечно.
- Пути. Разделите каталоги загрузок и готовых файлов; не храните данные на корневом разделе.
DHT, PEX и LSD полезны для публичных легальных раздач, но увеличивают сетевую активность. Для закрытого трекера или локальной сети их лучше отключить. Проверить, слушается ли порт, можно так:
ss -tulpn | grep 6881
sudo ufw allow 6881/tcp
sudo ufw allow 6881/udp
tail -n 30 ~/.local/share/qBittorrent/logs/qbittorrent.log
Если порт закрыт, а скачивание идёт, не спешите менять настройки: многие сети работают только через исходящие соединения. Для раздачи собственных файлов проброс всё же желателен.
API и автоматизация
У qBittorrent есть WebUI API v2. Он позволяет получать статус, ставить задачи на паузу и управлять очередью. Пример входа и проверки списка:
curl -s -c /tmp/qb.cookie -H 'Referer: http://127.0.0.1:8080' \
--data 'username=admin&password=пароль' \
http://127.0.0.1:8080/api/v2/auth/login
curl -s -b /tmp/qb.cookie http://127.0.0.1:8080/api/v2/torrents/info | python3 -m json.tool
Не храните пароль в истории команд: используйте переменные окружения или файл с правами 600. Для мониторинга достаточно периодически запрашивать /api/v2/transfer/info и /api/v2/sync/maindata. Не автоматизируйте добавление контента, права на который вам не принадлежат.
RSS, поиск и легальные источники
Встроенный RSS-модуль подписывается на ленты и умеет автоматически скачивать новые выпуски по правилу. Это удобно для подкастов, релизов открытых проектов и собственных архивов: правило задаёт шаблон имени, каталог и лимит. Поисковые плагины устанавливаются отдельно и обращаются к внешним каталогам; подключайте только те источники, которые распространяют контент законно, и проверяйте лицензию каждой раздачи.
Для публичных легальных раздач полезно включить шифрование в режиме совместимости и ограничить число соединений. Если скорость не растёт, сравните её с пропускной способностью канала и проверьте диск: перегруженный накопитель тормозит сильнее сети. Команда df -h покажет свободное место, а журнал клиента — ошибки записи.
df -h ~/Downloads
du -sh ~/.local/share/qBittorrent/BT_backup
grep -i -E 'error|warn' ~/.local/share/qBittorrent/logs/qbittorrent.log | tail
systemctl --user status qbittorrent-nox
Альтернативы и сравнение
Transmission проще и легче, хорошо подходит для постоянной работы на слабом железе. Deluge расширяется плагинами, но интерфейс менее дружелюбен. rTorrent с ruTorrent — выбор тех, кто любит терминал и тонкую настройку. qBittorrent выигрывает балансом: понятный GUI, встроенный поиск с подключаемыми плагинами, RSS и зрелая веб-панель.
Перед раздачей проверьте целостность файла — например, свежего ISO-образа:
sha256sum ubuntu-24.04.2-desktop-amd64.iso
sha256sum -c SHA256SUMS
ls -lh ~/Downloads/
find ~/.local/share/qBittorrent/BT_backup -maxdepth 1 -type f | wc -l
Сверка контрольной суммы занимает секунды и защищает от битой загрузки. Резервную копию настроек удобно делать из ~/.config/qBittorrent/qBittorrent.conf и каталога BT_backup: там хранятся метаданные и текущие задачи.
При переносе на другой компьютер закройте клиент, скопируйте конфиг и BT_backup, затем запустите его на новой машине и проверьте пути. Если клиент не видит задачи, укажите новый каталог загрузок в настройках и запустите перехеширование. Не копируйте данные на ходу: незакрытый клиент может записать половину файла и испортить состояние раздачи. После переноса проверьте права на каталог загрузок и убедитесь, что свободного места достаточно для всех задач.
Итог
qBittorrent остаётся одним из самых удобных клиентов для Linux: без рекламы, с нормальной веб-панелью и предсказуемыми настройками. Для домашнего использования хватит GUI-версии, для сервера — nox под systemd с доступом через SSH-туннель. Настройте порт, лимиты и шифрование, проверяйте контрольные суммы и используйте клиент только для контента, который вы вправе распространять.