Tomcat从安装到配置Https SSL证书

Posted Hellxz博客

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Tomcat从安装到配置Https SSL证书相关的知识,希望对你有一定的参考价值。

为什么要写本文?

今天一个群友在群里问怎么给Tomcat配置SSL,也就是HTTPS,他买的阿里云的服务器,自带公网ip,还找到了免费的SSL证书

既然@我了,我就帮忙搞一搞呗,我就要了一个带sudo的用户,开始了踩坑-查文档爬坑

踩到坑的原因还是因为自己对Linux的用户端口权限不够了解,所以记下来,告诫自己戒骄戒躁

安装Tomcat

演示用Centos 7,Tomcat版本8.5.50,需要先安装JDK,这里用的openjdk

下载Tomcat http://mirrors.tuna.tsinghua.edu.cn/apache/tomcat/tomcat-8/v8.5.50/bin/apache-tomcat-8.5.50.tar.gz

$ cd ~
$ wget http://mirrors.tuna.tsinghua.edu.cn/apache/tomcat/tomcat-8/v8.5.50/bin/apache-tomcat-8.5.50.tar.gz #下载到家目录
$ tar zxvf apache-tomcat-8.5.50.tar.gz #解压tomcat
$ cd apache-tomcat-8.5.50
$ bin/startup.sh #启动tomcat
$ tail -f logs/catalina.out #查看日志输出

你会发现Linux下tomcat启动特别慢,原因在于Tomcat获取随机数使用/dev/./random在不能产生新的随机数时会阻塞程序,参考Linux中的随机数文件 /dev/random /dev/urandom,知道问题在哪里我们修改一下bin/catalina.sh,使其使用非阻塞的/dev/urandom

$ vim bin/catalina.sh

在256行附近为JAVA_OPTS添加指定默认随机数-Djava.security.egd=file:/dev/./urandom,保存退出

重启tomcat

$ bin/shutdown.sh
$ bin/startup.sh
$ tail -f logs/catalina.out

这次启动就非常快了

访问<127.0.0.1:8080>或者localhost:8080查看是否正确启动

安装APR

查看启动日志的时候,你可能会发现有个库好像没有找到

The APR based Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path

APR用官网的说法是:Tomcat can use the [Apache Portable Runtime](https://apr.apache.org/) to provide superior scalability, performance, and better integration with native server technologies.

简单来说,APR是针对操作系统优化,大幅度提升服务器性能的运行时环境

最简单的解决办法是安装apr-devel,更多细节参考http://tomcat.apache.org/tomcat-8.5-doc/apr.html

$ sudo yum install -y apr-devel

更细致的安装是使用源码,通过rpmbuild打成rpm包进行安装,参考https://apr.apache.org/compiling_unix.html

修改Tomcat端口为80

http默认的端口是80,当我们只写ip或域名时会默认访问80端口,配置一下还挺有用的

$ vim conf/server.xml

在69行左右修改8080为80,保存退出

重启tomcat,命令与上边一致,不再赘述

如果你和我一样,使用的也是sudo用户,启动tomcat时没加sudo,那么此时你也要被坑了,“我访问127.0.0.1”怎么没反应啊?

这是因为Linux默认非root用户可直接使用的端口号要大于1024! 我今天就坑在这里好久,之前一直使用root用户一点事没有,这才发现这个问题,改安全组、关防火墙、改配置一把梭没查到问题,改到怀疑人生,使用sudo解决问题;不要盲目迷信root

配置Https SSL证书

首先从证书颁发机构网站下载证书文件和密码,证书文件后缀.pfx,密码一般是pfx-password.txt,有时使用pfx配置密码会失败,这里就使用转化pfxjks文件

先复制.pfx证书与密码到当前目录,这里放在用户家目录中

转换pfx证书为jks

$ cd ~
$ cat pfx-password.txt #查看密码,这里可以复制一下,马上会用到
$ keytool -importkeystore -srckeystore 你的证书.pfx -destkeystore domains.jks -srcstoretype PKCS12 -deststoretype JKS #这里的domains.jks名称你可以改成别的,只要以.jks结尾就可以

输入3次密码,粘贴刚才复制的密码即可,ls你会发现domain.jks已经生成

配置Server.xml

$ cp domains.jks ~/apache-tomcat-8.5.50/conf
$ cd ~/apache-tomcat-8.5.50
$ vim conf/server.xml

在大约87行,修改原来的8443为443, protocol可以使用其它高版本协议,详情参考http://tomcat.apache.org/tomcat-8.5-doc/config/http.html#SSL_Support

如图,keystoreFile处填写jks的绝对路径,keystorePass填写证书密码(刚才生成jks时填写的与pfx相同的密码)

    <!-- 开启ssl支持,请注意其它接口转发应修改redirectPort为443 --> 
    <Connector port="443" protocol="HTTP/1.1" SSLEnabled="true" 
              maxThreads="150" scheme="https" secure="true" 
              keystoreFile="/你的目录/apache-tomcat-8.5.50/conf/domains.jks" 
              keystorePass="证书密码" 
              clientAuth="false" sslProtocol="TLS" 
              connectionTimeout="20000" />

修改默认配置的8443为443,使其它端口转发到443端口拥有加密功能

在vim中输入,一般应该成功替换6处(含注释)

:1,$s/8443/443/g

保存退出,重启Tomcat

后续

一般来说看到这里,你的Tomcat应该已经绑上Https证书了

由于这是一次踩坑的记录,再提几嘴可能碰到的问题:

  • ECS服务器由安全组配置入站出站规则,默认入站全禁,出站全开,要注意配置80与443端口入站放行
  • 某些地区的阿里ECS安全组只能使用专用网络,区别于经典网络的公网与内网可单独配置,专用网络安全组默认标灰内网为不可修改,通过查询阿里的文档,发现专用网络安全组配置在公网与内网中均会生效
  • Linux非root用户默认没有1024以下端口使用的权力

以上是关于Tomcat从安装到配置Https SSL证书的主要内容,如果未能解决你的问题,请参考以下文章

将 SSL 证书配置到 SINGLE Elastic Beanstalk TOMCAT 实例

Tomcat APR 连接器的 SSL 证书配置查询

Tomcat SSL证书安装配置

Tomcat服务器配置https协议(Tomcat HTTPS/SSL 配置)

​tomcat7.0配置ssl受信证书,手机打开不受信

在 AWS EBS 单实例 (Tomcat) 上安装 SSL 证书