bitmeal/nodegit

bitmeal/nodegit:alpine 镜像文档

镜像概述

基于node:alpine容器，包含预编译的nodegit版本及辅助功能。nodegit作为全局模块安装，当检测到项目依赖nodegit时会自动链接，同时拦截npm调用以实现自动链接逻辑，简化依赖nodegit的Node.js项目部署。

核心功能

• 预编译nodegit：nodegit作为全局模块预安装，无需项目内编译
• 自动链接：检测到项目依赖nodegit时，自动链接全局nodegit模块
• npm拦截：拦截npm调用并评估是否需要自动链接nodegit
• 手动npm访问：可通过/usr/local/bin/npm直接调用原始npm
• 手动链接支持：支持通过npm install、npm link nodegit或/usr/local/bin/npm install --link手动链接nodegit

使用场景

适用于依赖nodegit的Node.js项目，尤其是在alpine环境中部署时，可避免nodegit编译过程，快速部署；适合需要简化nodegit依赖管理的开发和生产环境。

快速开始

bash
docker run bitmeal/nodegit:alpine

配置选项

通过环境变量可配置镜像行为：

• NODEGIT_LINK_SILENT：禁用npm拦截和链接过程的输出
• NODEGIT_LINK_OFF：禁用自动nodegit链接
• NODEGIT_LINK_ALWAYS：始终链接全局nodegit，忽略检测结果
• NODEGIT_IGNORE_PACKAGE_LOCK：搜索nodegit依赖时忽略package-lock.json
• NPM_LINK：默认在npm install（及别名）后附加--link
• NPM_NO_PACKAGE_LOCK：使用npm时默认添加--no-package-lock选项

故障排除

• 版本匹配：确保容器中nodegit版本与项目package.json/package-lock.json中指定的版本一致
• 忽略package-lock.json：尝试在容器中忽略并重建package-lock.json
• npm二进制文件：调试时注意：npm二进制文件被屏蔽，可https://github.com/bitmeal/nodegit-alpine

标签信息

https://github.com/bitmeal/nodegit-alpine/actions/workflows/builder.yml/badge.svg](https://github.com/bitmeal/nodegit-alpine/actions/workflows/builder.yml)

此列表会自动更新，与容器镜像同步，反映最新构建状态。构建徽章指示所有容器是否构建成功，每个标签（组）的状态指示该标签是否包含在最新构建中。构建失败的标签可能仍有历史版本可用。

标签格式：[<nodegit版本>-][<node版本>-]alpine

• ✔ [基于node:alpine | nodegit@0.27.0] alpine、current-alpine、latest-current-alpine
• ✔ [基于node:lts-alpine | nodegit@0.28.0-alpha.28] 0.28-lts-alpine、next-lts-alpine
• ✔ [基于node:lts-alpine | nodegit@0.27.0] 0.27-lts-alpine、latest-lts-alpine、lts-alpine
• ✔ [基于node:lts-alpine | nodegit@0.26.5] 0.26-lts-alpine
• ❌ [基于node:lts-alpine | nodegit@0.25.1] 0.25-lts-alpine
• ❌ [基于node:23-alpine | nodegit@0.28.0-alpha.28] 0.28-23-alpine、next-23-alpine
• ✔ [基于node:23-alpine | nodegit@0.27.0] 0.27-23-alpine、23-alpine、latest-23-alpine
• ❌ [基于node:23-alpine | nodegit@0.26.5] 0.26-23-alpine
• ✔ [基于node:23-alpine | nodegit@0.25.1] 0.25-23-alpine
• ✔ [基于node:22-alpine | nodegit@0.28.0-alpha.28] 0.28-22-alpine、0.28-jod-alpine、next-22-alpine、next-jod-alpine
• ❌ [基于node:22-alpine | nodegit@0.27.0] 0.27-22-alpine、0.27-jod-alpine、22-alpine、jod-alpine、latest-22-alpine、latest-jod-alpine
• ✔ [基于node:22-alpine | nodegit@0.26.5] 0.26-22-alpine、0.26-jod-alpine
• ✔ [基于node:22-alpine | nodegit@0.25.1] 0.25-22-alpine、0.25-jod-alpine
• ❌ [基于node:20-alpine | nodegit@0.28.0-alpha.28] 0.28-20-alpine、0.28-iron-alpine、next-20-alpine、next-iron-alpine
• ✔ [基于node:20-alpine | nodegit@0.27.0] 0.27-20-alpine、0.27-iron-alpine、20-alpine、iron-alpine、latest-20-alpine、latest-iron-alpine
• ✔ [基于node:20-alpine | nodegit@0.26.5] 0.26-20-alpine、0.26-iron-alpine
• ✔ [基于node:20-alpine | nodegit@0.25.1] 0.25-20-alpine、0.25-iron-alpine

更多信息请访问：https://github.com/bitmeal/nodegit-alpine | https://github.com/bitmeal/nodegit-alpine/blob/master/Dockerfile