git用于nginx源码版本管理，支持打补丁、集成模块、定制功能及ci/cd；推荐下载官方tar包初始化本地仓库，用submodule管理第三方模块，并通过git describe保障编译可重现性。
源码安装 Nginx 时结合 Git，核心目的是把官方源码或带定制模块的代码纳入版本控制，便于追踪修改、协作开发、回滚调试和持续集成。它不是用 Git 替代编译流程，而是把 Git 当作源码生命周期管理工具——从拉取、打补丁、加模块到发布分支，全程可追溯。
用 Git 管理 Nginx 源码的典型场景
常见需求包括：基于某个稳定版（如 nginx-1.30.0）打安全补丁；集成第三方模块（如 lua-nginx-module）并长期维护；为内网环境定制 SSL 行为或日志格式；或构建内部发行版（含预置 conf、启动脚本、监控探针）。
- 直接克隆官方镜像（非 GitHub 托管）：Nginx 官方不托管在 GitHub，但社区有同步镜像，例如
https://github.com/nginx/nginx（只读镜像，更新滞后），仅适合参考结构，不建议用于生产定制 - 推荐方式：下载官方 tar.gz 后初始化本地仓库，再 commit 基础版本，后续所有改动都基于此提交
- 若需集成多个第三方模块，可将它们作为 Git 子模块（
git submodule add）引入，保持各自版本独立可更新
初始化一个可维护的定制源码仓库
以 Ubuntu 系统为例，在工作目录中执行：
- 创建空目录并进入：
mkdir ~/nginx-custom && cd ~/nginx-custom - 下载并解压官方源码：
wget https://nginx.org/download/nginx-1.30.0.tar.gz && tar -zxf nginx-1.30.0.tar.gz - 重命名并初始化 Git：
mv nginx-1.30.0 src && cd src && git init && git add . && git commit -m "chore: import nginx-1.30.0 official source" - （可选）添加子模块：
git submodule add https://github.com/openresty/lua-nginx-module.git modules/lua-nginx-module
此后所有配置变更、patch 文件、自定义模块代码都应提交进该仓库，形成清晰的 commit 历史。
编译时复用 Git 状态提升可重现性
确保每次编译对应明确的代码状态：
- 编译前记录当前状态：
git describe --always --dirty输出类似v1.30.0-5-ga1b2c3d-dirty，可写入 build 日志或二进制注释（通过--with-debug+ 自定义宏实现） - 若修改了 configure.ac 或 auto/ 脚本，需运行
./auto/configure（不是./configure）重新生成 configure 脚本，并提交变更 - 避免在源码树内混放编译产物（obj、Makefile）：用
git clean -fdX清理，或在.gitignore中加入objs/、Makefile、conf/nginx.conf等生成文件
对接 CI/CD 和自动化部署
Git 仓库可直接接入 Jenkins、GitLab CI 或 GitHub Actions：
- CI 流程示例：拉取指定 tag → 安装依赖 → 执行 configure（含模块开关）→
make -j$(nproc)→make install→ 运行 smoke test（如curl -I http://127.0.0.1/status） - 用 Git tag 标记发布版本，例如
git tag v1.30.0-myorg-v1，配合make install后打包成 deb/rpm 或容器镜像 - 敏感配置（如证书路径、密钥）不进仓库，通过 CI 变量注入或挂载配置卷方式处理
这样就把一次手工编译，变成了可审计、可重复、可自动发布的标准动作。
