Docker镜像CMD指令在Windows10设备运行时失效问题求助

可能原因及对应解决方法 #

1. 确认Docker是否运行在Linux容器模式 #

Windows Docker存在Linux容器和Windows容器两种模式，若你的镜像基于Linux系统，误切换到Windows容器模式时，执行shell脚本会触发“文件未找到”的错误（实际是找不到Linux shell解释器）。

• 解决：右键任务栏Docker图标，选择Switch to Linux containers，重启Docker后重新启动容器。

2. 检查WSL版本（适用于WSL后端） #

Windows 10默认可能使用WSL 1，其与Linux文件系统的兼容性弱于WSL 2，可能导致脚本路径解析异常。

• 查看WSL版本：打开PowerShell执行 wsl -l -v
• 升级到WSL 2：执行 wsl --set-version <你的发行版名称> 2，完成后重启Docker。

3. 验证Docker文件系统驱动 #

Windows 10的Docker若使用windowsfilter驱动（Hyper-V后端默认），可能对Linux镜像的文件路径解析存在问题，建议切换到overlay2驱动（需搭配WSL 2后端）。

• 操作路径：打开Docker设置 → Resources → WSL Integration，确保启用对应WSL发行版，且Docker设置为WSL 2后端。

4. 补充entrypoint.sh的shebang行 #

若entrypoint.sh开头未指定shell解释器（如#!/bin/bash或#!/bin/sh），部分环境下无法正确识别执行程序，会触发“文件未找到”报错。

• 解决：编辑entrypoint.sh，在第一行添加#!/bin/sh，重新构建镜像后测试。

5. 明确指定shell执行脚本 #

修改Dockerfile中的CMD指令，直接指定用shell执行脚本，避免环境差异导致的解析问题：

CMD ["sh", "/entrypoint.sh"]

或使用exec格式跳过shell层：

CMD ["/bin/sh", "/entrypoint.sh"]

重新构建镜像后在Windows 10设备上测试。

内容的提问来源于stack exchange，提问作者Alex Albalá