Windows下使用$PWD配置Docker卷时出现无效引用格式的解决方法

在Windows环境下运行Shell脚本配置Docker容器时，出现docker: invalid reference format错误，经确认问题出在volume="$PWD/data"的路径格式处理上。

原脚本代码：

# Variables
model="Llama-2-7b-chat"
volume="$PWD/data"

# Echo starting message
echo "Starting the Docker container with local files (No Internet): $model and volume: $volume ..."

# Start the Docker container
docker run --rm --entrypoint /bin/bash -itd \
  --name $model \
  -v $volume:/data \
  -p 8080:80 ghcr.io/huggingface/text-generation-inference:latest

执行脚本后的错误输出：

$ ./run_llama_2.sh
Starting the Docker container with local files (No Internet): Llama-2-7b-chat and volume: /c/Users/user_name/llama_chat/data ...
docker: invalid reference format.

针对Windows环境下的路径格式问题，可通过以下方式修正：

• 给挂载路径添加引号
  Docker解析路径时，带引号的写法能避免因路径格式或特殊字符导致的解析错误。修改docker run命令中的-v参数：

-v "$volume":/data

此方法能直接解决大部分路径格式引发的参数解析问题。

• 转换为Docker兼容的路径格式
  若使用Git Bash、MinGW等类Unix Shell，$PWD输出的是类Unix风格路径（如/c/Users/...），Docker在Windows原生环境下无法直接识别，可转换为以下两种兼容格式：

  1. 转换为Windows原生路径：

  volume="$(cmd.exe /c echo %cd%)/data"
  

  2. 使用双斜杠开头的类Unix路径：

  volume="//$(echo $PWD | sed 's/^\///')/data"
  

• 基于WSL环境的修正
  若启用了WSL并在其中运行脚本，确保$PWD为WSL原生路径（如/mnt/c/Users/...），且Docker Desktop已开启WSL集成功能，此时直接使用volume="$PWD/data"即可正常工作。

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