# ngx\_http\_limit\_conn\_module

* [指令](/nginx-docs/he-xin-gong-neng/http/ngx_http_limit_conn_module.md#directives)
  * [limit\_conn](/nginx-docs/he-xin-gong-neng/http/ngx_http_limit_conn_module.md#limit_conn)
  * [limit\_conn\_log\_level](/nginx-docs/he-xin-gong-neng/http/ngx_http_limit_conn_module.md#limit_conn_log_level)
  * [limit\_conn\_status](/nginx-docs/he-xin-gong-neng/http/ngx_http_limit_conn_module.md#limit_conn_status)
  * [limit\_conn\_zone](/nginx-docs/he-xin-gong-neng/http/ngx_http_limit_conn_module.md#limit_conn_zone)
  * [limit\_zone](/nginx-docs/he-xin-gong-neng/http/ngx_http_limit_conn_module.md#limit_zone)

`ngx_http_limit_conn_module` 模块用于限制每个已定义的 key 的连接数量，特别是来自单个 IP 地址的连接数量。

并非所有的连接都会被计数。只有当服务器处理了请求并且已经读取了整个请求头时，连接才被计数。

## 示例配置 <a href="#example_configuration" id="example_configuration"></a>

```
http {
    limit_conn_zone $binary_remote_addr zone=addr:10m;

    ...

    server {

        ...

        location /download/ {
            limit_conn addr 1;
        }
```

## 指令 <a href="#directives" id="directives"></a>

### limit\_conn

|       - | 说明                             |
| ------: | ------------------------------ |
|  **语法** | **limit\_conn** `zone number`; |
|  **默认** | ——                             |
| **上下文** | http、server、location           |

设置给定键值的共享内存区域和最大允许连接数。当超过此限制时，服务器将返回错误响应请求。例如：

```
limit_conn_zone $binary_remote_addr zone=addr:10m;

server {
    location /download/ {
        limit_conn addr 1;
    }
```

同一时间只允许一个 IP 地址一个连接。

> 在 HTTP/2和 SPDY 中，每个并发请求都被视为一个单独的连接。

可以有多个 `limit_conn` 指令。 例如，以下配置将限制每个客户端 IP 连接到服务器的数量，同时限制连接到虚拟服务器的总数：

```
limit_conn_zone $binary_remote_addr zone=perip:10m;
limit_conn_zone $server_name zone=perserver:10m;

server {
    ...
    limit_conn perip 10;
    limit_conn perserver 100;
}
```

当且仅当在当前级别上没有 `limit_conn` 指令时，这些指令才从前一级继承。

### limit\_conn\_log\_level

|       - | 说明                                                                   |
| ------: | -------------------------------------------------------------------- |
|  **语法** | **limit\_conn\_log\_level** `info` \| `notice` \| `warn` \| `error`; |
|  **默认** | limit\_conn\_log\_level error;                                       |
| **上下文** | http、server、location                                                 |
|  **提示** | 该指令在 0.8.18 版本中出现                                                    |

当服务器限制连接数时，设置所需的日志记录级别。

### limit\_conn\_status

|       - | 说明                              |
| ------: | ------------------------------- |
|  **语法** | **limit\_conn\_status** `code`; |
|  **默认** | limit\_conn\_status 503;        |
| **上下文** | http、server、location            |
|  **提示** | 该指令在 1.3.15 版本中出现               |

设置响应拒绝请求返回的状态码。

### limit\_conn\_zone

|       - | 说明                                          |
| ------: | ------------------------------------------- |
|  **语法** | **limit\_conn\_zone** `key zone=name:size`; |
|  **默认** | ——                                          |
| **上下文** | http                                        |

为共享内存区域设置参数，该区域将保留各种键的状态。特别是，该状态包含当前的连接数。`key` 可以包含文本、变量及其组合。不包括有空键值的请求。

> 在 1.7.6 版本之前，一个 key 可能只包含一个变量。

用法示例：

```
limit_conn_zone $binary_remote_addr zone=addr:10m;
```

在这里，客户端 IP 地址作为 key。请注意，不是 `$remote_addr`，而是使用 `$binary_remote_addr` 变量。`$remote_addr` 变量的大小可以为 7 到 15 个字节不等。存储状态在 32 位平台上占用 32 或 64 字节的内存，在 64 位平台上总是占用 64 字节。对于 IPv4 地址，`$binary_remote_addr` 变量的大小始终为 4 个字节，对于 IPv6 地址则为 16 个字节。存储状态在 32 位平台上始终占用 32 或 64 个字节，在 64 位平台上占用 64 个字节。一兆字节的区域可以保持大约 32000 个 32 字节的状态或大约 16000 个 64 字节的状态。如果区域存储耗尽，服务器会将错误返回给所有其余的请求。

### limit\_zone

|       - | 说明                                     |
| ------: | -------------------------------------- |
|  **语法** | **limit\_zone** `name $variable size`; |
|  **默认** | ——                                     |
| **上下文** | http                                   |

该指令在 1.1.8 版本中已过时，并在 1.7.6 版本中被删除。请使用等效 [limit\_conn\_zone](/nginx-docs/he-xin-gong-neng/http/ngx_http_limit_conn_module.md#limit_conn_zone) 指令代替：

> `limit_conn_zone $variable zone=name:size;`

## 原文档

<http://nginx.org/en/docs/http/ngx_http_limit_conn_module.html>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docshome.gitbook.io/nginx-docs/he-xin-gong-neng/http/ngx_http_limit_conn_module.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.