背景
使用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
的配置路径。
Building nginx from Sources
该文首发《虚怀若谷》个人博客,转载前请务必署名,转载请标明出处。
古之善为道者,微妙玄通,深不可识。夫唯不可识,故强为之容:
豫兮若冬涉川,犹兮若畏四邻,俨兮其若客,涣兮若冰之释,敦兮其若朴,旷兮其若谷,混兮其若浊。
孰能浊以静之徐清?孰能安以动之徐生?
保此道不欲盈。夫唯不盈,故能敝而新成。
请关注我的微信公众号:下雨就像弹钢琴,Thanks♪(・ω・)ノ