alexanderkrause/rpi-letsencrypt-nginx-proxy-companion

alexanderkrause/rpi-letsencrypt-nginx-proxy-companion 镜像说明

这是针对armhf架构（已在树莓派3测试）的分支版本，基于Yves Blusseau的https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion%E3%80%82%E4%BB%A5%E4%B8%8B%E5%86%85%E5%AE%B9%E6%9C%AA%E6%B6%B5%E7%9B%96%E5%8E%9F%E9%A1%B9%E7%9B%AE%E5%85%A8%E9%83%A8%E9%80%89%E9%A1%B9%EF%BC%8C%E5%BB%BA%E8%AE%AE%E5%8F%82%E8%80%83%E5%8E%9F%E4%BB%93%E5%BA%93%E6%96%87%E6%A1%A3%E3%80%82

镜像概述

该镜像作为nginx反向代理的配套容器，用于在树莓派上自动创建、续期Let's Encrypt TLS证书，帮助用户快速部署安全的HTTPS应用。

核心功能

1. 自动证书管理：自动生成和续期Let's Encrypt证书；
2. 架构适配：支持树莓派等armhf设备；
3. 协同工作：与nginx反向代理容器联动，通过Docker socket监听应用容器配置；
4. 灵活配置：通过环境变量定义虚拟主机和证书相关信息。

使用场景

适用于树莓派上部署需要TLS加密的应用，例如：

• Nextcloud（含Passman扩展）+ MySQL；
• Nginx静态网站；
• 邮件服务器（如tomav/docker-mailserver）。

配置说明

部署步骤

1. 启动nginx反向代理容器

需声明三个卷用于证书、虚拟主机配置和挑战文件：

bash
docker run -d -p 80:80 -p 443:443 \
    --name nginx-proxy \
    -v /path/to/certs:/etc/nginx/certs:ro \
    -v /etc/nginx/vhost.d \
    -v /usr/share/nginx/html \
    -v /var/run/docker.sock:/tmp/docker.sock:ro \
    --label com.github.jrcs.letsencrypt_nginx_proxy_companion.nginx_proxy \
    alexanderkrause/rpi-nginx-proxy

注意：标签com.github.jrcs.letsencrypt_nginx_proxy_companion.nginx_proxy用于让本容器识别nginx代理容器。

2. 启动本容器

bash
docker run -d \
    --name nginx-letsencrypt \
    -v /usr/ssl:/etc/nginx/certs:rw \
    -v /var/run/docker.sock:/var/run/docker.sock:ro \
    --volumes-from nginx-proxy \
    alexanderkrause/rpi-letsencrypt-nginx-proxy-companion

3. 启动目标应用容器

需添加环境变量指定虚拟主机和证书信息：

bash
docker run -d \
    --name example-app \
    -e "VIRTUAL_HOST=example.com" \
    -e "LETSENCRYPT_HOST=example.com" \
    -e "LETSENCRYPT_EMAIL=foo@bar.com" \
    tutum/apache-php

证书获取说明

证书获取需要nginx代理容器映射默认端口（80:80、443:443）。若需自定义端口：

1. 先按默认端口启动nginx代理、本容器和应用容器；
2. 关闭所有容器，删除nginx代理容器；
3. 重新启动nginx代理容器，使用自定义端口（如5050:80、5060:443）；
4. 启动本容器和应用容器。

自建镜像步骤

1. 克隆仓库：git clone https://github.com/Alexander-Krause/rpi-docker-letsencrypt-nginx-proxy-companion.git；
2. 进入目录：cd rpi-docker-letsencrypt-nginx-proxy-companion；
3. 构建镜像：docker build -t alexanderkrause/rpi-docker-letsencrypt-nginx-proxy-companion:latest .。

DynDNS配置

支持DynDNS（如duckdns）：

1. 在路由器或设备（如ddclient）配置DynDNS更新；
2. 开启端口转发（如443到树莓派/docker容器）；
3. 在应用容器环境变量中使用DynDNS域名（如yourducksubdomain.duckdns.org）。