mkcert

dcagatay/mkcert Docker 镜像

dcagatay/mkcert是将mkcert工具容器化的镜像,可用于生成自有的可信根CA证书以及指定域名的SSL证书,方便开发环境快速配置本地HTTPS服务。

1 次收藏下载次数: 0状态:社区镜像维护者:dcagatay仓库类型:镜像最近更新:
下载命令
点击查看

镜像概述

dcagatay/mkcert 是知名本地证书生成工具 mkcert 的容器化实现,无需在本地安装依赖即可快速创建自定义可信根证书颁发机构(CA)证书,以及适配任意域名的可信SSL证书,非常适合本地开发环境快速搭建HTTPS服务。

核心功能

  • 一键生成符合可信标准的本地根CA证书
  • 基于已有根CA批量生成多域名、通配符域名SSL证书
  • 支持自定义证书文件的所属用户ID与组ID,解决挂载卷文件权限问题
  • 兼容存量根CA文件,可复用已生成的可信证书体系

使用场景

  • 本地Web开发环境快速配置HTTPS服务,避免浏览器安全提示
  • 内网测试环境批量部署自签名可信证书
  • 开发团队统一生成内部服务信任的根证书,简化多设备证书配置流程

配置说明

基础使用

运行容器时将本地证书目录挂载至容器内的/certs路径,执行命令后生成的证书文件将持久化存储到本地:

仅生成根CA证书

sh
docker run --rm -it -v "$PWD/certs:/certs" docker.xuanyuan.run/dcagatay/mkcert

生成指定域名的SSL证书

注意通配符域名需要用单引号包裹,避免本地Shell提前解析通配符:

sh
docker run --rm -it -v "$PWD/certs:/certs" docker.xuanyuan.run/dcagatay/mkcert example.com www.example.com '*.example.com'

如果/certs/ca目录下已存在rootCA.pem和rootCA-key.pem根证书文件,工具会自动复用该根CA签发新的业务域名证书。

高级配置

默认生成的证书文件所属用户为root,可通过传入PUID和PGID环境变量自定义文件权限,适配本地当前用户的读写权限:

sh
docker run --rm -it -e "PUID=$(id -u)" -e "PGID=$(id -g)" -v "$PWD/certs:/certs" docker.xuanyuan.run/dcagatay/mkcert example.com www.example.com '*.example.com'

本地构建镜像

可基于源码自行构建镜像:

sh
docker buildx build -t dcagatay/mkcert:latest .

版本更新说明

v1.4.4版本变更点:

  1. 根证书存储目录从/certs迁移至/certs/ca,旧版本用户需要将原有rootCA.pem和rootCA-key.pem移动到/certs/ca路径下
  2. 原UID和GID环境变量重命名为PUID和PGID

致谢

  • 核心工具项目:https://github.com/FiloSottile/mkcert
  • 镜像实现参考:https://github.com/vishnudxb/docker-mkcert

镜像拉取方式

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

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

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

DockerHub 原生拉取命令

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