Docker run中--health-cmd变量拼接报错：unknown shorthand flag: 'f'

问题描述 #

我使用Shell脚本进行Docker容器的构建与运行，希望在命令行中添加心跳检测（健康检查）命令。通过变量拼接该命令时执行报错：unknown shorthand flag: 'f' in -f，但echo输出的命令直接执行却能正常启动。

脚本代码 #

# Heartbeat URL
health_check_cmd="curl -f http://172.17.0.1:5110/v2/alarm/hostRecord/find || exit 1"
# Heartbeat check interval, default: 30 seconds
health_check_interval=30s

dockerContainerOpe(){
    echo 'Starting operations on Docker container'
    # Stop and remove container
    if docker ps -a --format '{{.Names}}' | grep -q "^$container_name\$"; then
        docker rm -f $container_name
    fi
    # Build container
    docker build -t $docker_version_name --build-arg jarName=$jar_name .
    # Prepare docker run command
    run_cmd="docker run -itd $port_args --name=$container_name -v $docker_volume_path"
    # Add health check command and interval
    if [[ -n "$health_check_cmd" ]]; then
        run_cmd="$run_cmd --health-cmd=\"$health_check_cmd\" --health-interval=$health_check_interval"
    fi
    # Add other parameters
    run_cmd="$run_cmd --restart=always --privileged=true $docker_version_name"
    echo "Running command: $run_cmd"
    $run_cmd
    # Remove dangling containers
    if [[ -n $(docker images | grep "none" | awk '{print $3}') ]]; then
        docker rmi $(docker images | grep "none" | awk '{print $3}')
    fi
}

执行的命令 #

docker run -itd -p 5150:5150 --name=cmmop-alarm -v /home/logs:/home/logs --health-cmd="curl -f http://172.17.0.1:5110/v2/alarm/hostRecord/find || exit 1" --health-interval=30s --restart=always --privileged=true cmmop-alarm:1.0.0

报错信息 #

unknown shorthand flag: 'f' in -f
See 'docker run --help'.

环境信息 #

docker 
Server Version: 20.10.17

Operating System: CentOS Linux 7 (Core)

问题原因 #

你在拼接--health-cmd参数时用了转义双引号，但直接执行$run_cmd字符串时，Shell不会把转义的双引号解析为命令分隔符，反而会把"curl作为一个完整参数传给Docker。Docker会误以为-f是它自己的命令行标志，而非curl的参数，因此抛出未知短标志的错误。

解决方案 #

不要用字符串拼接命令，改用数组存储Docker命令的所有参数，数组能正确处理包含空格、特殊字符的参数，避免Shell解析错误。

修改后的脚本如下：

# Heartbeat URL
health_check_cmd="curl -f http://172.17.0.1:5110/v2/alarm/hostRecord/find || exit 1"
# Heartbeat check interval, default: 30 seconds
health_check_interval=30s

dockerContainerOpe(){
    echo 'Starting operations on Docker container'
    # Stop and remove container
    if docker ps -a --format '{{.Names}}' | grep -q "^$container_name\$"; then
        docker rm -f "$container_name"
    fi
    # Build container
    docker build -t "$docker_version_name" --build-arg jarName="$jar_name" .
    # Prepare docker run command using array
    run_cmd_args=(
        docker run -itd 
        "$port_args" 
        --name="$container_name" 
        -v "$docker_volume_path"
    )
    # Add health check command and interval
    if [[ -n "$health_check_cmd" ]]; then
        run_cmd_args+=(
            --health-cmd="$health_check_cmd"
            --health-interval="$health_check_interval"
        )
    fi
    # Add other parameters
    run_cmd_args+=(
        --restart=always 
        --privileged=true 
        "$docker_version_name"
    )
    # Echo the command (for debugging)
    echo "Running command: ${run_cmd_args[*]}"
    # Execute the command with array expansion
    "${run_cmd_args[@]}"
    # Remove dangling containers
    docker images | grep "none" | awk '{print $3}' | xargs -r docker rmi
}

关键修改说明 #

1. 改用数组存储参数：将run_cmd字符串替换为run_cmd_args数组，每个命令参数作为数组的独立元素
2. 正确展开数组：执行时使用"${run_cmd_args[@]}"，Shell会将每个数组元素作为独立参数传递，完美保留参数中的空格和特殊字符
3. 变量引用加引号：所有变量引用（如$container_name、$docker_version_name）都加上双引号，避免含空格的变量被错误拆分
4. 优化 dangling 镜像清理：用xargs -r替代原有的判断逻辑，更简洁可靠

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