🔧 Nginx 301 重定向暴露端口号问题解决方案#

问题场景#

典型的问题场景如下：

• 客户端通过 API 网关（如 https://blog.gmai.top，监听 443 端口）访问后端服务
• 后端 Nginx 监听在内部端口（如 8080、50001 等）
• 当访问的路径是目录且缺少尾部斜杠时（如 /hd-portal），Nginx 会自动返回 301 重定向到 /hd-portal/
• 问题： 重定向的 Location 头暴露了 Nginx 的内部端口号，如 https://blog.gmai.top:50001/hd-portal/
• 导致客户端无法正确访问，请求链断裂

原因分析#

Nginx 在遇到目录访问时，会根据以下配置参数生成 301 重定向响应：

• absolute_redirect：是否启用绝对路径重定向（默认 on）
• server_name_in_redirect：重定向中是否使用 server_name（默认 off）
• port_in_redirect：重定向中是否包含端口号（默认 on）

当 absolute_redirect 为 on 时，Nginx 会生成包含完整 URL 的 Location 头，可能会包含内部端口号，从而暴露给客户端。

解决方案：配置 absolute_redirect off#

在 Nginx 的 server 块中添加 absolute_redirect off; 配置，禁用绝对路径重定向。

1
server {
2
    listen 8080;
3
    server_name blog.gmai.top;
4

5
    # 禁用绝对路径重定向
6
    absolute_redirect off;
7

8
    location / {
9
        root /var/www/html;
10
        index index.html index.htm;
11
    }
12

13
    location /hd-portal {
14
        alias /var/www/hd-portal;
15
        index index.html;
16
    }
17
}

重新加载 Nginx 配置#

修改配置后，重新加载 Nginx 使配置生效：

1
# 测试配置文件语法
2
sudo nginx -t
3

4
# 重新加载配置
5
sudo nginx -s reload
6
# 或
7
sudo systemctl reload nginx

验证效果#

使用 curl 命令验证重定向行为：

1
# 访问目录（缺少尾部斜杠）
2
curl -I https://blog.gmai.top/hd-portal
3

4
# 预期响应（配置前）
5
HTTP/1.1 301 Moved Permanently
6
Location: https://blog.gmai.top:50001/hd-portal/
7

8
# 预期响应（配置后）
9
HTTP/1.1 301 Moved Permanently
10
Location: /hd-portal/

配置后，Location 头变为相对路径，不再暴露内部端口号。

总结#

通过在 Nginx 的 server 块中配置 absolute_redirect off;，可以有效解决 301 重定向暴露内部端口号的问题，确保客户端请求正常转发，避免暴露服务器内部架构信息。

✅ 关键配置：

1
server {
2
    server_name blog.gmai.top;
3
    absolute_redirect off;
4
}