betterweb/node

docker-node

Better Node.js Docker镜像，提供多个专业变体以满足不同开发和生产需求。

可用镜像

基础镜像

• betterweb/node:latest - 基于Alpine Linux的最新稳定版Node.js（当前为24.x）
• betterweb/node:24 - Node.js 24.x（主版本）
• betterweb/node:24.0.0 - 特定Node.js版本

开发变体

• betterweb/node:dev - 包含额外工具的开发镜像（不适用于生产环境）
• betterweb/node:dev-24 - Node.js 24.x的开发镜像
• betterweb/node:dev-24.0.0 - 特定版本的开发镜像

DevContainer变体

• betterweb/node:devcontainer-latest - 带开发工具的VS Code DevContainer
• betterweb/node:devcontainer-24 - Node.js 24.x的DevContainer
• betterweb/node:devcontainer-24.0.0 - 特定版本的DevContainer

Docker-in-Docker (DIND)变体

• betterweb/node:dind-latest - 支持Docker和Docker Compose的Node.js
• betterweb/node:dind-24 - Node.js 24.x的DIND镜像
• betterweb/node:dind-24.0.0 - 特定版本的DIND镜像

使用方法

命令行运行

基础Node.js容器

bash
# 运行最新Node.js版本
docker run -it betterweb/node:latest

# 运行特定版本
docker run -it betterweb/node:24

# 挂载卷用于开发
docker run -it -v $(pwd):/app -w /app betterweb/node:24 npm start

# 端口映射
docker run -it -p 3000:3000 -v $(pwd):/app -w /app betterweb/node:24 node server.js

开发容器

bash
# 交互式开发环境
docker run -it -v $(pwd):/app -w /app betterweb/node:dev-24 bash

# 安装带原生依赖的包
docker run -it -v $(pwd):/app -w /app betterweb/node:dev-24 install_packages "bcrypt sharp"

# 运行带热重载的开发服务器
docker run -it -p 3000:3000 -v $(pwd):/app -w /app betterweb/node:dev-24 npm run dev

Docker-in-Docker容器

bash
# 带Docker socket访问（Linux/macOS）
docker run -it --privileged -v /var/run/docker.sock:/var/run/docker.sock betterweb/node:dind-24 bash

# 运行CI/CD流水线
docker run -it --privileged -v $(pwd):/app -w /app betterweb/node:dind-24 npm test

DevContainer使用

bash
# 交互式DevContainer环境
docker run -it -v $(pwd):/workspace -w /workspace betterweb/node:devcontainer-24 bash

# 配合VS Code DevContainer扩展（在.devcontainer/devcontainer.json中使用）

Dockerfile示例

基础Node.js应用

dockerfile
FROM betterweb/node:24
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 3000
CMD ["node", "index.js"]

开发环境

dockerfile
FROM betterweb/node:dev-24
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
CMD ["npm", "run", "dev"]

使用install_packages处理原生依赖

开发变体包含一个辅助脚本，用于安装带原生依赖的包：

dockerfile
FROM betterweb/node:dev-24
WORKDIR /app
COPY package*.json ./
# 使用install_packages安装需要编译的包
RUN install_packages "bcrypt canvas sharp"
COPY . .
CMD ["npm", "run", "dev"]

用于CI/CD的Docker-in-Docker

dockerfile
FROM betterweb/node:dind-24
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
# 可在此容器内运行docker命令
RUN docker --version
CMD ["npm", "test"]

DevContainer配置

对于VS Code DevContainers，在.devcontainer/devcontainer.json中使用：

json
{
  "name": "Node.js DevContainer",
  "image": "betterweb/node:devcontainer-24",
  "features": {},
  "forwardPorts": [3000],
  "postCreateCommand": "npm install"
}

镜像特性

基础镜像（betterweb/node）

• 基于Alpine Linux，体积最小化
• 从官方源安装Node.js
• gosu用于正确的用户权限处理
• 自定义入口脚本
• 非root用户node

开发镜像（dev-*）

• 基于基础镜像构建
• 包含install_packages脚本，便于安装带原生依赖的npm包
• 预配置构建工具（python、make、g++）用于编译原生模块
• 不推荐用于生产环境

DevContainer镜像（devcontainer-*）

• 基于Debian，提供更广泛的工具兼容性
• 预安装开发工具（git、curl、make、g++、python3）
• node用户拥有sudo权限
• 针对VS Code DevContainer环境优化

DIND镜像（dind-*）

• 基于基础Alpine镜像构建
• 安装Docker引擎和Docker CLI
• 支持Docker Compose v2
• 在后台运行dockerd
• 用户添加到docker组

版本矩阵

镜像支持多个Node.js版本构建：

• 基础镜像：所有受支持的Node.js版本（当前为18.x、20.x、21.x、22.x、23.x、24.x）
• 专业变体（dev、devcontainer、dind）：最新3个主版本Node.js（当前为22.x、23.x、24.x）
• 更新计划：每月1日更新

架构支持

多平台镜像支持：

• linux/amd64（x86_64）
• linux/arm64/v8（ARM64）

安全性

• 所有镜像默认以非root用户node运行
• 通过自动化构建定期进行安全更新
• 基于Alpine Linux的最小***面（DevContainer除外）
• 镜像中不包含任何密钥或凭证

构建流程

镜像通过GitHub Actions自动构建和发布：

1. prepare-matrix：确定Node.js版本和平台
2. build：为所有版本构建基础镜像
3. build-dev：构建开发变体（有限版本）
4. build-devcontainers：构建VS Code DevContainer变体（有限版本）
5. build-dind：构建Docker-in-Docker变体（有限版本）

贡献

此仓库包含：

• Dockerfile - 基础Node.js镜像
• Dockerfile.dev - 开发变体
• Dockerfile.devcontainer - VS Code DevContainer变体
• Dockerfile.dind - Docker-in-Docker变体
• .github/workflows/buildAndPub.yml - 自动化构建流水线

许可

本项目遵循与官方Node.js Docker镜像相同的许可协议。