mkcert - 一个简单的零配置工具,用于生成具有任意名称的本地可信开发证书。
镜像概述
mkcert 是一个简单的零配置工具,专为生成本地可信开发证书而设计,支持使用任意自定义名称。它解决了开发环境中 HTTPS 证书信任问题,无需复杂配置即可创建浏览器信任的本地证书。
核心功能和特性
- 零配置:无需手动设置复杂的证书参数,开箱即用
- 本地可信:生成的证书基于本地 CA(证书颁发机构),安装 CA 后可被浏览器自动信任
- 灵活命名:支持为任意名称(如 localhost、IP 地址、自定义域名)生成证书
- 简单易用:通过命令行快速生成证书,无需深入了解 PKI(公钥基础设施)知识
使用场景和适用范围
- 本地 Web 服务开发:为本地运行的 Web 应用(如前端开发服务器、后端 API 服务)提供可信 HTTPS 支持
- 开发测试环境:在开发和测试阶段模拟 HTTPS 环境,避免浏览器因自签名证书显示安全警告
- 多服务测试:为多个本地服务(如微服务架构中的不同服务)生成独立证书
- 教育和演示:学习 HTTPS 原理时快速搭建本地可信证书环境
使用方法和配置说明
前提条件
- 已安装 Docker 环境
- 具备基本的命令行操作能力
快速开始
1. 创建命令别名(可选)
为简化 Docker 命令使用,建议创建别名:
bashalias mkcert="docker run -ti --rm alpine/mkcert"
2. 生成证书
使用以下命令生成包含指定名称的证书(例如 localhost、127.0.0.1、自定义服务名):
bashmkcert 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 安装到系统信任存储,确保证书被浏览器和系统自动信任:
bashmkcert -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
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull alpine/mkcert:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务