eilandert/letsencrypt

Let's Encrypt 容器（测试版）

镜像概述

这是一个简单的Let's Encrypt容器（测试版），主要用于自动获取和更新SSL证书。运行容器后，它会尝试更新证书，并每24小时再次检查续期。支持webroot和standalone两种工作模式，适用于不同的Web服务器场景。

核心功能与特性

• 支持webroot和standalone两种证书获取模式
• 自动续期机制，每日检查并更新证书
• 可通过docker exec执行certbot命令手动获取新证书
• 证书共享存储，便于与Web服务器容器协同工作

使用场景与适用范围

适用于需要为Web服务器配置SSL证书的场景，尤其适合：

• Web服务持续运行场景：使用webroot模式，无需停止现有Web服务即可完成证书验证
• 临时证书配置场景：使用standalone模式，适合没有运行Web服务或可临时停止服务的环境

使用方法与配置说明

获取新证书

执行以下命令手动请求新证书：

bash
docker exec -it letsencrypt certbot certonly

若选择webroot验证方式，指定webroot路径为/var/www/html。

模式一：webroot模式

通过Web服务器的文件系统进行证书验证，无需停止Web服务。

配置步骤

1. 挂载共享目录
   在letsencrypt容器和Web服务器容器中挂载同一个目录：

   • letsencrypt容器：挂载目录到/var/www/html（用于ACME验证文件）
   • Web服务器容器：挂载相同目录到Web服务可访问路径

2. 配置Web服务器
   以Nginx为例，添加以下location块以支持ACME验证：

   nginx
   location ^~ /.well-known/acme-challenge/ {
       default_type "text/plain";
       root /var/www/html;
       return 404;
   }
   

3. docker-compose示例

   yaml
   version: '3'
   services:
     letsencrypt:
       image: docker.xuanyuan.run/your-letsencrypt-image
       volumes:
         - ./shared/html:/var/www/html
         - ./certs:/etc/letsencrypt
       restart: always
   
     nginx:
       image: docker.xuanyuan.run/nginx:latest
       ports:
         - "80:80"
         - "443:443"
       volumes:
         - ./shared/html:/var/www/html
         - ./nginx/conf.d:/etc/nginx/conf.d
         - ./certs:/etc/letsencrypt
       depends_on:
         - letsencrypt
   

模式二：standalone模式

直接通过容器自身监听80/443端口进行证书验证，需要确保端口可用。

配置步骤

1. 停止现有Web服务
   确保80和443端口未被占用，需先停止当前运行的Web服务器。

2. 挂载证书目录
   在letsencrypt容器和Web服务器容器中挂载共享的证书存储目录：

   bash
   docker run -d \
     --name letsencrypt \
     -p 80:80 \
     -p 443:443 \
     -v /path/to/shared/certs:/etc/letsencrypt \
     docker.xuanyuan.run/your-letsencrypt-image
   

3. 完成后重启Web服务
   证书获取完成后，重启Web服务器，并挂载相同的证书目录以使用新证书。

注意事项

• 该容器目前为测试版，生产环境使用前建议充分测试
• standalone模式下，必须确保80和443端口在容器运行期间无其他服务占用
• 证书续期过程自动执行，无需手动干预，但需确保容器持续运行