smebberson/alpine-nodejs

alpine-nodejs

基于Alpine Linux的Node.js运行环境Docker镜像，属于https://github.com/smebberson/docker-alpine%E9%95%9C%E5%83%8F%E5%A5%97%E4%BB%B6%E7%9A%84%E4%B8%80%E9%83%A8%E5%88%86%E3%80%82

核心功能

• 基于轻量级的https://www.alpinelinux.org/%EF%BC%8C%E9%95%9C%E5%83%8F%E4%BD%93%E7%A7%AF%E5%B0%8F
• 集成http://www.skarnet.org/software/s6/%E5%92%8Chttps://github.com/just-containers/s6-overlay%E8%BF%9B%E7%A8%8B%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%94%AF%E6%8C%81%E5%BA%94%E7%94%A8%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F%E7%AE%A1%E7%90%86
• 提供多版本Node.js支持（包含9.0.0、8.x、6.x等多个稳定版本）

使用场景

• Node.js Web应用、API服务的容器化部署
• 需要进程自动恢复能力的生产环境Node.js服务
• 轻量级Node.js开发与测试环境搭建

配置说明

自动重启配置

若需让s6自动重启应用，需完成以下步骤：

1. 在容器内创建目录/etc/services.d/app（名称可自定义，需位于/etc/services.d下）
2. 在该目录下创建可执行文件run，内容示例：

bash
#!/usr/bin/with-contenv sh
cd /app
node server.js

3. 通过Dockerfile设置run文件的执行权限：RUN chmod +x /etc/services.d/app/run

容器退出配置

若需应用退出时容器随之退出，可在Dockerfile中添加：

dockerfile
CMD ["node", "/app/server.js"]

若需结合清理逻辑，可在/etc/services.d/app目录下创建finish文件（需可执行），内容示例：

bash
#!/usr/bin/with-contenv sh
# 执行清理操作（如关闭数据库连接）
s6-svscanctl -t /var/run/s6/services # 触发容器退出

日志处理

应用通过console.log输出的日志可通过Docker日志命令查看：

bash
docker logs [容器ID/名称]

未捕获异常处理

建议捕获未捕获异常并记录日志，示例代码：

javascript
process.on('uncaughtException', (error) => {
  console.error('未捕获异常:', error);
  process.exit(1);
});

部署示例

Dockerfile继承示例

dockerfile
FROM docker.xuanyuan.run/smebberson/alpine-nodejs:latest
WORKDIR /app
COPY package*.json ./
RUN npm install --production
COPY . .
EXPOSE 3000
# 配置s6自动重启
RUN mkdir -p /etc/services.d/app
COPY ./scripts/run.sh /etc/services.d/app/run
RUN chmod +x /etc/services.d/app/run

其中scripts/run.sh内容为：

bash
#!/usr/bin/with-contenv sh
cd /app
node app.js

Docker Run示例

假设已构建应用镜像my-node-app，运行命令：

bash
docker run -d -p 3000:3000 --name node-service docker.xuanyuan.run/my-node-app

Docker Compose示例

yaml
version: '3'
services:
  node-app:
    build: .
    ports:
      - "3000:3000"
    restart: always