kpcyrd/acme-redirect

acme-redirect 镜像说明

镜像概述

acme-redirect是一款轻量级HTTP守护进程，核心功能为处理ACME证书挑战请求，并将所有非挑战的HTTP流量重定向至HTTPS。它支持多域名证书管理与自动续期，能触发Web服务器重载，是简化网站HTTPS配置的高效工具。

核心功能

1. ACME挑战响应：处理HTTP-01挑战，支持Let's Encrypt等机构的证书验证请求。
2. HTTPS重定向：将所有非挑战HTTP请求301重定向至对应HTTPS地址。
3. 自动续期：自动更新证书并执行预设命令（如重载Nginx/Apache）。
4. 多域名支持：通过配置文件管理多个域名的证书与重定向规则。

使用场景

• 网站需启用HTTPS并自动管理SSL证书。
• 简化Web服务器配置，无需手动处理ACME挑战路径。
• 生产环境轻量级证书管理方案，资源占用低。

配置说明

基础配置

创建TOML格式配置文件，放置于/etc/acme-redirect.d/目录（Docker部署需挂载该目录）：

toml
# example.com.conf
[cert]
name = "example.com"
dns_names = ["example.com", "www.example.com"]
exec = ["systemctl reload nginx"]  # Docker环境可调整为容器内命令或主机映射触发

Docker部署示例

Docker Run命令

bash
docker run -d \
  --name acme-redirect \
  -p 80:80 \
  -v /your/host/config:/etc/acme-redirect.d \
  -v /your/host/certs:/var/lib/acme-redirect/live \
  -v /your/host/challs:/var/lib/acme-redirect/challs \
  kpcyrd/acme-redirect

Docker Compose示例

yaml
version: '3'
services:
  acme-redirect:
    image: kpcyrd/acme-redirect
    ports: ["80:80"]
    volumes:
      - ./config:/etc/acme-redirect.d
      - ./certs:/var/lib/acme-redirect/live
      - ./challs:/var/lib/acme-redirect/challs
    restart: always

Web服务器配置示例

Nginx配置

nginx
server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name example.com www.example.com;

    ssl_certificate /var/lib/acme-redirect/live/example.com/fullchain;
    ssl_certificate_key /var/lib/acme-redirect/live/example.com/privkey;
    
    ssl_session_timeout 1d;
    ssl_session_cache shared:MozSSL:10m;
    ssl_session_tickets off;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;
    add_header Strict-Transport-Security "max-age=63072000" always;
}

Apache配置

apache
<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com
    SSLEngine on
    SSLCertificateFile /var/lib/acme-redirect/live/example.com/fullchain
    SSLCertificateKeyFile /var/lib/acme-redirect/live/example.com/privkey
    
    Protocols h2 http/1.1
    Header always set Strict-Transport-Security "max-age=63072000"
</VirtualHost>

许可证

本镜像基于GPLv3+许可证发布。