歡迎通路我的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伺服器
解壓，移動到指定目錄：

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

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

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

執行source .bashrc使得配置生效
檢查是否安裝成功，如下：

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

準備編譯nginx所需的應用

更新yum：

yum update -y

安裝必要的應用：

yum install -y epel-release \
vim \
net-tools \
bridge-utils \
firewalld \
bc \
iotop \
bc \
gcc \
gcc-c++ \
glibc \
glibc-devel \
pcre \
pcre-devel \
openssl \
openssl-devel \
zip \
unzip \
zlib-devel \
lrzsz \
tree \
ntpdate \
telnet \
lsof \
tcpdump \
wget \
libevent \
libevent-devel \
systemd-devel \
bash-completion \
traceroute \
psmisc

安裝lein

lein是編譯nginx-clojure源碼時用到的工具

安裝步驟如下：

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

實測在騰訊雲伺服器上執行上述指令，可能出現連接配接逾時的錯誤(Failed to download https://github.com/technomancy/leiningen/releases/download/2.9.8/leiningen-2.9.8-standalone.jar
)，若遇到此類錯誤，請重試幾次，即可成功
下載下傳的過程有點耗時，就看您的網絡狀況了：

執行lein -version，控制台輸出如下，表示lein安裝成功：

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

下載下傳nginx和nginx-clojure源碼

用一行指令搞定下載下傳nginx和nginx-clojure源碼的壓縮包，并将它們分别解壓，然後删除壓縮包：

cd ~ \
&& curl -O http://nginx.org/download/nginx-1.21.6.tar.gz \
&& curl -o nginx-clojure-0.5.2.zip https://codeload.github.com/nginx-clojure/nginx-clojure/zip/refs/tags/v0.5.2 \
&& tar -zxvf nginx-1.21.6.tar.gz \
&& unzip nginx-clojure-0.5.2.zip \
&& 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子產品的源碼位置：

cd ~/nginx-1.21.6 \
&& ./configure  \
--prefix=/usr/local/nginx  \
--sbin-path=/usr/local/nginx/sbin/nginx \
--conf-path=/usr/local/nginx/conf/nginx.conf \
--error-log-path=/var/log/nginx/error.log  \
--http-log-path=/var/log/nginx/access.log  \
--pid-path=/var/run/nginx/nginx.pid \
--lock-path=/var/lock/nginx.lock  \
--user=nginx --group=nginx \
--with-http_ssl_module \
--with-http_stub_status_module \
--with-http_gzip_static_module \
--http-client-body-temp-path=/var/tmp/nginx/client/ \
--http-proxy-temp-path=/var/tmp/nginx/proxy/ \
--http-fastcgi-temp-path=/var/tmp/nginx/fcgi/ \
--http-uwsgi-temp-path=/var/tmp/nginx/uwsgi \
--http-scgi-temp-path=/var/tmp/nginx/scgi \
--with-pcre \
--add-module=/root/nginx-clojure-0.5.2/src/c \
&& make \
&& make install

還要增加名為nginx的使用者組和使用者：

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

建立必要的檔案夾：

mkdir -p /var/tmp/nginx/client

此時nginx已經安裝好了，驗證一下：

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

編譯nginx-clojure的jar包

二進制的nginx編譯已經完成，還需要nginx-clojure子產品的源碼，得到的jar在運作時要用，執行以下指令：

cd ~/nginx-clojure-0.5.2 \
&& lein jar

編譯建構成功後，将得到的jar檔案放入建立的目錄/usr/local/nginx/jars：

mkdir /usr/local/nginx/jars \
&& 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：

mkdir /usr/local/nginx/libs \
&& 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/目錄下：

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的配置中增加以下兩行：

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

然後在server的配置中增加一個location：

location /java {
  content_handler_type 'java';
  content_handler_name 'com.bolingcavalry.simplehello.HelloHandler';
}

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

#user  nobody;
worker_processes  1;

