Docker化本地Moodle实例失败，寻求技术解决方案

我希望将本地已安装的Moodle实例Docker化，以便后续升级及管理多个实例时更便捷。尝试了两种方案均未成功，具体情况及修正建议如下：

方案1：自行编写Dockerfile构建镜像 #

原代码 #

Dockerfile：

# Use an official PHP runtime as a parent image
FROM php:7.4-apache

# Set the working directory to /var/www/html
WORKDIR /var/www/html

# Copy the contents of your Moodle directory to the container
COPY . /var/www/html

# Install any additional dependencies or PHP extensions if needed
# For example:
# RUN docker-php-ext-install pdo_mysql

# Expose port 80 to the outside world
EXPOSE 80

# Start Apache when the container launches
CMD ["apache2-foreground"]

docker-compose.yml：

version: '3.8'

services:
  moodle:
    image: your-moodle-image-name
    ports:
      - "8080:80"  # Adjust the port mapping as needed

失败原因 #

• 缺少Moodle运行必需的PHP扩展（如pdo_mysql、gd、curl等）
• 未启用Apache重写模块，Moodle的URL路由无法正常工作
• 未关联数据库服务，Moodle无法连接数据库完成初始化

修正后的Dockerfile #

FROM php:7.4-apache

# 安装系统依赖与Moodle必需的PHP扩展
RUN apt-get update && apt-get install -y \
    libpng-dev libjpeg-dev libfreetype6-dev \
    libcurl4-openssl-dev libxml2-dev zip unzip \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) gd pdo_mysql mysqli curl xmlrpc zip

# 启用Apache重写模块
RUN a2enmod rewrite

# 设置工作目录
WORKDIR /var/www/html

# 复制本地Moodle代码
COPY . /var/www/html

# 配置目录权限
RUN chown -R www-data:www-data /var/www/html

EXPOSE 80

CMD ["apache2-foreground"]

配套docker-compose.yml（需添加数据库服务） #

version: '3.8'
services:
  moodle:
    build: .
    ports:
      - "8080:80"
    volumes:
      - /var/www/html/moodle:/var/www/html
      - /var/www/moodledata:/var/www/moodledata
    depends_on:
      - db
    environment:
      - MOODLE_DB_HOST=db
      - MOODLE_DB_USER=moodleuser
      - MOODLE_DB_PASSWORD=moodlepass
      - MOODLE_DB_NAME=moodle

  db:
    image: mariadb:10.6
    volumes:
      - moodle-db:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_USER=moodleuser
      - MYSQL_PASSWORD=moodlepass
      - MYSQL_DATABASE=moodle

volumes:
  moodle-db:

方案2：使用Bitnami/Moodle镜像部署 #

原代码 #

version: '2'
services:
  mariadb:
    image: mariadb
    container_name: mariadb2
    ports:
      - 3306:3306
    volumes:
      - /srv/dev-disk-by-x/dckcnfg/moodle:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=passroot
      - MYSQL_ROOT_USER=root
      - MYSQL_DATABASE=moodle
      - ALLOW_EMPTY_PASSWORD=yes

  moodle:
    image: bitnami/moodle
    container_name: moodle2
    ports:
      - 8089:80
     # - 8449:443
    environment:
      - MOODLE_DATABASE_HOST=localhost
      - MOODLE_DATABASE_USER=user
      - MOODLE_DATABASE_PASSWORD=pass
      - MOODLE_DATABASE_NAME=moodle
      - ALLOW_EMPTY_PASSWORD=yes
    volumes:
      - /var/www/html/moodle:/opt/bitnami/moodle
      - /var/www/moodledata:/opt/bitnami/moodledata
    depends_on:
      - mariadb
    links:
      - mariadb:mariadb

失败原因 #

• 数据库连接地址错误：MOODLE_DATABASE_HOST=localhost指向Moodle容器自身，而非MariaDB容器，应改为服务名mariadb
• 数据库用户不匹配：MariaDB环境变量未创建user用户，密码也未对应
• 端口冲突：外部已有MariaDB占用3306端口，容器端口映射失败导致数据库无法启动
• 目录权限问题：挂载的本地目录权限与Bitnami镜像默认用户（UID 1001）不匹配，导致无法读写

修正后的docker-compose.yml #

version: '3.8'
services:
  mariadb:
    image: mariadb:10.6
    container_name: moodle-mariadb
    ports:
      - "3307:3306"  # 修改端口避免与外部服务冲突
    volumes:
      - /srv/dev-disk-by-x/dckcnfg/moodle:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=passroot
      - MYSQL_DATABASE=moodle
      - MYSQL_USER=user
      - MYSQL_PASSWORD=pass  # 与Moodle配置的密码一致
    restart: always

  moodle:
    image: bitnami/moodle:latest
    container_name: moodle-app
    ports:
      - "8089:80"
    environment:
      - MOODLE_DATABASE_HOST=mariadb  # 使用服务名连接数据库
      - MOODLE_DATABASE_USER=user
      - MOODLE_DATABASE_PASSWORD=pass
      - MOODLE_DATABASE_NAME=moodle
      - MOODLE_SITE_URL=http://localhost:8089
    volumes:
      - /var/www/html/moodle:/opt/bitnami/moodle
      - /var/www/moodledata:/opt/bitnami/moodledata
    depends_on:
      - mariadb
    restart: always

额外注意事项 #

1. 确保外部MariaDB服务已停止，或3307端口未被占用
2. 修复挂载目录权限：

   chown -R 1001:1001 /var/www/html/moodle /var/www/moodledata
   

3. 迁移本地Moodle数据时，需将本地数据库导出，导入到容器的MariaDB中，并确保moodle/config.php的数据库配置与容器环境变量一致

内容的提问来源于stack exchange，提问作者rafaelp014