cyhustc/koel

docker-koel-fpm镜像说明

镜像概述

本镜像为Koel音乐流媒体服务提供PHP-FPM运行环境，包含必要的PHP扩展，仅保留运行Koel所需的核心组件，需配合Nginx容器和数据库容器（如MySQL）使用。

核心功能

1. 提供Koel运行所需的PHP-FPM环境及扩展
2. 支持连接MySQL等数据库（已验证MySQL兼容性）
3. 可通过Nginx反向代理对外提供Web服务
4. 支持音乐文件挂载与管理功能

使用场景

• 个人搭建私有音乐流媒体平台
• 小型团队内部共享音乐资源
• 学习Docker容器化部署音乐服务

配置说明

拉取镜像

bash
docker pull cyhustc/koel:fpm

构建镜像（可选）

bash
docker build -t koel:fpm .

首次运行步骤

1. 初始化Koel
   创建Koel容器后，执行初始化命令生成APP_KEY、创建管理员用户并初始化数据库：

   bash
   docker exec -it <koel_container_name> bash
   php artisan koel:init --no-assets
   

2. 启动数据库容器（MySQL示例）

   bash
   docker run -d --name database \
       -e MYSQL_ROOT_PASSWORD=<root密码> \
       -e MYSQL_DATABASE=koel \
       -e MYSQL_USER=koel \
       -e MYSQL_PASSWORD=<koel用户密码> \
       mysql/mysql-server:5.7
   

3. 启动Koel-FPM容器

   bash
   docker run -d --name koel \
       -v `pwd`/koel/html:/var/www/koel \
       -v `pwd`/koel/music:/music \
       --link database:mysql \
       cyhustc/koel:fpm
   

4. 启动Nginx容器

   bash
   docker run --name nginx \
       --restart=always \
       -p 80:80 -p 443:443 \
       --link koel \
       -v `pwd`/koel/music:/music \
       -v `pwd`/koel/html:/var/www/koel \
       -v `pwd`/nginx/conf/nginx.conf:/etc/nginx/nginx.conf \
       -v `pwd`/nginx/conf/sites-enabled:/etc/nginx/sites-enabled \
       -d nginx
   

Nginx配置示例

nginx
server {
  listen          *:80;
  server_name     koel.example.com;
  root            /var/www/koel/public;
  index           index.php;

  gzip            on;
  gzip_types      text/plain text/css application/x-javascript text/xml application/xml application/xml+rss text/javascript application/json;
  gzip_comp_level 9;
  client_max_body_size 512M;

  location /media/ {
    internal;
    alias       $upstream_http_x_media_root;
    access_log /var/log/nginx/koel.access.log;
    error_log  /var/log/nginx/koel.error.log;
  }

  location / {
    try_files   $uri $uri/ /index.php?$args;
  }

  location ~ \.php$ {
    try_files $uri $uri/ /index.php?$args;
    fastcgi_param     PATH_INFO $fastcgi_path_info;
    fastcgi_param     PATH_TRANSLATED $document_root$fastcgi_path_info;
    fastcgi_param     SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass      koel:9000;
    fastcgi_index     index.php;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_intercept_errors on;
    include           fastcgi_params;
  }
}