Nginx配置REST服务HTTP转HTTPS及测试问题咨询

1. 修复HTTP重定向规则 #

当前重定向server块存在语法错误，需调整：

• 移除server_name中的http://ipaddress:port，server_name仅支持主机名/IP，不能包含协议和端口
• 用$host变量替代硬编码的IP/端口，保证重定向适配不同访问域名，修改后块如下：

server {
    listen 80;
    listen [::]:80;
    server_name 你的虚拟机主机名 你的服务器公网IP;

    # 永久重定向所有HTTP请求到HTTPS
    return 301 https://$host$request_uri;
}

• 删除默认的80端口default_server块（第一个listen 80的server块），避免请求冲突，让重定向块处理所有HTTP流量

2. 启用HTTPS与反向代理配置 #

HTTPS server块的SSL配置被注释，需启用并适配你的证书，同时必须添加反向代理规则（否则Nginx仅返回静态页面，无法转发REST请求）：

server {
    listen 443 ssl http2 default_server;
    listen [::]:443 ssl http2 default_server;
    server_name 你的虚拟机主机名 你的服务器公网IP;
    root /usr/share/nginx/html;

    # 替换为你的SSL证书实际路径
    ssl_certificate "/etc/pki/nginx/your-cert.crt"; # 或自定义路径如/usr/local/nginx/ssl/server.crt
    ssl_certificate_key "/etc/pki/nginx/private/your-key.key"; # 对应私钥文件路径
    ssl_session_cache shared:SSL:1m;
    ssl_session_timeout 10m;
    ssl_ciphers PROFILE=SYSTEM;
    ssl_prefer_server_ciphers on;

    include /etc/nginx/default.d/*.conf;

    # 核心：反向代理到你的REST后端服务
    location / {
        proxy_pass http://你的REST服务IP:端口; # 例如http://localhost:8080
        # 传递必要请求头，保证后端服务获取正确客户端信息
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    error_page 404 /404.html;
        location = /40x.html {
    }

    error_page 500 502 503 504 /50x.html;
        location = /50x.html {
    }
}

3. 信任库相关说明 #

Nginx本身不需要Java truststore，truststore是给Java后端服务用的——如果你的REST服务是Java编写，需要将SSL证书导入Java信任库，确保服务信任Nginx的证书：

• 使用keytool命令导入（默认信任库密码为changeit）：

keytool -import -alias nginx-cert -file /path/to/your-cert.crt -keystore $JAVA_HOME/jre/lib/security/cacerts

• 导入后重启你的REST服务即可

1. 存放路径：建议将证书放到Nginx专属目录，比如/etc/nginx/ssl/，先创建目录：

mkdir -p /etc/nginx/ssl

2. 权限配置：确保Nginx进程能读取证书和私钥（私钥权限必须为600，避免泄露）：

chmod 600 /etc/nginx/ssl/your-key.key
chmod 644 /etc/nginx/ssl/your-cert.crt
chown nginx:nginx /etc/nginx/ssl/*

3. 生效配置：修改完文件后，先验证配置正确性：

nginx -t

如果输出test is successful，重启Nginx使配置生效：

# CentOS/RHEL
systemctl restart nginx
# Ubuntu/Debian
service nginx restart

1. 查看Nginx日志：检查访问日志/var/log/nginx/access.log和错误日志/var/log/nginx/error.log，确认请求是否到达Nginx、是否有报错信息
2. 直接测试HTTPS：跳过重定向，用Postman直接请求HTTPS地址（如https://你的服务器IP/api/xxx），如果有返回，说明重定向配置有问题；如果仍无返回，排查HTTPS或后端服务
3. 验证后端服务可用性：在Nginx服务器上用curl测试后端服务：

curl -X POST http://你的REST服务IP:端口/api/xxx -d "请求参数"

如果后端无响应，先修复服务问题
4. 调整Postman设置：关闭Postman的「Follow redirects」选项（设置→General→Follow redirects），因为POST请求被301重定向时，Postman会自动转为GET请求，导致无预期返回
5. 检查网络规则：确保服务器80/443端口对外开放，后端服务端口允许Nginx访问（防火墙/安全组需放行）

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