turnkeylinux/nodejs

TurnKey Node.js Docker镜像文档

镜像概述和主要用途

TurnKey Node.js Docker镜像是一个预配置的Node.js运行环境，基于TurnKey Linux构建，旨在提供开箱即用的Node.js开发和部署解决方案。该镜像集成了Node.js运行时、npm包管理器及相关依赖，简化了Node.js应用的部署流程，适用于快速搭建开发环境或生产环境中的Node.js服务。

核心功能和特性

• 预配置环境：包含Node.js运行时和npm包管理器，无需手动安装配置
• 异步I/O模型：基于Chrome V8引擎，支持非阻塞I/O，提升应用性能
• 跨平台兼容：可在任何支持Docker的环境中运行，确保环境一致性
• 轻量级设计：优化的镜像大小，减少资源占用
• 易于扩展：支持通过npm安装额外依赖，满足不同应用需求

使用场景和适用范围

• 开发环境：快速搭建本地Node.js开发环境，避免环境配置冲突
• 生产部署：部署Node.js应用到服务器，如API服务、Web应用、微服务等
• 实时应用：构建实时通信应用，如聊天系统、实时通知服务
• 自动化测试：在CI/CD流程中作为测试环境，确保代码在标准Node.js环境中运行

使用方法和配置说明

基本部署（docker run）

通过以下命令快速启动Node.js容器：

bash
docker run -d -p 3000:3000 --name turnkey-nodejs turnkeylinux/nodejs

• -d：后台运行容器
• -p 3000:3000：将容器的3000端口映射到主机的3000端口（默认Node.js应用端口）
• --name turnkey-nodejs：指定容器名称

挂载应用目录

将本地Node.js应用代码挂载到容器中：

bash
docker run -d -p 3000:3000 -v /path/to/your/app:/app --name turnkey-nodejs turnkeylinux/nodejs

• -v /path/to/your/app:/app：将本地应用目录挂载到容器的/app目录，实现代码实时更新

环境变量配置

可通过环境变量自定义Node.js配置：

bash
docker run -d -p 3000:3000 -e NODE_ENV=production -e PORT=4000 --name turnkey-nodejs turnkeylinux/nodejs

• NODE_ENV=production：设置Node.js环境为生产模式
• PORT=4000：指定应用运行端口（需确保容器端口映射对应）

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  nodejs:
    image: turnkeylinux/nodejs
    ports:
      - "3000:3000"
    volumes:
      - ./app:/app
    environment:
      - NODE_ENV=production
      - PORT=3000
    restart: always

通过docker-compose up -d启动服务。

访问应用

容器启动后，通过http://localhost:3000访问Node.js应用（端口需与映射端口一致）。