LinuxServer Docker LetsEncrypt 项目安装与使用指南

LinuxServer Docker LetsEncrypt 项目安装与使用指南

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

目录结构及介绍

在LinuxServer/docker-letsencrypt仓库中, 主要包含了以下关键文件:

1. Dockerfile, Dockerfile.arm64, Dockerfile.armhf: 这些是构建容器镜像的基本脚本，用于定义构建环境的基础设置。

2. Jenkinsfile: 此文件用于自动化流程，可能是为了持续集成或持续部署（CI/CD）而设计。

3. LICENSE: 提供项目使用的许可证详情，在这里指明该项目遵循 GPL-3.0 许可证。

4. README.md: 包含项目的主要信息、功能描述以及如何使用和贡献到此项目的指南。

5. package_versions.txt, readme-vars.yml: 这两个文件可能包含了一些关于软件版本和其他元数据的信息，帮助维护者追踪项目状态。

6. jenkins-vars.yml: 与 Jenkinsfile 搭配使用，用于存储Jenkins 环境变量或参数。

重要通知: 注意这个项目的镜像已被弃用，建议转向使用 LinuxServer/swag 的新仓库。

---

启动文件介绍

Dockerfile 和 Docker Compose 文件

• Dockerfile 及其变体 (aarch64, armhf) 定义了如何创建基础镜像，包括拉取必要的依赖和应用配置。

• docker-compose.yml 示例:

    version: '2.1'
    services:
      swag:
        image: linuxserver/letsencrypt
        container_name: swag
        cap_add:
          - NET_ADMIN
        environment:
          - PUID=1000
          - PGID=1000
          - TZ=Europe/London
          - URL=yourdomain.url
          - SUBDOMAINS=www
          - VALIDATION=http
          - DNSPLUGIN=cloudflare # optional
          # 更多可选环境变量...
        volumes:
          - /path/to/appdata/config:/config
        ports:
          - 443:443
          - 80:80
  

通过上述示例可以看到容器启动时所需的配置项，如环境变量设定和网络端口映射。

---

配置文件介绍

/config 目录

该目录被视为容器内的主要配置点，其中包含了所有必要的配置文件，例如 Nginx 配置、Let's Encrypt SSL 证书等。

关键文件说明：

1. nginx.conf —— 针对特定域名的Nginx服务器块定义。

2. SSL/TLS 证书 —— 位于子目录 etc/letsencrypt/live/<yourdomain>.com 下，包含：

   • cert.pem,
   • chain.pem,
   • fullchain.pem,
   • privkey.pem.

其他重要组件：

• 密码保护: 若要添加基本认证，需生成并管理一个 .htpasswd 文件。

• 密钥交换参数 dhparams.pem —— 提供了一组预生成的4096位 Diffie-Hellman 参数。

以上指南应有助于快速上手并理解 LinuxServer/docker-letsencrypt 项目的使用方式及其关键组成部分的细节。

---

请注意，由于项目已迁移至新的仓库，未来的新特性和支持将不会在这个位置进行更新；因此，对于最新的文档和指导，应当参考 LinuxServer/swag。

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