Docker-Compose部署TYPO3网站数据不持久化及权限问题求助

核心问题拆解 #

你遇到的两个问题分别是本地目录挂载权限错误和命名卷数据未持久化，结合Windows 11环境和你的配置，逐一解决如下：

问题1：本地目录挂载出现403 Forbidden错误 #

原因

Windows文件系统权限与Linux容器内权限不匹配，TYPO3镜像中Web服务（Apache）以www-data用户运行，该用户无本地挂载目录的读写权限；同时Windows WSL2挂载目录默认权限可能不符合Linux预期。

解决步骤

1. 调整本地目录Windows权限
   右键typo3-persisted-data目录 → 属性 → 安全 → 确保当前用户拥有「完全控制」权限，取消「只读」勾选。

2. 容器内强制设置目录权限
   修改docker-compose.yaml中website服务的command，启动时先递归设置目录权限：

   services:
     website:
       # ... 其他配置不变 ...
       command: sh -c "chown -R www-data:www-data /var/www/html && apache2-foreground"
   

3. WSL2挂载权限优化（如果用WSL2后端）
   在WSL2的/etc/wsl.conf中添加以下配置（没有则新建文件）：

   [automount]
   options = "metadata,umask=0022,fmask=0022"
   

   保存后执行wsl --shutdown重启WSL，重新挂载的目录权限会适配Linux容器需求。

问题2：命名卷数据无法持久化 #

原因

• 命名卷配置未正确定义
• 旧版Docker Compose语法（version:1）导致特性兼容问题
• 全目录挂载可能被容器初始化逻辑覆盖

解决步骤

1. 正确配置命名卷
   升级Docker Compose版本到3.x（推荐3.8），并显式定义命名卷：

   version: "3.8" # 替换旧版1.x
   networks: 
     lst: 
   volumes: # 新增命名卷定义
     typo3-data:
     mysql-data:
   services: 
     website:
       # ... 其他配置不变 ...
       volumes:
         - typo3-data:/var/www/html/ # 替换本地目录为命名卷
     db:
       # ... 其他配置不变 ...
       volumes:
         - mysql-data:/var/lib/mysql # 也可改为命名卷更稳定
   

2. 避免全目录覆盖（可选优化）
   不建议挂载整个/var/www/html，而是单独挂载TYPO3核心数据目录，避免容器初始化时覆盖自定义数据：

   volumes:
     - typo3-fileadmin:/var/www/html/fileadmin
     - typo3-conf:/var/www/html/typo3conf
     - typo3-uploads:/var/www/html/uploads
   

   同时在volumes部分定义这三个卷。

3. 验证命名卷数据
   执行docker volume inspect typo3-data查看卷的存储路径，确认数据是否真实写入。

额外配置修正 #

1. 废弃语法替换
   links已被废弃，改用depends_on声明服务依赖：

   services:
     website:
       # ... 其他配置 ...
       depends_on:
         - db
     phpmyadmin:
       # ... 其他配置 ...
       depends_on:
         - db
   

2. 环境变量修正

   • db服务中MYSQL_ROOT_USER是多余的，MySQL镜像默认root用户为root，可删除该变量
   • phpmyadmin服务中PMA_HOST = db的空格会导致变量无效，改为PMA_HOST=db

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