一、准备工作


为了编译 Nginx 源代码,需要标准的 GCC 编译器。GCC 的全称为 GNU Compiler Collection,其由 GNU 开发,并以 GPL 及 LGPL 许可证发行,是自由的类 UNIX 即苹果电脑 Mac OSX 操作系统的标准编译器。因为 GCC 原本只能处理 C 语言,所以原名为 GNU C 语言编译器,后来得到快速扩展,可处理 C++FortranPascal Objective-CJava 以及 Ada 等其他语言。


除此之外,还需要 Automake 工具,以完成自动创建 Makefile 文件的工作。由于 Nginx 的一些模块需要依赖其他第三方库,通常有 pcre 库(支持 rewrite 模块)、zlib 库(支持 gzip 模块)和 openssl 库(支持 ssl 模块)等。


1.1 安装第三方库


如果已经安装过以上软件,则可以略过;如果没有,可以使用一下命令进行在线安装:


$ yum -y install gcc gcc-c++ automake pcre pcre-devel zlib zlib-devel openssl openssl-devel



二、执行安装


2.1 创建 Nginx 用户


groupadd nginx
useradd nginx -g nginx -s /sbin/nologin -M



2.2 下载解压


Nginx 的下载地址在:http://nginx.org/en/download.html,我们推荐下载 Stable 的稳定版本。

nginx-download.png


$ wget http://nginx.org/download/nginx-1.18.0.tar.gz
$ tar zvxf nginx-1.18.0.tar.gz
$ cd nginx-1.18.0
$ ll
total 752
drwxr-xr-x. 6 root root   4096 Nov 18 10:54 auto
-rw-r--r--. 1 root root 296463 Aug 13 20:51 CHANGES
-rw-r--r--. 1 root root 452171 Aug 13 20:51 CHANGES.ru
drwxr-xr-x. 2 root root    168 Nov 18 10:54 conf
-rwxr-xr-x. 1 root root   2502 Aug 13 20:51 configure
drwxr-xr-x. 4 root root     72 Nov 18 10:54 contrib
drwxr-xr-x. 2 root root     40 Nov 18 10:54 html
-rw-r--r--. 1 root root   1397 Aug 13 20:51 LICENSE
drwxr-xr-x. 2 root root     21 Nov 18 10:54 man
-rw-r--r--. 1 root root     49 Aug 13 20:51 README
drwxr-xr-x. 9 root root     91 Nov 18 10:54 src


这里对解压完成后的部分目录和文件做个简单的介绍:



2.3 编译安装

在介绍生成 Makefile 文件操作之前,先介绍一下 configure 脚本支持的常用选项:

选项

说明

--prefix=path

定义一个目录,存放服务器上的文件 ,也就是nginx的安装目录。默认使用 /usr/local/nginx。

--sbin-path=path

设置nginx的可执行文件的路径,默认为 prefix/sbin/nginx.

--conf-path=path

设置在nginx.conf配置文件的路径。nginx允许使用不同的配置文件启动,通过命令行中的-c选项。默认为prefix/conf/nginx.conf.

--pid-path=path

设置nginx.pid文件,将存储的主进程的进程号。安装完成后,可以随时改变的文件名 , 在nginx.conf配置文件中使用 PID指令。默认情况下,文件名 为prefix/logs/nginx.pid.

--error-log-path=path

设置主错误,警告,和诊断文件的名称。安装完成后,可以随时改变的文件名 ,在nginx.conf配置文件中 使用 的error_log指令。默认情况下,文件名 为prefix/logs/error.log.

--http-log-path=path

设置主请求的HTTP服务器的日志文件的名称。安装完成后,可以随时改变的文件名 ,在nginx.conf配置文件中 使用 的access_log指令。默认情况下,文件名 为prefix/logs/access.log.

--user=name

设置nginx工作进程的用户。安装完成后,可以随时更改的名称在nginx.conf配置文件中 使用的 user指令。默认的用户名是nobody。

--group=name

设置nginx工作进程的用户组。安装完成后,可以随时更改的名称在nginx.conf配置文件中 使用的 user指令。默认的为非特权用户。

--with-select_module

启用或禁用构建一个模块来允许服务器使用select()方法。该模块将自动建立,如果平台不支持的kqueue,epoll,rtsig或/dev/poll。

--without-select_module

--with-poll_module

启用或禁用构建一个模块来允许服务器使用poll()方法。该模块将自动建立,如果平台不支持的kqueue,epoll,rtsig或/dev/poll。

--without-poll_module

--without-http_gzip_module

不编译压缩的HTTP服务器的响应模块。编译并运行此模块需要zlib库。

