WeiG qB WebUI：qBittorrent の「別のWebUI」初心者向け導入ガイド

1. ZIP を展開

最新の正式版 weig-qb-webui.zip をダウンロードして展開します。最初から次のフォルダー構成になっているので、名前の変更は不要です。

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

weig-qb-webui フォルダー全体が WebUI のルートです。public や private だけをコピーしないでください。

2. 固定した場所へ移動

weig-qb-webui フォルダー全体を、あとで誤って削除しない場所へ移動します。例：

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

このディレクトリを qBittorrent に指定します。

3. qBittorrent で有効化

qBittorrent を開きます。

ツール → オプション… → WebUI

これは現在の qBittorrent 日本語公式 UI の用語です。続いて：

1. 別のWebUIを使用する を有効にします。
2. ファイルの場所: を探します。
3. 保存した weig-qb-webui フォルダーのパスを入力します。

Windows の例：

D:\weig-qb-webui

通常の Linux の例：

/opt/weig-qb-webui

4. OK を押して保存します。
5. qBittorrent WebUI のページを再読み込みします。古い画面が残る場合は Ctrl + F5 を試してください。

パスが正しいか確認する方法： 指定したディレクトリの直下に public、private、VERSION などが見える必要があります。さらにもう一つ weig-qb-webui フォルダーへ入らないと見えない場合は、パスの階層がずれています。

Docker ユーザー： qBittorrent はコンテナー内で動作するため、通常はホスト側の実パスをそのまま指定できません。下の Docker ガイドを参照してください。

./install.sh

WebUI 本体の既定インストール先：

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

root ユーザーで実行する場合は通常：

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

「ホスト」と「コンテナー」

VPS、Linux サーバー、Synology、QNAP などで Docker を使用している場合：

• ホスト：Docker を実際に動かしている Linux / NAS。本体側のシステムです。
• コンテナー：Docker が qBittorrent 用に作る独立した実行環境です。qBittorrent はコンテナー内のパスを参照します。

たとえば次のマウントがあるとします。

ホスト：      /root/qbittorrent/config
   ↓ マウント
コンテナー：  /config

Docker Compose では一般に：

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

左側がホストパス、右側がコンテナーパスです。

WebUI がホスト側の：

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

にある場合、qBittorrent の ファイルの場所: には：

/config/weig-qb-webui

を指定します。ホストパスをそのまま指定しないでください。

1つだけ qBittorrent コンテナーがある場合

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

インストーラーが実行中の qBittorrent コンテナーと /config マウントを検出し、適切なホスト側の場所へ WebUI を配置して設定を行います。

コンテナー名を確認する

sh install.sh --list-containers

Docker 自体でも確認できます。

docker ps

名前が qbittorrent の場合：

sh install.sh --container=qbittorrent -configure

複数の 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

インストーラーが /config/... を対応するホスト側パスへ変換します。

ケース 6：既存の WebUI を複数まとめて更新

qBittorrent を複数運用している場合は -o を繰り返し指定できます。パッケージのダウンロードと検証は一度だけ行い、すべてのターゲットを準備してから切り替えます。バックアップは ~/.config/weig-qb-webui/backups/ に対象ごとに直近 3 件ずつ保存します。

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

複数ターゲットの場合は -configure を付けないでください。各インスタンスは既存の WebUI パスを使い続けます。詳しくは sh install.sh -help をご覧ください。

インストール後の確認

成功すると、次のようなパスが表示されます。前者はホストの保存先、後者は qBittorrent の「Files location」に指定するコンテナー内のパスです。

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 がなければ main の検証済み GitHub Release、あれば現在の dev を exact SHA で指定した開発版をインストールします。
• -o は output の略。Linux では繰り返し指定でき、複数の既存 WebUI を一度のダウンロードで更新できます。
• バックアップは ~/.config/weig-qb-webui/backups/ に保存され、インストール先ごとに直近 3 件のみ保持します。
• -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

ロールバック

Linux：

sh install.sh -rollback

Windows：

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

既定ではインストーラーバックアップを残さない完全アンインストールを推奨します。WebUI を削除し、対象の代替 WebUI 設定を無効化し、その対象に属する installer-owned backups / 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 は現在のアンインストール対象に属するバックアップだけを削除し、他のインストールには触れません。共有状態ディレクトリが空になれば、Linux の ~/.config/weig-qb-webui（root は /root/.config/weig-qb-webui）または Windows の %APPDATA%\weig-qb-webui も削除されます。

後で -rollback できるようバックアップを残す場合は、-purge を外してください。