MacOS编译NGINX1.17

背景

使用Mac的开发者大多数的时候通过 brew 命令安装各类软件，比如 PHP、Python、Nodejs，Nginx 也不例外。

默认情况下Nginx安装在/usr/local/Cellar/nginx，通过brew link nginx加软连接到/usr/local/bin/nginx，虽然这样完全满足开发且符合 Mac 软件的管理，但是却不方便移植（比如想给不懂开发的用户一键部署部署的应用包，做私有化部署的同学应该对此不陌生）。

从源码编译NGINX程序比安装预编译的安装包要灵活很多，可以添加特定的模块（来自NGINX官方或者第三方的，比如给 Fastdfs 提供 HTTP 访问文件能力的 fastdfs-nginx 模块），当然自己编译源码拉取的可以是已修复 bug 和新增特性的最新分支。

编译

依赖

• PCRE——支持正则表达式。 是 Nginx 的核心和重写模块的所需依赖库。

wget https://ftp.pcre.org/pub/pcre/pcre-8.43.tar.bz2
tar zxf pcre-8.43.tar.bz2

• zlib——支持标头压缩。是 Nginx 的 Gzip 模块所需。

wget http://zlib.net/zlib-1.2.11.tar.gz
tar zxf zlib-1.2.11.tar.gz

• OpenSSL——支持HTTPS协议。是Nginx的SSL模块和其他模块所需。

wget http://www.openssl.org/source/openssl-1.1.1c.tar.gz
tar zxf openssl-1.1.1c.tar.gz

构建NGINX

下载源

wget https://nginx.org/download/nginx-1.17.4.tar.gz
tar zxf nginx-1.17.4.tar.gz 
cd nginx-1.17.4

配置构建选项

NGINX编译配置选项由./configure 设置各种参数，包括源文件和配置文件路径、编译选项、链接处理方法以及模块列表。通过./configure可以创建 Makefile 编译代码和安装 Nginx。

./configure \
--user=nginx \
--group=nginx \
--prefix=./nginx \
--sbin-path=nginx \
--conf-path=nginx.conf \
--pid-path=nginx.pid \
--with-http_ssl_module \
--with-pcre=../pcre-8.43 \
--with-zlib=../zlib-1.2.11 \
--with-openssl=../openssl-1.1.1c

• --prefix=path - 定义一个将保留服务器文件的目录。同样的目录也将用于由 configure 设置的所有相对路径（除了库源的路径）和nginx.conf 配置文件中。它默认设置为/usr/local/nginx目录。

• --sbin-path=path - 设置 nginx 可执行文件的名称。该名称仅在安装期间使用。默认情况下，该文件被命名为${prefix}/sbin/nginx。

• --conf-path=path - 设置 nginx.conf 配置文件的名称。如果需要，通过在命令行参数 -c 文件中指定 nginx的配置文件，nginx 始终可以使用不同的配置文件启动。默认情况下，该文件名为${prefix}/conf/nginx.conf。

• --pid-path=path - 设置将存储主进程的进程ID的 nginx.pid 文件的名称。安装完成后，可以使用 pid 指令始终在 nginx.conf 配置文件中更改文件名。默认情况下，该文件名为 ${prefix}/logs/nginx.pid。

• --error-log-path=path - 设置主要错误，警告和诊断文件的名称。安装完成后，可以使用error_log指令始终在 nginx.conf 配置文件中更改文件名。默认情况下，该文件名为${prefix}/logs/error.log。

• --http-log-path=path - 设置HTTP服务器的主要请求日志文件的名称。安装完成后，可以使用 access_log 指令始终在 nginx.conf 配置文件中更改文件名。默认情况下，该文件被命名为${prefix}/logs/access.log。

• --build=name - 设置一个可选的 nginx 构建名称。

• --user=name - 设置其凭据将被工作进程使用的非特权用户的名称。 安装完成后，可以使用 user 指令始终在 nginx.conf 配置文件中更改该名称。默认的用户名是 nobody。

• --group=name - 设置工作进程将使用其凭据的组的名称。安装完成后，可以使用 user 指令始终在 nginx.conf 配置文件中更改该名称。 默认情况下，组名称设置为非特权用户的名称。

