用HTTP核心模块配置一个静态Web服务器

编程界的谢菲尔德

已于 2022-11-30 12:30:43 修改

阅读量396

点赞数

文章标签：服务器运维

于 2022-11-30 12:24:49 首次发布

本文链接：https://blog.csdn.net/qq_62309585/article/details/128105653

版权

1.预备知识

静态 Web 服务器的主要功能由 ngx_http_core_module 模块（ HTTP 框架的主要成员）实现，

当然，一个完整的静态 Web 服务器还有许多功能是由其他的 HTTP 模块实现的。

所有的 HTTP 配置项都必须直属于 http 块、 server 块、 location 块、 upstream 块或 if 块等

（ HTTP 配置项自然必须全部在 http{} 块之内，这里的 “ 直属于 ” 是指配置项直接所属的大括号

对应的配置块），同时，在描述每个配置项的功能时，会说明它可以在上述的哪个块中存

在，因为有些配置项可以任意地出现在某一个块中，而有些配置项只能出现在特定的块中。

Nginx 为配置一个完整的静态 Web 服务器提供了非常多的功能，下面会把这些配置项分为

以下 8 类进行详述：

虚拟主机与请求的分发

文件路径的定义

内存及磁盘资源的分配

网络连接的设置

MIME类型的设置

对客户端请求的限制

文件操作的优化

对客户端请求

这种划分只是为了帮助大家从功能上理解这些配置项

2虚拟主机与请求的分发

由于 IP 地址的数量有限，因此经常存在多个主机域名对应着同一个 IP 地址的情况，这时

在 nginx.conf 中就可以按照 server_name （对应用户请求中的主机域名）并通过 server 块来定义

虚拟主机，每个 server 块就是一个虚拟主机，它只处理与之相对应的主机域名请求。这样，

一台服务器上的 Nginx 就能以不同的方式处理访问不同主机域名的 HTTP 请求了

（1）监听端口

listen address:port[default(deprecated in 0.8.21)|default_server|
[backlog=num|rcvbuf=size|sndbuf=size|accept_filter=filter|deferred|
bind|ipv6only=[on|off]|ssl]]

解释

1.address:port :

listen 127.0.0.1:8000;

listen 127.0.0.1; # 注意：不加端口时，默认监听

80 端口

2.使用ipv6

listen [::]:8000;

listen [fe80::1];

listen [:::a8c9:1234]:80;

3 default default_server

将所在的server块作为整个Web服务的默认server块。如果没有设置这个参数，

那么将会以在nginx.conf中找到的第一个server块作为默认server块。为什么需要默认虚拟主机

呢？当一个请求无法匹配配置文件中的所有主机域名时，就会选用默认的虚拟主机

4 backlog=num

表示TCP中backlog队列的大小。默认为–1表示不予设置。在TCP建立三次握手过程中，进程还没有开始处理监听句柄，这时backlog队列将会放置这些新连接。可如果backlog队列已满，还有新的客户端试图通过三次握手建立TCP连接，这时客户端将会建立连接失败

rcvbuf=size：设置监听句柄的SO_RCVBUF参数。

sndbuf=size：设置监听句柄的SO_SNDBUF参数。

accept_filter：设置accept过滤器，只对FreeBSD操作系统有用。

6 deferred

在设置该参数后，若用户发起建立连接请求，并且完成了TCP的三次握手，内核也不会为了这次的连接调度worker进程来处理，只有用户真的发送请求数据时（内核已经在网卡中收到请求数据包），内核才会唤醒worker进程处理这个连接。这个参数适用于大并发的情况下，它减轻了worker进程的负担。当请求数据来临时，worker进程才会开始处理这个连接。只有确认上面所说的应用场景符合自己的业务需求时，才可以使用deferred配置

7 bind

绑定当前端口/地址对，如127.0.0.1:8000。只有同时对一个端口监听多个地址时

才会生效

8.ssl

在当前监听的端口上建立的连接必须基于SSL协议。

ssl：

SL协议的三个特性

