nginx源码编译

一 准备

软件环境下载

1
yum install -y wget gcc gcc-c++ make pcre pcre-devel zlib zlib-devel openssl openssl-devel

nginx下载

http://nginx.org/download/

二 源码编译

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
[root@k8s-master01 nginx-1.23.1]# ./configure --prefix=/usr/local/nginx --with-http_ssl_module
[root@k8s-master01 nginx-1.23.1]# make && make install
#配置 /usr/local/nginx/sbin到环境变量
[root@k8s-master01 nginx-1.23.1]# cd /usr/local/nginx/
[root@k8s-master01 nginx-1.23.1]# sbin/nginx -c conf/nginx.conf
[root@k8s-master01 nginx]# curl 10.0.0.101
<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
<style>
html { color-scheme: light dark; }
body { width: 35em; margin: 0 auto;
font-family: Tahoma, Verdana, Arial, sans-serif; }
</style>
</head>
<body>
<h1>Welcome to nginx!</h1>
<p>If you see this page, the nginx web server is successfully installed and
working. Further configuration is required.</p>

<p>For online documentation and support please refer to
<a href="http://nginx.org/">nginx.org</a>.<br/>
Commercial support is available at
<a href="http://nginx.com/">nginx.com</a>.</p>

<p><em>Thank you for using nginx.</em></p>
</body>
</html>