• --with-select_module --without-select_module- 启用或禁用构建允许 Nginx 使用select()方法工作的模块。如果平台可能不支持更合适的方法(例如kqueue，epoll或/dev/poll)，则会自动构建此模块。

• --with-poll_module --without-poll_module - 启用或禁用构建允许 Nginx 使用该poll()方法工作的模块。如果平台似乎不支持更合适的方法（例如kqueue，epoll或/dev/poll），则会自动构建此模块。

• --without-http_gzip_module - 禁用构建压缩HTTP服务器响应的模块。需要zlib库来构建和运行此模块。

• --without-http_rewrite_module - 禁止构建允许HTTP服务器重定向请求并更改请求URI的模块。PCRE库需要构建和运行该模块。

• --without-http_proxy_module - 禁用构建HTTP服务器代理模块。

• --with-http_ssl_module - 可以构建一个将HTTPS协议支持添加到HTTP服务器的模块。该模块不是默认生成的。OpenSSL库是构建和运行该模块所必需的。

• --with-pcre=path - 设置PCRE库源的路径。发行版（版本4.4 - 8.41）需要从PCRE网站下载并提取。该库是location指令和ngx_http_rewrite_module模块支持正则表达式所必需的。

• --with-pcre-jit - 用“即时编译”支持（1.1.12，pcre_jit指令）构建PCRE库。

• --with-zlib=path - 设置zlib库源的路径。库分发（版本1.1.3 - 1.2.11）需要从zlib站点下载并解压缩。该库是ngx_http_gzip_module模块所必需的。

• --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"应该指定。

编译安装

make && make install

最后看到有test相关的数据输出则表示编译成功：

test -d './nginx' || mkdir -p './nginx'
test -d './nginx' \
                || mkdir -p './nginx'
test ! -f './nginx/nginx' \
                || mv './nginx/nginx' \
                        './nginx/nginx.old'
cp objs/nginx './nginx/nginx'
test -d './nginx' \
                || mkdir -p './nginx'
cp conf/koi-win './nginx'
cp conf/koi-utf './nginx'
cp conf/win-utf './nginx'
test -f './nginx/mime.types' \
                || cp conf/mime.types './nginx'
cp conf/mime.types './nginx/mime.types.default'
test -f './nginx/fastcgi_params' \
                || cp conf/fastcgi_params './nginx'
cp conf/fastcgi_params \
                './nginx/fastcgi_params.default'
test -f './nginx/fastcgi.conf' \
                || cp conf/fastcgi.conf './nginx'
cp conf/fastcgi.conf './nginx/fastcgi.conf.default'
test -f './nginx/uwsgi_params' \
                || cp conf/uwsgi_params './nginx'
cp conf/uwsgi_params \
                './nginx/uwsgi_params.default'
test -f './nginx/scgi_params' \
                || cp conf/scgi_params './nginx'
cp conf/scgi_params \
                './nginx/scgi_params.default'
test -f './nginx/nginx.conf' \
                || cp conf/nginx.conf './nginx/nginx.conf'
cp conf/nginx.conf './nginx/nginx.conf.default'
test -d './nginx' \
                || mkdir -p './nginx'
test -d './nginx/logs' \
                || mkdir -p './nginx/logs'
test -d './nginx/html' \
                || cp -R html './nginx'
test -d './nginx/logs' \
                || mkdir -p './nginx/logs'

错误或注意事项

• make 阶段缺少 pcre 错误

make[1]: *** [/usr/local/Cellar/pcre/8.43/lib//Makefile] Error 127

Nginx 高版本的需要使用 pcre 原文件路径，通过--with-pcre=PATH指定 pcre 的源路径即可。

• --prefix指定的是整个编译后输出文件的位置的前缀

如果其他配置项不指定或者其他配置项是相对路径，在编译路径会加上prefix的配置路径。

---

该文首发《虚怀若谷》个人博客，转载前请务必署名，转载请标明出处。

古之善为道者，微妙玄通，深不可识。夫唯不可识，故强为之容：

豫兮若冬涉川，犹兮若畏四邻，俨兮其若客，涣兮若冰之释，敦兮其若朴，旷兮其若谷，混兮其若浊。

孰能浊以静之徐清？孰能安以动之徐生？

保此道不欲盈。夫唯不盈，故能敝而新成。