alexanderkrause/rpi-nginx-proxy

镜像概述

本镜像为针对armhf架构（如树莓派3）优化的自动nginx反向代理工具，基于Jason Wilder的nginx-proxy项目fork，通过docker-gen动态生成反向代理配置，支持与配套的Let's Encrypt证书管理容器结合，实现Docker应用的安全访问。

核心功能

• 自动检测Docker容器的VIRTUAL_HOST环境变量，生成nginx反向代理配置
• 支持SSL/TLS加密，可通过Let's Encrypt自动获取和续期证书
• 适配树莓派等armhf架构设备
• 兼容DynDNS服务（如DuckDNS），方便暴露本地Docker应用至公网

使用场景

• 树莓派上部署Nextcloud、个人网站等Docker应用并对外暴露
• 为树莓派上多个Docker服务提供统一访问入口和TLS加密保护
• 结合DynDNS实现家庭网络中Docker应用的公网访问

配置说明

基础运行（无SSL）

bash
docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock:ro docker.xuanyuan.run/alexanderkrause/rpi-nginx-proxy:alpine

启动需代理的容器时添加环境变量：

bash
docker run -e VIRTUAL_HOST=foo.bar.com [其他参数] [镜像名]

自构建镜像

1. 克隆仓库：

bash
git clone https://github.com/Alexander-Krause/rpi-nginx-proxy.git

2. 构建镜像：

bash
cd rpi-nginx-proxy && docker build -t alexanderkrause/rpi-nginx-proxy:latest .

3. 运行镜像：

bash
docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock:ro docker.xuanyuan.run/alexanderkrause/rpi-nginx-proxy

SSL支持（Let's Encrypt推荐）

需配合https://github.com/Alexander-Krause/rpi-docker-letsencrypt-nginx-proxy-companion%E5%AE%B9%E5%99%A8%E5%AE%9E%E7%8E%B0%E8%87%AA%E5%8A%A8%E8%AF%81%E4%B9%A6%E7%AE%A1%E7%90%86%E3%80%82

手动SSL配置

bash
docker run -d -p 80:80 -p 443:443 \
  -v /path/to/certs:/etc/nginx/certs \
  -v /var/run/docker.sock:/tmp/docker.sock:ro \
  docker.xuanyuan.run/alexanderkrause/rpi-nginx-proxy:alpine

将证书文件（如foo.bar.com.crt和foo.bar.com.key）放入/path/to/certs目录，容器VIRTUAL_HOST需与证书文件名匹配。