Java扩展Nginx之二：编译nginx-clojure源码

欢迎访问我的GitHub

这里分类和汇总了欣宸的全部原创(含配套源码)：https://github.com/zq2599/blog_demos

为什么要编译nginx-clojure源码

• 作为《Java扩展Nginx》的第二篇，本想与大家一起开始nginx-clojure的深度之旅，但有个问题若不解决，会让大多数有兴趣的读者立即止步、关闭网页、再也不见
  
• 前文咱们使用的是nginx-clojure官方的安装包，这是个编译好的nginx可执行文件，开箱即用，当时我们还用命令查看过nginx版本是1.18.0，如下图：
  
  
• 直接使用nginx-clojure官方编译好的安装包，虽然好处是简单省事儿，但同样带来一些致命问题，导致咱们不敢将其用于生产环境，其实相信聪明的您已经想到了：
  

• 如果nginx1.18.0被曝出有安全问题，需要升级到更高版本，咋办？寄希望于nginx-clojure官方推出更高nginx版本的包吗？
  
• 如果说问题1可以通过等待来解决，那么，假设咱们的nginx不仅需要nginx-clojure能力，还需要集成其他第三方或者自研模块，那又该如何呢？
  

• 所以，nginx-clojure提供的安装包，只能作为一个学习工具，帮助咱们熟悉nginx-clojure技术框架，或者在开发的时候用到，至于生产环境就不适合了
  
• 此刻，经验丰富的您一定看出了欣宸的套路：啰啰嗦嗦、拐弯抹角扯了这么多，可以给出解决方案了吧，嗯嗯，既要用上nginx-clojure，又要避免上述两个致命问题，最合适的方案应该是：下载nginx和nginx-clojure的源码，自行编译和安装
  

本篇概览

• 本篇的主题十分明确，就是编译源码和安装，所以整体上由以下几部分组成：
  

• 准备环境
  
• 编译安装操作
  
• 验证功能
  

• 本次实战，所用nginx源码的版本是1.21.6，nginx-clojure源码的版本是0.5.2
  
• 整个编译和验证的过程，由以下步骤组成：
  
  
• 不说废话，直接开始动手
  

准备环境

• 建议准备一个纯净的linux环境用来实战，我这里是租用的腾讯云轻应用服务器，安装了CentOS7.6，话说这轻应用服务器还真的方便，价格便宜，重装系统也很简单，如下图：
  
  
• 为了省事儿，全程使用root账号
  
• 远程连接腾讯云服务的客户端工具是FinalShell-3.9.2.2
  

安装jdk

• nginx-clojure的源码中有java文件，因此要准备好JDK用于编译
  
• 去oracle官网下载jdk安装包，例如jdk-8u291-linux-x64.tar.gz，将其上传到linux服务器
  
• 解压，移动到指定目录：
  

1. tar -zxvf jdk-8u291-linux-x64.tar.gz \
2. && mkdir -p /usr/lib/jvm/ \
3. && mv jdk1.8.0_291 /usr/lib/jvm/

复制代码

• 打开.bashrc，在尾部增加以下内容：
  

1. export JAVA_HOME=/usr/lib/jvm/jdk1.8.0_291
2. export JRE_HOME=${JAVA_HOME}/jre
3. export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib
4. export PATH=${JAVA_HOME}/bin:$PATH

复制代码

• 执行source .bashrc使得配置生效
  
• 检查是否安装成功，如下：
  

1. [root@VM-20-17-centos ~]# java -version
2. java version "1.8.0_291"
3. Java(TM) SE Runtime Environment (build 1.8.0_291-b10)
4. Java HotSpot(TM) 64-Bit Server VM (build 25.291-b10, mixed mode)

复制代码

准备编译nginx所需的应用

• 更新yum：
  

1. yum update -y

复制代码

• 安装必要的应用：
  

1. yum install -y epel-release \
2. vim \
3. net-tools \
4. bridge-utils \
5. firewalld \
6. bc \
7. iotop \
8. bc \
9. gcc \
10. gcc-c++ \
11. glibc \
12. glibc-devel \
13. pcre \
14. pcre-devel \
15. openssl \
16. openssl-devel \
17. zip \
18. unzip \
19. zlib-devel \
20. lrzsz \
21. tree \
22. ntpdate \
23. telnet \
24. lsof \
25. tcpdump \
26. wget \
27. libevent \
28. libevent-devel \
29. systemd-devel \
30. bash-completion \
31. traceroute \
32. psmisc

复制代码

安装lein

• lein是编译nginx-clojure源码时用到的工具
  
  
• 安装步骤如下：
  

1. curl -o /usr/bin/lein https://raw.githubusercontent.com/technomancy/leiningen/stable/bin/lein \
2. && chmod a+x /usr/bin/lein \
3. && lein

