defra-docker-node 镜像文档

概述

defra-docker-node 是英国环境、食品和农村事务部（DEFRA）开发的Node.js基础镜像，设计为构建Node.js应用的父镜像。该镜像提供标准化的Node.js运行环境，集成基础依赖管理工具与安全配置，旨在简化应用镜像构建流程，确保基础环境的一致性与可靠性。

核心功能与特性

• 标准化Node.js环境：基于***Node.js镜像构建，支持多版本Node.js（通过标签指定）
• 依赖管理工具：预安装npm及可选yarn，满足不同项目的依赖管理需求
• 安全加固：默认采用非root用户运行，减少容器运行时安全风险
• 基础系统依赖：包含Node.js应用运行所需的基础系统库与工具链
• 可扩展架构：作为父镜像设计，支持通过Dockerfile指令灵活扩展自定义配置

使用场景

• DEFRA内部Node.js应用的基础镜像构建
• 需要统一Node.js环境的企业级应用开发与部署
• 对安全性、稳定性有较高要求的Node.js应用容器化场景

使用方法与配置说明

镜像拉取

从Docker仓库拉取指定版本镜像：

bash
docker pull defra/defra-docker-node:[tag]

标签说明：[tag]格式为{node-version}-{base-image}，例如18-alpine（Node.js 18 + Alpine基础）、20-buster（Node.js 20 + Debian Buster基础），具体版本可参考GitHub仓库标签列表。

作为基础镜像使用

在应用Dockerfile中集成该镜像：

dockerfile
# 指定基础镜像版本
FROM defra/defra-docker-node:18-alpine

# 设置工作目录（继承自父镜像，可覆盖）
WORKDIR /app

# 复制依赖文件并安装
COPY package*.json ./
RUN npm ci --only=production

# 复制应用代码
COPY . .

# 暴露应用端口
EXPOSE 3000

# 启动命令
CMD ["node", "server.js"]

环境变量配置

支持以下常用环境变量（可在Dockerfile或运行时设置）：

构建与运行示例

1. 构建应用镜像：

   bash
   docker build -t my-defra-node-app .
   

2. 运行应用容器：

   bash
   docker run -d \
     -p 3000:3000 \
     -e "NODE_ENV=production" \
     --name my-app \
     my-defra-node-app
   

注意事项

• 生产环境建议使用Alpine版本镜像以减小体积
• 自定义用户权限需在子镜像中显式配置，避免覆盖父镜像安全设置
• 版本选择应匹配应用的Node.js版本需求，参考***Node.js LTS生命周期

完整配置与更新日志请参考GitHub仓库