lavue/certbot

Alpine 3.7容器中的独立Certbot

镜像概述和主要用途

本镜像为基于Alpine 3.7的独立Certbot容器，用于自动化获取、续期和管理Let's Encrypt SSL/TLS证书。主要适用于需要HTTPS加密的Web服务（如LaVue），提供轻量级、高效的证书生命周期管理解决方案。

核心功能和特性

• 轻量级基础：基于Alpine 3.7构建，镜像体积小，资源占用低
• Certbot集成：内置Certbot工具，支持自动获取和续期Let's Encrypt证书
• 多验证方式：支持HTTP-01、DNS-01等多种证书验证方式
• 持久化存储：可通过卷挂载实现证书持久化，确保数据不丢失
• 灵活配置：支持通过环境变量和命令参数自定义证书申请参数

使用场景和适用范围

• 为Web服务（如LaVue、Nginx、Apache等）配置SSL/TLS证书
• 自动化证书续期，避免手动操作导致证书过期
• 轻量级服务器环境，对镜像体积和资源占用有严格要求的场景
• 需要快速部署SSL证书的开发、测试及生产环境

使用方法和配置说明

基本使用步骤

1. 拉取镜像
2. 配置必要的环境变量和卷挂载
3. 运行容器执行证书申请或续期操作

配置参数

环境变量

卷挂载

Docker运行示例

bash
# HTTP-01验证方式申请证书
docker run -it --rm \
  -e DOMAINS="example.com,www.example.com" \
  -e EMAIL="admin@example.com" \
  -e CERTBOT_ARGS="--agree-tos" \
  -v /host/path/letsencrypt:/etc/letsencrypt \
  -v /host/path/webroot:/var/www/html \
  certbot-alpine:latest certonly --webroot -w /var/www/html

Docker Compose配置示例

yaml
version: '3'
services:
  certbot:
    image: certbot-alpine:latest
    container_name: certbot-lavue
    environment:
      - DOMAINS=example.com,www.example.com
      - EMAIL=admin@example.com
      - CERTBOT_ARGS=--agree-tos --non-interactive
    volumes:
      - ./letsencrypt:/etc/letsencrypt
      - ./webroot:/var/www/html
    command: certonly --webroot -w /var/www/html

贡献指南

• 代码规范：提交代码需遵循项目编码规范
• 测试要求：新增功能需编写相应测试用例
• 代码审查：通过Pull Request提交贡献，经代码审查通过后方可合并
• 文档更新：功能变更需同步更新相关文档

联系方式

• 仓库所有者或管理员
• 社区或团队联系方式