🏰️ qBittorrent + ProtonVPN(WireGuard)をDockerで実行(macOS)
Gluetunを使用してProtonVPN(WireGuard)経由でqBittorrentをDocker内で安全に実行し、完全なVPNルーティングと自動ポートフォワーディングを実現してトレントのパフォーマンスを向上させます。
📌 目次
- 概要
- 特徴
- 前提条件
- インストールガイド
- Dockerのインストール
- リポジトリのクローン
.envファイルの設定- 認証の設定
- コンテナの起動
- qBittorrent Web UIへのアクセス
- セキュリティとベストプラクティス
- トラブルシューティング
- ライセンス
- 貢献
- サポートとフィードバック
🔹 概要
このセットアップはqBittorrentがProtonVPN(WireGuard)経由のみで接続することを保証し、Gluetunを用いてリークを防ぎセキュリティを強化します。\ さらに、ポートフォワーディングを自動化してトレント速度を向上させ、すべてをDocker内で実行することで管理を簡単にします。
✅ 特徴
- 🔒 VPN強制トレント – リークなし、すべての通信がVPN内で実行されます。
- ⚡ 自動ポートフォワーディング – 速度向上とピア接続の改善を保証します。
- 🌐 ローカルWeb UIアクセス –
http://localhost:8080から簡単にトレントを管理可能。 - 📺 完全コンテナ化 – Dockerを使用して簡単にデプロイ、更新、および分離を実現。
- 🔄 耐障害性のあるセットアップ – 何かがクラッシュした場合、コンテナは自動再起動します。
- 不完全および完了したトレント用に別々のストレージを使用。
- Watchtowerを使ったコンテナの自動更新 🛠️
🛠️ 前提条件
- Docker Desktop(macOS/Windows/Linux)
- Docker Compose(Docker Desktopに同梱)
- ProtonVPNアカウント(WireGuardサポートにはPlusまたはVisionaryが必要)
📂 インストールガイド
1️⃣ Dockerのインストール
こちらからDocker Desktopをダウンロードしてインストールしてください。\ 続行する前にDockerが起動していることを確認してください。
2️⃣ リポジトリをクローン
git clone https://github.com/torrentsec/qbittorrent-protonvpn-docker.git
cd qbittorrent-protonvpn-docker3️⃣ .env ファイルの設定
このプロジェクトでは、機密設定値を保存するために .env ファイルを使用します(セキュリティのためGitによって無視されます)。
#### あなたの .env ファイルを作成する
cp .env.example .env
nano .env#### 以下の変数を入力してください
WIREGUARD_PRIVATE_KEY=your_private_key_here
SERVER_COUNTRIES="United Kingdom"
SERVER_CITIES="London"PUID=1000
PGID=1000
TZ=Europe/London
GLUETUN_USER=your_admin_username
GLUETUN_PASS=your_admin_password
GSP_GTN_API_KEY=your_random_api_key_here
GSP_QBITTORRENT_PORT=your_forwarded_port_here
Save and close (CTRL + X, then Y, then ENTER).
4️⃣ Start the Containers
docker-compose up -d🚀 qBittorrentはProtonVPNを通じて安全に稼働中です!
📚 qBittorrent Web UIへのアクセス
起動後、以下を開いてください:\ 📌 http://localhost:8080\ (デフォルトのユーザー名:admin、パスワード:コンソールで一時パスワードを確認)
初回ログイン後は必ずWeb UIのパスワードを変更してください。そうしないと、コンテナ再起動ごとにパスワードがランダム生成されます。
🛡️ セキュリティとベストプラクティス
.envを非公開に保つこと.gitignoreファイルはすでに.envがGitHubにアップロードされるのを防いでいます。- Gluetun APIには強力なパスワードを使用する
.env内のGLUETUN_PASSを変更し、無許可のAPIアクセスを防ぎましょう。- トレントを始める前にVPN接続を確認する
- コンテナ内で
curl ifconfig.meを実行してください:
docker exec -it qbittorrent curl ifconfig.me
``
- ✅ IPがProtonVPNと一致する場合、正常に動作しています。
- ❌ 実際のIPが表示される場合は、問題があります。
---🛠️ トラブルシューティング
VPNが動作しているか確認する
sh
docker ps
もしGluetunが起動していない場合は、すべてを再起動してください:
sh
docker-compose down && docker-compose up -d
qBittorrentがVPNを使用していることを確認する
sh
docker exec -it qbittorrent curl ifconfig.me
🟢 IPがProtonVPNと一致していれば、正常に動作しています。\
🔴 実際のIPが表示されている場合は、何か問題があります。エラーログの確認
sh
docker logs -f gluetun
``AUTH_FAILED または接続の問題を探してください。
💎 ライセンス
このプロジェクトは MITライセンス の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。
💪 貢献
貢献は歓迎します!改善点やフィードバックがあれば、Issue またはプルリクエストを送ってください。
💬 サポート&フィードバック
- 役に立った場合は、GitHubで⭐スターを付けてください!
- フィードバックや提案はいつでも歓迎します。