使用NGINX limit_conn模块时，如何向用户展示拦截原因提示？

嘿，这个需求很好实现，咱们用NGINX自带的error_page指令配合limit_conn模块就能搞定，给被拦截的用户返回自定义提示。下面给你具体的配置方案：

基础配置前提 #

首先确保你已经正确配置了limit_conn的核心规则，比如限制单个IP同时只能有1个连接（对应你的下载场景）：

http {
    # 定义连接限制的共享内存区域
    limit_conn_zone $binary_remote_addr zone=addr:10m;

    server {
        # 你的其他server配置（比如监听端口、根目录等）
        listen 80;
        root /usr/share/nginx/html;

        # 启用连接限制，每个IP最多1个并发连接
        limit_conn addr 1;
    }
}

方案一：直接返回纯文本提示（简单快捷） #

limit_conn触发拦截时默认返回503状态码，我们可以用error_page把这个状态码指向一个自定义的内部location，直接返回提示文本：

server {
    # 上述的基础配置...

    # 将503错误指向自定义的错误处理location
    error_page 503 @limit_conn_error;

    # 定义错误处理的location
    location @limit_conn_error {
        default_type text/plain; # 设置响应内容类型为纯文本
        return 503 "您一次只能下载1个文件，请先完成当前下载后再尝试";
    }
}

方案二：返回自定义HTML页面（更美观） #

如果需要更友好的可视化提示，可以创建一个HTML页面，再通过error_page跳转过去：

1. 先在NGINX的静态文件目录（比如/usr/share/nginx/html）创建limit_conn_tip.html，内容示例：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>下载提示</title>
    <style>
        body { text-align: center; margin-top: 100px; font-family: sans-serif; }
        .tip-box { padding: 20px; border: 1px solid #ccc; border-radius: 8px; width: 400px; margin: 0 auto; }
        h2 { color: #e74c3c; }
    </style>
</head>
<body>
    <div class="tip-box">
        <h2>温馨提示</h2>
        <p>您一次只能下载1个文件，请先完成当前下载后再发起新的请求哦～</p>
    </div>
</body>
</html>

2. 然后在NGINX配置中添加：

server {
    # 上述的基础配置...

    # 将503错误指向自定义HTML页面
    error_page 503 /limit_conn_tip.html;

    # 配置页面的访问规则，设置internal禁止用户直接访问
    location = /limit_conn_tip.html {
        root /usr/share/nginx/html; # 替换成你的静态文件目录
        internal;
    }
}

可选：修改拦截状态码 #

如果不想用默认的503，也可以通过limit_conn_status指令改成其他状态码（比如429表示请求过多），示例：

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

    server {
        # 其他配置...
        limit_conn addr 1;
        limit_conn_status 429; # 把拦截状态码改成429

        # 对应的error_page也要改成429
        error_page 429 @limit_conn_error;
        location @limit_conn_error {
            default_type text/plain;
            return 429 "您一次只能下载1个文件";
        }
    }
}

配置完成后，记得重启NGINX（nginx -s reload）生效，这样用户触发连接限制时就能看到你自定义的提示啦～

内容的提问来源于stack exchange，提问作者Michael Rogers