qtvhao/docker-mkcert

docker-mkcert镜像说明

镜像概述

本镜像无需在本地安装mkcert包，通过容器化方式运行mkcert服务，为本地开发环境生成有效的SSL证书，助力开发者在容器化场景中快速实现HTTPS配置。

核心功能

• 支持单域名或多域名SSL证书生成
• 共享卷存储证书数据，便于跨容器共享
• 可将根证书添加到系统钥匙链，实现本地信任

使用场景

适用于本地容器化开发场景，如API服务、Web应用开发等需要HTTPS支持的场景，帮助开发者模拟生产环境的安全配置。

配置说明

1. 创建共享卷

用于存储证书数据：

bash
docker volume create --name mkcert-data

2. 运行容器（单域名）

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

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

3. 运行容器（多域名）

通过逗号分隔指定多个域名：

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

4. 集成开发环境

将开发容器与共享卷挂载，使用生成的证书：

bash
# 假设已构建开发镜像（示例）
docker run -d -p 443:443 --name mkcert-dev -v mkcert-data:/tmp -it [你的开发镜像名]

5. 信任根证书（macOS示例）

复制根证书到本地并添加信任：

bash
mkdir ~/Documents/root-ca
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