复制代码

• 实测在腾讯云服务器上执行上述命令，可能出现连接超时的错误(Failed to download https://github.com/technomancy/leiningen/releases/download/2.9.8/leiningen-2.9.8-standalone.jar
  )，若遇到此类错误，请重试几次，即可成功
  
• 下载的过程有点耗时，就看您的网络状况了：
  
  
• 执行lein -version，控制台输出如下，表示lein安装成功：
  

1. [root@VM-20-17-centos ~]# lein -version
2. WARNING: You have $CLASSPATH set, probably by accident.
3. It is strongly recommended to unset this before proceeding.
4. Leiningen 2.9.8 on Java 1.8.0_291 Java HotSpot(TM) 64-Bit Server VM

复制代码

下载nginx和nginx-clojure源码

• 用一行命令搞定下载nginx和nginx-clojure源码的压缩包，并将它们分别解压，然后删除压缩包：
  

1. cd ~ \
2. && curl -O http://nginx.org/download/nginx-1.21.6.tar.gz \
3. && curl -o nginx-clojure-0.5.2.zip https://codeload.github.com/nginx-clojure/nginx-clojure/zip/refs/tags/v0.5.2 \
4. && tar -zxvf nginx-1.21.6.tar.gz \
5. && unzip nginx-clojure-0.5.2.zip \
6. && rm -f nginx-1.21.6.tar.gz nginx-clojure-0.5.2.zip

复制代码

• 此刻新增了两个文件夹，它们的完整路径分别是/root/nginx-1.21.6和/root/nginx-clojure-0.5.2，前者是nginx源码，后者是nginx-clojure模块的源码
  

编译和安装nginx

• 执行以下命令，完成配置、编译、安装，注意add-module参数，里面指定了nginx-clojure模块的源码位置：
  

1. cd ~/nginx-1.21.6 \
2. && ./configure  \
3. --prefix=/usr/local/nginx  \
4. --sbin-path=/usr/local/nginx/sbin/nginx \
5. --conf-path=/usr/local/nginx/conf/nginx.conf \
6. --error-log-path=/var/log/nginx/error.log  \
7. --http-log-path=/var/log/nginx/access.log  \
8. --pid-path=/var/run/nginx/nginx.pid \
9. --lock-path=/var/lock/nginx.lock  \
10. --user=nginx --group=nginx \
11. --with-http_ssl_module \
12. --with-http_stub_status_module \
13. --with-http_gzip_static_module \
14. --http-client-body-temp-path=/var/tmp/nginx/client/ \
15. --http-proxy-temp-path=/var/tmp/nginx/proxy/ \
16. --http-fastcgi-temp-path=/var/tmp/nginx/fcgi/ \
17. --http-uwsgi-temp-path=/var/tmp/nginx/uwsgi \
18. --http-scgi-temp-path=/var/tmp/nginx/scgi \
19. --with-pcre \
20. --add-module=/root/nginx-clojure-0.5.2/src/c \
21. && make \
22. && make install

复制代码

• 还要增加名为nginx的用户组和用户：
  

1. groupadd nginx && useradd -d /home/nginx -g nginx -m nginx

复制代码

• 创建必要的文件夹：
  

1. mkdir -p /var/tmp/nginx/client

复制代码

• 此时nginx已经安装好了，验证一下：
  

1. [root@VM-20-17-centos ~]# /usr/local/nginx/sbin/nginx -version
2. nginx version: nginx/1.21.6

复制代码

编译nginx-clojure的jar包

• 二进制的nginx编译已经完成，还需要nginx-clojure模块的源码，得到的jar在运行时要用，执行以下命令：
  

1. cd ~/nginx-clojure-0.5.2 \
2. && lein jar

复制代码

• 编译构建成功后，将得到的jar文件放入新建的目录/usr/local/nginx/jars：
  

1. mkdir /usr/local/nginx/jars \
2. && mv ~/nginx-clojure-0.5.2/target/nginx-clojure-0.5.2.jar /usr/local/nginx/jars/

复制代码

安装clojure的jar包

• nginx-clojure在运行的时候还要用到clojure-1.7.0.jar，我将其放在自己的GitHub仓库了，下载并放入新建的目录/usr/local/nginx/libs：
  

1. mkdir /usr/local/nginx/libs \
2. && curl -o /usr/local/nginx/libs/clojure-1.7.0.jar https://raw.githubusercontent.com/zq2599/blog_download_files/master/files/clojure-1.7.0.jar

复制代码

• 至此，完整的nginx和nginx-clojure已经安装完成，接下来验证是否可用
  

验证

• 既然是验证nginx-clojure是否可用，简简单单就好，就用前文的Hello World功能吧
  
