LinuxServer Docker LetsEncrypt 容器深度指南

最新推荐文章于 2024-12-17 09:40:29 发布

翟万实Robust

最新推荐文章于 2024-12-17 09:40:29 发布

阅读量684

点赞数 24

本文链接：https://blog.csdn.net/gitblog_00164/article/details/141046240

版权

LinuxServer Docker LetsEncrypt 容器深度指南

docker-letsencryptDEPRECATED: Please use linuxserver/swag instead项目地址:https://gitcode.com/gh_mirrors/do/docker-letsencrypt

一、项目介绍

LinuxServer 的 Docker-LetsEncrypt 项目是一个旨在自动获取并更新 Let's Encrypt TLS/SSL 证书的 Docker 镜像。尽管项目已标记为弃用，并建议转向使用 LinuxServer/SWAG 替代，但对于理解基于 Docker 的证书自动化过程仍具有极高的参考价值。

此镜像集成了多种功能，包括但不限于 CloudFlare DNS 插件集成、预生成的 Diffie-Hellman 参数，以及自动生成和管理 HTTPS 证书的能力。该容器设计用于适应各种环境需求，从简单到复杂的多域证书配置皆可应对。

二、项目快速启动

以下示例展示了如何在本地环境中快速部署 LinuxServer 的 Docker-LetsEncrypt：

基础配置

首先，确保你的 Docker 环境已经设置好。然后，在终端中运行以下命令来下载并启动 Docker 镜像：

docker pull linuxserver/letsencrypt
docker run -d \
    --name=letsencrypt \
    -e URL=<YOUR_DOMAIN_URL> \
    -e SUBDOMAINS=<SUBDOMAINS> \
    -e VALIDATION=http \
    -e DNSPLUGIN=<DNS_PLUGIN> \
    -v /path/to/appdata/config:/config \
    --restart unless-stopped \
    linuxserver/letsencrypt

其中 <YOUR_DOMAIN_URL> 和 <SUBDOMAINS> 应替换为你想要保护的主域名和子域名（如 www）；<DNS_PLUGIN> 是用来验证的 DNS 提供商插件，如果是使用 HTTP 验证则可以忽略这个选项。

Docker Compose 配置

使用 Docker Compose 可以更优雅地管理和编排服务。以下是基本的 docker-compose.yml 文件示例：

version: '2.1'
services:
  swag:
    image: linuxserver/letsencrypt
    container_name: swag
    cap_add:
      - NET_ADMIN
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - URL=<YOUR_DOMAIN_URL>
      - SUBDOMAINS=<SUBDOMAINS>
      - VALIDATION=http
      - DNSPLUGIN=<DNS_PLUGIN>
      - DUCKDNSTOKEN=<TOKEN>
    volumes:
      - /path/to/appdata/config:/config
    restart: unless-stopped

在这个例子中，<TOKEN> 对应于 DuckDNS 或其他提供此类认证机制的服务。

三、应用案例和最佳实践

对于证书安全性和隐私性的要求较高时，推荐采用更为安全的数据共享方法。具体而言：

(较简单的方案) 将整个容器的配置文件夹挂载到其他容器 (-v /path-to-le-config:/le-ssl) 并在其他容器中使用证书位置 /le-ssl/keys/letsencrypt/。
(更安全的方案) 挂载位于 /config 下的 letsencrypt 目录到其他容器 (-v /path-to-le-config/etc/letsencrypt:/le-ssl)，并在这些容器内使用路径 /le-ssl/live/<your domain url>/ 访问证书。这种做法仅分享 SSL/TLS 证书而不会暴露完整的配置信息。

通过输入你的电子邮件地址至 Docker 参数的方式接收 Let's Encrypt 发送的证书到期通知是被推荐的做法。