#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid        logs/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;

    #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
    #                  '$status $body_bytes_sent "$http_referer" '
    #                  '"$http_user_agent" "$http_x_forwarded_for"';

    #access_log  logs/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    #keepalive_timeout  0;
    keepalive_timeout  65;

    #gzip  on;
    jvm_path auto;
    jvm_classpath "/usr/local/nginx/libs/*:/usr/local/nginx/jars/*";

    server {
        listen       80;
        server_name  localhost;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;

        location / {
            root   html;
            index  index.html index.htm;
        }

        location /java {
         content_handler_type 'java';
         content_handler_name 'com.bolingcavalry.simplehello.HelloHandler';
       }

        #error_page  404              /404.html;

        # redirect server error pages to the static page /50x.html
        #
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }

        # proxy the PHP scripts to Apache listening on 127.0.0.1:80
        #
        #location ~ \.php$ {
        #    proxy_pass   http://127.0.0.1;
        #}

        # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
        #
        #location ~ \.php$ {
        #    root           html;
        #    fastcgi_pass   127.0.0.1:9000;
        #    fastcgi_index  index.php;
        #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
        #    include        fastcgi_params;
        #}

        # deny access to .htaccess files, if Apache's document root
        # concurs with nginx's one
        #
        #location ~ /\.ht {
        #    deny  all;
        #}
    }

    # another virtual host using mix of IP-, name-, and port-based configuration
    #
    #server {
    #    listen       8000;
    #    listen       somename:8080;
    #    server_name  somename  alias  another.alias;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}

    # HTTPS server
    #
    #server {
    #    listen       443 ssl;
    #    server_name  localhost;

    #    ssl_certificate      cert.pem;
    #    ssl_certificate_key  cert.key;

    #    ssl_session_cache    shared:SSL:1m;
    #    ssl_session_timeout  5m;

    #    ssl_ciphers  HIGH:!aNULL:!MD5;
    #    ssl_prefer_server_ciphers  on;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}
}

啟動nginx，指令是/usr/local/nginx/sbin/nginx
直接在伺服器上用curl指令驗證，指令是curl 127.0.0.1/java，響應如下圖紅框，可見服務正常，咱們寫的java類被正常調用并且傳回了預期的内容：

至此，nginx和nginx-clojure的源碼編譯以及驗證都完成了，既然可以自由的編譯源碼，那麼之前提到的安全、與其他子產品共存的問題也就得以解決，接下來，咱們會深入研究nginx-clojure，以便更好的擴充nginx為實際項目所用。

歡迎關注頭條号：程式員欣宸

學習路上，你不孤單，欣宸原創一路相伴...

Java擴充Nginx之二：編譯nginx-clojure源碼

歡迎通路我的GitHub

為什麼要編譯nginx-clojure源碼

本篇概覽

準備環境

安裝jdk

準備編譯nginx所需的應用

安裝lein

下載下傳nginx和nginx-clojure源碼

編譯和安裝nginx

編譯nginx-clojure的jar包

安裝clojure的jar包

驗證

歡迎關注頭條号：程式員欣宸

繼續閱讀

nginx虛拟主機配置及負載均衡示例

歡迎使用CSDN-markdown編輯器Nginx配置檔案nginx.conf中文詳解（總結）

雲伺服器部署項目：vue-cli 部署服務配置

win7 localhost 配置 nginx ssl自簽名證書步驟報錯相關連結

（Nginx）03_Nginx原理與優化一、Nginx原理二、master-workers機制三、面試題：

（Nginx）02_Nginx配置執行個體一、Nginx的應用：反向代理實作一：二、反向代理執行個體二：三、Nginx的配置執行個體三–負載均衡：四、Nginx的配置執行個體四–動靜分離：Nginx在實際開發中的應用：

nginx配置示例

niginx的location的location詳細規則和優先級關系以及測試案例2.1比對文法2.2優先級判斷2.3練習3.1處理邏輯如何執行3.2功能測試3.3流程解析

Puppet自動化Nginx+Mongrel負載均衡配置

Ubuntu修改nginx将多個域名分别配置到伺服器不同端口

修改or隐藏nginx版本号

Nginx安全改動：隐藏Nginx版本号背景解決serve_tokens指令參考

版本号隐藏

Nginx服務優化（版本隐藏、版本号僞裝、逾時管理、程序管理、日志分割）Nginx服務優化未完待續

nginx location中斜線的位置的重要性