你好,我是赵兴晨,97年文科程序员。
你使用过Nginx的第三方模块吗?今天咱们来聊聊Nginx的第三方模块。
在深入了解Nginx的高性能与灵活性的过程中,我们不可避免地会接触到第三方模块。
这些模块是对Nginx原生功能的有力扩展,它们通常需要再编译安装Nginx时通过 --add-module=PATH 参数指定第三方模块的路径来集成。
一些模块由企业开发者针对特定业务需求定制开发,而另一些则是由开源社区的爱好者们精心打造并分享至GItHUb的成果。
第三方模块的集成与编译
以开源的echo模块为例,该模块位于 https://github.com/openresty/echo-nginx-module。以下是一段示例配置,展示如何在Nginx配置文件中使用echo模块:
location /main {index index.html;default_type text/html;echo "hello world,main-->";echo $remote_addr;echo_reset_timer; # 重置计时器开始时间为当前时间echo_location /sub1;echo_location /sub2;echo "took $echo_timer_elapsed sec for total.";
}location /sub1 {echo_sleep 1;echo sub1;
}location /sub2 {echo_sleep 1;echo sub2;
}
然而,在尝试配置时,我遇到了一个错误
nginx: [emerg] unknown directive "echo_reset_timer" in /apps/nginx/conf/conf.d/pc.conf:86
nginx: configuration file /apps/nginx/conf/nginx.conf test failed
这个错误表明Nginx配置文件中包含一个无法识别的指令echo_reset_timer。
Nginx在解析配置文件时无法识别这个指令,因此报错,并且测试配置文件失败。
需要安装echo模块去解决。以下是安装步骤:
1、确保git已安装,并且克隆echo模块的源代码到本地
2、在Nginx源码目录下使用./configure命令来配置Nginx编译选项,并指定echo模块的路径。
3、重新编译并替换Nginx二进制文件
配置命令如下:
# 安装 git
[root@localhost ~]# yum install -y git# 下载echo模块源码
[root@localhost ~]# git clone https://github.com/openresty/echo-nginx-module.git# 预编译 添加echo模块
[root@localhost ~]# cd nginx-1.20.1
[root@localhost nginx-1.20.1]# ./configure --prefix=/usr/nginx --add-module=/root/echo-nginx-module# 编译Nginx
[root@localhost nginx-1.20.1]# make# 编译好的Nginx在 objs目录,覆盖掉之前的Nginx即可
[root@localhost nginx-1.20.1]# mv objs/nginx /usr/nginx/sbin/# 查看版本和模块
[root@localhost nginx-1.20.1]# /usr/nginx/sbin/nginx -V
nginx version: nginx/1.20.1
configure arguments: --prefix=/usr/nginx --add-module=/root/echo-nginx-module
测试与验证:
重新编译之后,对Nginx进行语法检测并重启Nginx服务
[root@localhost conf]# ../sbin/nginx -t
nginx: the configuration file /usr/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/nginx/conf/nginx.conf test is successful[root@localhost conf]# systemctl restart nginx
通过简单的curl命令,验证配置Nginx第三方echo模块是否生效
[root@localhost conf]# curl 10.0.0.10/main
hello world,main-->
10.0.0.10
sub1
sub2
took 2.008 sec for total.
OK,今天的分享就到这,通过这次实践,我们不仅学会了如何集成和使用Nginx的第三方模块,还加深了对NGINX配置和模块化的理解,感谢你的陪伴,希望这些分享在未来的某一天对你有所启发。让我们期待下一次的相遇,继续在技术的道路上共同成长。