WeiG qB WebUI: guia para iniciantes da WebUI alternativa do qBittorrent

1. Extrair o ZIP

Transfira a versão estável mais recente weig-qb-webui.zip e extraia o ficheiro. A pasta principal já tem o nome correto:

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

A pasta weig-qb-webui completa é a raiz da WebUI. Não copie apenas public ou private.

2. Mover para uma localização permanente

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

Este é o diretório que deverá indicar no qBittorrent.

3. Ativar no qBittorrent

Abra o qBittorrent:

Ferramentas → Opções… → WebUI

Estes são os termos atuais da tradução oficial portuguesa do qBittorrent. Depois:

1. Ative Usar interface web alternativa.
2. Procure Localização dos ficheiros:.
3. Introduza o caminho para a pasta weig-qb-webui.

Exemplo Windows:

D:\weig-qb-webui

Exemplo Linux:

/opt/weig-qb-webui

4. Clique em OK para guardar.
5. Atualize a página da WebUI. Se a interface antiga continuar em cache, experimente Ctrl + F5.

Como confirmar o caminho: dentro do diretório indicado deve conseguir ver diretamente public, private, VERSION e os restantes ficheiros.

Docker: o qBittorrent é executado dentro de um contentor. Normalmente deve indicar um caminho visível pelo contentor, não o caminho real do anfitrião.

./install.sh

Diretório predefinido da WebUI:

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

Ao executar como root:

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

Anfitrião e contentor

• Anfitrião: o sistema Linux/NAS onde o Docker é executado.
• Contentor: o ambiente isolado onde o qBittorrent é executado.

Exemplo:

Anfitrião: /root/qbittorrent/config
   ↓ montado em
Contentor: /config

Docker Compose:

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

Se a WebUI estiver instalada no anfitrião em:

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

então Localização dos ficheiros: no qBittorrent deve ser:

/config/weig-qb-webui

Apenas um contentor qBittorrent

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

O instalador tenta detetar automaticamente o contentor e a montagem /config.

Listar contentores

sh install.sh --list-containers

Ou:

docker ps

Selecionar explicitamente um contentor:

sh install.sh --container=qbittorrent -configure

Se existirem vários contentores qBittorrent, o instalador não escolhe um ao acaso.

Caso 3: vários contentores qBittorrent

Se existirem qbittorrent e qbittorrent-test, liste os contentores e indique qual pretende configurar. O instalador não escolhe por adivinhação:

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

Indicar a pasta do anfitrião montada como /config

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

Synology:

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

Outro NAS:

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

Escolher o caminho da WebUI

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

Caso 6: atualizar várias pastas WebUI existentes

Com várias instâncias do qBittorrent, pode repetir -o para indicar os destinos. O pacote é transferido e verificado uma única vez; a mudança começa depois de todos os destinos estarem preparados. Cada um guarda as três últimas cópias separadamente em ~/.config/weig-qb-webui/backups/.

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

Não junte -configure à instalação de vários destinos. Cada instância mantém o caminho WebUI já configurado. Consulte sh install.sh -help para as opções.

Verificar os caminhos após a instalação

No fim, o instalador apresenta caminhos semelhantes aos seguintes. O primeiro é a pasta real no anfitrião; o segundo é o caminho dentro do contentor que deve introduzir em Files location no qBittorrent.

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

C:\Users\<nome-do-utilizador>\AppData\Local\weig-qb-webui

Os nomes dos parâmetros PowerShell não distinguem maiúsculas de minúsculas.

• Sem -dev, é usado o GitHub Release estável e verificado de main; com -dev, a versão atual de dev identificada pelo SHA Git exato.
• -o significa output. No Linux pode repeti-lo para atualizar várias pastas WebUI existentes com uma única transferência verificada.
• As cópias de segurança ficam em ~/.config/weig-qb-webui/backups/, guardando as três mais recentes por destino.
• -configure ativa Use alternative WebUI e define Files location no qBittorrent. Só funciona com um destino de cada vez.
• -rollback restaura a última cópia do instalador para o destino escolhido. Pode repetir -o para repor vários destinos específicos.
• -uninstall -purge remove a WebUI e as cópias / o estado de restauro do destino, sem afetar outras instalações. A pasta partilhada é apagada quando fica vazia.
• Para guardar as cópias e poder usar -rollback mais tarde, retire -purge ao desinstalar.
• -version 1.2.0 instala um GitHub Release específico. Se não existir, dá erro e não muda automaticamente para latest ou dev.
• -help mostra as opções suportadas.
• Se houver vários contentores Docker, use --list-containers e --container=NAME, ou --config-root=/path para o diretório de configuração no anfitrião.

Versão específica e diretório de instalação

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

Restauro

Restauro:

sh install.sh -rollback

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

Por predefinição, recomendamos a desinstalação completa sem manter cópias do instalador: remove o WebUI, desativa a interface alternativa correspondente, elimina as cópias / estado de rollback pertencentes a esse destino e, por fim, remove o script de instalação transferido no diretório atual.

Linux / NAS

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

Para um caminho personalizado, acrescente -o /path/to/weig-qb-webui.

Docker

Um contentor / deteção automática:

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

Vários contentores:

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

Ao 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 um caminho personalizado, acrescente -o D:\weig-qb-webui.

-purge elimina apenas as cópias pertencentes ao destino que está a ser desinstalado e não afeta outras instalações. Se o diretório de estado partilhado ficar vazio, ~/.config/weig-qb-webui no Linux (root: /root/.config/weig-qb-webui) ou %APPDATA%\weig-qb-webui no Windows também é removido.

Para manter as cópias e poder usar -rollback mais tarde, basta omitir -purge.