Docker小雅全家桶一键部署完整教程：快速搭建家庭影音媒体库，集成Alist网盘管理、Emby和Jellyfin播放器，支持阿里云盘、夸克网盘、PikPak资源挂载，实现智能元数据维护、跨终端播放，兼容Linux、Windows、macOS、群晖NAS系统，覆盖X86和ARM架构，提供安全容器隔离、资源优化配置，适合影音爱好者、家庭用户和开发者
本文将详细介绍一款开源工具——Docker小雅全家桶，它通过一行命令即可快速构建个人影视库，集成了小雅Alist与Emby或Jellyfin播放器，并利用Docker Compose实现一键部署。该方案兼容多种平台，包括群晖NAS、Linux、Windows和macOS，并全面支持X86和ARM架构设备。
- 项目源码地址：
https://github.com/monlor/docker-xiaoya - 一键安装脚本示例：
export VERSION=main GH_PROXY=https://gh.monlor.com/ IMAGE_PROXY=ghcr.monlor.com && bash -c "$(curl -fsSL ${GH_PROXY}https://raw.githubusercontent.com/monlor/docker-xiaoya/main/install.sh)"
一、项目概述：全能影音管理解决方案
本项目基于Docker Compose构建，是一个全栈式解决方案，通过整合Alist、Emby和Jellyfin三大核心组件，实现了以下功能：
- 资源聚合能力：支持阿里云盘、夸克网盘和PikPak等多种云存储资源的挂载与管理。
- 智能管理功能：自动维护媒体库的元数据信息，包括影片简介、封面和播放记录。
- 跨端播放支持：完美适配手机、平板电脑、智能电视等多种终端设备。
脚本通过预置的docker-compose.yml配置文件，简化了手动配置环境变量的复杂流程，真正实现了开箱即用的便捷体验。
二、核心优势：五大关键特性深度解析
- 全平台覆盖的便捷部署
支持Linux、Windows、macOS和群晖NAS系统，兼容X86和ARM架构设备。通过install.sh脚本实现3分钟极速搭建，即使是新手用户也能轻松完成部署。 - 智能化的云端管理
- 自动清理阿里云盘中的过期缓存文件，有效规避存储容量限制问题。
- 实时同步云端资源到本地媒体库，确保内容及时更新。
- 每日定时更新影视元数据，包括封面图片、剧情简介和评分信息。
- 安全防护机制
采用容器隔离技术，确保系统安全：
- 网盘账号信息独立存储于
/app/storage目录，防止数据泄露。 - 各组件通过专属网络进行通信，增强隔离性。
- 资源访问权限实行分级控制，提升安全性。
- 多播放器生态支持
除自带的Emby和Jellyfin外，还提供额外支持：
- WebDav协议支持，可适配Kodi等第三方播放器。
- TvBox定制接口，优化移动端使用体验。
- 硬件资源优化
实测在树莓派4B（4GB内存）设备上可流畅运行，对老旧硬件友好。通过Docker资源限制策略，有效避免媒体扫描过程占用过多CPU资源。
三、适用人群：目标用户群体分析
- 影音收藏爱好者
适合拥有10TB以上影视资源的用户，通过阿里云盘挂载功能节省本地存储空间。 - 家庭媒体中心搭建者
配合智能电视或投影仪使用，老人和小孩都能通过分类海报墙轻松点播内容。 - 开发者技术尝鲜派
提供完整的API文档，支持二次开发扩展功能，例如弹幕插件集成等自定义需求。
四、默认设置：环境与部署配置详情
- 环境信息配置
| 类型 | 地址 | 默认用户密码 |
|---|---|---|
| alist | http://ip:5678 | - |
| webdav | http://ip:5678/dav | guest/guest_Api789 |
| tvbox | http://ip:5678/tvbox/my_ext.json | - |
| emby | http://ip:2345 | xiaoya/1234 |
- 部署资源配置
| 部署方案 | CPU | 内存 | 硬盘 |
|---|---|---|---|
| Alist + Emby | 2核 | 4G | 140G |
| 仅部署 Alist | 1核 | 512M | 512M |
五、安全提示：增强系统安全性的建议
🔹 启用alist登录功能，在alist服务中设置FORCE_LOGIN=true，并为webdav设置密码WEBDAV_PASSWORD。
🔹 在emby控制台中修改ApiKey，此密钥需配置到metadata和alist服务，变量名为EMBY_APIKEY。