staticfloat/nginx-certbot

注意：本仓库已进入维护模式

Jonas Alfredsson维护的https://github.com/JonasAlfredsson/docker-nginx-certbot/%E5%85%B7%E5%A4%87%E6%9B%B4%E5%A4%9A%E6%96%B0%E7%89%B9%E6%80%A7%E4%B8%94%E6%9B%B4%E6%B4%BB%E8%B7%83%EF%BC%8C%E5%BB%BA%E8%AE%AE%E6%89%80%E6%9C%89%E7%94%A8%E6%88%B7%E8%BF%81%E7%A7%BB%E8%87%B3%E8%AF%A5%E9%95%9C%E5%83%8F%EF%BC%8C%E5%85%B6%E5%9C%A8%E4%BF%9D%E6%8C%81%E6%98%93%E7%94%A8%E6%80%A7%E7%9A%84%E5%90%8C%E6%97%B6%E5%8A%9F%E8%83%BD%E6%9B%B4%E4%BC%98%E3%80%82

docker-nginx-certbot

基于nginx web服务器，使用免费证书机构letsencrypt及其客户端certbot创建并自动续期网站SSL证书。

本仓库最初从@henridwyer分叉，感谢其创意。之后经过完全重写，与原版本几乎无相似之处，对web服务器/容器结构有更明确的约定，但只要遵循该模式，使用会更简单。

核心功能

1. 自动向Let's Encrypt申请SSL/TLS证书
2. 定期自动续期证书，无需手动操作
3. 支持通过envsubst进行配置模板化，可动态替换环境变量
4. 基于官方nginx镜像构建，兼容标准nginx配置规范

使用场景

适用于需要为网站启用HTTPS的个人或企业场景，尤其是希望减少证书管理手动操作、确保证书持续有效的用户。

配置说明

步骤1：创建配置目录

bash
mkdir conf.d

步骤2：编写nginx配置文件

在conf.d目录下创建*.conf文件（如nginx.conf，不能仅为.conf）：

nginx
server {
    listen              443 ssl;
    server_name         server.company.com;
    ssl_certificate     /etc/letsencrypt/live/server.company.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/server.company.com/privkey.pem;

    location / {
        ... # 此处填写你的业务配置
    }
}

步骤3：编写docker-compose.yml

yml
version: '3'
services:
    frontend:
        restart: unless-stopped
        image: staticfloat/nginx-certbot
        ports:
            - 80:80/tcp
            - 443:443/tcp
        environment:
            CERTBOT_EMAIL: owner@company.com # 填写你的邮箱用于证书通知
        volumes:
          - ./conf.d:/etc/nginx/user.conf.d:ro # 挂载自定义配置
          - letsencrypt:/etc/letsencrypt # 持久化证书数据
volumes:
    letsencrypt:

步骤4：启动服务

运行以下命令启动容器：

bash
docker-compose up -d

certbot会自动为所有在nginx配置中引用/etc/letsencrypt/live路径证书的站点申请SSL证书，并定期续期。

注意：监听80端口的server块可能影响证书续期，本容器已处理80到443的转发，无需额外配置80端口的server块。

配置模板化

若需通过环境变量动态生成配置（如多站点部署），可使用envsubst功能。示例：

模板配置文件（user.conf.d/nginx_template.conf）

nginx
server {
    listen              443 ssl;
    server_name         ${FQDN};
    ssl_certificate     /etc/letsencrypt/live/${FQDN}/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/${FQDN}/privkey.pem;

    ... # 业务配置
}

带模板的docker-compose.yml

yml
version: '3'
services:
    frontend:
        restart: unless-stopped
        image: staticfloat/nginx-certbot
        ports:
            - 80:80/tcp
            - 443:443/tcp
        environment:
            CERTBOT_EMAIL: owner@company.com
            ENVSUBST_VARS: FQDN # 空格分隔的环境变量列表
            FQDN: server.company.com # 替换模板中的${FQDN}
        volumes:
          - ./conf.d:/etc/nginx/user.conf.d:ro
          - letsencrypt:/etc/letsencrypt
volumes:
    letsencrypt:

变更日志

1.2

• 正式进入维护模式。

1.1

• 升级环境至Python 3，优化初始设置和续期流程的体验。

1.0

• 感谢全球贡献者的改进，大幅减少自定义需求：配置可直接挂载到预构建镜像，且支持模板化。

0.8

• 移除cron，改用sleep和while循环实现定期任务。

0.7

• 完全重写，基于nginx镜像构建，同时运行cron/certbot与nginx，实现证书可用时动态启用nginx配置。

0.6

• 在/etc/letsencrypt/添加nginx_auto_enable.sh脚本，支持SSL证书可用前启动nginx。

0.5

• 更名为docker-certbot-cron，更新文档，移除无关内容。

0.4

• 移除大量内容，按@staticfloat的方式重构。

0.3

• 支持webroot模式；一次为所有域名运行certbot。

0.2

• 升级为certbot客户端；改用alpine linux镜像。

0.1

• 初始版本发布。