Bitnami Node.js minimal 镜像

什么是 Node.js minimal？

Node.js minimal 是基于 V8 JavaScript 引擎构建的运行环境。其事件驱动、非阻塞 I/O 模型支持开发快速、可扩展且数据密集型的服务器应用程序。

Node.js minimal 概述
商标声明：本软件列表由 Bitnami 打包。所提及的相关商标归各自公司所有，使用这些商标并不意味着任何关联或认可。

请参考我们的文档开始使用最小化容器。

快速启动

docker run -it --name node bitnami/node-min:latest

这是由 Bitnami 构建和维护的安全加固、最小化 CVE 镜像。Bitnami 安全镜像基于云优化、安全加固的企业级 OS Photon Linux。选择 BSI 镜像的理由：

• 流行开源软件的安全加固镜像，具有近零漏洞（Near-Zero Vulnerabilities）
• 漏洞分类与优先级划分，包含 VEX 声明、KEV 和 EPSS 评分
• 合规性支持，包括 FIPS、STIG 和离线选项，以及安全物料清单（SBOM）
• 通过 in-toto 提供软件供应链来源证明
• 对主流 Helm 图表的一流支持

每个镜像均附带有价值的安全元数据。您可在 我们的公共目录 中查看元数据。注意：部分数据仅对 BSI 商业订阅用户 开放。

如需基于 Debian Linux 的旧版镜像，请参阅 Bitnami Legacy 仓库。

支持的标签及对应 Dockerfile 链接

了解 Bitnami 标签政策以及滚动标签与不可变标签的区别，请参阅 文档页面。

您可通过查看分支文件夹中的 tags-info.yaml 文件（如 bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml）了解不同标签的对应关系。

订阅项目更新，请关注 bitnami/containers GitHub 仓库。

获取镜像

获取 Bitnami Node.js minimal Docker 镜像的推荐方式是从 Docker Hub 仓库 拉取预构建镜像。

docker pull bitnami/node-min:latest

如需使用特定版本，可拉取带版本标签的镜像。您可在 Docker Hub 仓库中查看 可用版本列表。

docker pull bitnami/node-min:[TAG]

如需手动构建镜像，可克隆仓库、进入包含 Dockerfile 的目录并执行 docker build 命令。请将以下示例命令中的 APP、VERSION 和 OPERATING-SYSTEM 占位符替换为实际值。

git clone [***]
cd bitnami/APP/VERSION/OPERATING-SYSTEM
docker build -t bitnami/APP:latest .

进入 REPL

默认情况下，运行此镜像将进入 Node.js minimal REPL，您可在此交互式测试和尝试 Node.js 功能。

docker run -it --name node bitnami/node-min

延伸阅读：

• nodejs.org/api/repl.html

配置

运行 Node.js 脚本

Node.js minimal 镜像的默认工作目录为 /app。您可将主机中的文件夹挂载至此目录（包含 Node.js 脚本），并使用 node 命令正常运行。

docker run -it --name node -v /path/to/app:/app bitnami/node-min script.js

运行含 npm 依赖的 Node.js 应用

如果您的 Node.js 应用包含定义依赖和启动脚本的 package.json，需先安装依赖再运行应用。

此过程需使用完整 node 镜像运行 npm install，然后将包含模块的应用挂载到 bitnami/node-min 镜像中执行。

docker run --rm -v /path/to/app:/app bitnami/node npm install
docker run -it --name node  -v /path/to/app:/app bitnami/node-min <app.js>

访问运行 Web 服务器的 Node.js 应用

默认情况下，镜像暴露容器的 3000 端口。您可将此端口用于 Node.js 应用服务器。

以下是 express.js 应用示例，监听 3000 端口的远程连接：

var express = require('express');
var app = express();

app.get('/', function (req, res) {
  res.send('Hello World!');
});

var server = app.listen(3000, '0.0.0.0', function () {

  var host = server.address().address;
  var port = server.address().port;

  console.log('Example app listening at [***] host, port);
});

如需从主机访问 Web 服务器，可让 Docker 将主机的随机端口映射到容器的 3000 端口。

docker run -it --name node -v /path/to/app:/app -P bitnami/node-min index.js

运行 docker port 查看 Docker 分配的随机端口：

$ docker port node
3000/tcp -> 0.0.0.0:32769

您也可指定主机到容器的端口转发：

docker run -it --name node -p 8080:3000 -v /path/to/app:/app bitnami/node-min index.js

在浏览器中访问 http://localhost:8080 即可打开应用。

连接其他容器

如需从其他容器访问 Node.js Web 服务器，可使用 Docker 网络创建网络并将所有容器连接至此网络。

通过 nginx 前端提供 Node.js 应用服务

您可能希望仅通过 nginx Web 服务器访问 Node.js Web 服务器，以便配置静态资源服务、负载均衡等复杂场景。

步骤 1：创建网络

docker network create app-tier --driver bridge

步骤 2：创建虚拟主机

创建 nginx 虚拟主机配置，反向代理至 Node.js 容器：

server {
    listen 0.0.0.0:80;
    server_name yourapp.com;

    location / {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header HOST $http_host;
        proxy_set_header X-NginX-Proxy true;

        # proxy_pass http://[your_node_container_link_alias]:3000;
        proxy_pass [***]
        proxy_redirect off;
    }
}

注意配置中使用了链接别名 myapp，创建容器时需使用相同名称。

将上述虚拟主机配置保存至主机，后续将其挂载到 nginx 容器中。

步骤 3：以特定名称运行 Node.js 镜像

docker run -it --name myapp --network app-tier \
  -v /path/to/app:/app \
  bitnami/node-min index.js

步骤 4：运行 nginx 镜像

docker run -it \
  -v /path/to/vhost.conf:/bitnami/nginx/conf/vhosts/yourapp.conf:ro \
  --network app-tier \
  bitnami/nginx

维护

升级镜像

Bitnami 会及时提供包含安全补丁的 Node.js minimal 更新版本。建议按以下步骤升级容器：

步骤 1：获取更新镜像

docker pull bitnami/node-min:latest

步骤 2：移除当前运行容器

docker rm -v node

步骤 3：运行新镜像

使用新镜像重新创建容器：

docker run --name node bitnami/node-min:latest

贡献

我们欢迎您为此 Docker 镜像贡献代码。您可通过创建 issue 请求新功能，或提交 pull request 贡献代码。

问题反馈

如运行容器时遇到问题，可提交 issue。为获得更好支持，请填写 issue 模板。

许可

版权所有 © 2025 Broadcom。"Broadcom" 指 Broadcom Inc. 及其子公司。

根据 Apache License, Version 2.0 许可（"许可"）授权；除非遵守许可，否则不得使用本文件。

您可在以下地址获取许可副本：

<[***]>

除非适用法律要求或书面同意，软件按"原样"分发，不提供任何明示或暗示的担保或条件。详情请参阅许可。