captinsano/koel

docker-koel - Alpine Linux、PHP-FPM、Nginx、NodeJS

镜像概述

本镜像为开源音乐流媒体服务Koel的Docker化部署版本，基于轻量的Alpine Linux系统，整合PHP-FPM、Nginx和NodeJS技术栈，支持通过Docker环境变量动态配置核心参数，便于快速搭建私有的音乐流媒体平台。

核心功能

• 支持挂载本地音乐目录，实现个人音乐库的管理与流媒体播放
• 通过环境变量灵活配置数据库连接（主机、名称、用户名、密码）
• 初始化管理员账户（***、名称、密码）
• 支持链接外部数据库容器（如MySQL）
• 提供生产环境优化配置（默认APP_ENV=production）

使用场景

• 个人音乐收藏的数字化管理与跨设备流媒体访问
• 家庭或小型团队内部的音乐共享服务
• 搭建私有的音乐服务器替代第三方音乐平台

配置说明

必要环境变量

需设置以下环境变量确保镜像正常运行：

• DB_HOST: 数据库主机地址（链接容器时可填容器名称）
• DB_DATABASE: 数据库名称
• DB_USERNAME: 数据库用户名
• DB_PASSWORD: 数据库密码
• ADMIN_EMAIL: 管理员***
• ADMIN_NAME: 管理员名称
• ADMIN_PASSWORD: 管理员密码

挂载目录

将本地音乐目录挂载到容器内/DATA/music，并设置正确权限：

bash
chown 100:101 /path/to/your/music

部署示例

Docker Run命令

bash
docker run -d \
  -e DB_HOST="172.17.0.1" \
  -e DB_DATABASE="koel_db" \
  -e DB_USERNAME="koel_user" \
  -e DB_PASSWORD="your_db_pass" \
  -e ADMIN_EMAIL="admin@example.com" \
  -e ADMIN_NAME="Admin" \
  -e ADMIN_PASSWORD="admin_pass" \
  -v /path/to/your/music:/DATA/music \
  docker.xuanyuan.run/captinsano/koel

初始化站点

容器启动后执行初始化命令：

bash
docker exec [容器ID] su nginx -c "cd /DATA/htdocs && php artisan init"

链接数据库容器

若使用MySQL容器，通过--link指定数据库主机：

bash
docker run -d \
  --link mysql_container:mysql \
  -e DB_HOST="mysql" \
  # 其他环境变量...
  captinsano/koel