tauproject/certbot

Tau Hypercomputing Facility 证书配置服务容器

镜像概述和主要用途

该Docker容器镜像为Tau Hypercomputing Facility的证书配置服务，封装了certbot工具，用于从符合ACME协议的证书机构（如Let's Encrypt）获取TLS证书。

核心功能和特性

• 封装certbot工具，提供ACME协议支持
• 支持从Let's Encrypt等证书机构获取TLS证书
• 通过挂载宿主机目录实现证书数据持久化
• 命令行参数直接传递给letsencrypt-auto，保持与原生certbot使用方式一致

使用场景和适用范围

适用于需要自动获取和管理TLS证书的环境，特别是：

• 需要为域名配置HTTPS的服务器
• 希望自动化证书申请和续期流程的场景
• 可暴露80端口或能够转发ACME验证请求（/.well-known/acme路径）的环境

发布状态

使用方法和配置说明

前提条件

假设用户已熟悉certbot的基本使用方法。

拉取镜像

根据发布状态选择合适的镜像标签。当前可用的预生产版本标签为shimmer：

bash
$ docker pull tauproject/certbot:shimmer

创建证书存储目录

certbot默认将文件存储在/etc/letsencrypt目录。如果该目录不存在，需先创建：

bash
$ sudo mkdir -p /etc/letsencrypt

运行容器

容器参数直接传递给letsencrypt-auto，例如查看帮助：

bash
$ docker run -v /etc/letsencrypt -it tauproject/certbot:shimmer help

颁发证书

为确保证书申请成功，需暴露容器的80端口（或转发/.well-known/acme路径请求）。以下示例假设主机未运行其他Web服务器：

bash
$ docker run -v /etc/letsencrypt -p 80:80 -it tauproject/certbot:shimmer certonly -d mydomain.example.com

开发信息

源代码控制

项目公开仓库托管在https://github.com/tauproject/certbot/%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%E4%BB%A5%E4%B8%8B%E5%91%BD%E4%BB%A4%E5%85%8B%E9%9A%86%EF%BC%9A

bash
# 使用Git协议
$ git clone -b shimmer/master git://github.com/tauproject/certbot.git

# 或使用HTTPS协议
$ git clone -b shimmer/master https://github.com/tauproject/certbot.git

自动构建

Travis CI

Travis CI每天至少对每个发布分支执行一次完整构建，并将结果镜像推送到https://hub.docker.com/r/tauproject/certbot/%EF%BC%8C%E8%BF%99%E4%BA%9B%E9%95%9C%E5%83%8F%E6%9E%84%E6%88%90%E5%AE%98%E6%96%B9%E5%8F%91%E5%B8%83%E7%89%88%E6%9C%AC%E3%80%82

Docker Cloud

Docker Cloud也配置了自动构建，用于确保https://hub.docker.com/r/tauproject/certbot/%E4%B8%8A%E7%9A%84%E4%BF%A1%E6%81%AF%E6%9B%B4%E6%96%B0%EF%BC%8C%E7%94%9F%E6%88%90%E7%9A%84%60cloudbuild%60%E6%A0%87%E7%AD%BE%E5%8F%AF%E5%BF%BD%E7%95%A5%E3%80%82

版权信息

Copyright © 2018.

本项目基于Apache License, Version 2.0许可。您必须遵守许可条款才能使用本文件。

您可以从以下地址获取许可副本：

[***]

除非适用***要求或书面同意，否则根据许可分发的软件按"原样"分发，不提供任何明示或暗示的保证或条件。有关许可下权限和限制的具体规定，请参见许可协议。