bellsoft/alpaquita-linux-nodejs

bellsoft/alpaquita-linux-nodejs

镜像概述和主要用途

bellsoft/alpaquita-linux-nodejs是基于Alpaquita Linux Stream的Node.js镜像，包含Node.js运行时及相关工具（如npm）。Alpaquita Linux是一款针对云原生应用部署优化的轻量级操作系统，该镜像继承其资源高效、性能优异的特性，同时保持与Docker官方Node镜像的兼容性，并提供额外增强功能。

核心功能和特性

Alpaquita Linux特性

• 轻量级基础：基础镜像大小仅3.22MB，显著减少容器资源占用
• 用户空间二进制保护：增强应用安全性
• 多内存分配实现：提供四种malloc实现，适应不同工作负载需求
• 优化C库：采用"musl perf"标准C库实现，兼具小巧体积和高性能
• 广泛兼容性：支持Docker和QEMU环境
• 灵活扩展：可通过Alpaquita apk仓库安装额外模块和包

镜像特有特性

• 双libc支持：提供Musl和Glibc两种libc版本，Musl通常可生成更小的最终镜像
• tini集成：内置tini初始化系统，可通过设置ENTRYPOINT ["/usr/sbin/tini", "--"]实现对Node进程的正确信号处理
• 默认Entrypoint配置：所有命令行参数直接传递给/usr/bin/node二进制文件

使用场景和适用范围

• 构建轻量级云原生Node.js应用容器
• 对镜像大小和资源占用有严格要求的部署场景
• 需要高效信号处理和进程管理的Node.js服务
• 追求高性能且关注安全性的应用部署

使用方法和配置说明

基本使用示例

以下示例演示如何使用该镜像构建并运行一个基础HTTP服务器应用。

1. 创建server.js文件：

javascript
import { createServer } from 'node:http';

const server = createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain' });
  res.end('Hello World!\n');
});

server.listen(3000, '0.0.0.0', () => {
  console.log('Listening on 0.0.0.0:3000');
});

2. 创建Dockerfile：

dockerfile
FROM docker.xuanyuan.run/bellsoft/alpaquita-linux-nodejs:musl

WORKDIR /app
COPY server.js .

# 使用非特权用户增强安全性
USER node

# 配置tini处理信号
ENTRYPOINT ["/usr/sbin/tini", "--"]
CMD ["node", "server.js"]

3. 构建并运行镜像：

shell
# 构建镜像
docker build -t alpaquita-node-example . 

# 运行容器
docker run --rm -p 3000:30300 docker.xuanyuan.run/alpaquita-node-example
# 输出: Listening on 0.0.0.0:3000

4. 测试应用：

shell
curl http://127.0.0.1:3000
# 输出: Hello World!

安全最佳实践

• 使用非特权用户：镜像内置node用户，通过USER node指令可避免以root权限运行应用，提升容器安全性
• 启用tini：配置tini作为entrypoint可确保正确处理信号，避免僵尸进程问题

标签说明

该镜像支持最新的Node.js主要版本，标签格式如下：

• X-glibc, X.Y-glibc, X.Y.Z-glibc：指定版本的Node.js，基于Glibc
• X-musl, X.Y-musl, X.Y.Z-musl：指定版本的Node.js，基于Musl
• glibc：最新Node.js版本，基于Glibc
• musl, latest：最新Node.js版本，基于Musl（默认标签）

许可信息

与所有Docker镜像一样，本镜像包含其他软件，可能以不同许可协议分发。

可通过在镜像中执行apk list -I命令获取已安装软件组件及其许可信息。

使用预构建镜像时，用户有责任确保对本镜像的任何使用均符合其中包含的所有软件的相关许可要求。