WeiG qB WebUI: руководство для начинающих по альтернативному веб-интерфейсу qBittorrent

1. Распакуйте ZIP

Скачайте последнюю стабильную версию weig-qb-webui.zip и распакуйте архив. Папка уже имеет нужное имя:

weig-qb-webui/
├── public/
├── private/
├── VERSION
└── GIT_SHA

Вся папка weig-qb-webui является корнем WebUI. Не копируйте только public или private.

2. Переместите в постоянное место

Например:

Windows: D:\weig-qb-webui
Linux:   /opt/weig-qb-webui

Этот путь затем нужно указать в qBittorrent.

3. Включите в qBittorrent

Откройте qBittorrent:

Сервис → Настройки… → WebUI

Это текущие термины официального русского перевода qBittorrent. Затем:

1. Включите Использовать альтернативный веб-интерфейс.
2. Найдите Расположение файлов:.
3. Укажите путь к папке weig-qb-webui.

Пример Windows:

D:\weig-qb-webui

Пример Linux:

/opt/weig-qb-webui

4. Нажмите OK для сохранения.
5. Обновите страницу WebUI. Если осталась старая версия из кэша, попробуйте Ctrl + F5.

Проверка пути: в указанном каталоге должны сразу быть видны public, private, VERSION и другие файлы.

Docker: qBittorrent работает внутри контейнера, поэтому обычно нужно указывать путь, видимый из контейнера, а не реальный путь хоста.

./install.sh

Каталог WebUI по умолчанию:

~/.local/share/weig-qb-webui

При запуске от root обычно:

/root/.local/share/weig-qb-webui

Хост и контейнер

• Хост: Linux/NAS, на котором запущен Docker.
• Контейнер: изолированная среда, где работает qBittorrent.

Пример:

Хост:       /root/qbittorrent/config
   ↓ смонтировано как
Контейнер:  /config

Docker Compose:

volumes:
  - /root/qbittorrent/config:/config

Если WebUI на хосте находится здесь:

/root/qbittorrent/config/weig-qb-webui

то в Расположение файлов: qBittorrent нужно указать:

/config/weig-qb-webui

Один контейнер qBittorrent

curl -fsSL https://weigefenxiang.github.io/WeiG-qB-WebUI/downloads/dev/install.sh -o install.sh && sh install.sh -configure

Установщик попытается автоматически определить контейнер и монтирование /config.

Показать контейнеры

sh install.sh --list-containers

Или:

docker ps

Явно выбрать контейнер:

sh install.sh --container=qbittorrent -configure

Если найдено несколько контейнеров qBittorrent, установщик не выбирает один случайно.

Случай 3: несколько контейнеров qBittorrent

Если запущены qbittorrent и qbittorrent-test, сначала выведите список, а затем явно укажите нужный контейнер. Установщик не выбирает наугад:

sh install.sh --list-containers
sh install.sh --container=qbittorrent -configure
sh install.sh --container=qbittorrent-test -configure

Указать путь хоста, смонтированный как /config

sh install.sh --config-root=/root/qbittorrent/config -configure

Synology:

sh install.sh --config-root=/volume1/docker/qbittorrent -configure

Другой NAS:

sh install.sh --config-root=/share/Container/qbittorrent -configure

Указать путь WebUI

sh install.sh --container=qbittorrent -o /config/weig-qb-webui -configure

Случай 6: обновление нескольких существующих папок WebUI

Для нескольких экземпляров qBittorrent можно повторить параметр -o. Пакет скачивается и проверяется один раз; переключение начинается после подготовки всех целей. В ~/.config/weig-qb-webui/backups/ для каждой цели отдельно остаются три последние резервные копии.

sh install.sh -dev \
  -o /root/qbittorrent/config/weig-qb-webui \
  -o /root/qbittorrent3/config/weig-qb-webui

Не используйте -configure с несколькими целями: каждый экземпляр qBittorrent сохранит свой текущий путь WebUI. Список параметров доступен через sh install.sh -help.

Проверка путей после установки

После установки скрипт выводит примерно такие пути. Первый — фактическая папка на хосте, второй — путь внутри контейнера, который нужно указать в Files location qBittorrent.

Host install path: /root/qbittorrent/config/weig-qb-webui
qBittorrent Root Folder: /config/weig-qb-webui

C:\Users\<имя-пользователя>\AppData\Local\weig-qb-webui

Имена параметров PowerShell не зависят от регистра.

• Без -dev устанавливается проверенный стабильный GitHub Release из main. С -dev используется текущая сборка dev, закреплённая за конкретным Git SHA.
• -o означает output. В Linux параметр можно повторять, чтобы обновить несколько WebUI за одну проверенную загрузку.
• Резервные копии находятся в ~/.config/weig-qb-webui/backups/; для каждой цели отдельно сохраняются последние три.
• -configure включает в qBittorrent Use alternative WebUI и указывает Files location. Параметр работает только с одной целью.
• -rollback восстанавливает последнюю копию для выбранной цели; для отката нескольких целей повторите -o.
• -uninstall -purge удаляет WebUI и резервные копии / состояние отката выбранной цели, сохраняя копии других установок. Общий каталог удаляется, только когда пуст.
• Чтобы сохранить копии для будущего -rollback, не добавляйте -purge при удалении.
• -version 1.2.0 задаёт конкретный GitHub Release. Если версии нет, будет ошибка: автоматического перехода на latest или dev не происходит.
• -help выводит поддерживаемые параметры.
• Если контейнеров Docker несколько, используйте --list-containers и --container=NAME, либо укажите --config-root=/path.

Конкретная версия и каталог установки

Linux:

sh install.sh -version 1.2.0 -o /opt/weig-qb-webui -configure

Windows:

powershell -ExecutionPolicy Bypass -File .\install.ps1 -version 1.2.0 -o D:\weig-qb-webui -configure

Откат

Откат:

sh install.sh -rollback

powershell -ExecutionPolicy Bypass -File .\install.ps1 -rollback

По умолчанию рекомендуется полное удаление без сохранения резервных копий установщика: удалить WebUI, отключить соответствующий альтернативный WebUI, очистить принадлежащие этой цели резервные копии / состояние rollback, а затем удалить загруженный скрипт установки из текущего каталога.

Linux / NAS

sh install.sh -uninstall -configure -purge && rm -f -- ./install.sh

Для собственного пути установки добавьте -o /path/to/weig-qb-webui.

Docker

Один контейнер / автоопределение:

sh install.sh -uninstall -configure -purge && rm -f -- ./install.sh

Несколько контейнеров:

sh install.sh -uninstall -configure -purge --container=qbittorrent && rm -f -- ./install.sh

При использовании --config-root:

sh install.sh -uninstall -configure -purge --config-root=/path/to/qbittorrent/config && rm -f -- ./install.sh

Windows PowerShell

powershell -ExecutionPolicy Bypass -File .\install.ps1 -uninstall -configure -purge; if ($LASTEXITCODE -eq 0) { Remove-Item .\install.ps1 -Force }

Для собственного пути установки добавьте -o D:\weig-qb-webui.

-purge удаляет только резервные копии текущей цели и не затрагивает другие установки. Если общий каталог состояния становится пустым, также удаляется ~/.config/weig-qb-webui в Linux (для root: /root/.config/weig-qb-webui) или %APPDATA%\weig-qb-webui в Windows.

Чтобы сохранить резервные копии для последующего -rollback, просто уберите -purge.