使用Spring Boot和mkcert解决本地及局域网HTTPS访问

在现代Web开发中，HTTPS已经成为保障数据传输安全的标准。然而，在开发和测试阶段，配置HTTPS可能会带来一些额外的复杂性。尤其是在本地开发环境和局域网内网环境中，获得和配置证书通常是一个挑战。本文将介绍如何使用Spring Boot和mkcert工具，快速简便地为本地及局域网应用配置HTTPS。

一、HTTPS的重要性

HTTPS（HyperText Transfer Protocol Secure）通过SSL/TLS协议提供加密的数据传输渠道，从而保证数据的机密性和完整性。在使用HTTPS的情况下，浏览器与服务器之间传输的数据是加密的，防止了中间人攻击和数据窃听。

二、mkcert简介

mkcert是一个用于生成本地自签名SSL证书的工具。它非常适合开发环境下的使用，因为它可以快速生成受信任的自签名证书，并在本地系统上自动安装这些证书，使浏览器不会显示不安全的警告。

2.1 mkcert的优势

简便易用：mkcert通过简单的命令即可生成和安装证书。
受信任的证书：生成的证书会被浏览器信任，不会显示不安全警告。
支持多平台：mkcert支持Windows、macOS和Linux等多个操作系统。

三、Spring Boot简介

SpringBoot是Spring框架的子项目，旨在简化新Spring应用的初始搭建以及开发过程。通过SpringBoot，开发者可以快速创建独立运行、生产级的Spring应用。

3.1 Spring Boot的特点

自动配置：Spring Boot自动配置大部分的Spring应用，只需很少的代码或配置。
嵌入式服务器：内嵌Tomcat、Jetty等服务器，无需外部配置。
生产级准备：提供生产级的应用监控和管理工具。

四、配置环境

在开始之前，请确保已安装以下软件：

Java（JDK 8或更高版本）
Spring Boot CLI（可选）
mkcert

4.1 安装mkcert

在不同平台上安装mkcert的步骤如下：

macOS

brew install mkcert
brew install nss # 如果使用Firefox浏览器
mkcert -install

Windows

choco install mkcert
mkcert -instal

Linux

对于Linux用户，请参考mkcert的官方文档进行安装。

五、生成和配置自签名证书

5.1 生成证书

使用mkcert生成一个用于本地和局域网的自签名证书。假设你需要为localhost和192.168.0.100生成证书：

mkcert localhost 192.168.0.100

这将生成两个文件：localhost+1.pem（证书）和localhost+1-key.pem（私钥）。

5.2 配置Spring Boot

在Spring Boot项目中，使用这些证书配置HTTPS。首先，将生成的证书和私钥文件放在项目的src/main/resources目录下。

然后，在application.properties文件中添加以下配置：

server.port=8443
server.ssl.key-store-type=PKCS12
server.ssl.key-store=classpath:keystore.p12
server.ssl.key-store-password=changeit
server.ssl.key-alias=localhost

接下来，我们需要将PEM格式的证书和私钥转换为PKCS12格式的keystore文件。可以使用以下命令：

openssl pkcs12 -export -in localhost+1.pem -inkey localhost+1-key.pem -out keystore.p12 -name localhost -CAfile $(mkcert -CAROOT)/rootCA.pem -caname root -password pass:changeit

这个命令会生成一个keystore.p12文件，密码为changeit。