① 保密：在握手协议中定义了会话密钥后，所有的消息都被加密；

② 鉴别：可选的客户端认证，和强制的服务器端认证；

③ 完整性：传送的消息包括消息完整性检查（使用MAC）。

(2) server_name

语法： server_name name[...];
默认： server_name"";
配置块  server

server_name 后可以跟多个主机名称，

如 server_name www.testweb.com 、 download.testweb.com;

在开始处理一个 HTTP 请求时， Nginx 会取出 header 头中的 Host ，与每个 server 中的

server_name 进行匹配，以此决定到底由哪一个 server 块来处理这个请求。有可能一个 Host 与

多个 server 块中的 server_name 都匹配，这时就会根据匹配优先级来选择实际处理的 server 块。

server_name 与 Host 的匹配优先级如下

1 ）首先选择所有字符串完全匹配的 server_name ，如 www.testweb.com 。

2 ）其次选择通配符在前面的 server_name ，如 *.testweb.com 。

3 ）再次选择通配符在后面的 server_name ，如 www.testweb.* 。

4 ）最后选择使用正则表达式才匹配的 server_name ，如 ~^\.testweb\.com$ 。

如果 Host 与所有的 server_name 都不匹配，这时将会按下列顺序选择处理的server 块。

1）优先选择在listen配置项后加入[default|default_server]的server块。
2）找到匹配listen端口的第一个server块

（3） server_names_hash_bucket_size server_names_hash_max_size

语法： server_names_hash_bucket_size size;
默认： server_names_hash_bucket_size 32|64|128;
配置块： http、server、location


语法： server_names_hash_max_size size;
默认： server_names_hash_max_size 512;
配置块： http、server、location

为了提高快速寻找到相应 server name 的能力， Nginx 使用散列表来存储 server_name 。

server_names_hash_bucket_size 设置了每个散列桶占用的内存大小。

erver_names_hash_max_size 会影响散列表的冲突率。 server_names_hash_max_size 越大，

消耗的内存就越多，但散列 key 的冲突率则会降低，检索速度也更server_names_hash_max_size越小，消耗的内存就越小，但散列 key 的冲突率可能增高

（5）重定向主机名称的处理

语法： server_name_in_redirect on|off;
默认： server_name_in_redirect on;
配置块： http、server或者location

该配置需要配合 server_name 使用。在使用 on 打开时，表示在重定向请求时会使用

server_name 里配置的第一个主机名代替原先请求中的 Host 头部，而使用 off 关闭时，表示在重

定向请求时使用请求本身的 Host 头部。

（6）location

语法： location[=|~|~*|^~|@]/uri/{...}
配置块 server

location 会尝试根据用户请求中的 URI 来匹配上面的 /uri 表达式，如果可以匹配，就选择

location{} 块中的配置来处理用户请求。

当然，匹配方式是多样的，下面介绍 location 的匹配规则(可使用正则表达式)

1 ） = 表示把 URI 作为字符串，以便与参数中的 uri 做完全匹配

2 ） ~ 表示匹配 URI 时是字母大小写敏感的。

3 ） ~* 表示匹配 URI 时忽略字母大小写问题。

4 ） ^~ 表示匹配 URI 时只需要其前半部分与 uri 参数匹配即可。

5 ） @ 表示仅用于 Nginx 服务内部请求之间的重定向，带有 @ 的 location 不直接处理用户请

求

注意

1.location 是有顺序的，当一个请求有可能匹配多个 location 时，实际上这个请求会

被第一个 location 处理

2.在以上各种匹配方式中，都只能表达为 “ 如果匹配 ... 则 ...” 。如果需要表达 “ 如果不匹配 ...

则 ...” ，就很难直接做到。有一种解决方法是在最后一个 location中使用/ 作为参数，它会匹配

所有的 HTTP 请求，这样就可以表示如果不能匹配前面的所有 location ，则由 “/” 这个 location 处

理。例如

location / {
# /可以匹配所有请求
…
}

文件路径的定义

（1）以root方式设置资源路径

