Docker Compose 一键部署 Alist+Emby 小雅全家桶媒体服务

方案简介

docker-xiaoya 是一个小雅全家桶部署方案，使用 Docker Compose 一键部署 Alist + Emby，实现网盘资源家庭影院化。项目将部署 alist、下载元数据、部署 emby 服务的全流程自动化，无需人工干预，所有脚本集成到 Docker 镜像中，避免污染系统环境。方案兼容群晖、Linux、Windows、Mac，覆盖所有 X86 和 Arm 架构，并提供卸载脚本与 Kubernetes(helmfile) 部署方式。适合想快速搭建家庭影视库、聚合阿里云盘/夸克/PikPak 等网盘资源的用户。

亮点与能力

• 一键部署 alist + 下载元数据 + 部署 emby 全流程自动
• 所有脚本集成到 Docker 镜像，避免污染系统环境
• 合并 emby 的 x86 和 arm 镜像，部署时无需区分镜像名
• 自动清理阿里云盘，默认每10分钟一次
• 自动更新小雅 alist 中的云盘数据，默认每天一次
• 自动更新 emby 服务配置（每周）与媒体数据（每天）
• 支持小雅夸克网盘、PikPak、阿里云盘资源及自定义挂载
• 支持 WebDav、TvBox 服务

前置要求

部署配置推荐：

| 部署方案 | CPU | 内存 | 硬盘 |
| --- | --- | --- | --- |
| Alist + Emby | 2核 | 4G | 140G |
| 仅部署 Alist | 1核 | 512M | 512M |

需具备 Docker 与 Docker Compose 环境；如部署在 Kubernetes，需安装 helm 与 helmfile。

实施步骤

1. 一键部署（推荐）

脚本支持重复执行，每天自动同步最新镜像：

bash
export VERSION=main && bash -c "$(curl -fsSL ${GH_PROXY}https://raw.githubusercontent.com/monlor/docker-xiaoya/${VERSION:-main}/install.sh)"

使用加速源：

bash
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/${VERSION:-main}/install.sh)"

2. 手动 Docker Compose 部署

创建 compose 文件夹：

bash
mkdir /opt/xiaoya
cd /opt/xiaoya

下载配置：

bash
curl -#LO https://raw.githubusercontent.com/monlor/docker-xiaoya/main/docker-compose.yml
curl -#LO https://raw.githubusercontent.com/monlor/docker-xiaoya/main/env

修改配置 env 里面的阿里云盘相关变量，启动服务：

bash
docker compose up -d

查看日志：

bash
docker compose logs

3. Kubernetes 部署

安装 helm：

bash
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

安装 helmfile 并下载 helmfile.yaml，修改其中的 WEBDAV_PASSWORD、ALIYUN_TOKEN、ALIYUN_OPEN_TOKEN、ALIYUN_FOLDER_ID、QUARK_COOKIE、PAN115_COOKIE、PIKPAK_USER 等环境变量后：

bash
helmfile sync -f helmfile.yaml

使用与配置要点

部署完成后通过以下地址访问：

| 类型 | 地址 | 默认用户密码 |
| --- | --- | --- |
| alist | http://ip:5678 | - |
| webdav | http://ip:5678/dav | guest/guest_Api789 |
| tvbox | http://ip:5678/tvbox/my_ext. | - |
| emby | http://ip:2345 | xiaoya/1234 |

自定义配置（非必须）：如需修改硬解、端口、数据目录、环境变量，自行修改 docker-compose.yml 和 env 文件后执行：

bash
cd 你的安装目录
docker-compose up --remove-orphans -d

注意事项与常见问题

• 脚本没有计划支持硬解，作者认为这个功能没有必要
• 修改配置后注意：执行更新脚本会覆盖 docker-compose.yml，不会覆盖 env 文件
• 安全建议：开启 alist 的登陆，设置 webdav 密码 WEBDAV_PASSWORD
• 在 emby 控制台修改 ApiKey，这个 key 需要配置到 metadata 和 alist 服务，变量名 EMBY_APIKEY
• 卸载使用 uninstall.sh 脚本
• Armv7 设备适配为 Beta 状态

优缺点

• ✓ 全流程自动无需人工干预
• ✓ 兼容 X86 和 Arm 架构
• ✕ 更新脚本会覆盖 docker-compo
• ✕ 不支持硬解功能

出处

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