jgoerzen/ampache-mysql

Ampache音乐服务器镜像

镜像概述与主要用途

Ampache是一款开源的Web音乐服务器，支持音乐文件的管理、流式传输与共享。本镜像基于Debian构建，集成MySQL数据库服务器，无需额外配置外部数据库，可快速部署并投入使用，适用于构建个人或小型团队的私有音乐流媒体服务。

核心功能与特性

• 集成MySQL数据库：内置MySQL服务器，简化部署流程，无需单独配置数据库环境
• 即开即用：预配置基础运行环境，启动容器后可直接通过Web界面进行初始化设置
• Web界面管理：提供直观的浏览器管理界面，支持音乐库管理、播放列表创建、用户权限配置等功能
• 多格式支持：兼容主流音频格式（如MP3、FLAC、OGG、WAV等）
• 数据持久化：支持通过卷挂载保存音乐文件和数据库数据，确保容器重启后数据不丢失

使用场景与适用范围

• 个人音乐库管理：集中存储和管理本地音乐收藏，支持跨设备远程访问
• 家庭音乐服务：在家庭局域网内搭建音乐服务器，实现多设备（手机、电脑、智能音箱）音乐共享
• 小型团体音乐共享：为小团队或社区提供音乐流式播放服务，支持用户权限分级管理

使用方法与配置说明

基本部署（docker run）

通过以下命令快速启动Ampache服务器：

bash
docker run -d \
  --name ampache \
  -p 80:80 \
  -v /path/to/local/music:/music \  # 挂载本地音乐目录
  -v ampache_mysql_data:/var/lib/mysql \  # 持久化MySQL数据
  jgoerzen/ampache

参数说明：

• -p 80:80：将容器的80端口映射到主机80端口，通过http://<主机IP>访问Web界面
• -v /path/to/local/music:/music：挂载本地音乐文件目录至容器内，供Ampache扫描和管理
• -v ampache_mysql_data:/var/lib/mysql：使用命名卷ampache_mysql_data持久化MySQL数据库数据

访问与初始化设置

1. 容器启动后，通过浏览器访问http://<主机IP>（若本地部署则为http://localhost）
2. 首次访问将进入配置向导，按提示完成以下步骤：
   • 创建管理员账户（设置用户名和密码）
   • 配置音乐库路径（默认读取/music目录，对应本地挂载的音乐文件夹）
   • 完成数据库初始化（自动使用内置MySQL，无需额外配置）
3. 初始化完成后，使用管理员账户登录即可开始使用音乐服务

高级配置（可选）

自定义端口映射

若需使用非80端口，可修改端口映射参数，例如使用8080端口：

bash
docker run -d \
  --name ampache \
  -p 8080:80 \  # 映射主机8080端口至容器80端口
  -v /path/to/music:/music \
  -v ampache_mysql_data:/var/lib/mysql \
  jgoerzen/ampache

访问地址变为http://<主机IP>:8080

环境变量配置

可通过-e参数设置环境变量自定义配置，常用变量包括：

• ADMIN_USER：默认管理员用户名（默认值：admin）
• ADMIN_EMAIL：管理员***（用于密码重置等）
• MYSQL_DB：自定义MySQL数据库名（默认值：ampache）

示例：

bash
docker run -d \
  --name ampache \
  -p 80:80 \
  -e ADMIN_USER=myadmin \
  -e ADMIN_EMAIL=admin@example.com \
  -v /path/to/music:/music \
  -v ampache_mysql_data:/var/lib/mysql \
  jgoerzen/ampache

更多信息

完整配置文档及高级用法请参考：Ampache Docker镜像官方文档