xmb5/docker-nginx-certbot

docker-nginx-certbot镜像说明

镜像概述

本镜像基于nginx构建，集成Let's Encrypt官方客户端certbot，实现SSL证书的自动获取与定期续期，同时优化了稳定性并添加nginx sub_filter模块，便于Web服务快速启用HTTPS。

核心功能

1. 自动向Let's Encrypt申请免费SSL证书
2. 定期检测并续期即将过期的证书
3. 支持自定义nginx配置文件
4. 包含nginx sub_filter模块，可实现内容替换功能

使用场景

• 个人或企业网站需要启用HTTPS协议
• Web服务部署中希望自动管理SSL证书续期
• 需要使用nginx sub_filter功能进行页面内容修改的场景

配置说明

步骤1：创建配置目录

bash
mkdir conf.d

步骤2：编写nginx配置文件

在conf.d目录下创建自定义.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

创建docker-compose.yml文件：

yml
version: '3'
services:
    frontend:
        restart: unless-stopped
        image: docker.xuanyuan.run/xmb5/docker-nginx-certbot
        ports:
            - 80:80/tcp
            - 443:443/tcp
        environment:
            - CERTBOT_EMAIL=owner@company.com # 用于接收证书相关通知
        volumes:
          - ./conf.d:/etc/nginx/user.conf.d # 挂载自定义配置目录

步骤4：启动服务

bash
docker-compose up -d

版本变更记录

0.8

• 移除cron，改用sleep+while循环实现定期续期

0.7

• 基于nginx镜像重构，同时运行certbot和nginx，支持证书动态生效

0.6

• 添加nginx_auto_enable.sh脚本，支持证书未就绪时启动nginx

0.5

• 重命名镜像，更新文档

0.4

• 简化冗余功能

0.3

• 支持webroot模式，一次处理所有域名证书

0.2

• 升级为certbot客户端，基于Alpine Linux构建

0.1

• 初始版本发布