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配置密码会失败，这里就使用转化pfx为jks文件

先复制.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以下端口使用的权力