如何用-e标志向Docker容器传递含空格与反斜杠的环境变量？

问题描述 #

尝试向Docker容器传递HOST_GROUP环境变量，目标值为：

HOST_GROUP="BUH\100 user"

但容器内仅能读取到BUH\100，user部分被截断。试过以下写法均无效：

HOST_GROUP="BUH\100 user"
HOST_GROUP=BUH\\100\\ user
"HOST_GROUP=BUH\100 user"

使用的docker run命令如下：

sudo docker run --network host --name head_node --restart always -d \
  -e HOST_GROUP="$HOST_GROUP" \
  ...
  $head_node_image sleep infinity

解决方案 #

问题核心是shell对转义字符和空格的解析规则，以及Docker环境变量传递时的参数拆分问题，可通过以下两种方式解决：

方式一：先定义本地变量，再传递给容器 #

1. 用单引号定义本地环境变量，避免shell解析反斜杠和拆分空格：

export HOST_GROUP='BUH\100 user'

单引号会原样保留所有字符，不会将\100解析为八进制转义字符，也不会把空格当作参数分隔符。

2. 在docker run命令中，用双引号包裹-e的参数，确保变量完整传递：

sudo docker run --network host --name head_node --restart always -d \
  -e "HOST_GROUP=$HOST_GROUP" \
  $head_node_image sleep infinity

方式二：直接在docker run命令中传递值 #

无需依赖本地变量，直接用单引号包裹完整值传递给-e参数：

sudo docker run --network host --name head_node --restart always -d \
  -e HOST_GROUP='BUH\100 user' \
  $head_node_image sleep infinity

为什么之前的写法无效 #

• HOST_GROUP="BUH\100 user"：双引号内的\100会被bash解析为八进制ASCII字符（@），且传递时若未正确包裹，空格会触发参数拆分；
• HOST_GROUP=BUH\\100\\ user：反斜杠虽被转义，但空格未被包裹，shell会将user视为单独参数，导致变量值仅保留BUH\100；
• "HOST_GROUP=BUH\100 user"：整个字符串虽被当作单一参数，但\100仍会被shell解析为转义字符，无法保留原始值。

验证 #

进入容器执行以下命令，若输出BUH\100 user则说明传递成功：

docker exec head_node echo "$HOST_GROUP"

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