configure
命令用来配置nginx编译环境。 该命令定义了系统各方面功能,包括允许nginx使用的连接处理方式。 其执行结果是生成一个Makefile
文件。 configure
命令支持如下参数:
-
--prefix=
— 定义服务器文件的完整路径,该路径同时也是path
configure
命令设置的 相对路径(除类库源文件外)以及nginx.conf
文件定义的相对路径的基准路径。其默认 值是/usr/local/nginx
。 -
--sbin-path=
— 设置nginx可执行文件的完整路径,该路径仅在安装期间使用, 默认路径为path
。prefix
/sbin/nginx -
--conf-path=
— 设置配置文件path
nginx.conf
的完整路径。如有必要,总是可以 在nginx启动时通过命令行参数-c
指定一个不同的配置文件路径。 默认路径为file
。prefix
/conf/nginx.conf -
--pid-path=
— 设置nginx.pid文件的完整路径,该文件存储了主进程的进程ID。安装完成后, 该路径总是可以在path
nginx.conf
文件中用 pid指令来修改。 默认路径为
。prefix
/logs/nginx.pid -
--error-log-path=
— 设置记录主要错误、警告以及调试信息日志的完整路径。安装完成后, 该路径总是可以在path
nginx.conf
文件中用 error_log 指令来修改。 默认路径为
。prefix
/logs/error.log -
--http-log-path=
— 设置记录HTTP服务器主要请求日志的完整路径。安装完成后, 该路径总是可以在path
nginx.conf
文件用 access_log 指令来修改。 默认路径为prefix
/logs/access.log -
--user=
— 设置工作进程以某非特权用户的身份运行。安装完成后,该用户名总是可以在name
nginx.conf
文件用user指令来修改。 其默认值为nobody。 -
--group=
— 设置工作进程以某非特权用户的身份运行。安装完成后,该用户名总是可以在name
nginx.conf
用user指令来修改。 其默认名称与未授权用户名称相同。 -
--with-select_module
--without-select_module
— 设置是否将select()
方法模块编译进nginx中。如果系统平台不支持kqueue、epoll、rtsig或/dev/poll等更合适的方法, 该模块会被自动编译。 -
--with-poll_module
--without-poll_module
— 设置是否将poll()
方法模块编译进nginx中。如果系统平台不支持kqueue、epoll、rtsig或/dev/poll等更合适的方法, 该模块会被自动编译。 -
--without-http_gzip_module
— 不编译http_gzip_module模块。该模块可以压缩HTTP服务器的响应,该模块需要zlib库才能编译和运行。 -
--without-http_rewrite_module
— 不编译http_rewrite_module模块。该模块允许HTTP服务器重定向请求,改变请求的URI地址 。创建并运行该模块需要PCRE库支持。 -
--without-http_proxy_module
— 不编译HTTP服务器的代理模块。 -
--with-http_ssl_module
— 为HTTP服务器编译HTTPS协议支持的模块。该模块默认是不编译的。它需要OpenSSL库才能编译和运行。 -
--with-pcre=
— 设置PCRE库源文件的路径地址。PCRE库的发行版(version 4.4 — 8.30)需要先从PCRE站点下载并解压缩。 剩下的安装工作由nginx的./configure和make命令来完成。该库应用于location 指令的正则表达式支持以及ngx_http_rewrite_module模块。path
-
--with-pcre-jit
— 编译PCRE库时增加“实时编译(pcre_jit)”支持。 -
--with-zlib=
— 设置zlib库源文件的路径地址。zlib库的发行版(version 1.1.3 — 1.2.5)需要先从zlib站点下载并解压缩。 剩下的安装工作由nginx的./configure和make命令来完成。该库应用于 ngx_http_gzip_module模块。path
-
--with-cc-opt=
— 设置将会添加额外参数到CFLAGS变量中。当在FreeBSD使用系统PCRE库时,需要指定parameters
--with-cc-opt="-I /usr/local/include"
。 如果需要增加select()
方法所支持的文件数量,也可以参照如下方式指定:--with-cc-opt="-D FD_SETSIZE=2048"
。 -
--with-ld-opt=
— 设置将会在链接(linking)过程中使用的额外参数。当在FreeBSD使用系统PCRE库时,需要指定parameters
--with-ld-opt="-L /usr/local/lib"
。
以下是参数使用示例(注意不应有换行):
./configure --sbin-path=/usr/local/nginx/nginx --conf-path=/usr/local/nginx/nginx.conf --pid-path=/usr/local/nginx/nginx.pid --with-http_ssl_module --with-pcre=../pcre-4.4 --with-zlib=../zlib-1.1.3