Nginx服务实践

--help

帮助

--prefix=PATH

设置安装路径

不指定默认安装到 ： /usr/local/nginx （⭐⭐⭐⭐⭐）

手动指定

--sbin-path=PATH

nginx执行命令路径

Nginx可执行文件安装路径。只能安装时指定，如果没有指定，默认为 /sbin/nginx

手动指定

--modules-path=PATH

动态模块库

定义一个将安装的nginx的的动态模块的目录。情况默认下使用该prefix/modules目录

手动指定

--conf-path=PATH

配置文件路径

设置nginx.conf路径名

手动指定

--error-log-path=PATH

错误日志

设置错误日志路径

手动指定

--pid-path=PATH

pid文件

pid文件路径

手动指定

--lock-path=PATH

锁文件路径

锁文件路径

手动指定

--user=USER

运行的用户

设置nginx运行worker进程的的用户 （⭐⭐⭐⭐⭐）

手动指定

--group=GROUP

运行的组

设置nginx运行worker进程的的组 （⭐⭐⭐⭐⭐）

手动指定

--build=NAME

./configure的临时文件名

configure执行时与编译期间产生的临时文件的文件名

手动指定

--builddir=DIR

临时文件目录

configure执行时与编译期间产生的临时文件放置的目录，包括产生的Makefile、C源文件、目标文件、可执行文件等

手动指定

--with-select_module

事件处理驱动

使用select module处理事件驱动

开启

--without-select_module

select模块

不安装select module

关闭

--with-poll_module

poll模块

使用poll module处理事件驱动 poll的性能与select类似，在大量并发连接下性能都远不如epoll。默认情况下，Nginx是不安装poll

开启

--without-poll_module

poll模块

默认不安装poll module 不需要指定

关闭

--with-threads

线程池

参考:

开启

--with-file-aio

AIO支持

使用AIO方式处理事件驱动 (IO异步大幅度提升性能，需要内核 2.6.22 以上的版本)

开启

--with-http_ssl_module

SSL模块

SSL模块开启（⭐⭐⭐⭐⭐）

开启

--with-http_v2_module

SSL V2版本

enable ngx_http_v2_module 开启https2.0（⭐⭐⭐⭐⭐）

开启

--with-http_realip_module

改变请求头

允许我们改变客户端请求头中客户端IP地址值(例如，X-Real-IP 或 X-Forwarded-For) 在 location 里头插入： set_real_ip_from 192.168.2.1; real_ip_header X-Real-IP;

开启

--with-http_addition_module

响应头追加内容

开启

--with-http_xslt_module=dynamic

创建一个modules的子目录，用来存放动态加载模块共享对象的二进制文件，默认的路径为/usr/local/nginx/modules.

开启

--with-http_image_filter_module

图片处理模块，图片缩放

