Nginx端口跳转保姆级教程：3步搞定HTTP/HTTPS、多端口访问难题

你是否遇到过这样的情况：搭建的网站明明配置了HTTPS，访客却用HTTP访问时总提示“不安全”？或者不同服务部署在不同端口，用户想通过统一域名访问却需要手动加端口号？这背后的“锅”，多半是Nginx端口跳转没做好。作为网站的“守门人”，Nginx的端口跳转功能能帮你把流量精准引向目标服务，今天就用最通俗的方式教你搞定！

一、什么是端口跳转？为什么需要它？

简单说，端口跳转就是通过Nginx配置，让不同端口的请求自动“跳”到目标端口或服务。比如：

安全需求：强制HTTP请求跳转到HTTPS（加密访问）；
简化访问：用户只需记80/443端口，不用手动加端口号；
服务隔离：不同服务（如博客、管理后台）用不同端口，但对外统一暴露安全端口。

二、3类高频场景+配置示例

场景1：HTTP强制跳转HTTPS（最基础也最常用）

需求：用户用http://example.com访问时，自动跳转到https://example.com。
配置代码：

server {
    listen 80;  # 监听HTTP默认端口80
    server_name example.com www.example.com;  # 匹配目标域名
    # 重写规则：把所有HTTP请求永久重定向到HTTPS
    rewrite ^(.*)$ https://$host$1 permanent;
}

关键参数解释：

listen 80：Nginx监听80端口，接收HTTP请求；
server_name：指定域名，确保跳转只针对目标网站；
rewrite ^(.*)$ ... permanent：将所有路径（^(.*)$）重定向到HTTPS，permanent表示301永久跳转（对SEO更友好）；
https://$host$1：$host是域名，$1是原始请求路径（如/blog），保证跳转后路径不变。

场景2：同一域名不同端口跳转（如8080→80）

需求：用户访问example.com时，Nginx自动转发到后端服务的8080端口。
配置代码：

server {
    listen 80;
    server_name example.com;
    location / {
        proxy_pass http://127.0.0.1:8080;  # 转发到后端服务的8080端口
        proxy_set_header Host $host;       # 传递原始域名
        proxy_set_header X-Real-IP $remote_addr;  # 传递访客真实IP
    }
}

关键点：

proxy_pass：反向代理核心指令，将请求转发到后端服务地址；
proxy_set_header：避免后端服务获取不到正确的域名或IP，导致路径错误。

场景3：多域名/多端口跳转（如blog→8080，admin→8888）

需求：不同子域名对应不同端口（blog.example.com→8080，admin.example.com→8888）。
配置代码：

server {
    listen 80;
    server_name blog.example.com;  # 子域名匹配
    location / {
        proxy_pass http://127.0.0.1:8080;
    }
}

server {
    listen 80;
    server_name admin.example.com;
    location / {
        proxy_pass http://127.0.0.1:8888;
    }
}

注意：多域名跳转需为每个域名单独写server块，避免冲突。

三、配置后不生效？3个排查技巧

语法检查：执行nginx -t（需加配置文件路径，如nginx -t -c /etc/nginx/nginx.conf），检查是否有配置错误；
端口占用：用netstat -tuln | grep 80查看80/443端口是否被其他进程占用（如Apache），若被占用需kill进程或换端口；
日志定位：查看/var/log/nginx/error.log，重点关注“rewrite”“proxy_pass”相关错误，比如“rewrite规则不匹配”“404 Not Found”可能是后端服务未启动。

四、进阶技巧：带参数/路径的跳转

如果需要对特定路径（如/api）跳转，可在location中加正则匹配：

server {
    listen 80;
    server_name example.com;
    location ~ ^/api/(.*)$ {  # 匹配/api/开头的路径
        proxy_pass http://127.0.0.1:9000/$1;  # 路径参数传递（如/api/user→/user）
    }
}