使用Docker Compose部署Moodle容器时文件缺失及启动失败问题

1. 两种卷的行为差异是核心原因 #

• 主机绑定卷：当你把主机目录挂载到容器的/bitnami/moodle时，主机目录的内容会直接覆盖容器内该路径下的所有东西。你在Dockerfile里COPY的插件是构建镜像时放进容器的，但启动容器时，主机目录一挂载上去，容器里/bitnami/moodle下的原有文件（包括插件）全被主机目录的内容替换了——如果主机目录是空的，那自然看不到插件。
• 命名卷：Docker第一次用命名卷时，会把容器内挂载点的原有内容复制到卷里，所以插件能出现在卷中。但Bitnami的Moodle镜像启动时，依赖的是容器内/opt/bitnami/moodle下的核心文件（比如config.php），而你把命名卷挂载到/bitnami/moodle后，这个路径的原始结构被破坏了——Bitnami镜像里/bitnami/moodle通常是指向/opt/bitnami/moodle的符号链接，挂载卷会直接替换这个链接，导致启动脚本找不到原本的配置文件。

2. Bitnami镜像的特殊设计坑点 #

Bitnami的官方镜像把应用核心文件放在/opt/bitnami/moodle，而/bitnami/moodle是专门留作卷挂载的路径（要么是符号链接，要么是单独的目录）。你直接挂载整个/bitnami/moodle，等于把镜像自带的核心文件结构给冲了，自然会出问题。

3. 正确的插件部署姿势 #

别挂载整个/bitnami/moodle，换两种方式都行：

• 只挂载插件目录：在Docker Compose里把你的主机插件目录挂载到容器的/bitnami/moodle/local/local_custom_api，这样不会影响其他核心文件。
• 改Dockerfile的复制路径：把插件复制到/opt/bitnami/moodle/local/local_custom_api，因为这个是镜像里的核心应用目录，不会被卷覆盖。比如：

FROM bitnami/moodle:latest
COPY ./local_custom_api /opt/bitnami/moodle/local/local_custom_api

然后在docker-compose.yml里只挂载必要的卷（比如数据、配置目录），别碰整个应用目录：

services:
  moodle:
    build: .
    volumes:
      - moodle_data:/bitnami/moodle/data
      - moodle_config:/bitnami/moodle/config
    # 其他端口、环境变量配置...
  mariadb:
    image: bitnami/mariadb:latest
    volumes:
      - mariadb_data:/bitnami/mariadb
    # 其他配置...
volumes:
  moodle_data:
  moodle_config:
  mariadb_data:

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