语法： root path;
默认： root html;
配置块： http、server、location、if

例子：

location /download/ {
root optwebhtml;
}

在上面的配置中，如果有一个请求的 URI 是 /download/index/test.html ，那么 Web 服务器将

会返回服务器上 opt web html download/index/test.html 文件的内容。

（2）以alias方式设置资源路径

语法： alias path;
配置块： location

alias 也是用来设置文件资源路径的，它与 root 的不同点主要在于如何解读紧跟 location 后

面的 uri 参数，这将会致使 alias 与 root 以不同的方式将用户请求映射到真正的磁盘文件上。例

如，如果有一个请求的 URI 是 /conf/nginx.conf ，而用户实际想访问的文件：

location conf {
alias usr/local/nginx/conf/;
}

如果用 root 设置，那么语句如下所示：

location conf {
root usr/local/nginx/;
}

使用 alias 时，在 URI 向实际文件路径的映射过程中，已经把 location后配置的/conf这部分

字符串丢弃掉，因此， /conf/nginx.conf 请求将根据 alias path 映射为 path/nginx.conf 。 root 则不

然，它会根据完整的 URI 请求来映射，因此， /conf/nginx.conf 请求会根据 root path 映射为

path/conf/nginx.conf 。这也是 root 可以放置到 http 、 server 、 location 或 if 块中，而 alias 只能放置

到 location 块中的原因

（3）访问首页

语法： index file...;
默认： index index.html;
配置块： http、server、location

有时，访问站点时的 URI 是 / ，这时一般是返回网站的首页，而这与 root 和 alias 都不同。

这里用 ngx_http_index_module 模块提供的 index 配置实现。 index 后可以跟多个文件参数， Nginx

将会按照顺序来访问这些文件，例如：

location {
root path;
index index.html htmlindex.php /index.php;
}

接收到请求后， Nginx 首先会尝试访问 path/index.php 文件，如果可以访问，就直接返回文

件内容结束请求，否则再试图返回 path html index.php 文件的内容，依此类推。

（4）根据HTTP返回码重定向页面

语法： error_page code[code...][=|=answer-code]uri|@named_location
配置块： http、server、location、if

解释：

当对于某个请求返回错误码时，如果匹配上了 error_page 中设置的 code ，则重定向到新

的 URI 中。例如：

error_page 404 404.html;
error_page 502 503 504 50x.html;
error_page 403 http://example.com/forbidden.html
;
error_page 404 = @fetch;

2.虽然重定向了URI，但返回的HTTP错误码还是与原来的相同。用户可以通过“=”来更改返回的错误码，例如

error_page 404 =200 empty.gif;
error_page 404 =403 forbidden.gif;

3. 如果不想修改URI，只是想让这样的请求重定向到另一个location中进行处理，那么可以这样设

location / (
error_page 404 @fallback;
)
location @fallback (
proxy_pass http://backend
;
)

（5）是否允许递归使用error_page

语法： recursive_error_pages[on|off];
默认： recursive_error_pages off;
配置块： http、server、location

（6） try_files

语法： try_files path1[path2]uri;
配置块： server、location

try_files 后要跟若干路径，如 path1 path2... ，而且最后必须要有 uri 参数，意义如下：尝试

按照顺序访问每一个 path ，如果可以有效地读取，就直接向用户返回这个 path 对应的文件结

束请求，否则继续向下访问。如果所有的 path 都找不到有效的文件，就重定向到最后的参数

uri 上。因此，最后这个参数 uri 必须存在，而且它应该是可以有效重定向的

try_files systemmaintenance.html $uri $uri/index.html $uri.html @other;
location @other {
proxy_pass http://backend
;
}

上面这段代码表示如果前面的路径，如 system maintenance.html 等，都找不到，就会反向

代理到 http://backend 服务上。还可以用指定错误码的方式与 error_page 配合使用，例如

location {
try_files $uri $uri /error.phpc=404 =404;
}

编程界的谢菲尔德

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
用HTTP核心模块配置一个静态Web服务器

location中使用/
复制链接

扫一扫