qBit-Mobile v1.5のインストール・使い方ガイド

スマートフォンからqBittorrentを操作したいと思ったことはないだろうか。標準のWeb UIはPC向けに設計されている。スマホでは操作しづらく、実用に耐えないと感じるユーザーも多い。

そんな課題を解決するのが、qBit-Mobile v1.5だ。同じサーバーにインストールするだけで使える。モバイルファーストなフロントエンドとして設計されている。

v1.5では以下の機能が利用できる。

大量トレントでも快適に動く仮想化リスト
ファイル・トラッカー・転送統計を表示するトレント詳細ドロワー
一括停止・再開・削除が可能なバッチ選択機能
タグフィルタ・ダークモード・ライブ統計表示
オフラインシェル対応のインストール可能なPWA

この記事でわかることは以下の3点だ。

qBit-Mobileのインストール手順と初期設定方法
スマホからqBittorrentをLAN経由で操作する具体的な使い方
認証設定やセキュリティまわりの注意点

qBit-Mobile v1.5とは
必要な環境・スペック
インストール手順
初期設定・基本の使い方
活用例・便利な機能
セキュリティ設定とトラブルシューティング
まとめ：qBit-Mobile v1.5でqBittorrentのスマホ運用を快適に
1. この記事は「AI自動投稿×SEO検証プロジェクト」の一環です

qBit-Mobile v1.5とは

qBit-Mobileは、qBittorrentのWeb UIをスマホ向けに作り直したフロントエンドツールだ。開発者が「スマホでの操作が苦痛だった」という実体験をもとに作成した。

純正のWeb UIはPC向け設計のため、スマホブラウザでは操作しにくい。ボタンが小さく、スクロールも不安定になりやすい。

qBit-Mobileはその問題を解決するために設計されている。同じサーバー上に追加インストールする形で動作する。スマホからLAN経由でアクセスするだけで使い始められる。

アーキテクチャの仕組み

内部構造はExpressベースの薄いプロキシとして実装されている。qBittorrentの組み込みWeb UIの前段に置く構成だ。

外部に直接アクセスするのではなく、許可リスト（allowlist）に登録されたエンドポイントのみをqBittorrentへ転送する。不要なAPIを遮断できるため、セキュリティ面でも安心して運用できる。

PWA対応による使い勝手の向上

qBit-Mobile v1.5の大きな特徴がPWA（Progressive Web App）対応だ。スマホのホーム画面に追加するだけで、ネイティブアプリのように起動できる。

特に注目したいのがオフラインシェル機能だ。Wi-Fiが一時的に切れた際も、UIの基本フレームはキャッシュから表示される。操作が中断されにくい点は、実際の利用シーンで大きなメリットになる。

v1.5で利用できる主な機能

仮想化トレントリスト：数千件のトレントがあってもスクロールが滑らか
トレント詳細ドロワー：ファイル一覧・トラッカー情報・転送統計を1画面で確認
再チェック・再アナウンス：ドロワーから直接実行可能
バッチ選択機能：複数トレントの一括停止・再開・削除に対応
移動先プリセット：よく使うフォルダをあらかじめ登録しておける
タグフィルタ・検索・ソート：大量トレントの整理に便利
ライブグローバル統計：現在の速度や接続数をリアルタイム表示
ダークモード：夜間の操作でも目に優しい

認証はデフォルトで有効

qBit-Mobileは認証機能がデフォルトでオンになっている。設定変更なしでも最低限のアクセス制限が機能する。

LAN内での利用を前提とした設計だが、認証を有効にしておくことで不正アクセスのリスクを下げられる。セキュリティ設定の詳細は後述のセクションで解説する。

必要な環境・スペック

qBit-Mobileを動かすには、2つのソフトウェアが必要だ。qBittorrentが稼働するサーバーと、Node.js実行環境を用意する。

qBit-MobileはExpressベースの薄いプロキシサーバーとして動作する。qBittorrentの組み込みWeb UIの前段に配置し、スマートフォンからのリクエストを中継する構成だ。

サーバー側の要件

qBittorrent：Web UIを有効化した状態で起動していること
Node.js：バージョン18以上を推奨
npm：パッケージのインストールに使用
ポート開放：qBit-MobileのデフォルトポートはExpressサーバーが使用するポート（例：3000番台）

qBittorrentのWeb UIは、デフォルトでポート8080で待機している。qBit-Mobileはこのエンドポイントにローカルでリクエストを転送する。

ネットワーク要件

qBit-Mobileは同一LAN内での利用を前提に設計されている。スマートフォンとサーバーが同じWi-Fiルーターに接続されていることが必須条件だ。

