编译时使用 configure
命令进行配置。它定义了系统的各个方面,包括了 nginx 进行连接处理使用的方法。最终它会创建出一个 Makefile
。configure
命令支持以下参数:
-
--prefix=path
定义一个用于保留服务器文件的目录。此目录也将用于所有通过
configure
设置的相对路径(除了库源码路径外)和nginx.conf
配置文件。默认设置为/usr/local/nginx
目录。 -
--sbin-path=path
设置 nginx 可执行文件的名称。此名称仅在安装过程中使用。默认情况下,文件名为
prefix/sbin/nginx
。 -
--conf-path=path
设置
nginx.conf
配置文件的名称。如果需要,nginx 可以使用不同的配置文件启动,方法是使用命令行参数-c
指定文件。默认情况下,文件名为prefix/conf/nginx.conf
。 -
--pid-path=path
设置存储主进程的进程 ID 的 nginx.pid 文件名称。安装后,可以在
nginx.conf
配置文件中使用 pid 指令更改文件名。默认文件名为prefix/logs/nginx.pid
。 -
--lock-path=path
设置锁文件的名称前缀。安装后,可以在
nginx.conf
配置文件中使用 lock_file 指令更改对应的值。默认值为prefix/logs/nginx.lock
。 -
--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
。 -
--build=name
设置一个可选的 nginx 构建名称
-
--user=name
设置一个非特权用户名称,其凭据将由工作进程使用。安装后,可以在
nginx.conf
配置文件中使用 user 指令更改名称。默认的用户名为nobody
。 -
--group=name
设置一个组的名称,其凭据将由工作进程使用。安装后,可以在
nginx.conf
配置文件中使用 user 指令更改名称。默认情况下,组名称设置为一个非特权用户的名称。 -
--with-select_module 和 --without-select_module
启用或禁用构建允许服务器使用
select()
方法的模块。如果平台不支持其他更合适的方法(如 kqueue、epoll 或 /dev/poll),则将自动构建该模块。 -
--with-poll_module 和 --without-poll_module
启用或禁用构建允许服务器使用
poll()
方法的模块。如果平台不支持其他更合适的方法(如 kqueue、epoll 或 /dev/poll),则将自动构建该模块。 -
--without-http_gzip_module
禁用构建 HTTP 服务器响应压缩模块。需要 zlib 库来构建和运行此模块。
-
--without-http_rewrite_module
-
--without-http_proxy_module
禁用构建 HTTP 服务器代理模块。
-
--with-http_ssl_module
启用构建可将 HTTPS 协议支持添加到 HTTP 服务器的模块。默认情况下,此模块参与构建。构建和运行此模块需要 OpenSSL 库支持。
-
--with-pcre=path
设置 PCRE 库的源路径。发行版(4.4 至 8.40 版本)需要从 PCRE 站点下载并提取。其余工作由 nginx 的
./configure
和make
完成。该库是 location 指令和 ngx_http_rewrite_module 模块中正则表达式支持所必需的。 -
--with-pcre-jit
使用“即时编译(just-in-time compilation)”支持(1.1.12版本的 pcre_jit 指令)构建 PCRE 库。
-
--with-zlib=path
设置 zlib 库的源路径。发行版(1.1.3 至 1.2.11 版本)需要从 zlib 站点下载并提取。其余工作由 nginx 的
./configure
和make
完成。该库是 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"`。
参数使用示例:
./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-8.40 \
--with-zlib=../zlib-1.2.11
配置完成之后,使用 make
和 make install
编译和安装 nginx。