Nginx 源码编译安装（含第三方模块）完整笔记

Nginx 源码编译安装含第三方模块完整笔记适用系统CentOS / RHEL 7目标编译安装 Nginx并集成echo-nginx-module第三方模块安装目录/usr/local/nginx源码目录/usr/local/src一、环境准备目的安装编译工具和依赖库确保后续操作不报错。# 安装基础编译工具和必需的开发库yuminstall-ygccmakepcre-devel zlib-devel openssl-develgitwget解释gccC编译器make构建工具pcre-devel支持正则表达式Nginx rewrite 模块需要zlib-devel支持压缩gzip 模块需要openssl-devel支持 HTTPSSSL 模块需要git用于克隆第三方模块源码wget用于下载源码包二、源码编译安装含第三方模块第一步安装编译依赖上面的命令已经完成这里直接进入下载如果你已经执行了“环境准备”这步可跳过。但为保持笔记完整性此处再写一遍yuminstall-ygccmakepcre-devel zlib-devel openssl-develgitwget第二步下载 Nginx 源码和第三方模块# 进入源码存放目录cd/usr/local/src# 下载 Nginx 源码以 1.30.4 为例可换成其他版本wgethttp://nginx.org/download/nginx-1.30.4.tar.gz# 解压tar-xzfnginx-1.30.4.tar.gz# 克隆 echo 模块GitHub 仓库gitclone https://github.com/openresty/echo-nginx-module.git解释下载的源码包解压后得到nginx-1.30.4目录echo 模块克隆到/usr/local/src/echo-nginx-module第三步配置编译选项添加第三方模块cd/usr/local/src/nginx-1.30.4 ./configure\--prefix/usr/local/nginx\--usernginx\--groupnginx\--with-http_ssl_module\--with-http_v2_module\--with-http_stub_status_module\--with-http_gzip_static_module\--add-module/usr/local/src/echo-nginx-module解释--prefix指定安装目录--user/--group运行用户和组生产环境建议新建 nginx 用户此处简化--with-*开启 Nginx 官方自带的功能模块--add-module添加第三方 echo 模块如果配置过程中提示缺少依赖请根据错误信息安装对应的-devel包然后重新执行./configure。第四步编译安装makemakeinstall解释make编译源码耗时较长make install将编译好的文件安装到--prefix指定的目录⚠️重编译注意事项如果你想重新配置比如添加新模块务必先执行make clean清理旧编译文件再重新执行./configure和make make install。第五步验证模块是否编译成功/usr/local/nginx/sbin/nginx-V21|grepecho预期输出如果成功会看到类似--add-module/usr/local/src/echo-nginx-module的字样。如果没有任何输出说明模块没有编译进去请检查./configure时的路径是否正确。第六步创建 systemd 服务文件方便管理这一步让你可以用systemctl start/stop/restart nginx来管理 Nginx而不是每次都要敲完整路径。cat/etc/systemd/system/nginx.serviceEOF [Unit] DescriptionNginx HTTP Server Afternetwork.target [Service] Typeforking PIDFile/usr/local/nginx/logs/nginx.pid ExecStart/usr/local/nginx/sbin/nginx ExecReload/usr/local/nginx/sbin/nginx -s reload ExecStop/usr/local/nginx/sbin/nginx -s stop PrivateTmptrue [Install] WantedBymulti-user.target EOF解释Typeforking因为 Nginx 以 master/worker 方式启动属于 fork 模式PIDFile指定 pid 文件路径ExecStart启动命令ExecReload重载配置不停服ExecStop停止服务配置生效systemctl daemon-reload第七步启动并访问测试启动前检查确保 80 端口未被占用netstat-tlnp|grep:80如果发现占用可先停止旧进程例如pkill -9 nginx。启动 Nginx# 如果之前用源码启动过先停掉旧的/usr/local/nginx/sbin/nginx-sstop# 或 pkill -9 nginx# 现在用 systemctl 启动systemctl start nginx systemctlenablenginx# 设置开机自启# 查看状态systemctl status nginx验证 Echo 模块先修改配置文件添加测试 locationcat/usr/local/nginx/conf/nginx.confEOF worker_processes 1; events { worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; server { listen 80; server_name localhost; location /test { echo Hello, echo module!; } location / { root html; index index.html; } } } EOF重载配置systemctl reload nginx测试访问curlhttp://localhost/test预期输出Hello, echo module!如果看到这行字恭喜你整个源码编译安装 第三方模块集成已成功完成附日常运维命令操作命令检查配置语法/usr/local/nginx/sbin/nginx -t启动systemctl start nginx停止systemctl stop nginx重载配置systemctl reload nginx查看状态systemctl status nginx查看编译参数/usr/local/nginx/sbin/nginx -V查看进程ps -ef | grep nginx查看端口监听netstat -tlnp | grep :80常见问题速查问题现象可能原因解决方法bind() to 0.0.0.0:80 failed (98: Address already in use)80端口被其他进程占用用netstat -tlnp | grep :80找到 PIDkill -9 PID或pkill -9 nginxnginx: [emerg] unknown directive echo未正确编译 echo 模块重新执行./configure --add-module...然后make clean make make installinvalid PID number in nginx.pidNginx 从未启动或 pid 文件丢失先删除 pid 文件rm -f /usr/local/nginx/logs/nginx.pid再启动systemctl start nginx修改配置后不生效未重载配置执行systemctl reload nginx或/usr/local/nginx/sbin/nginx -s reload笔记结束。这份内容覆盖了从环境准备到最终验证的全流程你可以把它保存成.txt或.md文件以后只要照着复制粘贴就能完成部署。