radersolutions/letsencryptnginx

镜像概述

本镜像基于linuxserver.io的https://github.com/linuxserver/docker-letsencrypt%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%B8%BB%E8%A6%81%E5%8A%9F%E8%83%BD%E6%98%AF%E4%BD%9C%E4%B8%BA%E4%B8%BB%E9%A1%B9%E7%9B%AE%E6%9B%B4%E6%96%B0%E7%9A%84%E7%BD%91%E5%85%B3%EF%BC%8C%E6%8F%90%E4%BE%9B%E8%87%AA%E5%8A%A8Let's Encrypt证书管理能力。

核心功能与特性

基于原镜像的增强

• 继承原letsencrypt nginx镜像的核心功能，包括自动Let's Encrypt证书申请与续期
• 作为主项目更新的网关，提供请求转发与安全控制能力

主要变更

1. 调整certbot模式（已弃用）
   因https://community.letsencrypt.org/t/important-what-you-need-to-know-about-tls-sni-validation-issues/50811%EF%BC%8C%E5%8E%9F%E8%B0%83%E6%95%B4certbot%E4%BD%BF%E7%94%A8http%E6%A8%A1%E5%BC%8F%E4%BB%A5%E5%85%81%E8%AE%B8nginx%E4%BD%BF%E7%94%A8proxy_protocol ssl监听器的功能已弃用。

2. 优化容器稳定性
   初始certbot执行失败时，容器将进入无限期休眠状态。此设计避免了在使用--restart=unless-stopped或--restart=always参数时，因certbot持续失败导致的容器不断重启问题。

使用场景与适用范围

• 需要自动管理SSL证书的NGINX部署环境
• 作为主项目的前端网关，需确保稳定运行的场景
• 对容器重启行为有严格控制要求的生产环境

使用方法与配置说明

基础使用

建议参考原linuxserver.io letsencrypt nginx镜像的使用文档进行基础配置。本镜像的使用方式与原镜像基本一致，主要差异在于certbot失败处理机制。

Docker Run示例

bash
docker run -d \
  --name=letsencrypt-gatekeeper \
  --restart=unless-stopped \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/config:/config \
  your-image-name:latest

Docker Compose示例

yaml
version: '3'
services:
  letsencrypt-gatekeeper:
    image: your-image-name:latest
    container_name: letsencrypt-gatekeeper
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /path/to/config:/config

关键配置说明

1. 证书管理
   证书申请与续期逻辑与原letsencrypt镜像一致，通过配置文件指定域名、***等信息。

2. 失败处理
   当初始certbot证书申请失败时，容器将进入休眠状态，而非退出。此时需手动排查问题（如域名解析、网络连通性等），修复后可通过docker restart重启容器。

3. 重启策略
   推荐使用--restart=unless-stopped或--restart=always参数，配合本镜像的失败休眠机制，确保容器在非证书问题情况下能自动恢复。

注意事项

• 原certbot http模式调整已因TLS验证机制变更而弃用，无需额外配置相关参数
• 首次部署时需确保域名解析正确且80/443端口可访问，避免certbot初始失败导致容器进入休眠
• 配置文件路径/config需持久化存储，以保留证书和NGINX配置