grupovoalle/webserver

集成Certbot的Nginx Web服务器镜像

镜像概述

本Docker镜像基于Nginx构建，集成了Certbot工具，旨在简化HTTPS网站部署流程。通过整合Nginx的Web服务能力与Certbot的SSL证书管理功能，实现自动申请、配置和续期Let's Encrypt免费SSL/TLS证书，帮助用户快速搭建安全的HTTPS服务，无需手动处理复杂的证书操作。

核心功能与特性

• 完整Web服务能力：基于官方Nginx镜像，提供标准HTTP/HTTPS服务、反向代理、负载均衡等Nginx核心功能。
• Certbot深度集成：内置Certbot客户端，支持与Let's Encrypt证书颁发机构交互，自动完成证书申请、验证和配置。
• 自动证书续期：配置定时任务，自动检测证书有效期，在到期前30天触发续期流程，确保证书持续有效。
• 灵活配置支持：允许通过环境变量、配置文件挂载等方式自定义Nginx站点配置、证书申请参数和续期策略。
• 数据持久化：证书和配置文件支持外部挂载，确保容器重启或重建后数据不丢失。

使用场景

• 个人/小型网站：快速部署个人博客、作品集等站点，低成本实现HTTPS加密。
• 开发测试环境：在本地或测试服务器中模拟生产环境的HTTPS配置，验证SSL相关功能。
• 小型企业服务：为企业官网、内部系统提供安全的Web访问，减少证书管理的人工成本。
• 自动化部署流程：集成到CI/CD管道中，实现HTTPS服务的自动化部署与证书管理。

使用方法与配置说明

基本使用（docker run）

首次运行时需申请证书并启动服务：

bash
docker run -d \
  --name nginx-certbot \
  -p 80:80 \
  -p 443:443 \
  -e DOMAINS="example.com,www.example.com" \
  -e EMAIL="admin@example.com" \
  -e STAGING=0 \
  -v ./nginx/conf:/etc/nginx/conf.d \
  -v ./certbot/conf:/etc/letsencrypt \
  -v ./certbot/www:/var/www/certbot \
  your-image-name

环境变量说明

配置文件与数据持久化

必要挂载目录

• Nginx配置目录：/etc/nginx/conf.d
  需挂载本地目录包含自定义站点配置文件（如：default.conf），示例配置：

  nginx
  server {
      listen 80;
      server_name example.com www.example.com;
      # 将HTTP请求重定向到HTTPS（或用于Certbot验证）
      location /.well-known/acme-challenge/ {
          root /var/www/certbot;
      }
      location / {
          return 301 https://$host$request_uri;
      }
  }
  

• 证书存储目录：/etc/letsencrypt
  用于持久化存储Certbot生成的SSL证书及配置，必须挂载为外部卷，避免容器重建后证书丢失。

• Certbot验证目录：/var/www/certbot
  用于Let's Encrypt的HTTP-01验证，需确保Nginx配置中正确指向此目录（如上述示例配置）。

docker-compose示例

yaml
version: '3'
services:
  nginx-certbot:
    image: your-image-name
    ports:
      - "80:80"
      - "https://443:443"
    environment:
      - DOMAINS=example.com,www.example.com
      - EMAIL=admin@example.com  
      - STAGING=0
    volumes:
      - ./nginx/conf:/etc/nginx/conf.d
      - ./certbot/conf:/etc/letsencrypt
      - ./certbot/www:/var/www/certbot
    restart: always

证书管理操作

-** 手动申请证书 **（首次运行未自动申请时）：
进入容器后执行：

bash
certbot certonly --webroot -w /var/www/certbot -d example.com -d www.example.com --email admin@example.com --agree-tos

-** 手动续期证书 **：

bash
docker exec nginx-certbot certbot renew --force-renewal

-** 查看证书状态 **：

bash
docker exec nginx-certbot certbot certificates

注意事项*首次运行需确保端口80/443对外开放，且域名解析正确指向当前服务器（Let's Encrypt验证需通过公网访问）生产环境中建议设置强密码保护Certbot配置目录，并定期备份证书文件如需自定义Nginx高级配置（如SSL协议版本、加密套件），可在挂载的Nginx配置文件中添加相关参数（如ssl_protocols TLSv1.2 TLSv1.3;）