cozza38/docker-letsencrypt

linuxserver/letsencrypt 镜像说明

镜像概述

本镜像由LinuxServer.io团队维护，整合Nginx web服务器、PHP运行环境、Let's Encrypt客户端及fail2ban入侵防护工具。它能自动完成免费SSL证书的生成与续期，提供反向代理功能，支持多架构部署，适合个人或小型企业搭建安全的HTTPS服务。

核心功能

1. 自动SSL证书管理：内置Let's Encrypt客户端，支持HTTP、DNS等验证方式，自动生成、续期免费SSL证书。
2. Nginx服务：高性能web服务器与反向代理，支持PHP应用运行。
3. 安全防护：集成fail2ban，有效防止暴力破解等入侵行为。
4. 多架构支持：兼容x86-64、arm64、armhf架构，适配不同硬件设备。
5. 灵活配置：支持用户ID/组ID映射（解决权限问题），可自定义时区、域名、子域名等参数。

使用场景

• 个人网站/博客需要HTTPS加密访问。
• 为内部服务（如NAS、应用服务器）提供反向代理与SSL加密。
• 需要简单高效的SSL证书管理方案，避免手动操作。
• 对服务安全性有基础要求，需入侵防护功能。

配置说明

部署示例

Docker Run命令

bash
docker create \
  --name=letsencrypt \
  --cap-add=NET_ADMIN \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e URL=yourdomain.com \
  -e SUBDOMAINS=www,api \
  -e VALIDATION=http \
  -e EMAIL=your@email.com \
  -p 443:443 \
  -p 80:80 \
  -v /path/to/your/config:/config \
  --restart unless-stopped \
  linuxserver/letsencrypt

Docker Compose配置

yaml
version: "2"
services:
  letsencrypt:
    image: linuxserver/letsencrypt
    container_name: letsencrypt
    cap_add:
      - NET_ADMIN
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - URL=yourdomain.com
      - SUBDOMAINS=www,api
      - VALIDATION=http
      - EMAIL=your@email.com
    volumes:
      - /path/to/your/config:/config
    ports:
      - 443:443
      - 80:80
    restart: unless-stopped

关键参数说明

应用设置要点

1. 证书验证：
   • HTTP验证需确保端口80转发到容器；DNS验证需配置对应插件（如Cloudflare）凭据。
   • 通配符证书仅支持DNS或DuckDNS验证。
2. 安全配置：
   • 密码保护：docker exec -it letsencrypt htpasswd -c /config/nginx/.htpasswd username。
   • fail2ban默认启用3个规则，可通过/config/fail2ban/jail.local调整。
3. 反向代理：
   • 预设应用代理配置位于/config/nginx/proxy_confs，启用时重命名为.conf。

更新与维护

• 手动更新：拉取最新镜像后重建容器（配置目录保留）。
• 日志查看：docker logs -f letsencrypt查看实时日志。
• 证书续期：容器每日检查证书，30天内过期自动续期。
• 版本查看：docker inspect -f '{{ index .Config.Labels "build_version" }}' letsencrypt获取容器版本。