qBittorrent — это мощный торрент-клиент с открытым исходным кодом, который может работать как обычное десктопное приложение (с графическим интерфейсом) и как фоновый сервис на сервере без графической оболочки (через веб-интерфейс). В отличие от многих других клиентов, в qBittorrent нет рекламы, а его веб-интерфейс очень похож на классический µTorrent. Сложность в том, что в зависимости от версии Debian меняется не только версия самого qBittorrent, но и поведение веб-интерфейса при первой авторизации.
💡 В этом руководстве мы разберём все основные способы установки qBittorrent на Debian: для домашнего компьютера (APT Desktop), для сервера без графики (qbittorrent-nox), а также альтернативные методы — Flatpak и AppImage. Вы узнаете, как настроить веб-доступ, создать systemd-сервис и решить типичные проблемы с авторизацией.
В этой статье вы узнаете:
- Какой способ установки выбрать в зависимости от ваших задач
- Как установить qBittorrent с графическим интерфейсом через APT
- Как установить и настроить серверную версию (qbittorrent-nox) с веб-интерфейсом
- Как создать systemd-сервис для автоматического запуска (включая Debian 11)
- Как открыть порт в фаерволе для удалённого доступа
- Как решить проблему с паролем (особенно на свежих версиях)
- Как установить qBittorrent через Flatpak и AppImage (если нужна новее версия)
Для кого: домашние пользователи, желающие скачивать торренты на своём компьютере, администраторы домашних серверов и NAS, а также все, кто хочет управлять загрузками удалённо через браузер.
1. 🔧 Предварительные требования
Перед установкой убедитесь, что:
- У вас установлена Debian 11, 12 или 13
- Подключение к интернету стабильно
- Вы знаете, нужен ли вам графический интерфейс (десктоп) или только веб-интерфейс (сервер)
⚠️ ВАЖНО: Проверьте права sudo перед установкой
Если вы не уверены, есть ли у вашего пользователя права администратора, выполните в терминале:
sudo whoamiЧто делает: sudo выполняет команду от имени суперпользователя, whoami показывает имя текущего пользователя.
Зачем: Эта команда проверяет, есть ли у вас права sudo. Без них вы не сможете устанавливать пакеты.
✅ Если выводит root — всё в порядке, можете продолжать.
❌ Если выводит is not in the sudoers file — сначала пройдите наше руководство по настройке sudo.
1.1 Обновление системы
Перед установкой всегда обновляйте список пакетов:
sudo apt update && sudo apt upgrade -yЧто делает:
sudo— права суперпользователяapt update— обновляет список доступных пакетов из репозиториев&&— выполняет следующую команду только если предыдущая успешнаapt upgrade -y— обновляет все установленные пакеты до последних версий
Зачем: Это стандартная практика безопасности перед установкой нового ПО.
2. 📊 Сравнение способов установки
Прежде чем выбирать метод, посмотрите таблицу. Она поможет принять решение.
| Метод | Откуда | Версия | Обновления | Для кого |
|---|---|---|---|---|
| APT Desktop | Репозитории Debian | Стабильная, но старая | Автоматически через APT | Домашний компьютер, простота |
| APT Headless (nox) | Репозитории Debian | Стабильная, но старая | Автоматически через APT | Сервер, NAS, seedbox |
| Flatpak | Flathub | Свежая | Автоматически через Flatpak | Десктоп, нужны новые функции |
| AppImage | SourceForge | Самая свежая (включая бета) | Вручную (перескачивать файл) | Портативность, тестирование бета |
💡 Рекомендация: Если вы обычный пользователь домашнего компьютера — берите APT Desktop. Если ставите на сервер без графики — APT Headless. Если версия в Debian слишком старая, а свежие функции нужны — используйте Flatpak.
3. 📊 Версии qBittorrent по умолчанию в разных Debian
В разных версиях Debian предустановленные версии qBittorrent различаются. Это важно, особенно для серверной версии, потому что меняется способ авторизации в веб-интерфейсе.
| Версия Debian | Версия qBittorrent | systemd-сервис | Пароль WebUI по умолчанию |
|---|---|---|---|
| Debian 13 (Trixie) | 5.1.x | Встроенный | Временный (генерируется при каждом запуске) |
| Debian 12 (Bookworm) | 4.5.x | Встроенный | adminadmin (старый способ) |
| Debian 11 (Bullseye) | 4.2.x | Нет (создаём вручную) | adminadmin (старый способ) |
⚠️ Важно: Начиная с qBittorrent 4.6.1 (в Debian 13 используется более новая версия), разработчики убрали стандартный пароль adminadmin. Теперь при первом запуске генерируется временный одноразовый пароль, который выводится в лог. Обязательно прочитайте раздел 8.3, если не можете войти в веб-интерфейс.
4. 🖥️ Способ 1: Установка десктопной версии (с графикой) через APT
Этот способ подходит, если вы используете Debian с графической оболочкой (GNOME, KDE, XFCE) и хотите управлять торрентами через обычное окно приложения.
4.1 Установка пакета
sudo apt install qbittorrent -yЧто делает: Устанавливает графическую версию qBittorrent со всеми зависимостями (библиотеки Qt и т.д.).
Зачем: Это самый простой способ для домашнего компьютера. Обновления будут приходить вместе с системой.
4.2 Проверка установки
qbittorrent --versionЧто делает: Показывает установленную версию.
✅ Ожидаемый вывод в терминале (зависит от версии Debian):
qBittorrent v5.1.0(На Debian 12 будет v4.5.x, на Debian 11 — v4.2.x)
4.3 Запуск программы
Способ 1 (графический): Нажмите Super (клавиша с логотипом Windows), введите в поиске qBittorrent и нажмите на иконку.
Способ 2 (терминал):
qbittorrentЧто делает: Запускает графическое приложение.
Зачем: При первом запуске появится лицензионное соглашение. Примите его, и откроется главное окно программы.
5. 🖥️ Способ 2: Установка серверной версии (без графики) — qbittorrent-nox
Этот способ подходит, если ваш Debian работает без графического интерфейса (например, на домашнем сервере или одноплатном компьютере вроде Raspberry Pi). Управление происходит через веб-интерфейс из любого браузера.
5.1 Установка пакета
sudo apt install qbittorrent-nox -yЧто делает: Устанавливает версию без графического интерфейса (nox = No X Window System).
Проверка установки:
qbittorrent-nox --version✅ Ожидаемый вывод (Debian 13):
qBittorrent v5.1.05.2 Создание отдельного пользователя для сервиса (рекомендуется)
Для безопасности лучше запускать qbittorrent-nox от отдельного пользователя, а не от вашего основного.
sudo adduser --system --group --home /var/lib/qbittorrent qbittorrentЧто делает:
--system— создаёт системного пользователя (без возможности интерактивного входа)--group— создаёт одноимённую группу--home /var/lib/qbittorrent— задаёт домашнюю директорию (по умолчанию была бы/nonexistent, что сломало бы хранение настроек)qbittorrent— имя пользователя
Зачем: Изоляция. Если в qBittorrent найдётся уязвимость, злоумышленник получит доступ только к этому пользователю, а не ко всей вашей учётной записи.
5.3 Настройка systemd-сервиса
Для Debian 12 и 13 (сервис уже встроен)
В Debian 12 и 13 уже есть готовый шаблон сервиса qbittorrent-nox@.service. Всё, что нужно — включить и запустить его для нашего пользователя.
sudo systemctl enable --now qbittorrent-nox@qbittorrentЧто делает:
enable— добавляет сервис в автозагрузку--now— запускает сервис сразу, не дожидаясь перезагрузки@qbittorrent— передаёт имя пользователя, от которого будет работать сервис
Проверка статуса:
systemctl status qbittorrent-nox@qbittorrent✅ Ожидаемый вывод в терминале (сокращённо):
● qbittorrent-nox@qbittorrent.service - qBittorrent-nox service for user qbittorrent
Loaded: loaded (/usr/lib/systemd/system/qbittorrent-nox@.service; enabled)
Active: active (running)Ключевая строка — Active: active (running). Если видите failed или inactive (dead) — перейдите к разделу 8.
Для Debian 11 (создаём сервис вручную)
В Debian 11 встроенного сервиса нет, поэтому создадим его сами.
Шаг 1: Создайте файл сервиса:
sudo nano /etc/systemd/system/qbittorrent-nox@.serviceЧто делает: Открывает редактор nano для создания нового файла.
Шаг 2: Вставьте в файл следующее содержимое:
[Unit]
Description=qBittorrent-nox service for user %I
Documentation=man:qbittorrent-nox(1)
Wants=network-online.target
After=local-fs.target network-online.target nss-lookup.target
[Service]
Type=simple
PrivateTmp=false
User=%i
ExecStart=/usr/bin/qbittorrent-nox
TimeoutStopSec=1800
[Install]
WantedBy=multi-user.targetЧто означает каждая секция:
[Unit]— общая информация о сервисе[Service]— как запускать: от какого пользователя (User=%i), какую команду (ExecStart=...)[Install]— когда запускать (при достижении уровняmulti-user.target, то есть при обычной загрузке системы)
Шаг 3: Сохраните файл (в nano: Ctrl+O, затем Enter, затем Ctrl+X).
Шаг 4: Перезагрузите конфигурацию systemd и запустите сервис:
sudo systemctl daemon-reload
sudo systemctl enable --now qbittorrent-nox@qbittorrentЧто делает:
daemon-reload— заставляет systemd перечитать все файлы сервисов (нужно после создания нового)enable --now— включает автозапуск и запускает сейчас
5.4 Открытие порта в фаерволе
Веб-интерфейс qbittorrent-nox по умолчанию работает на порту 8080. Если на вашем сервере включён фаервол, этот порт нужно открыть.
Если используете UFW (стандартный для Debian):
sudo ufw allow 8080/tcpЧто делает: Добавляет правило, разрешающее входящие подключения на TCP-порт 8080.
Если используете firewalld (редко на Debian, но бывает):
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload⚠️ Важно: Не открывайте порт 8080 в интернет без необходимости. Лучше оставить доступ только внутри локальной сети или использовать SSH-туннель.
5.5 Доступ к веб-интерфейсу
Откройте браузер и перейдите по адресу:
- На самом сервере:
http://localhost:8080 - С другого компьютера в сети:
http://IP-ВАШЕГО-СЕРВЕРА:8080(например,http://192.168.1.100:8080)
Логин: admin
Пароль: Зависит от версии Debian (см. таблицу в разделе 3 и раздел 8.3, если не можете войти).
6. 🧪 Способ 3: Установка через Flatpak (свежая версия для десктопа)
Flatpak подходит, если вам нужна более новая версия qBittorrent, чем та, что лежит в репозиториях Debian. Особенно актуально для Debian 12 и 11, где версии заметно устарели.
6.1 Установка Flatpak (если ещё не установлен)
sudo apt install flatpak -y
sudo flatpak remote-add --system --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepoЧто делает:
- Первая команда — устанавливает Flatpak
- Вторая — добавляет репозиторий Flathub (откуда берутся приложения)
Зачем: Flatpak — это система изоляции приложений. Flathub — основной источник приложений для Flatpak.
💡 Если вы не знакомы с Flatpak: У нас есть подробное руководство по установке Flatpak на Debian.
6.2 Установка qBittorrent из Flathub
sudo flatpak install --system flathub org.qbittorrent.qBittorrent -yЧто делает: Устанавливает qBittorrent из репозитория Flathub.
6.3 Проверка версии
flatpak info --system org.qbittorrent.qBittorrent | grep Version✅ Ожидаемый вывод в терминале:
Version: 5.1.4(Версия будет свежее, чем в APT, особенно на Debian 11 и 12.)
6.4 Запуск
Из терминала:
flatpak run org.qbittorrent.qBittorrentИз меню приложений: Нажмите Super, введите qBittorrent, появится значок.
7. 📦 Способ 4: Установка через AppImage (портативная версия)
AppImage — это один файл, который содержит всё приложение целиком. Не требует установки, не требует прав sudo, не оставляет следов в системе.
7.1 Скачивание последней стабильной версии
Эта команда сама находит и скачивает последнюю версию qBittorrent с SourceForge:
VERSION=$(curl -sL "https://sourceforge.net/projects/qbittorrent/files/qbittorrent-appimage/" | grep -oP 'qbittorrent-\d+\.\d+\.\d+(?=/)' | grep -v -E 'beta|rc' | sort -Vu | tail -1 | sed 's/qbittorrent-//')
curl -L "https://sourceforge.net/projects/qbittorrent/files/qbittorrent-appimage/qbittorrent-${VERSION}/qbittorrent-${VERSION}_x86_64.AppImage/download" -o ~/qbittorrent.AppImage
chmod +x ~/qbittorrent.AppImageЧто делает:
- Первая команда: запрашивает список версий, отфильтровывает бета-версии, выбирает самую свежую
- Вторая: скачивает AppImage в вашу домашнюю директорию
- Третья: делает файл исполняемым
Зачем: AppImage полезен, если вы хотите протестировать новую версию, не трогая установленный через APT или Flatpak qBittorrent.
7.2 Запуск AppImage
~/qbittorrent.AppImageЧто делает: Запускает qBittorrent прямо из скачанного файла.
7.3 (Опционально) Перемещение в ~/.local/bin и создание ярлыка
Чтобы запускать AppImage командой qbittorrent из любого места и видеть его в меню приложений:
mkdir -p ~/.local/bin
mv ~/qbittorrent.AppImage ~/.local/bin/qbittorrentСоздание ярлыка для меню:
cat <<EOF > ~/.local/share/applications/qbittorrent-appimage.desktop
[Desktop Entry]
Name=qBittorrent (AppImage)
Exec=$HOME/.local/bin/qbittorrent
Icon=qbittorrent
Type=Application
Categories=Network;FileTransfer;P2P;
Comment=qBittorrent BitTorrent client (AppImage)
EOFЧто делает: Создаёт файл .desktop, который говорит системе, как отображать приложение в меню.
8. ⚠️ Решение типичных проблем
8.1 Ошибка: WebUI не открывается (страница недоступна)
Симптом: В браузере при попытке открыть http://ваш-сервер:8080 ничего не загружается, ошибка подключения.
Причина: Сервис не запущен, не слушает порт или фаервол блокирует доступ.
Пошаговое решение:
Шаг 1: Проверьте статус сервиса:
systemctl status qbittorrent-nox@qbittorrentЧто ищем: Строку Active: active (running). Если статус inactive (dead) или failed — сервис не работает.
Шаг 2: Если сервис не запущен, запустите:
sudo systemctl start qbittorrent-nox@qbittorrentШаг 3: Проверьте, слушает ли qBittorrent порт 8080:
sudo ss -tlnp | grep 8080✅ Ожидаемый вывод в терминале:
LISTEN 0 4096 0.0.0.0:8080 0.0.0.0:* users:(("qbittorrent-no",pid=1234,fd=12))Если вывода нет — qBittorrent не слушает порт. Посмотрите логи:
sudo journalctl -u qbittorrent-nox@qbittorrent -n 30 --no-pagerШаг 4: Проверьте фаервол (если включён):
sudo ufw statusЕсли видите Status: active, то убедитесь, что порт 8080 разрешён:
sudo ufw allow 8080/tcp8.2 Ошибка: qbittorrent-nox.service не найден или bad unit file setting
Симптом: При попытке запустить systemctl enable --now qbittorrent-nox@qbittorrent появляется ошибка о том, что сервис не найден или некорректен.
Причина: Вы используете Debian 11 (где нет встроенного сервиса) или неправильно указали имя пользователя.
Пошаговое решение:
Шаг 1: Проверьте, есть ли встроенный сервис:
ls /usr/lib/systemd/system/qbittorrent-nox@.serviceЕсли файл существует — вы на Debian 12/13. Если нет — на Debian 11.
Шаг 2: Для Debian 11 создайте сервис вручную по инструкции из раздела 5.3.
Шаг 3: Убедитесь, что пользователь, от которого вы запускаете сервис, существует:
getent passwd qbittorrent✅ Ожидаемый вывод: Строка с информацией о пользователе. Если вывода нет — создайте пользователя (раздел 5.2).
8.3 Ошибка входа в WebUI: не подходит пароль adminadmin
Симптом: Вводите логин admin и пароль adminadmin, а веб-интерфейс говорит «Invalid login».
Причина: Начиная с qBittorrent 4.6.1 (в Debian 13 версия 5.1.x), разработчики убрали стандартный пароль. Теперь при первом запуске генерируется временный одноразовый пароль. Он выводится в лог сервиса.
Пошаговое решение:
Шаг 1: Посмотрите логи сервиса и найдите временный пароль:
sudo journalctl -u qbittorrent-nox@qbittorrent -n 50 | grep -i "temporary password"✅ Пример вывода:
The WebUI administrator password was not set. A temporary password is provided for this session: mK7xP2wQvВременный пароль — mK7xP2wQv (в вашем случае будет другой).
Шаг 2: Войдите в веб-интерфейс с логином admin и этим временным паролем.
Шаг 3: Сразу же смените пароль на постоянный. В веб-интерфейсе перейдите в Tools (Инструменты) → Options (Настройки) → Web UI → Authentication. Установите свой логин и пароль, нажмите Save.
Шаг 4: После сохранения выйдите из веб-интерфейса и войдите снова с новым паролем.
💡 Если временный пароль не появился в логах: Возможно, вы уже когда-то заходили и установили пароль. Остановите сервис, удалите конфигурацию и запустите заново:
sudo systemctl stop qbittorrent-nox@qbittorrent
sudo rm -rf /var/lib/qbittorrent/.config/qBittorrent/qBittorrent.conf
sudo systemctl start qbittorrent-nox@qbittorrent
sudo journalctl -u qbittorrent-nox@qbittorrent -n 50 | grep -i "temporary password"8.4 Сервис не запускается из-за отсутствия домашней директории у пользователя
Симптом: systemctl status показывает ошибку, и в логах есть что-то про Failed to create runtime directory или No such file or directory.
Причина: Системный пользователь (qbittorrent) был создан без домашней директории, а qBittorrent она нужна для сохранения настроек.
Пошаговое решение:
Шаг 1: Создайте домашнюю директорию вручную:
sudo mkdir -p /var/lib/qbittorrent
sudo chown qbittorrent:qbittorrent /var/lib/qbittorrentЧто делает: Создаёт директорию и назначает её владельцем пользователя qbittorrent.
Шаг 2: Перезапустите сервис:
sudo systemctl restart qbittorrent-nox@qbittorrentШаг 3: Проверьте статус:
systemctl status qbittorrent-nox@qbittorrent8.5 Flatpak: qBittorrent не видит файлы за пределами домашней директории
Симптом: В qBittorrent, установленном через Flatpak, вы не можете выбрать папку для загрузки за пределами вашей домашней директории (например, /mnt/storage).
Причина: Flatpak изолирует приложения. По умолчанию qBittorrent видит только домашнюю папку пользователя.
Решение: Добавьте доступ к нужной директории с помощью flatpak override:
flatpak override --user org.qbittorrent.qBittorrent --filesystem=/путь/к/директорииПример для доступа к /mnt/storage:
flatpak override --user org.qbittorrent.qBittorrent --filesystem=/mnt/storageЧто делает: Разрешает Flatpak-версии qBittorrent доступ к указанной директории.
9. 🔄 Обновление qBittorrent
Для APT-версии (десктоп или nox)
sudo apt update
sudo apt install --only-upgrade qbittorrent # для десктопной
sudo apt install --only-upgrade qbittorrent-nox # для сервернойПосле обновления серверной версии перезапустите сервис:
sudo systemctl restart qbittorrent-nox@qbittorrentДля Flatpak-версии
sudo flatpak update --system org.qbittorrent.qBittorrentДля AppImage
AppImage не обновляется автоматически. Скачайте новый файл (повторите шаги из раздела 7.1) и замените старый.
10. ❌ Удаление qBittorrent
Удаление APT-версии (десктоп)
sudo apt remove --purge qbittorrent -y
sudo apt autoremove -y
rm -rf ~/.config/qBittorrent ~/.local/share/qBittorrentУдаление APT-версии (серверная, nox)
sudo systemctl stop qbittorrent-nox@qbittorrent
sudo systemctl disable qbittorrent-nox@qbittorrent
sudo apt remove --purge qbittorrent-nox -y
sudo apt autoremove -y
sudo userdel -r qbittorrent # удаляет пользователя и его домашнюю директориюДля Debian 11 (если создавали сервис вручную):
sudo rm /etc/systemd/system/qbittorrent-nox@.service
sudo systemctl daemon-reloadУдаление Flatpak-версии
sudo flatpak uninstall --system org.qbittorrent.qBittorrent -y
sudo flatpak uninstall --system --unused -y
rm -rf ~/.var/app/org.qbittorrent.qBittorrentУдаление AppImage
rm ~/.local/bin/qbittorrent # если перемещали
rm ~/.local/share/applications/qbittorrent-appimage.desktop # если создавали ярлык
rm ~/qbittorrent.AppImage # если оставили в домашней директорииПроверка, что всё удалено
dpkg -l | grep -E 'qbittorrent' || echo "APT-пакеты удалены"
flatpak list --system | grep qbittorrent || echo "Flatpak удалён"
test ! -f ~/.local/bin/qbittorrent && echo "AppImage удалён"11. 📝 Чек-лист: всё готово к работе
- [ ] Определились с методом установки (десктоп/сервер/Flatpak/AppImage)
- [ ] Обновили систему (
sudo apt update && sudo apt upgrade -y) - [ ] Для серверной версии: создан отдельный пользователь
qbittorrent - [ ] Для серверной версии: сервис активен (
systemctl status qbittorrent-nox@qbittorrentпоказываетactive (running)) - [ ] Порт 8080 открыт в фаерволе (если нужен удалённый доступ)
- [ ] Веб-интерфейс открывается (
http://localhost:8080илиhttp://IP-сервера:8080) - [ ] Удалось войти (учтите особенности пароля для Debian 13)
- [ ] Сменили временный пароль на постоянный (для Debian 13)
Заключение
Вы установили qBittorrent на Debian. Если вы выбрали десктопную версию — просто запускайте программу из меню и качайте торренты. Если вы настроили серверную версию (qbittorrent-nox) — теперь у вас есть полноценный торрент-клиент, который работает в фоне и доступен из любого браузера в локальной сети. Главное — не забывайте про безопасность: меняйте пароль по умолчанию, не открывайте порт 8080 в интернет без необходимости, а для доступа извне используйте SSH-туннель.
Что дальше:
- Настройте автозагрузку торрентов из определённой папки (Watch folder)
- Ограничьте скорость загрузки/отдачи в настройках
- Настройте RSS-ленты для автоматической загрузки
- Для удалённого доступа из интернета настройте SSH-туннель или VPN
- Если используете серверную версию, установите
fail2banдля защиты веб-интерфейса от брутфорса
