《mkcert介绍及使用》

news2024/12/27 10:55:10

在这里插入图片描述

🤖 作者简介：水煮白菜王，一位资深前端劝退师 👻

👀 文章专栏：前端专栏，记录一下平时在博客写作中，总结出的一些开发技巧✍。
感谢支持💕💕💕

关联文章：
《开发环境使用HTTPS调试》

使用 mkcert 在本地开发环境中生成 SSL/TLS 证书
- mkcert 的用途
- 安装 mkcert
- - 1. 安装 mkcert
  - - macOS
    - Linux
    - Windows
  - 2. 安装根证书
- 生成证书
- - 生成单个证书
  - 生成多个证书
- 使用证书
- - Nginx
  - Apache
  - Node.js (Express)
- 卸载 mkcert
- 总结

使用 mkcert 在本地开发环境中生成 SSL/TLS 证书

mkcert 是一个简单的工具，用于生成本地开发环境中的受信任的 SSL/TLS 证书。这对于在本地开发环境中测试 HTTPS 连接非常有用，因为它可以为我们的本地开发域名生成自签名的证书，并通过一个根证书（CA）使其在我们的系统上被信任。

mkcert 的用途

本地开发：在本地开发环境中启用 HTTPS，确保应用程序可以在安全连接下运行。
测试环境：在测试服务器上使用 HTTPS 进行测试，确保与生产环境一致的安全性。

安装 mkcert

1. 安装 mkcert

首先，需要安装 mkcert。对于不同的操作系统，安装步骤略有不同。

macOS

使用 Homebrew 安装：

brew install mkcert

Linux

对于 Debian/Ubuntu 系统，可以使用下面的命令：

sudo apt-get update
sudo apt-get install mkcert

Windows

下载可执行文件并将其添加到 PATH 环境变量中。

2. 安装根证书

mkcert 生成的证书需要一个根证书来信任它们。运行以下命令来生成根证书：

mkcert -install

这将在系统上安装一个根证书，使得 mkcert 生成的所有证书都被系统信任。

生成证书

一旦安装了 mkcert 并安装了根证书，可以为本地开发域名生成证书。

生成单个证书

假设要为 example.local 域名生成证书，可以运行以下命令：

mkcert example.local

这将生成两个文件：

example.local.pem：包含私钥和证书。
rootCA.pem：包含根证书（通常位于 ~/.local/share/mkcert 目录下）。

生成多个证书

如果有多个域名需要证书，可以一次生成多个：

mkcert example.local another.example.local localhost

使用证书

一旦生成了证书，可以在 Web 服务器配置中使用它们。以下是几个常见 Web 服务器的配置示例。

Nginx

假设 Nginx 配置文件位于 ``/etc/nginx/sites-available/example.local``，可以这样配置：

server {
    listen 443 ssl;
    server_name example.local;

    ssl_certificate /path/to/example.local.pem;
    ssl_certificate_key /path/to/example.local-key.pem;

    location / {
        root /var/www/html;
        index index.html index.htm;
    }
}

Apache

在 Apache 中，可以在虚拟主机配置中指定证书文件：

<VirtualHost *:443>
    ServerName example.local
    DocumentRoot "/var/www/html"

    SSLEngine on
    SSLCertificateFile /path/to/example.local.pem
    SSLCertificateKeyFile /path/to/example.local-key.pem
</VirtualHost>

Node.js (Express)

在 Node.js 的 Express 应用中，可以使用 https 模块来创建 HTTPS 服务器：

const https = require('https');
const express = require('express');

const app = express();
const options = {
  key: fs.readFileSync('/path/to/example.local-key.pem'),
  cert: fs.readFileSync('/path/to/example.local.pem'),
};

https.createServer(options, app).listen(443, () => {
  console.log('HTTPS Server running on port 443');
});