joxit/node

docker-node-utils

镜像概述和主要用途

docker-node-utils是基于Node.js的Docker镜像集合，主要用于开发环境。通过该镜像可限制npm install操作，清晰管理项目依赖，并集成了cartoCSS相关工具，帮助开发者在隔离环境中进行Node.js应用开发和样式表处理。

支持的标签及对应Dockerfile链接

• latest https://github.com/Joxit/docker-node-utils/blob/master/Dockerfile
• carto https://github.com/Joxit/docker-node-utils/blob/master/carto/Dockerfile

核心功能和特性

• 提供Node.js运行环境，支持node、npm命令
• 可通过环境变量配置用户ID，避免容器创建文件时的权限问题
• 支持通过NODE_OPTS变量添加额外Docker选项
• 集成cartoCSS工具链，包括carto、cartocc和cartoymlcc
• 支持将Git URL作为依赖项（符合npm规范）

使用场景和适用范围

• Node.js项目开发环境搭建
• 依赖管理与隔离，避免本地环境污染
• cartoCSS样式表开发与转换（如地图样式处理）
• 需要临时运行Node.js命令或脚本的场景

使用方法和配置说明

环境变量配置

• USER_ID：配置用户ID，避免容器创建的文件被root用户拥有（默认建议设为当前用户ID，如1000）
• NODE_OPTS：额外的Docker运行选项（如端口映射、环境变量等）

快捷命令配置

可通过bashrc或bash_aliases配置以下快捷别名，简化使用：

sh
# 运行node repl或Node.js程序
alias node="docker run -ti --rm -e USER_ID=1000 -v $(pwd):/usr/src/app ${NODE_OPTS} joxit/node node"

# 使用npm命令（注意：-g全局安装可能无法按预期工作）
alias npm="docker run -ti --rm -e USER_ID=1000 -v $(pwd):/usr/src/app ${NODE_OPTS} joxit/node npm"

# 启动bash交互终端，可执行多个命令
alias node_bash="docker run -ti --rm -e USER_ID=1000 -v $(pwd):/usr/src/app ${NODE_OPTS} joxit/node bash"

# 使用cartoCSS工具
alias carto="docker run -ti --rm -e USER_ID=1000 -v $(pwd):/usr/src/app ${NODE_OPTS} joxit/node:carto cartoyml"
alias cartocc="docker run -ti --rm -e USER_ID=1000 -v $(pwd):/usr/src/app ${NODE_OPTS} joxit/node:carto cartoymlcc"

使用示例

1. 安装依赖（以root权限）

sh
# 以root用户ID运行npm install，node_modules将由root拥有
NODE_OPTS="-e USER_ID=0" npm install

2. 运行带端口映射的Node.js服务器

sh
# 通过NODE_OPTS添加端口映射，将容器3000端口映射到本地3000端口
NODE_OPTS="-p 3000:3000" node server/index.js

carto工具说明

carto是一种快速的类CSS地图样式表语言（详见https://github.com/mapbox/carto/blob/master/docs/latest.md%EF%BC%89%E3%80%82%60carto%60%E6%A0%87%E7%AD%BE%E9%95%9C%E5%83%8F%E5%8C%85%E5%90%AB%E4%BB%A5%E4%B8%8B%E5%B7%A5%E5%85%B7%EF%BC%9A

• carto：将cartoCSS（.mml）项目转换为Mapnik XML
• cartocc：自定义cartoCSS（.mml）项目（如修改数据库连接）
• cartoymlcc：将YAML文件转换为cartoCSS（.mml）项目，并通过cartocc进行自定义