nginx的编译安装参数


1. 记在前面

  • configure时遇到错误
    nginx在编译安装时,进入其源码解压目录后,使用./configure指令可以带上如下这些参数进行自定义编译安装,如果在编译时遇到错误,一般是相应的依赖软件包没有安装的,可以根据with后的名称,安装相应软件包的devel程序,如--with-http_ssl_module要是报错找不到ssl相关的配置或者文件,可以执行yum install -y openssl-devel,将opensslopenssl-devel及其依赖包安装上,然后再次执行./configure指令一般即可configure成功。

  • with和without
    我个人理解:凡是./configure指令后只能使用without选项的功能或者模块,其默认不明确指定时即为with即启用状态或者支持某功能的状态。
    只能使用with选项的功能或者模块,其默认不指定时即为不支持或者关闭状态。
    对于即可以with又可以without的功能或模块则务必根据需求进行明确指定。

2. nginx的configure参数

下面是nginx源码程序的configure参数:

  • --prefix= 指向安装目录。
  • --sbin-path= 指定执行程序文件存放位置。
  • --modules-path= 指定第三方模块的存放路径。
  • --conf-path= 指定配置文件存放位置。
  • --error-log-path= 指定错误日志存放位置。
  • --pid-path= 指定pid文件存放位置。
  • --lock-path= 指定lock文件存放位置。
  • --user= 指定程序运行时的非特权用户。
  • --group= 指定程序运行时的非特权用户组。
  • --builddir= 指向编译目录。
  • --with-rtsig_module 启用rtsig模块支持。
  • --with-select_module 启用select模块支持,一种轮询处理方式,不推荐在高并发环境中使用,禁用:--without-select_module。
  • --with-poll_module 启用poll模块支持,功能与select相同,不推荐在高并发环境中使用。
  • --with-threads启用thread pool支持。
  • --with-file-aio 启用file aio支持。
  • --with-http_ssl_module 启用https支持。
  • --with-http_v2_module 启用ngx_http_v2_module支持。
  • --with-ipv6 启用ipv6支持。
  • --with-http_realip_module 允许从请求报文头中更改客户端的ip地址,默认为关。
  • --with-http_addition_module 启用ngix_http_additon_mdoule支持(作为一个输出过滤器,分部分响应请求)。
  • --with -http_xslt_module 启用ngx_http_xslt_module支持,过滤转换XML请求 。
  • --with-http_image_filter_mdoule 启用ngx_http_image_filter_module支持,传输JPEG\GIF\PNG图片的一个过滤器,默认不启用,需要安装gd库。
  • --with-http_geoip_module 启用ngx_http_geoip_module支持,用于创建基于MaxMind GeoIP二进制文件相配的客户端IP地址的ngx_http_geoip_module变量。
  • --with-http_sub_module 启用ngx_http_sub_module支持,允许用一些其他文本替换nginx响应中的一些文本。
  • --with-http_dav_module 启用ngx_http_dav_module支持,增加PUT、DELETE、MKCOL创建集合,COPY和MOVE方法,默认为关闭,需要编译开启。
  • --with-http_flv_module 启用ngx_http_flv_module支持,提供寻求内存使用基于时间的偏移量文件。
  • --with-http_mp4_module 启用ngx_http_mp4_module支持,启用对mp4类视频文件的支持。
  • --with-http_gzip_static_module 启用ngx_http_gzip_static_module支持,支持在线实时压缩输出数据流。
  • --with-http_random_index_module 启用ngx_http_random_index_module支持,从目录中随机挑选一个目录索引。
  • --with-http_secure_link_module 启用ngx_http_secure_link_module支持,计算和检查要求所需的安全链接网址。
  • --with-http_degradation_module 启用ngx_http_degradation_module 支持允许在内存不足的情况下返回204或444代码。
  • --with-http_stub_status_module 启用ngx_http_stub_status_module 支持查看nginx的状态页。
  • --without-http_charset_module 禁用ngx_http_charset_module这一模块,可以进行字符集间的转换,从其它字符转换成UTF-8或者从UTF8转换成其它字符。它只能从服务器到客户端方向,只有一个字节的字符可以转换。
  • --without-http_gzip_module 禁用ngx_http_gzip_module支持,同--with-http_gzip_static_module功能一样。
  • --without-http_ssi_module 禁用ngx_http_ssi_module支持,提供了一个在输入端处理服务器包含文件(SSI)的过滤器。
  • --without-http_userid_module 禁用ngx_http_userid_module支持,该模块用来确定客户端后续请求的cookies。
  • --without-http_access_module 禁用ngx_http_access_module支持,提供了基于主机ip地址的访问控制功能。
  • --without-http_auth_basic_module 禁用ngx_http_auth_basic_module支持,可以使用用户名和密码认证的方式来对站点或部分内容进行认证。
  • --without-http_autoindex_module 禁用ngx_http_authindex_module,该模块用于在ngx_http_index_module模块没有找到索引文件时发出请求,用于自动生成目录列表。
  • --without-http_geo_module 禁用ngx_http_geo_module支持,这个模块用于创建依赖于客户端ip的变量。
  • --without-http_map_module 禁用ngx_http_map_module支持,使用任意的键、值 对设置配置变量。
  • --without-http_split_clients_module 禁用ngx_http_split_clients_module支持,该模块用于基于用户ip地址、报头、cookies划分用户。
  • --without-http_referer_module 禁用ngx_http_referer_modlue支持,该模块用来过滤请求,报头中Referer值不正确的请求。
  • --without-http_rewrite_module 禁用ngx_http_rewrite_module支持。该模块允许使用正则表达式改变URI,并且根据变量来转向以及选择配置。如果在server级别设置该选项,那么将在location之前生效,但如果location中还有更进一步的重写规则,location部分的规则依然会被执行。如果这个URI重写是因为location部分的规则造成的,那么location部分会再次被执行作为新的URI,这个循环会被执行10次,最后返回一个500错误。
  • --without-http_proxy_module 禁用ngx_http_proxy_module支持,http代理功能。
  • --without-http_fastcgi_module 禁用ngx_http_fastcgi_module支持,该模块允许nginx与fastcgi进程交互,并通过传递参数来控制fastcgi进程工作。
  • --without-http_uwsgi_module 禁用ngx_http_uwsgi_module支持,该模块用来使用uwsgi协议,uwsgi服务器相关。
  • --without-http_scgi_module 禁用ngx_http_scgi_module支持,类似于fastcgi,也是应用程序与http服务的接口标准。
  • --without-http_memcached_module 禁用ngx_http_memcached支持,用来提供简单的缓存,提高系统效率。
  • --without-http_limit_conn_module 禁用ngx_http_limit_conn_module支持,该模块可以根据条件进行会话的并发连接数进行限制。
  • --without-http_limit_req_module 禁用ngx_limit_req_module支持,该模块可以实现对于一个地址进行请求数量的限制。
  • --without-http_empty_gif_module 禁用ngx_http_empty_gif_module支持,该模块在内存中常驻了一个1*1的透明gif图像,可以被非常快速的调用。
  • --without-http_browser_module 禁用ngx_http_browser_mdoule支持,创建依赖于请求报头的值 。如果浏览器为modern,则$modern_browser等于modern_browser_value的值;如果浏览器为old,则$ancient_browser等于$ancient_browser_value指令分配的值;如果浏览器为MSIE,则$msie等于1。
  • --without-http_upstream_ip_hash_module 禁用ngx_http_upstream_ip_hash_module支持,该模块用于简单的负载均衡。
  • --with-http_perl_module 启用ngx_http_perl_module支持,它使nginx可以直接使用perl或通过ssi调用perl。
  • --with-perl_modules_path= 设定perl模块路径
  • --with-perl= 设定perl库文件路径
  • --http-log-path= 设定access log路径
  • --http-client-body-temp-path= 设定http客户端请求临时文件路径
  • --http-proxy-temp-path= 设定http代理临时文件路径
  • --http-fastcgi-temp-path= 设定http fastcgi临时文件路径
  • --http-uwsgi-temp-path= 设定http scgi临时文件路径
  • --http-scgi-temp-path= 设定http scgi临时文件路径
  • --without-http 禁用http server功能
  • --without-http-cache 禁用http cache功能
  • --with-mail 启用POP3、IMAP4、SMTP代理模块
  • --with-mail_ssl_module 启用ngx_mail_ssl_module支持
  • --without-mail_pop3_module 禁用pop3协议。
  • --without-mail_iamp_module 禁用iamp协议。
  • --without-mail_smtp_module 禁用smtp协议。
  • --with-google_perftools_module 启用ngx_google_perftools_mdoule支持,调试用,可以用来分析程序性能瓶颈。
  • --with-cpp_test_module 启用ngx_cpp_test_module支持。
  • --add-module= 指定外部模块路径,启用对外部模块的支持。
  • --with-cc= 指向C编译器路径。
  • --with-cpp= 指向C预处理路径。
  • --with-cc-opt= 设置C编译器参数,指定--with-cc-opt="-I /usr/lcal/include",如果使用select()函数,还需要同时指定文件描述符数量--with-cc-opt="-D FD_SETSIZE=2048"。 (PCRE库)
  • --with-ld-opt= 设置连接文件参数,需要指定--with-ld-opt="-L /usr/local/lib"。(PCRE库)
  • --with-cpu-opt= 指定编译的CPU类型,如pentium,pentiumpro,...amd64,ppc64...
  • --without-pcre 禁用pcre库。
  • --with-pcre 启用pcre库。
  • --with-pcre= 指向pcre库文件目录。
  • --with-pcre-opt= 在编译时为pcre库设置附加参数 。
  • --with-md5= 指向md5库文件目录。
  • --with-md5-opt= 编译时为md5库设置附加参数。
  • --with-md5-asm 使用md5汇编源。
  • --with-sha1= 指向sha1库文件目录。
  • --with-sha1-opt= 编译时为sha1库设置附加参数。
  • --with-sha1-asm 使用sha1汇编源。
  • --with-zlib= 指向zlib库文件目录。
  • --with-zlib-opt= 在编译时为zlib设置附加参数。
  • --with-zlib-asm= 为指定的CPU使用汇编源进行优化。
  • --with-libatomic 为原子内存的更新操作的实现提供一个架构。
  • --with-libatomic= 指向libatomic_ops的安装目录。
  • --with-openssl= 指向openssl安装目录。
  • --with-openssl-opt= 在编译时为openssl设置附加参数。
  • --with-debug 启用debug日志。

