使用Docker搭建GhostCMS主题开发环境时文件加载失败

操作错误点分析 #

• 挂载路径错误：你将本地目录挂载到了/var/lib/ghost/current/content/themes/customtheme，但容器内Ghost的主题存储核心目录是/var/lib/ghost/content/themes，current下的content并非持久化内容目录，挂载到这里会导致Ghost无法正确识别主题的合法存储路径。
• 软链接操作冗余且路径混乱：手动创建的软链接将挂载目录指向实际主题目录，反而造成主题文件的路径识别冲突，Ghost加载主题时无法读取package.json、模板文件等必要资源，最终引发加载失败。

正确的主题开发配置步骤 #

1. 准备本地主题目录：确保当前终端所在的$PWD是你的主题开发目录，且目录内包含Ghost主题必备的核心文件（如package.json、default.hbs、index.hbs等）。
2. 创建并启动开发容器：使用正确的挂载路径，直接将本地主题目录映射到容器内的合法主题存储目录：

docker run -d --rm -e NODE_ENV=development -p 3001:2368 -v $PWD:/var/lib/ghost/content/themes/customtheme ghost

3. 验证主题加载：启动容器后，访问http://localhost:3001/ghost进入后台管理界面，在「设计」设置的主题选择菜单中选中customtheme即可正常加载。
4. 开发模式特性利用：由于设置了NODE_ENV=development，Ghost会自动监听主题文件的变更，修改本地主题文件后无需重启容器，刷新页面就能看到更新效果。

额外注意事项 #

• 确保本地主题目录的权限正确，避免容器内Ghost进程无法读取文件（可设置本地目录权限为755，文件权限为644）。
• 若主题仍无法加载，可进入容器检查主题文件是否存在：

docker exec -it <容器ID> ls /var/lib/ghost/content/themes/customtheme

同时查看Ghost日志排查具体错误：

docker logs <容器ID>

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