アクセス方法はシンプルだ。サーバーのローカルIPアドレス（例：192.168.1.10:3000）をスマートフォンのブラウザで開くだけでよい。

スマートフォン：サーバーと同じWi-Fiネットワークに接続
サーバーのIPアドレス：固定IPまたはDHCP固定割り当てを推奨
ファイアウォール：サーバー側でqBit-Mobileのポートへの受信を許可

インターネット公開は非推奨

外部ネットワークへの公開は想定外の設計だ。LAN外から使いたい場合は、VPN経由でLANに接続する方法が安全でおすすめだ。

WireGuardやTailscaleを使えば、外出先からでもLAN内アクセスと同等の環境を作れる。qBit-Mobile自体をインターネットに直接晒す構成は避けたい。

PWAとしてインストールする場合の注意点

qBit-MobileはPWA（プログレッシブウェブアプリ）としてホーム画面に追加できる。その場合も動作環境の要件は変わらない。

サーバーへの通信が発生するため、PWAインストール後もスマートフォンはLAN接続が必要だ。オフラインシェルはUIフレームの表示維持に使われるもので、完全オフライン動作ではない点に注意してほしい。

インストール手順

qBit Mobileの導入は、GitHubからのクローンから始まる。Node.jsとnpmが事前にインストールされていることを確認してほしい。

以下の手順を順番に実行すれば、スマホからアクセスできる環境が整う。

リポジトリをクローンする

GitHubからソースコードをローカルに取得する。これにより最新版のファイル一式がサーバー上に展開される。

git clone https://github.com/yourusername/qbit-mobile.git
cd qbit-mobile
依存パッケージをインストールする

npmを使って必要なライブラリを一括インストールする。Expressプロキシの動作に必要なモジュールもここで揃う。

npm install
環境変数を設定する

qBittorrentのWeb UIと接続するため、設定ファイルを用意する。サンプルファイルをコピーして編集しよう。

cp .env.example .env

.envファイルを開き、以下の項目を自分の環境に合わせて書き換える。
- QBIT_HOST：qBittorrentが動いているホスト（例：http://localhost:8080）
- PORT：qBit Mobileを公開するポート番号（例：3000）
- AUTH_ENABLED：認証の有効化（デフォルト：true）
Expressプロキシの動作を確認する

qBit MobileはExpressを使った薄いプロキシ構成になっている。qBittorrentへのリクエストは許可リスト（allowlist）に登録されたエンドポイントのみ転送される。

これにより、外部から直接qBittorrentを操作されるリスクを抑えられる。認証もデフォルトで有効になっている点も安心だ。
サービスを起動する

設定が完了したら、以下のコマンドでサーバーを起動する。

npm start

起動後、同一LAN内のスマホからhttp://<サーバーのIPアドレス>:3000にアクセスして動作を確認しよう。
常駐化させる（推奨）

サーバー再起動後も自動で立ち上がるよう、PM2を使って常駐化しておくと便利だ。

npm install -g pm2
pm2 start npm --name "qbit-mobile" -- start
pm2 save

以上でインストールは完了だ。ブラウザからアクセスしてトレントリストが表示されれば、導入成功となる。

初期設定・基本の使い方

qBit Mobileを起動したら、まずqBittorrentとの接続確認を行います。設定は順番通りに進めると迷いません。

qBittorrentとの接続設定

qBittorrentのWeb UIを有効にする
qBittorrentを開き、「ツール」→「設定」→「Web UI」タブへ進みます。「Web UIを有効にする」にチェックを入れ、ポート番号（デフォルト：8080）を確認します。外部からアクセスするための入口を作る手順です。
qBit Mobileの設定ファイルを編集する
サーバー上の設定ファイルを開きます。QBIT_URLにqBittorrentのアドレスを指定します。例：QBIT_URL=http://localhost:8080。同じマシン上で動かす場合はlocalhostのままで問題ありません。
認証情報を設定する
qBit MobileはデフォルトでBasic認証が有効です。.envファイルにUI_USER=adminとUI_PASS=任意のパスワードを記載します。セキュリティ確保のため、パスワードは必ず変更してください。
サーバーを起動して接続確認する
npm startを実行し、サーバーを立ち上げます。ブラウザでhttp://サーバーのIPアドレス:3000を開き、ログイン画面が表示されれば成功です。

スマホからLAN経由でアクセスする

スマホとサーバーを同じWi-Fiに接続した状態でアクセスします。サーバーのローカルIPを確認するにはip aコマンドを使います。

スマホのブラウザでhttp://192.168.x.x:3000を開きます。アドレスはご自身の環境に合わせて変更してください。

スマホからqBit Mobileにアクセスした画面 — スマホブラウザからのアクセス画面（イメージ）