--without-http_rewrite_module

不编译重写模块。编译并运行此模块需要PCRE库支持。

--without-http_proxy_module

不编译http_proxy模块。

--with-http_ssl_module

使用https协议模块。默认情况下,该模块没有被构建。建立并运行此模块的OpenSSL库是必需的。

--with-pcre=path

设置PCRE库的源码路径。PCRE库的源码(版本4.4 - 8.30)需要从PCRE网站下载并解压。其余的工作是Nginx的./ configure和make来完成。正则表达式使用在location指令和 ngx_http_rewrite_module 模块中。

--with-pcre-jit

编译PCRE包含“just-in-time compilation”(1.1.12中, pcre_jit指令)。

--with-zlib=path

设置的zlib库的源码路径。要下载从 zlib(版本1.1.3 - 1.2.5)的并解压。其余的工作是Nginx的./ configure和make完成。ngx_http_gzip_module模块需要使用zlib 。

--with-cc-opt=parameters

置额外的参数将被添加到CFLAGS变量。例如,当你在FreeBSD上使用PCRE库时需要使用:--with-cc-opt="-I /usr/local/include。.如需要需要增加 select()支持的文件数量:--with-cc-opt="-D FD_SETSIZE=2048".

--with-ld-opt=parameters

设置附加的参数,将用于在链接期间。例如,当在FreeBSD下使用该系统的PCRE库,应指定:--with-ld-opt="-L /usr/local/lib".

了解了如上选项后,就可以根据实际情况使用 configure 脚本生成 Makefile 文件了。若上面的选项无法满足需求,可自行 Google 其他选项,上面介绍的只是其中的一小部分。



2.4 生成Makefile文件


使用下面的命令配置并生成Makefile文件:

$ ./configure --prefix=/data/software/nginx-1.18.0 --with-http_ssl_module
checking for OS
 + Linux 3.10.0-957.el7.x86_64 x86_64
checking for C compiler ... found
 + using GNU C compiler
 + gcc version: 4.8.5 20150623 (Red Hat 4.8.5-39) (GCC)
checking for gcc -pipe switch ... found
checking for -Wl,-E switch ... found
checking for gcc builtin atomic operations ... found
checking for C99 variadic macros ... found
checking for gcc variadic macros ... found
checking for gcc builtin 64 bit byteswap ... found
...
... 这里省略n行
...
checking for zlib library ... found
creating objs/Makefile

Configuration summary
  + using system PCRE library
  + using system OpenSSL library
  + using system zlib library

  nginx path prefix: "/data/software/nginx-1.18.0"
  nginx binary file: "/data/software/nginx-1.18.0/sbin/nginx"
  nginx modules path: "/data/software/nginx-1.18.0/modules"
  nginx configuration prefix: "/data/software/nginx-1.18.0/conf"
  nginx configuration file: "/data/software/nginx-1.18.0/conf/nginx.conf"
  nginx pid file: "/data/software/nginx-1.18.0/logs/nginx.pid"
  nginx error log file: "/data/software/nginx-1.18.0/logs/error.log"
  nginx http access log file: "/data/software/nginx-1.18.0/logs/access.log"
  nginx http client request body temporary files: "client_body_temp"
  nginx http proxy temporary files: "proxy_temp"
  nginx http fastcgi temporary files: "fastcgi_temp"
  nginx http uwsgi temporary files: "uwsgi_temp"
  nginx http scgi temporary files: "scgi_temp"





2.4 编译安装


得到了 Makefile 文件后,就可以编译源码了。

$ make && make install

到此,我们已经安装后了一个最基本的 Nginx 服务器,其安装路径为 /data/software/nginx-1.18.0。



三、启动与测试


3.1 启动


使用下面的命令启动 nginx:

$ ./sbin/nginx


3.2 测试


使用下面的命令执行测试:

$ curl localhost

nginx-curl-localhost.png


若返回类似如上的结果,证明已成功启动。其实,上面返回的是目录/Nginx/html/下的index.html文件,可以使用cat /Nginx/html/index.html命令进行验证。


若是有图形界面,在浏览器访问 localhost 或者你本机的公网 ip,可以看到类似下图的页面:

welcome-to-nginx.png



四、常用命令


附上一些 nginx 的常用命令。

nginx                   # 启动nginx
nginx -s quit   # 快速停止nginx
nginx -V                # 查看版本,以及配置文件地址
nginx -v                # 查看版本
nginx -s reload|reopen|stop|quit   # 重新加载配置|重启|快速停止|安全关闭nginx
nginx -h                # 帮助



五、参考资料


  1. sprinkle_liz,《Centos 7 下编译安装 Nginx》,简书