如何在Dockerfile中基于RUNNING_LOCALLY参数条件执行命令？

核心问题 #

你当前的Docker代码存在两个关键错误：

1. RUN指令误用：RUN是镜像构建阶段执行的命令，把npm run serve放在RUN里会导致构建镜像时就启动前台服务，直接卡住镜像构建流程，永远无法完成镜像制作。而且容器启动后不会再执行该命令——RUN的结果只会固化在镜像层中。
2. ENTRYPOINT无法在RUN脚本中设置：ENTRYPOINT是Dockerfile的顶层指令，只能直接写在Dockerfile里，无法通过RUN中的shell脚本设置，你当前的写法只是在构建阶段输出了一个字符串，完全不会被Docker解析为容器启动指令。

正确实现方式 #

方案1：构建阶段通过ARG生成启动脚本（推荐）

思路：在构建阶段根据RUNNING_LOCALLY参数生成不同的启动脚本，容器启动时执行该脚本，既能复用镜像构建的大部分流程，又能实现不同环境的启动逻辑。

ARG RUNNING_LOCALLY

# 先执行通用构建操作（若生产环境不需要build产物，可将此步放入条件判断）
RUN npm run build

# 根据ARG生成可执行的启动脚本
RUN if [ "$RUNNING_LOCALLY" = "true" ]; then \
        echo '#!/bin/sh' > /start.sh; \
        echo 'npm run serve' >> /start.sh; \
    else \
        echo '#!/bin/sh' > /start.sh; \
        echo '/usr/bin/app' >> /start.sh; \
    fi && chmod +x /start.sh

# 容器启动时执行脚本
CMD ["/start.sh"]

方案2：多阶段构建（适合环境差异大的场景）

如果本地环境和生产环境的镜像内容差异较大，多阶段构建可以生成更精简的镜像：

ARG RUNNING_LOCALLY

# 通用构建阶段：完成依赖安装、build等操作
FROM node:18-alpine as builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build

# 本地环境阶段：启动开发服务
FROM node:18-alpine as local
WORKDIR /app
COPY --from=builder /app .
CMD ["npm", "run", "serve"]

# 生产环境阶段：设置ENTRYPOINT
FROM alpine:latest as prod
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /usr/bin/app /usr/bin/app
ENTRYPOINT ["/usr/bin/app"]

# 根据ARG选择最终输出的镜像
ARG RUNNING_LOCALLY=true
FROM ${RUNNING_LOCALLY = "true" ? local : prod}

为什么原来的代码正常？ #

你之前的写法：

RUN npm run build
CMD ["npm", "run", "serve"]

完全符合Docker逻辑：RUN在构建阶段完成静态资源构建，CMD是容器启动时执行的命令，两者阶段分离，因此构建和启动流程都能正常运行。

内容的提问来源于stack exchange，提问作者Monkey D. Teach