方案简介

Mediabox 是一套完全基于 Docker 容器的家庭媒体聚合方案（media aggregator stack）。它把下载（DelugeVPN、NZBGet、CouchPotato）、媒体服务（Plex）、容器管理（Portainer）等组件通过 Docker Compose 编排在一起，用仓库自带的 mediabox.sh 脚本交互式收集 .env 配置后一键拉起全部容器。适合想在 Ubuntu 服务器或桌面上自建下载+观影一体化家庭媒体中心的用户，尤其适合希望下载流量走 VPN 的场景。

亮点与能力

• 全容器化部署，依赖 Docker Compose 编排
• 交互式安装脚本，自动收集 .env 并准备 compose 配置
• 集成 VPN 下载（Private Internet Access + DelugeVPN）
• Plex 媒体服务器可选版本（latest / public / plexpass）
• 支持 plexpass 版本时可选配置 CLAIM_TOKEN
• 内置 Portainer CE 图形化管理界面
• 包含 NZBGet 与 Deluge 凭据供 CouchPotato 容器使用

组成与分工

• Docker / Docker Compose：所有组件的运行与编排基础，通过官方方式安装 Docker CE 与 compose 插件
• DelugeVPN：结合 VPN 的下载容器，需要 iptable_mangle 内核模块支持
• Private Internet Access：提供 VPN 账号与凭据，供 DelugeVPN 使用
• Plex（pms-docker）：媒体服务器，通过 PMSTAG 选择镜像版本
• NZBGet 与 Deluge daemon：下载接口，其凭据被 CouchPotato 容器使用
• Portainer CE：容器可视化管理，初始用户名 admin，首次登录设置密码

实施步骤

1. 安装系统与 Docker 前置

按 prerequisites 一节执行 apt 更新、安装 curl/git/bridge-utils/whiptail，移除旧 Docker 并安装 Docker CE：
bash
sudo apt remove -y docker docker-engine docker.io containerd runc
sudo snap remove docker

验证安装：
bash
docker --version
docker compose version

2. 加载 DelugeVPN 所需内核模块

bash
sudo /sbin/modprobe iptable_mangle
echo iptable_mangle | sudo tee -a /etc/modules

3. 重启（推荐）

bash
sudo reboot

4. 克隆 Mediabox

bash
git clone https://github.com/jamesvthompson/mediabox.git
cd mediabox

5. 运行配置与部署脚本

bash

Run the Mediabox setup script (collects .env and prepares compose)

./mediabox.sh

脚本运行中会依次提示输入：PIA 的 username/password；要运行的 Plex 版本（latest/public/plexpass，plexpass 可选 CLAIM_TOKEN，可到 plex.tv/claim 获取）；NZBGet 界面与 Deluge daemon 的凭据。完成后脚本自动启动全部 mediabox 容器。

使用与配置要点

• Plex 版本通过 .env 中的 PMSTAG 设置（如 public 或 plexpass），镜像形如 image: plexinc/pms-docker:${PMSTAG:-public}
• 更换镜像 tag 前应先直接测试该镜像
• Portainer 使用 CE 分支，初始用户名为 admin，首次登录时设置密码
• 验证部署成功：脚本执行完毕后 mediabox 容器会被自动启动，可通过 Portainer 界面查看容器状态

注意事项与常见问题

• 安装这些包使用 Ubuntu 默认包管理器 APT 是为了简化依赖管理；如果你没有 superuser 权限，也可以用其他方法
• 所有安装命令都需要 superuser 权限才能成功运行
• Mediabox 已测试可用环境为 Ubuntu 18.04 LTS / 20.04 LTS（Server 与 Desktop）
• DelugeVPN 需要 iptable_mangle 内核模块
• 若更换镜像 tag，请先直接测试该镜像
• 该软件按 "AS IS" 提供，不含任何明示或暗示的担保

优缺点

• ✓ 一键脚本部署，自动收集配置
• ✓ 下载流量经 VPN，隐私有保障
• ✕ 需要 superuser 权限
• ✕ 仅测试于 Ubuntu 18.04/20

出处

本方案挖掘自开源项目 tom472/mediabox，方案内容与实施命令均来自其 README 原文。