langrisha/npm-lazy

Docker npm_lazy

将此Docker容器加入您的编排系统，享受近乎即时的包依赖解析，这得益于mixu的lazy npm缓存（仓库地址：https://github.com/mixu/npm_lazy）。

核心功能

• 缓存NPM包依赖，减少重复下载，加速部署流程
• 支持本地端口映射与容器链接两种使用方式
• 通过命令行参数或环境变量动态配置服务
• 兼容官方NPM客户端的多种配置方式

使用场景

1. 本地开发环境：加速NPM install命令的执行速度
2. 容器化部署：作为内部NPM registry缓存，提升集群内应用构建效率
3. 团队协作：共享NPM包缓存，减少团队成员重复下载成本

部署示例

本地主机使用

将容器端口映射到本地，让主机的NPM客户端通过缓存获取包：

bash
# 启动后台容器，映射8080端口
sudo docker run -d -p 8080:8080 langrisha/npm-lazy

验证服务可用性：

bash
curl http://localhost:8080
{"db_name":"registry"}

容器链接使用

通过docker-compose链接其他容器（以fig.sh为例）：

yaml
web:
  image: docker.xuanyuan.run/google/nodejs
  environment:
    - npm_config_registry=http://npmlazy
  links:
    - npmlazy
npmlazy:
  image: docker.xuanyuan.run/langrisha/npm-lazy
  command: --show-config --port=80 --external-url=http://npmlazy

配置说明

服务端配置

命令行参数

启动容器时可通过参数配置服务：

bash
node index.js --help
# 支持参数包括--port、--cache-directory、--external-url等

环境变量

使用NPM_LAZY_前缀的环境变量配置：

bash
export NPM_LAZY_PORT=80
export NPM_LAZY_CACHE_DIRECTORY=/tmp/npm_lazy
node index.js

NPM客户端配置

环境变量方式

bash
docker run -e npm_config_registry=http://localhost:8080 docker.xuanyuan.run/nodejsapp

项目级配置文件

在项目根目录创建.npmrc：

ini
registry = http://localhost:8080/

故障排除

1. 检查端口与外部URL是否匹配服务配置
2. 使用--show-config参数查看运行时配置
3. 通过npm install --verbose获取客户端详细日志

参考链接

• npm_lazy项目页面
• https://github.com/mixu/npm_lazy
• https://github.com/mixu/npm_lazy/blob/master/config.js
• https://docs.npmjs.com/misc/config

变更日志

[1.11.0] 2017-04-04

• 更新mixu/npm_lazy至1.11.0版本

https://github.com/langri-sha/npm_lazy/compare/1.9.0...1.10.0 2017-04-02

• 更新mixu/npm_lazy至1.10.0版本

https://github.com/langri-sha/npm_lazy/compare/1.8.0...1.9.0 2017-04-02

• 更新mixu/npm_lazy至1.9.0版本
• 容器基础镜像更新为node:4.8.1
• 使用CCI 2.0

https://github.com/langri-sha/npm_lazy/compare/1.7.0...1.8.0 2016-09-01

• 更新mixu/npm_lazy至v1.8.0
• 切换至官方Node.js镜像
• Node.js版本更新至v0.12
• 新增环境变量配置支持
• 新增基础测试

https://github.com/langri-sha/npm_lazy/compare/3f***bbe3fd959e82b353e3f2013a2fed...1.7.0 2015-02-16

• 使用Google Node.js运行时镜像
• 更新mixu/npm_lazy至v1.7
• 新增使用示例
• 支持命令行参数解析

https://github.com/langri-sha/npm_lazy/compare/b0d5587a136a8b87cc95578aa53714c58ec5bfb1...3f***bbe3fd959e82b353e3f2013a2fed 2015-01-23

• 初始发布
• 使用mixu/npm_lazy v1.7.0