今天有朋友在问我 Nginx 用源码来安装时候有哪些编译的参数,常用的参数有哪些,它们又分别代表什么意思。其实用 ./configure –help 就可以看出来它有哪里编译的参数,不过那个朋友的英文不是很好,OwnLinux 有幸发现一份总结得很好的Nginx 源码编译参数详细列表。同大家分享如下:
以下是来源于 howtocn.org 总结的 Nginx 源码编译参数详细列表
原文地址是: http://howtocn.org/nginx:installoptions
转载时请注明来源于它们,谢谢。
编译时参数
configure 决定系统的特性,以及nginx可以用来处理连接的某些特性和方法,最后它将创建Makefile。
configure 支持以下选项:
–prefix=<path> – 安装路径,如果没有指定,默认为/usr/local/nginx。
–sbin-path=<path> – nginx可执行命令的文件,如果没有指定,默认为<prefix>/sbin/nginx。
–conf-path=<path> – 在没有使用-c参数指定的情况下nginx.conf的默认位置,如果没有指定,默认为<prefix>/conf/nginx.conf。
–pid-path=<path> – nginx.pid的路径,如果没有在nginx.conf中通过“pid”指令指定,默认为<prefix>/logs/nginx.pid。
–lock-path=<path> – nginx.lock文件路径,如果没有指定,默认为<prefix>/logs/nginx.lock。
–error-log-path=<path> – 当没有在nginx.conf中使用“error_log”指令指定时的错误日志位置,如果没有指定,默认为<prefix>/logs/error.log。
–http-log-path=<path> – 当没有在nginx.conf中使用“access_log”指令指定时的访问日志位置,如果没有指定,默认为<prefix>/logs/access.log。
–user=<user> – 当没有在nginx.conf中使用“user”指令指定时nginx运行的用户,如果没有指定,默认为“nobody”。
–group=<group> – 当没有在nginx.conf中使用“user”指令指定时nginx运行的组,如果没有指定,默认为“nobody”。
–builddir=DIR – 设置构建目录。
–with-rtsig_module – 启用rtsig模块。
–with-select_module –without-select_module – 如果在configure的时候没有发现kqueue, epoll, rtsig或/dev/poll其中之一,select模块始终为启用状态。
–with-poll_module –without-poll_module – 如果在configure的时候没有发现kqueue, epoll, rtsig或/dev/poll其中之一,poll模块始终为启用状态。
–with-http_ssl_module – 启用ngx_http_ssl_module,启用SSL支持并且能够处理HTTPS请求。需要OpenSSL,在Debian系统中,对应的包为libssl-dev。
–with-http_realip_module – 启用ngx_http_realip_module
–with-http_addition_module – 启用ngx_http_addition_module
–with-http_sub_module – 启用ngx_http_sub_module
–with-http_dav_module – 启用ngx_http_dav_module
–with-http_flv_module – 启用ngx_http_flv_module
–with-http_stub_status_module – 启用”server status”(服务状态)页
–without-http_charset_module – 禁用ngx_http_charset_module
–without-http_gzip_module – 禁用ngx_http_gzip_module,如果启用,需要zlib包。
–without-http_ssi_module – 禁用ngx_http_ssi_module
–without-http_userid_module – 禁用ngx_http_userid_module
–without-http_access_module – 禁用ngx_http_access_module
–without-http_auth_basic_module – 禁用ngx_http_auth_basic_module
–without-http_autoindex_module – 禁用ngx_http_autoindex_module
–without-http_geo_module – 禁用ngx_http_geo_module
–without-http_map_module – 禁用ngx_http_map_module
–without-http_referer_module – 禁用ngx_http_referer_module
–without-http_rewrite_module – 禁用ngx_http_rewrite_module。如果启用,需要PCRE包。
–without-http_proxy_module – 禁用ngx_http_proxy_module
–without-http_fastcgi_module – 禁用ngx_http_fastcgi_module
–without-http_memcached_module – 禁用ngx_http_memcached_module
–without-http_limit_zone_module – 禁用ngx_http_limit_zone_module
–without-http_empty_gif_module – 禁用ngx_http_empty_gif_module
–without-http_browser_module – 禁用ngx_http_browser_module
–without-http_upstream_ip_hash_module – 禁用ngx_http_upstream_ip_hash_module
–with-http_perl_module – 启用ngx_http_perl_module
–with-perl_modules_path=PATH – 为perl模块设置路径
–with-perl=PATH – 为perl库设置路径
–http-client-body-temp-path=PATH – 为http连接的请求实体临时文件设置路径,如果没有指定,默认为<prefix>/client_body_temp
–http-proxy-temp-path=PATH – 为http代理临时文件设置路径,如果没有指定,默认为<prefix>/proxy_temp
–http-fastcgi-temp-path=PATH - 为http fastcgi临时文件设置路径,如果没有指定,默认为<prefix>/fastcgi_temp
–without-http – 禁用HTTP服务
–with-mail – 启用IMAP4/POP3
–with-mail_ssl_module – 启用ngx_mail_ssl_module
–with-cc=PATH – 设置C编译器路径
–with-cpp=PATH – 设置C预处理器路径
–with-cc-opt=OPTIONS – 变量CFLAGS中附加的参数,用于FreeBSD中的PCRE库,同样需要指定–with-cc-opt=”-I /usr/local/include”,如果我们使用select()函数则需要同时增加文件描述符数量,可以通过–with-cc-opt=”-D FD_SETSIZE=2048”指定。
–with-ld-opt=OPTIONS – 通过连接器的附加参数,用于FreeBSD中的PCRE库,同样需要指定–with-ld-opt=”-L /usr/local/lib”。
–with-cpu-opt=CPU – 指定编译的CPU,可用的值为: pentium, pentiumpro, pentium3, pentium4, athlon, opteron, amd64, sparc32, sparc64, ppc64
–without-pcre – 禁用PCRE库文件,同时将禁用HTTP rewrite 模块,如果要在”location”指令中使用正则表达式,同样需要PCRE库。
–with-pcre=DIR – 设置PCRE库源文件路径。
–with-pcre-opt=OPTIONS – 在编译时为PCRE设置附加参数。
–with-md5=DIR – 设置md5库源文件路径。
–with-md5-opt=OPTIONS – 在编译时为md5设置附加参数。
–with-md5-asm – 使用md5汇编源。
–with-sha1=DIR – 设置sha1库源文件路径。
–with-sha1-opt=OPTIONS – 在编译时为sha1设置附加参数。
–with-sha1-asm – 使用sha1汇编源。
–with-zlib=DIR – 设置zlib库源文件路径。
–with-zlib-opt=OPTIONS – 在编译时为zlib设置附加参数。
–with-zlib-asm=CPU – 为指定的CPU使用zlib汇编源进行优化,可用值为: pentium, pentiumpro。
–with-openssl=DIR – 设置openssl库源文件路径。
–with-openssl-opt=OPTIONS – 在编译时为openssl设置附加参数。
–with-debug – 启用debug记录。
–add-module=PATH – 增加一个在PATH中的第三方模块。
编译参数可能会根据版本的不同进行变化,可以使用./configure –help 查看编译参数列表。
示例
示例1
./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
示例2
./configure / --conf-path=/etc/nginx/nginx.conf / --error-log-path=/var/log/nginx/error.log / --pid-path=/var/run/nginx.pid / --lock-path=/var/lock/nginx.lock / --http-log-path=/var/log/nginx/access.log / --with-http_dav_module / --http-client-body-temp-path=/var/lib/nginx/body / --with-http_ssl_module / --http-proxy-temp-path=/var/lib/nginx/proxy / --with-http_stub_status_module / --http-fastcgi-temp-path=/var/lib/nginx/fastcgi / --with-debug / --with-http_flv_module
示例3
用于基于RedHat的系统(RHEL, CentOS, Fedora)。
首先,安装依赖包:
yum install gcc openssl-devel pcre-devel zlib-devel
然后运行configure:
./configure /
--prefix=/usr /
--sbin-path=/usr/sbin/nginx /
--conf-path=/etc/nginx/nginx.conf /
--error-log-path=/var/log/nginx/error.log /
--pid-path=/var/run/nginx/nginx.pid /
--lock-path=/var/lock/nginx.lock /
--user=nginx /
--group=nginx /
--with-http_ssl_module /
--with-http_flv_module /
--with-http_gzip_static_module /
--http-log-path=/var/log/nginx/access.log /
--http-client-body-temp-path=/var/tmp/nginx/client/ /
--http-proxy-temp-path=/var/tmp/nginx/proxy/ /
--http-fastcgi-temp-path=/var/tmp/nginx/fcgi/
最后编译并安装:
make && make install