用 Ansible 自动化部署 Docker 容器化的云端媒体服务器套件

方案简介

Saltbox 是一套基于 Ansible 的自动化部署方案，用于快速搭建 Docker 容器化的云端媒体服务器，项目深度基于 Cloudbox。它的核心目标是三件事：自动获取媒体、随时随地从任意设备播放媒体，以及把媒体存储到云端。整套方案面向希望在 x64 架构的 Ubuntu Server LTS 机器上自建家庭/私有云媒体中心的用户。需要注意的是，Saltbox 本身没有仪表盘或图形界面，所有 Saltbox 专属的设置和命令都要在文本编辑器和命令行中完成，因此适合有一定命令行使用经验的用户。

亮点与能力

• 基于 Ansible 自动化部署，可快速搭建整套媒体服务器
• 全部服务以 Docker 容器方式运行
• 自动化媒体获取
• 任意设备、任意位置回放媒体
• 支持将媒体存储到云端
• 内置丰富的精选应用（Plex、Emby、Sonarr、Radarr 等）
• 提供 Portainer 容器管理与 Organizr 门户等辅助工具

组成与分工

• Ansible：自动化部署与配置编排核心，驱动整套安装流程
• Docker：容器运行时，所有应用以容器形式部署
• Plex / Emby：媒体服务器，负责媒体播放与串流
• Sonarr / Radarr / Lidarr：自动化媒体订阅与获取
• Rclone：云存储挂载与管理
• SABnzbd / NZBHydra2 / Jackett：下载与索引工具
• Tautulli / Overseer / Autoscan / Cloudplow / Traktarr：媒体监控、扫描与云上传辅助
• Organizr：统一门户面板
• Portainer：Docker 容器可视化管理

前置要求

• x64 架构机器
• Ubuntu Server 24.04 或 26.04 LTS（全新安装）；Ubuntu Server 22.04 LTS 的已有安装仍受支持
• 不支持：Ubuntu 非 LTS 版本、Desktop 桌面版、其他 Linux 发行版、ARM 处理器
• 具备命令行操作能力（Saltbox 无自带 GUI）

使用与配置要点

• 所有 Saltbox 专属的设置和命令均在文本编辑器和命令行中完成，项目本身不提供仪表盘或 GUI
• 部署完成后，可通过 Portainer 管理容器、Organizr 作为统一入口访问各项服务
• 媒体获取链路由 Sonarr/Radarr/Lidarr 配合 SABnzbd、Jackett、NZBHydra2 等索引与下载工具协作完成
• 云端存储与上传由 Rclone 和 Cloudplow 处理

注意事项与常见问题

• 仅支持 Ubuntu Server LTS：非 LTS 版本的 Ubuntu 和 Desktop 安装不受支持
• 仅支持 x64，ARM 处理器不受支持
• Ubuntu 以外的 Linux 发行版不受支持
• 没有自带 GUI/仪表盘，对纯图形界面用户不友好

优缺点

• ✓ 快速自动化部署
• ✓ 全容器化管理
• ✕ 仅支持 Ubuntu LTS
• ✕ 不支持 ARM 处理器

出处

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