rveillerot/letsencrypt-ssh

rveillerot/letsencrypt-ssh 镜像说明

镜像概述

本镜像基于Linuxserver的Let's Encrypt容器，集成SSH客户端功能，旨在简化SSL证书的生命周期管理（获取、续期、配置），同时支持通过SSH远程操作服务器，满足证书管理场景下的远程访问需求。

核心功能

1. 自动化证书管理：自动向Let's Encrypt申请、续期SSL证书，支持多域名及子域名配置；
2. 内置SSH客户端：集成SSH工具，可直接在容器内发起远程连接，简化运维流程；
3. 灵活配置：通过环境变量自定义证书参数（域名、***）及SSH连接选项；
4. 持久化存储：支持卷挂载保存证书配置与SSH密钥，确保数据不丢失。

使用场景

1. Web服务HTTPS部署：为Nginx、Apache等Web服务器快速配置SSL证书，实现HTTPS访问；
2. 测试环境验证：开发人员在本地/测试环境快速搭建HTTPS服务，验证证书功能；
3. 远程证书维护：通过SSH远程管理证书服务器，减少额外工具安装步骤。

配置说明

关键环境变量

• PUID/PGID：容器运行用户的UID/GID，确保文件权限匹配；
• TZ：时区设置（如Asia/Shanghai）；
• URL：主域名（如yourdomain.com）；
• SUBDOMAINS：子域名列表（逗号分隔，如www,api）；
• EMAIL：Let's Encrypt注册***（用于证书通知）。

卷挂载

• /config：存储证书配置、SSH密钥等数据，建议持久化到宿主机目录。

部署示例

Docker Run命令

bash
docker run -d \
  --name letsencrypt-ssh \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e URL=yourdomain.com \
  -e SUBDOMAINS=www,api \
  -e EMAIL=your@email.com \
  -p 80:80 \
  -p 443:443 \
  -v /host/path/to/config:/config \
  rveillerot/letsencrypt-ssh

Docker Compose示例

yaml
version: "3"
services:
  letsencrypt-ssh:
    image: rveillerot/letsencrypt-ssh
    container_name: letsencrypt-ssh
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - URL=yourdomain.com
      - SUBDOMAINS=www,api
      - EMAIL=***
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /host/path/to/config:/config
    restart: unless-stopped