Repolode
提交项目
ahembree

ahembree/ansible-hms-docker

基于 Ansible 的自动化脚本，在 Docker 中一键部署家庭媒体服务器全套服务。

在 GitHub 查看官网
Star
453
Fork
57
未关闭 Issue
0
最近提交
15小时前

这是什么？

HMS-Docker 是一个 Ansible playbook，用于在 Docker 容器中搭建家庭媒体服务器，适合希望在自有硬件上自动化部署媒体服务、而不是手动逐个配置容器的用户。

该 playbook 在缺少 Docker 时自动安装，支持 Intel 和 Nvidia 显卡的转码加速，并会检测加速是否可用。它还负责容器自动更新、Sonarr、Radarr、Prowlarr 等应用的初始化，并自动配置 Homepage 仪表盘。可选功能包括 Cloudflare 动态 DNS、泛域名 SSL 证书、Authentik 单点登录以及挂载多个网络共享。

项目附带若干辅助脚本，例如通过 Uptime-Kuma 检测 Plex 容器能否访问媒体文件的监控脚本，以及将 Traefik 证书转换为 Plex 可用的 PKCS12 格式的工具。完整的部署说明见项目文档站点。

核心功能

  • 01自动安装 Docker 及媒体服务容器栈
  • 02支持 Intel 和 Nvidia 显卡进行转码加速
  • 03容器自动更新
  • 04自动初始化 Sonarr、Radarr、Prowlarr 等应用
  • 05支持 Cloudflare 动态 DNS、泛域名 SSL 证书和 Authentik 单点登录

适用场景

  • 在 Linux 主机上快速搭建家庭媒体服务器，无需逐个手动配置容器
  • 在 Sonarr、Radarr 等自动化工具旁运行 Plex、Jellyfin 或 Emby
  • 通过域名和单点登录以 HTTPS 方式对外提供家庭服务

使用前须知

  • Nvidia GPU 驱动需要自行安装，本 playbook 不包含驱动。
  • README 中的安装指引仅指向外部文档站点，具体设置细节不在 README 中。
  • 采用 GPL-3.0 许可证，这是一种 copyleft 许可证，衍生作品需保持开源。

收录于专题

家庭影音服务器自托管应用

标签

#ansible#docker#media-server#home-server#automation#plex#jellyfin#self-hosted#arr-services#arr-stack

常见问题

ansible-hms-docker 是什么？
基于 Ansible 的自动化脚本，在 Docker 中一键部署家庭媒体服务器全套服务。 HMS-Docker 是一个 Ansible playbook，用于在 Docker 容器中搭建家庭媒体服务器，适合希望在自有硬件上自动化部署媒体服务、而不是手动逐个配置容器的用户。
ansible-hms-docker 可以免费使用吗？用的什么许可证？
ansible-hms-docker 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
ansible-hms-docker 还在维护吗？
活跃维护中。ansible-hms-docker 最近一次提交是在 2026年11月7日。
ansible-hms-docker 适合用来做什么？
在 Linux 主机上快速搭建家庭媒体服务器，无需逐个手动配置容器 在 Sonarr、Radarr 等自动化工具旁运行 Plex、Jellyfin 或 Emby 通过域名和单点登录以 HTTPS 方式对外提供家庭服务
在哪里获取 ansible-hms-docker？
源代码和安装说明在 GitHub 上：https://github.com/ahembree/ansible-hms-docker

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目