WeiG qB WebUI: guía para principiantes de la interfaz Web alternativa de qBittorrent

1. Extraer el ZIP

Descarga la última versión estable weig-qb-webui.zip y descomprímela. El archivo ya incluye la carpeta raíz con el nombre correcto:

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

La carpeta weig-qb-webui completa es la raíz de la WebUI. No copies solo public o private.

2. Moverla a una ubicación fija

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

Ese es el directorio que indicarás en qBittorrent.

3. Activarla en qBittorrent

Abre qBittorrent:

Herramientas → Opciones… → WebUI

Estos son los términos actuales de la traducción oficial al español de qBittorrent. Después:

1. Activa Usar la interfaz Web alternativa.
2. Busca Ubicación de archivos:.
3. Introduce la ruta de la carpeta weig-qb-webui.

Ejemplo en Windows:

D:\weig-qb-webui

Ejemplo en Linux:

/opt/weig-qb-webui

4. Pulsa OK para guardar.
5. Recarga la WebUI. Si sigue apareciendo la interfaz antigua, prueba Ctrl + F5.

Cómo comprobar la ruta: dentro del directorio indicado debes ver directamente public, private, VERSION y los demás archivos.

Docker: qBittorrent se ejecuta dentro de un contenedor, por lo que normalmente debes usar una ruta visible desde el contenedor y no la ruta real del host.

./install.sh

Ruta predeterminada de la WebUI:

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

Si se ejecuta como root:

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

Host y contenedor

• Host: el sistema Linux/NAS donde se ejecuta Docker.
• Contenedor: el entorno aislado donde se ejecuta qBittorrent.

Ejemplo:

Host:       /root/qbittorrent/config
   ↓ montado como
Contenedor: /config

Docker Compose:

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

Si la WebUI está instalada en el host en:

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

entonces Ubicación de archivos: en qBittorrent debe ser:

/config/weig-qb-webui

Un único contenedor qBittorrent

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

El instalador intenta detectar automáticamente el contenedor y el montaje /config.

Listar contenedores

sh install.sh --list-containers

O:

docker ps

Elegir un contenedor explícitamente:

sh install.sh --container=qbittorrent -configure

Si hay varios contenedores qBittorrent, el instalador no elige uno al azar.

Caso 3: varios contenedores qBittorrent

Si tienes qbittorrent y qbittorrent-test, consulta primero la lista y después selecciona cuál quieres configurar. El instalador no elige por su cuenta:

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

Indicar el directorio del host montado como /config

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

Synology:

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

Otro NAS:

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

Elegir la ruta WebUI

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

Caso 6: actualizar varias carpetas WebUI existentes

Si gestionas varias instancias de qBittorrent, repite -o para indicar sus carpetas. El paquete se descarga y verifica una sola vez; los cambios se aplican después de preparar todos los destinos. Cada uno conserva sus tres copias más recientes por separado en ~/.config/weig-qb-webui/backups/.

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

No uses -configure con varios destinos: cada instancia seguirá usando su ruta WebUI configurada. Ejecuta sh install.sh -help para ver las opciones.

Comprobar las rutas después de instalar

Al terminar, el instalador muestra rutas parecidas a estas. La primera es la ubicación real en el host; la segunda es la ruta dentro del contenedor que debes escribir en Files location de qBittorrent.

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

C:\Users\<tu-usuario>\AppData\Local\weig-qb-webui

Los nombres de parámetros de PowerShell no distinguen mayúsculas y minúsculas.

• Sin -dev, se instala la versión estable de GitHub verificada desde main. Con -dev, el desarrollo actual de dev mediante su SHA exacto.
• -o significa output. En Linux puedes repetirlo para actualizar varias carpetas WebUI existentes con una descarga verificada.
• Las copias se guardan en ~/.config/weig-qb-webui/backups/, conservando las tres más recientes por destino.
• -configure activa Use alternative WebUI y configura Files location en qBittorrent. Solo admite un destino a la vez.
• -rollback restaura la última copia del instalador para el destino indicado. Repite -o para restaurar varios destinos explícitos.
• -uninstall -purge elimina la WebUI y las copias / el estado de restauración de ese destino sin afectar a otros. El directorio compartido se limpia si queda vacío.
• Si quieres conservar las copias para usar -rollback más adelante, omite -purge.
• -version 1.2.0 instala un GitHub Release concreto. Si no existe, se produce un error y no se cambia automáticamente a latest ni dev.
• -help muestra las opciones disponibles.
• Para varios contenedores Docker, usa --list-containers y --container=NAME, o indica la configuración del host con --config-root=/path.

Versión específica y directorio de instalación

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

Reversión

Rollback:

sh install.sh -rollback

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

De forma predeterminada se recomienda la desinstalación completa sin conservar copias del instalador: elimina el WebUI, desactiva la interfaz alternativa correspondiente, purga las copias / el estado de rollback propiedad de ese destino y después elimina el script de instalación descargado en el directorio actual.

Linux / NAS

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

Para una ruta personalizada, añade -o /path/to/weig-qb-webui.

Docker

Un contenedor / detección automática:

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

Varios contenedores:

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

Al usar --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 }

Para una ruta personalizada, añade -o D:\weig-qb-webui.

-purge solo elimina las copias pertenecientes al destino que se está desinstalando y no afecta a otras instalaciones. Si el directorio de estado compartido queda vacío, también se elimina ~/.config/weig-qb-webui en Linux (root: /root/.config/weig-qb-webui) o %APPDATA%\weig-qb-webui en Windows.

Para conservar las copias y poder usar -rollback más adelante, simplemente omite -purge.