brunopadz/mkcert-docker

mkcert-docker

镜像概述

mkcert-docker是一个Docker镜像，提供了在本地开发环境中快速生成CA（证书颁发机构）和SSL证书的便捷方式。它封装了mkcert工具，允许用户无需在本地系统安装该工具，直接通过Docker容器运行，简化了本地HTTPS开发环境的搭建流程。

核心功能与特性

• 容器化运行：无需在本地系统安装mkcert，直接通过Docker容器执行证书生成操作
• 快速CA安装：支持一键安装本地CA，使生成的证书被系统信任
• 证书生成：可快速生成指定域名的SSL证书（PEM格式）
• 文件持久化：通过挂载本地目录，确保生成的CA和证书文件持久保存在宿主机

使用场景

• 本地Web应用开发环境需要HTTPS支持时
• 前端/后端开发中模拟HTTPS请求场景
• 本地API服务测试需要可信SSL证书时
• 避免因系统包管理器安装mkcert带来的环境依赖问题

使用方法

创建CA和PEM证书

通过以下命令生成CA并创建指定域名的SSL证书：

bash
docker run -v $PWD:/root/.local/share/mkcert brunopadz/mkcert-docker:latest \
/bin/sh -c "mkcert -install && \
mkcert -cert-file /root/.local/share/mkcert/mkcert.pem \
-key-file /root/.local/share/mkcert/mkcert.key localhost.dev"

命令参数说明

• -v $PWD:/root/.local/share/mkcert：将当前目录（$PWD）挂载到容器内的证书存储路径，确保生成的证书文件保存到本地
• brunopadz/mkcert-docker:latest：使用的Docker镜像名称及标签
• mkcert -install：在容器内安装本地CA（证书颁发机构）
• mkcert -cert-file ... -key-file ... localhost.dev：生成指定域名（localhost.dev）的证书文件（mkcert.pem）和密钥文件（mkcert.key）

生成结果

执行命令后，当前目录下将生成以下文件：

• mkcert.pem：SSL证书文件
• mkcert.key：证书密钥文件
• 容器内生成的CA证书会通过挂载目录间接提供（具体路径可通过容器内mkcert -CAROOT命令查看）

优势

相比通过系统包管理器安装mkcert，该镜像提供更快捷的使用方式，无需处理本地环境依赖，直接通过Docker容器即可完成CA安装和证书生成，特别适合需要快速搭建本地HTTPS开发环境的场景。