idelsink/ampache

Ampache Docker镜像

https://images.microbadger.com/badges/version/idelsink/ampache.svg](https://microbadger.com/images/idelsink/ampache "获取你的版本徽章") https://images.microbadger.com/badges/image/idelsink/ampache.svg](https://microbadger.com/images/idelsink/ampache "获取你的镜像徽章") https://img.shields.io/docker/automated/idelsink/ampache.svg]()
https://img.shields.io/github/stars/idelsink/ampache-docker.svg?style=social&label=Star]() https://img.shields.io/docker/stars/idelsink/ampache.svg]() https://img.shields.io/docker/pulls/idelsink/ampache.svg]()

这是一个基于轻量Alpine Linux构建的Ampache音乐服务器Docker镜像，集成Apache、MariaDB（MySQL）、PHP、FFmpeg等组件，支持多种音乐流后端和转码功能，方便用户快速部署个人音乐库。

核心功能

• 提供Web界面管理音乐库，支持分类、搜索与播放
• 集成多后端：Plex、Subsonic、Ampache API等
• 内置FFmpeg实现音乐格式转码
• 可配置容器时区
• 支持数据库及配置的备份与恢复

使用场景

• 个人音乐库的集中存储与远程访问
• 家庭内部音乐流服务共享
• 与Plex等媒体平台集成扩展功能

配置说明

基本部署

启动容器命令：

sh
docker run --name=ampache -d -v /本地音乐路径:/media:ro -p 80:80 idelsink/ampache

参数说明：

• -v /本地音乐路径:/media:ro：挂载本地音乐目录到容器（只读模式）
• -p 80:80：映射容器HTTP端口到主机

时区设置

通过环境变量设置时区（以北京时间为例）：

sh
docker run --name=ampache -e TIMEZONE="Asia/Shanghai" -d -v /本地音乐路径:/media:ro -p 80:80 idelsink/ampache

时区列表参考tz数据库时区列表

Plex后端配置

1. 启动容器时添加端口映射：-p 32400:32400
2. 在Ampache后台启用Plex后端（System > Use Plex backend > Enable）
3. 手动访问http://[主机IP]:32400/web/login.php，使用Ampache账号登录
4. 登录后手动访问http://[主机IP]:32400/web/index.php，链接Plex账号

备份与恢复

备份步骤

1. 获取容器ID/名称：docker ps
2. 进入容器：docker exec -it <容器ID/名称> sh
3. 创建备份目录：mkdir /backup
4. 执行备份：/scripts/backup.sh b /backup
5. 退出容器：exit
6. 复制备份到主机：docker cp <容器ID/名称>:/backup ./backup

恢复步骤

1. 复制备份到新容器：docker cp ./backup <新容器ID/名称>:/backup
2. 进入新容器：docker exec -it <新容器ID/名称> sh
3. 执行恢复：/scripts/backup.sh r /backup
4. 退出容器完成恢复

镜像技术栈

• 基础镜像：Alpine Linux
• 核心组件：Apache、MariaDB、PHP、Ampache、FFmpeg

许可证

该项目基于MIT许可证，详情见https://github.com/idelsink/ampache-docker/blob/master/LICENSE