3. 默认with或without的选项

选项(功能) with without 默认
prefix N/A N/A /usr/local/nginx
sbin-path N/A N/A prefix/sbin/nginx
conf-path N/A N/A prefix/conf/nginx.conf
pid-path N/A N/A prefix/logs/nginx.pid
error-log-path N/A N/A prefix/logs/error.log
http-log-path N/A N/A prefix/logs/access.log
user N/A N/A nobody
group N/A N/A nobody
select_module with without 如果平台不支持kqueue,epoll,/dev/poll,它将作为自动选择的事务处理方式
poll_module with without 如果平台不支持kqueue,epoll,/dev/poll,它将作为自动选择的事务处理方式
file_aio with N/A 关闭
ipv6 with N/A 关闭
http_ssl_module with N/A 关闭
http_realip_module with N/A 关闭
http_addition_module with N/A 关闭
http_xslt_module with N/A 关闭
http_image_filter_module with N/A 关闭
http_geoip_module with N/A 关闭
http_sub_module with N/A 关闭
http_dav_module with N/A 关闭
http_flv_module with N/A 关闭
http_gzip_static_module with N/A 关闭
http_random_index_module with N/A 关闭
http_secure_link_module with N/A 关闭
http_degradation_module with N/A 关闭
http_stub_status_module with N/A 关闭
http_charset_module N/A without 启用
http_gzip_module N/A without 启用
http_ssi_module N/A without 启用
http_userid_module N/A without 启用
http_access_module N/A without 启用
http_auth_basic_module N/A without 启用
http_autoindex_module N/A without 启用
http_geo_module N/A without 启用
http_map_module N/A without 启用
http_split_clients_module N/A without 启用
http_referer_module N/A without 启用
http_rewrite_module N/A without 启用
http_proxy_module N/A without 启用
http_fastcgi_module N/A without 启用
http_uwsgi_module N/A without 启用
http_scgi_module N/A without 启用
http_memcached_module N/A without 启用
http_limit_conn_module N/A without 启用
http_limit_req_module N/A without 启用
http_empty_gif_module N/A without 启用
http_brower_module N/A without 启用
http_upstream_ip_hash_module N/A without 启用
http_perl_module with N/A 禁用
http N/A without 启用
http-cache N/A without 启用
mail with N/A 禁用
pcre with without N/A
stream with N/A 禁用
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容