简单配置搞定 Nginx + Tomcat + HTTPS

最新推荐文章于 2026-06-23 16:30:18 发布

转载最新推荐文章于 2026-06-23 16:30:18 发布 · 726 阅读

标签

#nginx #tomcat #ssl

java web开发专栏收录该内容

237 篇文章

订阅专栏

本文介绍了一种简化Nginx+Tomcat+HTTPS配置的方法，即Nginx仅启用HTTPS，而Nginx与Tomcat之间的连接使用普通HTTP。通过详细配置示例展示了如何实现这一方案，包括Nginx和Tomcat端的配置细节，以及关键的SSL证书配置和proxy_pass使用。

简单配置搞定 Nginx + Tomcat + HTTPS

之前在网上搜索到的很多文章在描述 Nginx + Tomcat 启用 HTTPS 支持的时候，都必须在 Nginx 和 Tomcat 两边同时配置 SSL 支持。但我一直在想为什么就不能按照下面的方式来配置呢？就是 Nginx 上启用了 HTTPS，而 Nginx 和 Tomcat 之间走的却是普通的 HTTP 连接。但是搜索很多没有解决办法，最后还是老老实实的 Nginx 和 Tomcat 同时配置的 SSL 支持。

最近给 OSChina 买了个新的支持 *.oschina.net 泛域名的证书，然后我又开始偷懒的想为什么 Tomcat 一定要配 HTTPS 呢？没道理啊。然后潜心搜索终于找到了解决方案。原来却是如此的简单。

最终配置的方案是浏览器和 Nginx 之间走的 HTTPS 通讯，而 Nginx 到 Tomcat 通过 proxy_pass 走的是普通 HTTP 连接。

下面是详细的配置（Nginx 端口 80/443，Tomcat 的端口 8080）：

Nginx 这一侧的配置没什么特别的：

upstream tomcat {

server 127.0.0.1:8080 fail_timeout=0;

}

# HTTPS server

server {

listen 443 ssl;

server_name localhost;

ssl_certificate /Users/winterlau/Desktop/SSL/oschina.bundle.crt;

ssl_certificate_key /Users/winterlau/Desktop/SSL/oschina.key;

ssl_session_cache shared:SSL:1m;

ssl_session_timeout 5m;

ssl_ciphers HIGH:!aNULL:!MD5;

ssl_prefer_server_ciphers on;

location / {

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header Host $http_host;

proxy_set_header X-Forwarded-Proto https;

proxy_redirect off;

proxy_connect_timeout 240;

proxy_send_timeout 240;

proxy_read_timeout 240;

# note, there is not SSL here! plain HTTP is used

proxy_pass http://tomcat;

}

其中最为关键的就是 ssl_certificate 和 ssl_certificate_key 这两项配置，其他的按正常配置。不过多了一个 proxy_set_header X-Forwarded-Proto https; 配置。

最主要的配置来自 Tomcat，下面是我测试环境中的完整 server.xml：

<?xml version='1.0' encoding='utf-8'?>

<Connector port="8080" protocol="HTTP/1.1"

connectionTimeout="20000"

redirectPort="443"

proxyPort="443"/>

<Host name="localhost" appBase="webapps"

unpackWARs="true" autoDeploy="true">

<Valve className="org.apache.catalina.valves.RemoteIpValve"

remoteIpHeader="x-forwarded-for"

remoteIpProxiesHeader="x-forwarded-by"

protocolHeader="x-forwarded-proto"

</Host>

</Engine>

</Service>

</Server>

上述的配置中没有什么特别的，但是特别特别注意的是必须有 proxyPort=”443″，这是整篇文章的关键，当然 redirectPort 也必须是 443。同时 <Value> 节点的配置也非常重要，否则你在 Tomcat 中的应用在读取 getScheme() 方法以及在 web.xml 中配置的一些安全策略会不起作用。

怎么样，简单到一塌糊涂吧！！！