lelandsindt/hydrator

镜像概述

hydrator 是 nginx、dehydrated（Let's Encrypt ACME客户端）和 Let's Encrypt 的组合，用于自动化创建和续期 SSL 证书。注意：该项目已不再维护，建议使用 [*] 或 https://github.com/jwilder/nginx-proxy 替代。**

核心功能

• 自动生成和续期 Let's Encrypt SSL 证书
• 支持作为 SSL 卸载代理，为未加密应用提供加密前端
• 读取 nginx 配置中的 server_name 自动为对应域名生成证书
• 支持通过 domains.txt 配置多域名证书
• 支持持久化存储配置文件和证书

使用场景

1. 为静态网站或动态应用快速添加 HTTPS 支持
2. 为未加密的后端服务（如HTTP应用）提供 SSL 卸载，提升安全性

配置说明

速率限制提示

实验时请使用 Let's Encrypt staging URL，避免触发速率限制。详情见 https://github.com/lukas2511/dehydrated/tree/master/docs/staging.md%E3%80%82

快速部署示例

bash
mkdir -p /tmp/path/to/nginx/conf.d/
cat << EOF > /tmp/path/to/nginx/conf.d/default.conf
server {
    listen              443 ssl;
    server_name         your.domain.com;
    ssl_certificate     /etc/dehydrated/certs/your.domain.com/fullchain.pem;
    ssl_certificate_key /etc/dehydrated/certs/your.domain.com/privkey.pem;
    location / {
        root   /var/www/hydrated;
        index  index.html index.htm;
    }
}
EOF
docker create --name hydrator -v /tmp/path/to/nginx/conf.d/:/etc/nginx/conf.d/:ro -p 443:443 -p 80:80 lelandsindt/hydrator
docker start hydrator

SSL 卸载代理示例

假设后端有两台服务器（192.168.100.100:80 和 192.168.100.101:80）：

bash
mkdir -p /tmp/path/to/nginx/conf.d/
cat << EOF > /tmp/path/to/nginx/conf.d/default.conf
upstream backends {
    server 192.168.100.100:80;
    server 192.168.100.101:80;
}
server {
    listen              443 ssl;
    server_name         your.domain.com;
    ssl_certificate     /etc/dehydrated/certs/your.domain.com/fullchain.pem;
    ssl_certificate_key /etc/dehydrated/certs/your.domain.com/privkey.pem;
    ssl_protocols       TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers         HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;
    ssl_prefer_server_ciphers on;

    location / {
        proxy_set_header Host \$host;
        proxy_set_header X-Real-IP \$remote_addr;
        proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Host \$host:443;
        proxy_set_header X-Forwarded-Port 443;
        proxy_set_header X-Forwarded-Proto "https";
        proxy_read_timeout 300;
        proxy_pass http://backends/;
    }
}
EOF
docker create --name hydrator -v /tmp/path/to/nginx/conf.d/:/etc/nginx/conf.d/:ro -p 443:443 -p 80:80 lelandsindt/hydrator
docker start hydrator

持久化配置和证书

添加 -v /tmp/path/to/dehydrated/:/etc/dehydrated/ 可将 dehydrated 的配置文件和生成的证书持久化到容器外。需创建 dehydrated 配置文件（至少配置联系***）：

bash
mkdir -p /tmp/path/to/dehydrated/
cat << EOF > /tmp/path/to/dehydrated/config
CONTACT_EMAIL=you@your.domain.com
EOF

域名配置

1. 通过 server_name：hydrator 会为 nginx 配置中所有 server_name 对应的域名调用 dehydrated --domain your.domain.com 生成证书。
2. 通过 domains.txt：若 /etc/dehydrated/domains.txt 存在，hydrator 会使用该文件配置多域名证书（详情见 https://github.com/lukas2511/dehydrated/blob/master/docs/domains_txt.md%EF%BC%89%E3%80%82