用法： location ~ /simg/..jpg$ { #proxy_pass http://10.11.11.11; #rewrite "/simg/(..jpg)$" /img/$1 break ; image_filter resize 100 100; error_page 415 = /empty; } 这样访问/simg/目录下的图片，都会按照高度最高100并且宽度最高100按照原图比例进行截取出来，并输出给浏览器。当然也可以开启重写去读取本机另一个目录下源文件；如果不在一台机器上就可以开启proxy_pass，并加上重写即可。 安装此模块需要先安装依赖： yum -y install gd-devel

开启

--with-http_image_filter_module

图像处理过滤模块，开启图片压缩版本必须高于 0.7.54

动态加载图片模块（⭐⭐⭐⭐⭐）

开启

--with-http_geoip_module

解析客户端IP

开启

--with-http_geoip_module=dynamic

解析客户端IP

功能如上，不建议使用

开启

--with-http_sub_module

替换响应

开启

--with-http_dav_module

启用对WebDav协议的支持

允许ngx_http_dav_module模块(mod_dav) 为文件和目录指定权限，限制不同类型的用户对于页面有不同的操作权限

开启

--with-http_flv_module

启动对flv媒体支持

开启

--with-http_mp4_module

启动对MP4媒体支持

开启

--with-http_gunzip_module

压缩

对于不支持gzip编码的客户,该模块用于为客户解压缩预压缩内容

开启

--with-http_gzip_static_module

静态压缩

gzip 压缩为.gz 响应给客户端 案例： location ~* .(json)$ { gzip_static on; gzip_proxied expired no-cache no-store private auth; }

开启

--with-http_random_index_module

随机默认主页

就是用户访问时，给一个随机的主页

开启

--with-http_secure_link_module

下载防盗链

开启

--with-http_degradation_module

内存不足提示

允许当剩余内存较低时对某些位置的请求返回 204 或 404 状态码

开启

--with-http_slice_module

一个分割请求转换成子请求，每个返回一定范围内响应的滤波器。该过滤器提供了更有效的大响应缓存。

开启

--with-http_stub_status_module

运行状态监控

需要编译安装后才可以使用 curl 127.0.0.1/nginx_status 检查状态

开启

--without-http_charset_module

用于对网页重新编码

禁用

--without-http_gzip_module

用于压缩的响应缓冲区 gzip”方法压缩响应的过滤器。这通常有助于将传输数据的大小减少一半甚至更多。

关闭

--without-http_ssi_module

禁用ngx_http_ssi_module支持

禁用ngx_http_ssi_module支持（该模块提供了一个在输入端处理处理服务器包含文件（SSI）的过滤器，目前支持SSI命令的列表是不完整的）

关闭

--without-http_userid_module

启用或禁用设置Cookie并记录收到的Cookie

默认即编译进入Nginx的HTTP模块 实例： userid on; userid_name uid; userid_domain example.com; userid_path /; userid_expires 365d; userid_p3p 'policyref="/w3c/p3p.xml", CP="CUR ADM OUR NOR STA NID"';

关闭

--without-http_access_module

访问控制

location / { deny 192.168.1.1; allow 192.168.1.0/24; allow 10.1.1.0/16; allow 2001:0db8::/32; deny all; }

关闭

--without-http_auth_basic_module

用户认证(默认禁止)

关闭

--without-http_mirror_module

流量镜像

默认禁止该模块

关闭

--without-http_autoindex_module

自动为没有索引页面的目录生成文件列表。

默认禁止

关闭

--without-http_geo_module

禁ngx_http_geo_module

禁用ngx_http_geo_module支持

关闭

--with-http_stub_status_module

启动监控模块(服务状态查看模块)

为监控提供的状态模块

关闭

--with-http_stub_status_module

禁用 ngx_http_charset_module

禁用 ngx_http_charset_module模块

关闭

--without-http_charset_module

模块为响应头的“Content-Type”添加指定的字符集。 此外，这个模块可以把数据从一个字符集转换为另一个字符集，但也有以下限制： 只能单向转换，即从服务端到客户端， 只有单字节字符集能被转换 或者单字节字符集和UTF-8之间的互相转换。

关闭

--without-http_gzip_module

gzip”方法压缩响应的过滤器。这通常有助于将传输数据的大小减少一半甚至更多。

例子： gzip on; gzip_min_length 1000; gzip_proxied expired no-cache no-store private auth; gzip_types text/plain application/xml;

关闭

--without-http_ssi_module

该ngx_http_ssi_module模块是一个过滤器，用于处理通过它传递的响应中的SSI（服务器端包含）命令。目前，支持的SSI命令列表不完整

ssi on; # 开启SSI支持 ssi_silent_errors on; # 默认为off，设置为on则在处理SSI文件出错时不输出错误信息 ssi_types text/html; # 需要支持的shtml 默认是 text/html

关闭

--without-http_userid_module

模块是一个过滤器，用于处理通过它传递的响应中的SSI（服务器端包含）命令。目前，支持的SSI命令列表不完整。

发行用户身份标识cookie。

关闭

--without-http_map_module

为地图提供的

禁用Map模块，该模块允许你声明map区段

关闭

--without-http_split_clients_module

客户端访问用户的划分

ngx_http_split_clients_module支持，该模块用于基于用户ip地址、报头、cookies划分用户。

禁用

--without-http_referer_module

基于RefererHTTP请求头对请求进行过滤。主要用于防盗链

禁用

--without-http_rewrite_module

默认安装，未配置启用

伪静态模块

开启

--without-http_proxy_module

默认安装，未配置启用

默认安装

开启

--without-http_fastcgi_module

默认安装，未配置启用

解析php请求资源 location ~ .php$ { root html; fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name; include fastcgi_params; }

开启

--without-http_uwsgi_module

默认安装，未配置启用

支持uWSGI协议

开启

--without-http_scgi_module

默认安装，未配置启用

支持scgi协议

开启

--without-http_split_clients_module

默认安装，未配置启用

开启

--without-http_referer_module

防盗链

开启

--without-http_rewrite_module

地址重写

用于域名重定向

开启

--without-http_proxy_module

模块允许将请求传递给另一台服务器

用于反向代理

开启

--without-http_grpc_module

URI重写

添加这个参数重写功能会被关闭

--without-http_memcached_module

启用对memcached的支持

--without-http_limit_conn_module

并发连接控制模块

配置启用

不启用

--without-http_limit_req_module

限定客户端创建连接的频率。

配置启用

不启用

--without-http_empty_gif_module

产生单像素透明的gif图片

配置启用

不启用

--without-http_browser_module

解析HTTP请求头中的”User-Agent“ 的值。

配置启用

不启用

--without-http_upstream_hash_module

反向代理： upstream backend { server backend1.example.com weight=5; server backend2.example.com:8080; server unix:/tmp/backend3; server backup1.example.com:8080 backup; server backup2.example.com:8080 backup; } server { location / { proxy_pass http://backend; } }

配置启用

不启用

--without-http_upstream_ip_hash_module

反向代理提供ip hash算法模块

配置启用

不启用

--without-http_upstream_least_conn_module

决定最少连接数被启用

配置启用

不启用

--without-http_upstream_random_module

随机连接负载

配置启用

不启用

--without-http_upstream_keepalive_module

保持上游连接放入缓存 大于keepalive xx; 数值会被关闭

配置启用

不启用

--without-http_upstream_zone_module

配置启用

不启用

--with-http_perl_module

模块用于在Perl中实现位置和变量处理程序，并将Perl调用插入到SSI中。 该模块不是默认生成的，它应该使用--with-http_perl_module配置参数启用

默认不启用配置启用

不启用

--with-perl_modules_path=PATH

默认不启用配置启用

不启用

--with-perl=PATH

perl模块解析

默认不启用配置启用

--http-log-path=PATH

access_log日志格式定义模块 log_format compression '$remote_addr - $remote_user $time_local ' '"$request" $status $bytes_sent ' '"$http_referer" "$http_user_agent" "$gzip_ratio"'; access_log /spool/logs/nginx-access.log compression buffer=32k;

不启用

--http-client-body-temp-path=PATH

设置http客户机请求主体临时文件的路径

如： –http-client-body-temp-path=/opt/websuite/nginx/temp/client

不启用

--http-proxy-temp-path=PATH

这个指令的工作原理类似于client_body_temp_path，它指定一个位置来缓冲对文件系统的大型代理请求。

--http-fastcgi-temp-path=PATH

定义用于存储临时文件的目录，其中包含从FastCGI服务器接收的数据 如：fastcgi_temp_path / spool/nginx/fastcgi_temp 1 2;

不启用

--http-uwsgi-temp-path=PATH

设置的临时文件的目录都放在同一个文件系统上

升级httpv2

不启用

--http-scgi-temp-path=PATH

用于存储从SCGI服务器接收到的数据的临时文件。指定目录下最多可以使用三级子目录层次结构

如：scgi_temp_path /spool/nginx/scgi_temp 1 2;

不启用

--without-http

disable HTTP server

禁用http server功能

不启用

--with-mail

启用POP3、IMAP4、SMTP代理模块

启用邮件代理

不启用

--with-mail=dynamic

启用POP3、IMAP4、SMTP动态代理模块

启用动态邮件代理

不启用

--with-mail_ssl_module

启用邮件SSL

启用邮件SSL

不启用

--without-mail_pop3_module

启用邮件pop3

启用邮件pop3

不启用

--without-mail_imap_module

启用邮件imap

启用邮件imap

不启用

--without-mail_smtp_module

启用邮件smtp

启用邮件smpt

不启用

--with-stream

启用TCP/UDP代理模块

启用TCP/UDP代理模块

不启用

--with-stream=dynamic

启用TCP/UDP动态代理模块

启用TCP/UDP动态代理模块

--with-stream_ssl_module

启用ngx流ssl模块

启用ngx流ssl模块

不启用

--with-stream_realip_module

启用ngx流realip模块

启用ngx流realip模块

不启用

--with-stream_geoip_module

启用ngx流地理ip模块

启用ngx流地理ip模块

不启用

--with-stream_geoip_module=dynamic

启用动态ngx流地理ip模块

启用动态ngx流地理ip模块

不启用

--with-stream_ssl_preread_module

启用ngx流ssl预读模块

启用ngx流ssl预读模块

不启用

--without-stream_limit_conn_module

用于限制每个定义的键连接的数量，尤其是，从一个单一的IP地址的连接的数量。

如：limit_conn_zone $binary_remote_addr zone=addr:10m; server { ... limit_conn addr 1; }

不启用

--without-stream_access_module

允许限制访问某些客户端地址

如： server { . deny 192.168.1.1; allow 192.168.1.0/24; allow 10.1.1.0/16; allow 2001:0db8::/32; deny all; }

不启用

--without-stream_geo_module

创建客户端的源IP地址值的变量。

不启用

--without-stream_map_module

设置size地图变量散列表的最大值

不启用

--without-stream_split_clients_module

分割测试变量 创建一个适合于A / B测试

不启用

--without-stream_return_module

允许发送一个指定的值给客户端，然后关闭连接

server { listen 12345; return $time_iso8601; }

不启用

--without-stream_upstream_hash_module

允许使服务器定期健康检查在一组。服务器组必须驻留在共享内存中, 如果健康检查失败，服务器将被视为不健康。如果为同一组服务器定义了多个运行状况检查，则任何检查的单个故障都会导致相应的服务器被认为不健康。客户端连接不会以“检查”状态传递给不健康的服务器和服务器。

不启用

--without-stream_upstream_least_conn_module

指定组应使用负载平衡方法，其中将连接传递到具有最少活动连接的服务器，同时考虑服务器的权重。如果有多个这样的服务器，则使用加权循环平衡方法依次尝试它们

不启用

--without-stream_upstream_random_module

指定组应使用负载平衡方法，其中将连接传递给随机选择的服务器，同时考虑服务器的权重。

不启用

--with-google_perftools_module

该模块专供nginx开发人员使用

不启用

--add-module=PATH

安装第三方模块

–add-module=/第三方模块目录

不启用

--add-dynamic-module=PATH

需要增加第三方模块，使用参数--add-dynamic-module=即可

不启用

--with-cc=PATH

设置C编译器路径

设置C编译器路径

不启用

--with-cpp=PATH

设置C预处理器路径名

设置C预处理器路径名

不启用

--with-cc-opt=OPTIONS

设置额外的C编译器选项

设置额外的C编译器选项

不启用

--with-ld-opt=OPTIONS

设置其他链接器选项

设置其他链接器选项

不启用

--with-cpu-opt=CPU

为指定的CPU生成有效的值

为特定的 CPU 编译，有效的值包括：pentium, pentiumpro, pentium3, pentium4, athlon, opteron, amd64, sparc32, sparc64, ppc64 要确定CPU类型，可以通过如下命令:： grep "model name" /proc/cpuinfo

不启用

--with-openssl=DIR

设定OpenSSL库文件路径

不指定默认安装

不启用

--with-openssl-opt=OPTIONS

设置OpenSSL库源的路径

为OpenSSL构建设置其他选项

不启用

--with-debug

启用调试日志

启用调试日志

不启用