预编译参数：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
--add-module=path：启用外部模块。
--add-dynamic-module=path：启用外部动态模块。
--prefix=path ：定义将保留服务器文件的目录。
--sbin-path=path：设置nginx可执行文件的名称。此名称仅在安装期间使用。默认情况下，文件名为 prefix/sbin/nginx。
--modules-path=path：定义将在其中安装nginx动态模块的目录。默认情况下使用prefix/modules目录。
--conf-path=path：设置nginx.conf配置文件的名称。如果需要，可以通过在命令行参数中指定nginx来始终使用其他配置文件来启动它 。默认情况下，文件名为prefix/conf/nginx.conf
--error-log-path=path：设置主要错误，警告和诊断文件的名称及路径。默认情况下，文件名为 prefix/logs/error.log。
--pid-path=path：设置nginx.pid将存储主进程的进程ID 的文件名及路径。默认情况下，文件名为 prefix/logs/nginx.pid。
--lock-path=path：为锁定文件的名称设置前缀。默认情况下，值为 prefix/logs/nginx.lock。
--user=name：设置非特权用户的名称，默认用户名是nobody。（设置所有者）
--group=name：设置工作进程将使用其凭据的组的名称。默认情况下，组名称设置为非特权用户的名称。（所属组 ）
--build=name：设置一个可选的nginx构建名称。
--builddir=path：设置构建目录。
--http-log-path=path：设置HTTP服务器的主请求日志文件的名称。安装后，可以始终nginx.conf使用access_log伪指令在配置文件中 更改文件名 。默认情况下，文件名为 prefix/logs/access.log。
--http-client-body-temp-path=path：定义用于存储包含客户端请求正文的临时文件的目录。安装后，可以始终nginx.conf使用client_body_temp_path 指令在配置文件中 更改目录 。默认情况下，目录名为 prefix/client_body_temp。
--http-proxy-temp-path=path：定义一个目录，用于存储带有从代理服务器接收到的数据的临时文件。安装后，始终可以nginx.conf使用proxy_temp_path 指令在配置文件中 更改目录 。默认情况下，目录名为 prefix/proxy_temp。
--http-fastcgi-temp-path=path：定义一个目录，用于存储包含从FastCGI服务器接收到的数据的临时文件。安装后，可以始终nginx.conf使用fastcgi_temp_path 指令在配置文件中 更改目录 。默认情况下，目录名为 prefix/fastcgi_temp。
--http-uwsgi-temp-path=path：定义一个目录，用于存储包含从uwsgi服务器接收到的数据的临时文件。安装后，始终可以nginx.conf使用uwsgi_temp_path 指令在配置文件中 更改目录 。默认情况下，目录名为 prefix/uwsgi_temp。
--http-scgi-temp-path=path：定义一个目录，用于存储带有从SCGI服务器接收到的数据的临时文件。安装后，可以始终nginx.conf使用scgi_temp_path 指令在配置文件中 更改目录 。默认情况下，目录名为 prefix/scgi_temp。
--with-select_module
--with-threads：启用线程池的使用 。
--with-file-aio：支持 在FreeBSD和Linux上使用 异步文件I / O（AIO）。
--with-http_ssl_module：启用构建将HTTPS协议支持添加 到HTTP服务器的模块的功能。默认情况下未构建此模块。需要OpenSSL库来构建和运行此模块。
--with-http_v2_module：支持构建提供对HTTP / 2支持的模块 。默认情况下未构建此模块。
--with-http_realip_module：启用构建ngx_http_realip_module 模块的功能，该模块将客户端地址更改为在指定的标头字段中发送的地址。默认情况下未构建此模块。
--with-http_addition_module：允许构建ngx_http_addition_module 模块，该模块在响应前后添加文本。默认情况下未构建此模块。
--with-http_xslt_module
--with-http_xslt_module=dynamic：支持构建ngx_http_xslt_module 模块，该 模块使用一个或多个XSLT样式表转换XML响应。默认情况下未构建此模块。该libxml2的和 的libxslt库需要构建和运行此模块。
--with-http_image_filter_module
--with-http_image_filter_module=dynamic：支持构建ngx_http_image_filter_module 模块，该模块可以转换JPEG，GIF，PNG和WebP格式的图像。默认情况下未构建此模块。
--with-http_geoip_module
--with-http_geoip_module=dynamic：支持构建ngx_http_geoip_module 模块，该模块根据客户端IP地址和预编译的MaxMind数据库创建变量 。默认情况下未构建此模块。
--with-http_sub_module：支持构建ngx_http_sub_module 模块，该模块通过将一个指定的字符串替换为另一个指定的字符串来修改响应。默认情况下未构建此模块。
--with-http_dav_module：支持构建ngx_http_dav_module 模块，该模块通过WebDAV协议提供文件管理自动化。默认情况下未构建此模块。
--with-http_flv_module：支持构建ngx_http_flv_module 模块，该模块为Flash Video（FLV）文件提供伪流服务器端支持。默认情况下未构建此模块。
--with-http_mp4_module：支持构建ngx_http_mp4_module 模块，该模块为MP4文件提供伪流服务器端支持。默认情况下未构建此模块。
--with-http_gunzip_module：支持为不支持“ gzip”编码方法的客户端构建ngx_http_gunzip_module 模块，该 模块使用“ Content-Encoding: gzip” 解压缩响应。默认情况下未构建此模块。
--with-http_gzip_static_module：支持构建ngx_http_gzip_static_module 模块，该 模块支持发送.gz扩展名为“ ”的预压缩文件，而不是常规文件。默认情况下未构建此模块。
--with-http_auth_request_module：允许构建ngx_http_auth_request_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模块。默认情况下未构建此模块。
--with-http_slice_module：支持构建ngx_http_slice_module 模块，该 模块将请求拆分为子请求，每个子请求都返回一定范围的响应。该模块提供了更有效的大响应缓存。默认情况下未构建此模块。
--with-http_stub_status_module：支持构建ngx_http_stub_status_module 模块，该 模块提供对基本状态信息的访问。默认情况下未构建此模块。
--with-google_perftools_module：允许构建 ngx_google_perftools_module 模块，以使用Google Performance Tools对nginx工作进程进行 性能分析。该模块供nginx开发人员使用，默认情况下未构建。
--with-cpp_test_module：启用构建 ngx_cpp_test_module模块。
--with-mail
--with-mail=dynamic：启用POP3 / IMAP4 / SMTP 邮件代理服务器。
--with-mail_ssl_module：启用构建将 SSL / TLS协议支持添加 到邮件代理服务器的模块的功能。默认情况下未构建此模块。需要OpenSSL库来构建和运行此模块。
--with-compat：启用动态模块兼容性。
--with-cc=path：设置C编译器的名称。
--with-cpp=path：设置C预处理器的名称。
--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" 应指定。
--with-cpu-opt=cpu：每个指定的CPU能够使建筑： pentium，pentiumpro， pentium3，pentium4， athlon，opteron， sparc32，sparc64， ppc64。
--without-pcre：禁用PCRE库的用法。
--with-pcre：强制使用PCRE库。
--with-pcre=path：设置PCRE库源的路径。需要从PCRE站点下载并分发库分发（版本4.4 — 8.43） 。其余的由nginx的./configure和完成 make。该库对于location指令中的正则表达式支持和 ngx_http_rewrite_module 模块是必需的 。
--with-pcre-opt=parameters：为PCRE设置其他构建选项。
--with-pcre-jit：使用“及时编译”支持（1.1.12，pcre_jit指令）构建PCRE库 。
--with-zlib=path：设置zlib库源的路径。需要从zlib站点下载并分发库发行版（版本1.1.3-1.2.11） 。其余的由nginx的./configure和完成 make。ngx_http_gzip_module模块需要该库 。
--with-zlib-opt=parameters：为zlib设置其他构建选项。
--with-zlib-asm=cpu：使得能够使用指定的CPU中的一个优化的zlib汇编源程序： pentium，pentiumpro。
--with-libatomic：强制使用libatomic_ops库。
--with-libatomic=path：设置libatomic_ops库源的路径。
--with-openssl=path：设置OpenSSL库源的路径。
--with-openssl-opt=parameters：为OpenSSL设置其他构建选项。
--with-debug：启用调试日志。
--with-http_perl_module
--with-http_perl_module=dynamic：支持构建 嵌入式Perl模块。默认情况下未构建此模块。
--with-perl_modules_path=path：定义一个目录，该目录将保留Perl模块。
--with-perl=path：设置Perl二进制文件的名称。
--with-stream
--with-stream=dynamic：支持构建 用于通用TCP / UDP代理和负载平衡的 流模块。默认情况下未构建此模块。
--with-stream_ssl_module：支持构建一个模块，该模块 向流模块添加 SSL / TLS协议支持。默认情况下未构建此模块。需要OpenSSL库来构建和运行此模块。
--with-stream_realip_module：启用构建ngx_stream_realip_module 模块的功能，该 模块将客户端地址更改为PROXY协议标头中发送的地址。默认情况下未构建此模块。
--with-stream_geoip_module
--with-stream_geoip_module=dynamic：支持构建ngx_stream_geoip_module 模块，该 模块根据客户端IP地址和预编译的MaxMind数据库创建变量 。默认情况下未构建此模块。
--with-stream_ssl_preread_module：支持构建ngx_stream_ssl_preread_module 模块，该 模块允许从ClientHello 消息中提取信息， 而无需终止SSL / TLS。默认情况下未构建此模块。
--without-select_module：启用或禁用构建允许服务器使用该select()方法的模块。如果平台似乎不支持更合适的方法（例如kqueue，epoll或/ dev / poll），则会自动构建此模块。
--with-poll_module
--without-poll_module：启用或禁用构建允许服务器使用该poll()方法的模块。如果平台似乎不支持更合适的方法（例如kqueue，epoll或/ dev / poll），则会自动构建此模块。
--without-http_charset_module：禁用构建ngx_http_charset_module 模块，该 模块将指定的字符集添加到“ Content-Type”响应标头字段中，并且可以将数据从一个字符集转换为另一个字符集。
--without-http_gzip_module：禁用构建可压缩 HTTP服务器响应的模块。zlib库是构建和运行此模块所必需的。
--without-http_ssi_module：禁用构建处理通过SSI（服务器端包含）命令的 ngx_http_ssi_module模块的响应。
--without-http_userid_module：禁用构建ngx_http_userid_module 模块，该模块设置适合客户端标识的cookie。
--without-http_access_module：禁用构建ngx_http_access_module 模块，该 模块允许限制对某些客户端地址的访问。
--without-http_auth_basic_module：禁用构建ngx_http_auth_basic_module 模块，该 模块允许通过使用“ HTTP基本身份验证”协议验证用户名和密码来限制对资源的访问。
--without-http_mirror_module：禁用构建ngx_http_mirror_module 模块，该 模块通过创建后台镜像子请求来实现原始请求的镜像。
--without-http_autoindex_module：禁用构建 ngx_http_autoindex_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 模块，该 模块创建用于A / B测试的变量。
--without-http_referer_module：禁用构建ngx_http_referer_module 模块，该 模块可以阻止对“ Referer”标头字段中具有无效值的请求的站点访问。
--without-http_rewrite_module：禁用构建允许HTTP服务器 重定向请求和更改请求URI的模块。构建和运行此模块需要PCRE库。
--without-http_proxy_module：禁用构建HTTP服务器 代理模块。
--without-http_fastcgi_module：禁用构建将请求传递到FastCGI服务器的 ngx_http_fastcgi_module模块。
--without-http_uwsgi_module：禁用构建 将请求传递到uwsgi服务器的 ngx_http_uwsgi_module模块。
--without-http_scgi_module：禁用构建 将请求传递到SCGI服务器的 ngx_http_scgi_module模块。
--without-http_grpc_module：禁用构建 将请求传递到gRPC服务器的 ngx_http_grpc_module模块。
--without-http_memcached_module：禁用构建ngx_http_memcached_module 模块，该 模块从memcached服务器获取响应。
--without-http_limit_conn_module：禁用构建ngx_http_limit_conn_module 模块，该 模块限制每个键的连接数，例如，单个IP地址的连接数。
--without-http_limit_req_module：禁用构建ngx_http_limit_req_module 模块，该模块限制每个密钥的请求处理速率，例如，来自单个IP地址的请求的处理速率。
--without-http_empty_gif_module：禁用构建发出单像素透明GIF的模块 。
--without-http_browser_module：禁用构建ngx_http_browser_module 模块，该 模块创建的变量值取决于“ User-Agent”请求标头字段的值。
--without-http_upstream_hash_module：禁用构建实现哈希 负载平衡方法的模块 。
--without-http_upstream_ip_hash_module：禁用构建实现ip_hash 负载平衡方法的模块 。
--without-http_upstream_least_conn_module：禁用构建实现了minimum_conn 负载平衡方法的模块 。
--without-http_upstream_keepalive_module：禁用构建一个模块来提供 对上游服务器连接的缓存。
--without-http_upstream_zone_module：禁用构建模块，该模块可以将上游组的运行时状态存储在共享内存 区域中。
--without-http：禁用HTTP服务器。
--without-http-cache：禁用HTTP缓存。
--without-mail_pop3_module：在邮件代理服务器中 禁用POP3协议。
--without-mail_imap_module：在邮件代理服务器中 禁用IMAP协议。
--without-mail_smtp_module：在邮件代理服务器中 禁用SMTP协议。
--without-stream_limit_conn_module：禁用构建ngx_stream_limit_conn_module 模块，该 模块限制每个键的连接数，例如，单个IP地址的连接数。
--without-stream_access_module：禁用构建ngx_stream_access_module 模块，该 模块允许限制对某些客户端地址的访问。
--without-stream_geo_module：禁用构建ngx_stream_geo_module 模块，该 模块创建的变量的值取决于客户端IP地址。
--without-stream_map_module：禁用构建ngx_stream_map_module 模块，该 模块创建的变量值取决于其他变量的值。
--without-stream_split_clients_module：禁用构建ngx_stream_split_clients_module 模块，该 模块创建用于A / B测试的变量。
--without-stream_return_module：禁用构建ngx_stream_return_module 模块，该 模块向客户端发送一些指定的值，然后关闭连接。
--without-stream_upstream_hash_module：禁用构建实现哈希 负载平衡方法的模块 。
--without-stream_upstream_least_conn_module：禁用构建实现了minimum_conn 负载平衡方法的模块 。
--without-stream_upstream_zone_module：禁用构建模块，该模块可以将上游组的运行时状态存储在共享内存 区域中。

三、nginx命令

1
2
3
4
5
6
7
8
./nginx 启动nginx
./nginx -h 查看nginx命令简单帮助文档
./nginx -t 检查配置文件语法是否有错
./nginx -V 显示版本和编译时的配置选项
./nginx -s stop 强制停止nginx服务
./nginx -s reload 重新加载nginx配置文件，然后优雅的方式重启nginx
./nginx -s reopen 重启nginx
./nginx -s quit 处理完关于nginx的所有请求后再停止服务

四、示例

1
2
3
./configure --prefix=/usr/local/nginx --error-log-path=/var/log/nginx/error.log \
--http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx/nginx.pid --lock-path=/var/lock/nginx.lock --user=nginx --group=nginx \
--with-http_ssl_module --with-http_image_filter_module --with-http_flv_module --with-http_stub_status_module --with-http_gzip_static_module
服务器 > nginx
#nginx
nginx源码编译
https://leellun.github.io/2019/12/21/服务器/nginx/nginx源码编译/
作者
leellun
发布于
2019年12月21日
许可协议