dcagatay查看 Docker Hub 原文页
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证书
shdocker run --rm -it -v "$PWD/certs:/certs" docker.xuanyuan.run/dcagatay/mkcert
生成指定域名的SSL证书
注意通配符域名需要用单引号包裹,避免本地Shell提前解析通配符:
shdocker 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环境变量自定义文件权限,适配本地当前用户的读写权限:
shdocker 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'
本地构建镜像
可基于源码自行构建镜像:
shdocker buildx build -t dcagatay/mkcert:latest .
版本更新说明
v1.4.4版本变更点:
- 根证书存储目录从
/certs迁移至/certs/ca,旧版本用户需要将原有rootCA.pem和rootCA-key.pem移动到/certs/ca路径下 - 原
UID和GID环境变量重命名为PUID和PGID
致谢
- 核心工具项目:https://github.com/FiloSottile/mkcert
- 镜像实现参考:https://github.com/vishnudxb/docker-mkcert
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull dcagatay/mkcert:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务