基本機能の操作方法

接続後に使える主な機能は以下のとおりです。

ダークモード：画面右上のアイコンからワンタップで切り替え可能
タグフィルタリング：左側のサイドバーでタグを選択。目的のトレントを素早く絞り込めます
検索：上部の検索バーにキーワードを入力。数千件のトレントでも瞬時に絞り込めます
一括操作：トレントを長押しして複数選択。まとめて一時停止・再開・削除が可能
PWAとしてインストール：Chromeの「ホーム画面に追加」でアプリのように使えます

タグフィルタリングと検索を組み合わせると、大量のトレントも効率よく管理できます。PWAインストールしておくと、次回からアクセスがさらに手軽になります。

活用例・便利な機能

qBit Mobile v1.5には、スマホ操作に特化した強力な機能が揃っています。ここでは実際の使い方を交えて紹介します。

仮想化リストで大量トレントもサクサク表示

トレント一覧には仮想化レンダリングが採用されています。画面に表示される分だけをDOMに描画する仕組みです。

数千件のトレントを登録していても、スクロールが重くなりません。古いスマホでも快適に動作するのは、この仕組みのおかげです。

トレント単位のドロワーで詳細情報を確認

リスト上の任意のトレントをタップすると、詳細ドロワーがスライドアップします。確認できる情報は以下のとおりです。

ファイル一覧：ダウンロード対象ファイルの個別確認
トラッカー情報：接続中のトラッカーとステータス
転送統計：速度・アップロード量・接続ピア数など
Recheck（整合性チェック）：ファイル破損を手動で確認
Reannounce（再アナウンス）：トラッカーへの再接続をワンタップで実行

PCのqBittorrent UIと同等の情報をスマホ画面で確認できます。外出先からでも詳細な管理が可能です。

バッチ選択で一括操作を効率化

トレントを長押しすると、バッチ選択モードに切り替わります。複数のトレントを選択したあと、以下の操作をまとめて実行できます。

一時停止 / 再開：選択したトレントをまとめて制御
削除：不要なトレントをまとめて除去。ファイル削除の有無も選択可能
移動（Move to location）：あらかじめ登録した保存先プリセットに一括移動

保存先プリセットは事前に複数登録しておけます。たとえば /media/movies や /media/series のように用途別に設定しておくと便利です。

検索・ソート・タグフィルタの組み合わせ技

上部の検索バーにキーワードを入力すると、リストがリアルタイムで絞り込まれます。ソート条件（追加日・サイズ・進捗など）とタグフィルタを同時に適用することも可能です。

たとえば「タグ：anime」で絞り込み、「サイズ降順」でソートする、といった組み合わせが使えます。大量登録環境でも目的のトレントに素早くたどり着けます。

ライブ統計でサーバー全体の状況を把握

画面下部にはグローバル統計バーが常時表示されます。表示される項目は以下です。

現在の総ダウンロード速度
現在の総アップロード速度
アクティブなトレント数

サーバーに接続したままリアルタイムで更新されます。帯域の使い過ぎをスマホからすぐに把握できます。

セキュリティ設定とトラブルシューティング

qBit Mobileはデフォルトで認証機能が有効になっています。初期状態でも外部からの不正アクセスを防ぐ設計です。

ただし、LAN内運用でも設定を誤ると脆弱になります。正しく理解して使いましょう。

デフォルト認証の仕組み

qBit MobileはExpressベースの薄いプロキシ層として動作します。qBittorrentのWeb UIに直接アクセスさせるのではなく、許可済みエンドポイントのみを転送します。

この設計により、qBittorrent本体のAPIを直接叩かれるリスクを低減できます。認証は起動時から有効で、無効化するには意図的な設定変更が必要です。

LAN内アクセスのセキュリティベストプラクティス

ポートをLAN内に限定する：ルーターでポートフォワードを設定しない
デフォルトポートを変更する：3000番など既定値は避ける
強いパスワードを設定する：推測されにくい英数字混じりのものを使う
HTTPS化を検討する：同一ボックスでリバースプロキシ（Nginx等）を立てる

初回起動と接続確認の手順

サーバーのIPアドレスを確認する。
LAN内での固定IPが望ましいです。ip aコマンドで確認できます。
アプリを起動する。
インストール先ディレクトリでnpm startを実行します。デフォルトはhttp://<サーバーIP>:3000でアクセスできます。
スマホのブラウザからアクセスする。
同一LAN上のスマホで上記URLを開き、認証画面が表示されるか確認します。
qBittorrent Web UIとの接続設定を入力する。
qBittorrent側のWeb UIホスト（通常127.0.0.1:8080）とログイン情報を設定ファイルに記述します。