GravCMS Docker容器启动正常但宿主机目录无内容问题排查

核心问题1：YAML中的路径分隔符错误 #

Docker Compose基于YAML语法，而YAML里反斜杠\是转义字符，你配置里的..\grav\user\accounts这类路径会被错误解析，导致Docker无法定位到宿主机的正确目录。当路径解析失败时，Docker会自动创建错误的空目录，容器启动后生成的内容会写入这个错误位置，而非你预期的目录，所以看不到内容。

解决办法：
将所有反斜杠替换为跨平台通用的正斜杠/，修改后的volumes配置如下：

volumes:
  - ../grav/user/accounts:/var/www/grav/user/accounts
  - ../grav/user/blueprints:/var/www/grav/user/blueprints
  - ../config:/var/www/grav/user/config
  - ../contents/data:/var/www/grav/user/data
  - ../grav/user/images:/var/www/grav/user/images
  - ../grav/user/languages:/var/www/grav/user/languages
  - ../contents/posts:/var/www/grav/user/pages
  - ../grav/user/plugins:/var/www/grav/user/plugins
  - ../vendors/themes:/var/www/grav/user/themes

核心问题2：宿主机挂载目录不存在或路径层级错误 #

如果宿主机上../grav/user/accounts等目录本身不存在，Docker会自动创建空目录。而linuxserver/grav容器的逻辑是：仅当容器内的目标目录（如/var/www/grav/user/accounts）为空时，才会从镜像中复制初始化内容。Docker自动创建的空目录会被容器判定为“已存在”，因此不会复制任何内容到宿主机目录。

解决办法：

1. 手动在宿主机创建所有需要挂载的目录，确保目录结构与配置中的相对路径匹配（..代表docker-compose.yml所在目录的上级目录）。
2. 核对路径层级，确认../grav/user/accounts等路径确实指向你预期的宿主机位置。

额外检查：Windows文件权限 #

确保当前Windows用户对挂载目录有读写权限，同时Docker Desktop的文件共享设置已开启对应磁盘的访问权限（比如存放目录的磁盘）。权限不足会导致容器无法将内容写入宿主机目录。

内容的提问来源于stack exchange，提问作者p-marco