Nginx模块必须在编译时嵌入，运行中新增需重新编译并热替换二进制文件：先用nginx -V获取原配置参数，下载同版本源码及模块，configure追加--add-module后make，再通过USR2/WINCH信号平滑切换。
不能直接“安装”模块，Nginx 的模块必须在编译阶段嵌入二进制文件中。已运行的 Nginx 若需新增功能模块（如 ngx_http_google_filter_module、fastdfs-nginx-module 或 nginx_lua_module），必须通过重新编译并替换 nginx 可执行文件来实现——整个过程可做到不中断服务。
确认当前 Nginx 编译参数
这是最关键的一步，漏掉任何一项都可能导致新二进制无法正常启动：
- 进入 nginx 安装目录的
sbin/子目录（例如/usr/local/nginx/sbin） - 执行
./nginx -V（注意是大写 V），输出中configure arguments:后的内容就是原始编译命令 - 把整行参数完整复制下来，后续要在此基础上追加
--add-module=路径
准备源码与新模块代码
必须使用与当前 nginx 版本完全一致的源码包，否则兼容性风险极高：
- 从 nginx.org 下载对应版本源码（如
nginx-1.21.6.tar.gz），解压到临时目录 - 将第三方模块源码（如
fastdfs-nginx-module）克隆或解压到本地，确保路径稳定可访问 - 验证模块是否支持你当前的 nginx 版本（部分模块仅适配特定主版本，如 1.18–1.22）
重新编译，但不安装
核心原则：只生成新的 nginx 二进制文件，不覆盖配置、日志、HTML 等其他内容：
- 进入 nginx 源码目录（如
nginx-1.21.6/） - 运行完整 configure 命令，末尾追加
--add-module=/path/to/your/module - 执行
make（千万不能make install） - 编译成功后，新二进制位于
objs/nginx
平滑替换与验证
利用 Nginx 的二进制热替换机制，实现零停机升级：
- 备份原程序：
mv /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak - 复制新二进制：
cp objs/nginx /usr/local/nginx/sbin/ - 检查语法：
/usr/local/nginx/sbin/nginx -t - 发送 USR2 信号启动新 master：
kill -USR2 $(cat /usr/local/nginx/logs/nginx.pid) - 发送 WINCH 信号优雅关闭旧 worker：
kill -WINCH $(cat /usr/local/nginx/logs/nginx.pid.oldbin) - 确认新进程运行后，用
kill -QUIT终止旧 master
