mkcert

alpine/mkcert Docker Image

mkcert - 一个简单的零配置工具,用于生成具有任意名称的本地可信开发证书。

1 次收藏下载次数: 0状态:社区镜像维护者:Alpine 工具与轻量镜像仓库类型:镜像最近更新:

镜像概述

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

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 mkcert 镜像标签

docker pull docker.xuanyuan.run/alpine/mkcert:<标签>

DockerHub 原生拉取命令

docker pull alpine/mkcert:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告