Windows环境下Docker部署Xibo-cms-develop 4.10报错求助

问题描述 #

• 在Windows系统通过Docker安装Xibo CMS 4.10开发版，按教程操作后localhost始终返回500错误，疑似缺少组件
• 从官网及GitHub下载对应文件夹后，xibo-cms-develop的yml文件无法正常运行
• 尝试混用xibo-docker-master的docker-compose.yml时，页面提示：

The CMS is temporarily off-line as an upgrade is in progress. Please check with your system administrator for updates or refresh your page in a few minutes.

• 已将cms_custom_files.yml放入文件夹，问题仍未解决

当前使用的docker-compose.yml内容 #

version: "2.1"

services:
    cms-db:
        image: mysql:8.0
        volumes:
            - "./shared/db:/var/lib/mysql"
        environment:
            - MYSQL_DATABASE=cms
            - MYSQL_USER=cms
            - MYSQL_RANDOM_ROOT_PASSWORD=yes
        mem_limit: 1g
        env_file: config.env
        restart: always
    cms-xmr:
        image: ghcr.io/xibosignage/xibo-xmr:0.11
        ports:
            - "9505:9505"
        restart: always
        mem_limit: 256m
        env_file: config.env
    cms-web:
        image: ghcr.io/xibosignage/xibo-cms:release-4.0.11
        volumes:
            - "./shared/cms/custom:/var/www/cms/custom"
            - "./shared/backup:/var/www/backup"
            - "./shared/cms/web/theme/custom:/var/www/cms/web/theme/custom"
            - "./shared/cms/library:/var/www/cms/library"
            - "./shared/cms/web/userscripts:/var/www/cms/web/userscripts"
            - "./shared/cms/ca-certs:/var/www/cms/ca-certs"
        restart: always
        environment:
            - MYSQL_HOST=cms-db
            - XMR_HOST=cms-xmr
            - CMS_USE_MEMCACHED=true
            - MEMCACHED_HOST=cms-memcached
        env_file: config.env
        ports:
            - "80:80"
        mem_limit: 1g
    cms-memcached:
        image: memcached:alpine
        command: memcached -m 15
        restart: always
        mem_limit: 100M
    cms-quickchart:
      image: ianw/quickchart
      restart: always

故障排查与修复建议 #

1. 版本不匹配问题 #

当前cms-web使用的是release-4.0.11镜像，与目标安装的4.10开发版版本不一致，会导致兼容性冲突：

• 将cms-web的image字段修改为适配4.10开发版的镜像，比如ghcr.io/xibosignage/xibo-cms:develop-4.10（可确认GitHub仓库的镜像标签）
• 同步更新cms-xmr镜像版本，建议使用对应开发版的XMR镜像，如ghcr.io/xibosignage/xibo-xmr:develop

2. 升级中提示的解决 #

该提示通常是数据库迁移未完成或锁文件残留导致：

• 进入cms-web容器，删除var/cache目录下的所有文件，以及var/upgrade.lock锁文件（如果存在）
• 在容器内执行数据库迁移命令：php bin/console doctrine:migrations:migrate --no-interaction
• 重启cms-web容器

3. 500错误排查步骤 #

• 查看cms-web容器日志获取具体错误信息：

  docker logs <cms-web容器ID或名称>
  

• 检查shared/db目录权限（Windows下Docker卷权限易出问题），确保容器拥有读写权限
• 核对config.env文件配置，确认数据库密码匹配、无缺失的环境变量

4. 避免混用不同版本配置文件 #

xibo-cms-develop与xibo-docker-master的配置文件结构存在差异，混用会引发依赖缺失或配置冲突：

• 直接使用xibo-cms-develop仓库中的docker-compose.yml及配套配置文件
• 确保所有镜像版本与目标4.10版本完全匹配

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