如何将环境变量传入Azure Web App中的自定义容器

1. 调整Dockerfile的启动命令配置 #

你的Dockerfile最终使用CMD ["node", "server.js"]作为启动指令，Azure Web App默认会沿用镜像的CMD，但这会导致自定义启动命令无法覆盖，同时可能影响环境变量的传递逻辑。推荐两种调整方式：

方式1：改用ENTRYPOINT实现灵活启动 #

将Dockerfile末尾的CMD替换为：

ENTRYPOINT ["node"]
CMD ["server.js"]

这种配置下，你在Azure容器设置中填写的启动命令会作为ENTRYPOINT的参数生效，比如填写server.js --env production就能覆盖默认启动参数。

方式2：使用启动脚本确保环境变量传递 #

在项目根目录创建start.sh脚本：

#!/bin/sh
# 确保所有环境变量被传递给node进程
exec node server.js

在Dockerfile的runner阶段添加脚本复制与权限配置：

# 复制启动脚本并赋予执行权限
COPY --from=builder --chown=nextjs:nodejs /app/start.sh ./
RUN chmod +x start.sh

# 替换原CMD为脚本启动
CMD ["./start.sh"]

2. 正确配置Azure Web App环境变量 #

• 在Azure门户的Web App「配置」→「应用设置」中添加自定义变量，不要给业务变量加WEBSITE_前缀（该前缀为Azure系统变量专用）。
• 若变量需要在Next.js客户端访问，必须添加NEXT_PUBLIC_前缀；仅服务器端使用的变量无需额外前缀。

3. 验证环境变量是否传入容器 #

通过Azure Web App的「SSH」功能进入容器，执行以下命令检查变量是否存在：

printenv | grep 你的变量名

若能输出变量值，说明传递成功，问题可能出在Next.js的变量读取逻辑；若无法输出，检查应用设置是否保存并重启Web App。

4. 强制启用自定义启动命令 #

在Azure Web App的「容器设置」→「启动命令」中填写完整启动指令，例如：

node server.js

保存后重启Web App，Azure会优先使用该命令替代镜像的默认启动配置。

额外注意事项 #

• 你使用了Next.js的standalone输出模式，该模式下环境变量在运行时读取，无需重新构建镜像，确保启动时变量已加载即可。
• 确认Web App的应用服务计划为B1及以上级别，免费计划对自定义容器的环境变量传递存在限制。

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