vishnunair/docker-mkcert

docker-mkcert镜像说明

镜像概述

本镜像封装了mkcert工具，提供容器化的mkcert服务，帮助用户在本地开发环境中生成有效的SSL证书，无需在本地机器上直接安装mkcert包，适用于基于容器的本地开发场景。

核心功能

1. 生成针对本地域名的有效SSL证书
2. 支持多个域名同时配置
3. 通过共享卷与其他开发容器共享证书文件
4. 提供将根证书添加到系统信任链的方法

使用场景

• 本地Web应用开发需要HTTPS支持的场景
• API服务本地测试时的SSL证书需求
• 多域名本地环境的证书统一管理

配置说明

1. 创建共享卷

用于在mkcert容器和开发容器之间共享证书数据：

bash
docker volume create --name mkcert-data

2. 运行mkcert容器（单域名）

指定本地域名（如dev.localhost.com）：

bash
docker run -d -e domain=dev.localhost.com --name mkcert -v mkcert-data:/root/.local/share/mkcert vishnunair/docker-mkcert

3. 运行mkcert容器（多域名）

通过逗号分隔多个域名：

bash
docker run -d -e domain=api.staging.com,dev.localhost.com,stg.localhost.com --name mkcert -v mkcert-data:/root/.local/share/mkcert vishnunair/docker-mkcert

4. 连接到开发环境

将共享卷挂载到开发容器的证书目录（以Go语言HTTP服务器为例）：

bash
# 构建开发镜像
docker build -f Dockerfile.dev -t=vishnunair/docker-mkcert-dev .
# 运行开发容器并挂载共享卷
docker run -d -p 443:443 --name mkcert-dev -v mkcert-data:/tmp -it vishnunair/docker-mkcert-dev

5. 添加根证书到系统信任链（以macOS为例）

bash
# 创建目录存储根证书
mkdir ~/Documents/root-ca
# 从mkcert容器复制根证书到本地
docker cp mkcert:/root/.local/share/mkcert ~/Documents/root-ca
# 将根证书添加到系统钥匙串
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/Documents/root-ca/mkcert/rootCA.pem