alpine/mkcert

镜像概述

mkcert 是一个简单的零配置工具，专为生成本地可信开发证书而设计，支持使用任意自定义名称。它解决了开发环境中 HTTPS 证书信任问题，无需复杂配置即可创建浏览器信任的本地证书。

核心功能和特性

• 零配置：无需手动设置复杂的证书参数，开箱即用
• 本地可信：生成的证书基于本地 CA（证书颁发机构），安装 CA 后可被浏览器自动信任
• 灵活命名：支持为任意名称（如 localhost、IP 地址、自定义域名）生成证书
• 简单易用：通过命令行快速生成证书，无需深入了解 PKI（公钥基础设施）知识

使用场景和适用范围

• 本地 Web 服务开发：为本地运行的 Web 应用（如前端开发服务器、后端 API 服务）提供可信 HTTPS 支持
• 开发测试环境：在开发和测试阶段模拟 HTTPS 环境，避免浏览器因自签名证书显示安全警告
• 多服务测试：为多个本地服务（如微服务架构中的不同服务）生成独立证书
• 教育和演示：学习 HTTPS 原理时快速搭建本地可信证书环境

使用方法和配置说明

前提条件

• 已安装 Docker 环境
• 具备基本的命令行操作能力

快速开始

1. 创建命令别名（可选）

为简化 Docker 命令使用，建议创建别名：

bash
alias mkcert="docker run -ti --rm alpine/mkcert"

2. 生成证书

使用以下命令生成包含指定名称的证书（例如 localhost、127.0.0.1、自定义服务名）：

bash
mkcert localhost 127.0.0.1 web-service ::1

执行后输出示例：

Created a new local CA 💥
Note: the local CA is not installed in the system trust store.
Run "mkcert -install" for certificates to be trusted automatically ⚠️

Created a new certificate valid for the following names 📜
 - "localhost"
 - "127.0.0.1"
 - "web-service"
 - "::1"

The certificate is at "./localhost+3.pem" and the key at "./localhost+3-key.pem" ✅

It will expire on 23 December 2026 🗓

3. 安装本地 CA（使证书自动信任）

生成证书后，需将本地 CA 安装到系统信任存储，确保证书被浏览器和系统自动信任：

bash
mkcert -install

证书文件说明

生成的证书文件默认保存在当前工作目录：

• 证书文件：./[名称]+[数量].pem（如 localhost+3.pem）
• 私钥文件：./[名称]+[数量]-key.pem（如 localhost+3-key.pem）

相关链接

• Dockerfile 源码：https://github.com/alpine-docker/multi-arch-docker-images/blob/master/mkcert/Dockerfile
• 镜像标签：https://hub.docker.com/repository/docker/alpine/mkcert/tags