• 前文的jar包，我已经上传到GitHub上，下载到/usr/local/nginx/jars/目录下：
  

1. curl -o /usr/local/nginx/jars/simple-hello-1.0-SNAPSHOT.jar https://raw.githubusercontent.com/zq2599/blog_download_files/master/files/simple-hello-1.0-SNAPSHOT.jar

复制代码

• 还要修改/usr/local/nginx/conf/nginx.conf，先在http的配置中增加以下两行：
  

1.   jvm_path auto;
2.   jvm_classpath "/usr/local/nginx/libs/*:/usr/local/nginx/jars/*";

复制代码

• 然后在server的配置中增加一个location：
  

1. location /java {
2.   content_handler_type 'java';
3.   content_handler_name 'com.bolingcavalry.simplehello.HelloHandler';
4. }

复制代码

• 完整的/usr/local/nginx/conf/nginx.conf内容如下：
  

1. #user  nobody;
2. worker_processes  1;
4. #error_log  logs/error.log;
5. #error_log  logs/error.log  notice;
6. #error_log  logs/error.log  info;
8. #pid        logs/nginx.pid;
10. events {
11.     worker_connections  1024;
12. }
14. http {
15.     include       mime.types;
16.     default_type  application/octet-stream;
18.     #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
19.     #                  '$status $body_bytes_sent "$http_referer" '
20.     #                  '"$http_user_agent" "$http_x_forwarded_for"';
22.     #access_log  logs/access.log  main;
24.     sendfile        on;
25.     #tcp_nopush     on;
27.     #keepalive_timeout  0;
28.     keepalive_timeout  65;
30.     #gzip  on;
31.     jvm_path auto;
32.     jvm_classpath "/usr/local/nginx/libs/*:/usr/local/nginx/jars/*";
34.     server {
35.         listen       80;
36.         server_name  localhost;
38.         #charset koi8-r;
40.         #access_log  logs/host.access.log  main;
42.         location / {
43.             root   html;
44.             index  index.html index.htm;
45.         }
47.         location /java {
48.          content_handler_type 'java';
49.          content_handler_name 'com.bolingcavalry.simplehello.HelloHandler';
50.        }
52.         #error_page  404              /404.html;
54.         # redirect server error pages to the static page /50x.html
55.         #
56.         error_page   500 502 503 504  /50x.html;
57.         location = /50x.html {
58.             root   html;
59.         }
61.         # proxy the PHP scripts to Apache listening on 127.0.0.1:80
62.         #
63.         #location ~ \.php$ {
64.         #    proxy_pass   http://127.0.0.1;
65.         #}
67.         # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
68.         #
69.         #location ~ \.php$ {
70.         #    root           html;
71.         #    fastcgi_pass   127.0.0.1:9000;
72.         #    fastcgi_index  index.php;
73.         #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
74.         #    include        fastcgi_params;
75.         #}
77.         # deny access to .htaccess files, if Apache's document root
78.         # concurs with nginx's one
79.         #
80.         #location ~ /\.ht {
81.         #    deny  all;
82.         #}
83.     }
85.     # another virtual host using mix of IP-, name-, and port-based configuration
86.     #
87.     #server {
88.     #    listen       8000;
89.     #    listen       somename:8080;
90.     #    server_name  somename  alias  another.alias;
92.     #    location / {
93.     #        root   html;
94.     #        index  index.html index.htm;
95.     #    }
96.     #}
98.     # HTTPS server
99.     #
100.     #server {
101.     #    listen       443 ssl;
102.     #    server_name  localhost;
104.     #    ssl_certificate      cert.pem;
105.     #    ssl_certificate_key  cert.key;
107.     #    ssl_session_cache    shared:SSL:1m;
108.     #    ssl_session_timeout  5m;
110.     #    ssl_ciphers  HIGH:!aNULL:!MD5;
111.     #    ssl_prefer_server_ciphers  on;
113.     #    location / {
114.     #        root   html;
115.     #        index  index.html index.htm;
116.     #    }
117.     #}
118. }

复制代码

• 启动nginx，命令是/usr/local/nginx/sbin/nginx
  
• 直接在服务器上用curl命令验证，命令是curl 127.0.0.1/java，响应如下图红框，可见服务正常，咱们写的java类被正常调用并且返回了预期的内容：
  
  
• 至此，nginx和nginx-clojure的源码编译以及验证都完成了，既然可以自由的编译源码，那么之前提到的安全、与其他模块共存的问题也就得以解决，接下来，咱们会深入研究nginx-clojure，以便更好的扩展nginx为实际项目所用。
  

欢迎关注博客园：程序员欣宸

学习路上，你不孤单，欣宸原创一路相伴...

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！