aegypius/mkcert-for-nginx-proxy

mkcert for nginx-proxy

镜像概述和主要用途

mkcert-for-nginx-proxy是[nginx-proxy/nginx-proxy]的轻量级配套容器。它深受[nginx-proxy/acme-companion]的启发，允许使用根证书颁发机构创建/续期自签名证书。

核心功能和特性

• 利用原始nginx-proxy容器自动创建/续期自签名证书
• 支持创建多域名（SAN）证书
• 兼容所有Docker版本

使用场景和适用范围

适用于需要在本地开发或测试环境中使用HTTPS，但无需公共证书颁发机构（CA）签发证书的场景。可配合nginx-proxy实现自动的自签名证书管理，简化本地HTTPS环境配置。

使用方法和配置说明

Docker Compose配置示例

以下是与nginx-proxy/nginx-proxy配合使用的docker-compose文件示例：

yaml
version: '3.2'

networks:
  proxy:
    driver: bridge

services:

  mkcert:
    image: aegypius/mkcert-for-nginx-proxy
    restart: unless-stopped
    volumes:
    - ssl-certs:/app/certs:rw
    - ~/.mozilla/firefox:/root/.mozilla/firefox:rw
    - ~/.pki/nssdb:/root/.pki/nssdb:rw
    - ${CA_STORE:-/usr/local/share/ca-certificates}:/usr/local/share/ca-certificates
    - /var/run/docker.sock:/var/run/docker.sock:ro

  proxy:
    image: nginx-proxy/nginx-proxy
    labels:
      com.github.aegypius.mkcert-for-nginx-proxy.nginx_proxy: ''
    networks:
      proxy: {}
    ports:
    - published: 80
      target: 80
    - published: 443
      target: 443
    restart: unless-stopped
    volumes:
    - ssl-certs:/etc/nginx/certs:ro
    - /var/run/docker.sock:/tmp/docker.sock:ro

volumes:
  ssl-certs: {}

环境变量配置

需根据操作系统发行版设置CA_STORE环境变量：

Ubuntu / Debian:

shell
docker-compose up
sudo update-ca-certificates

Arch / Manjaro:

shell
echo 'CA_STORE=/etc/ca-certificates/trust-source/anchors' >> .env
docker-compose up
sudo trust extract-compat

Fedora / RHEL / CentOS:

shell
echo 'CA_STORE=/etc/pki/ca-trust/source/anchors' >> .env
docker-compose up
sudo update-ca-trust extract

Gentoo:

shell
echo 'CA_STORE=/etc/ssl/certs' >> .env
docker-compose up
sudo update-ca-certificates

注意事项

配置完成后，请重启浏览器使证书生效。

相关项目

• https://github.com/FiloSottile/mkcert
• https://github.com/nginx-proxy/acme-companion
• https://github.com/nginx-proxy/docker-gen
• https://github.com/nginx-proxy/nginx-proxy