adi90x/rancher-active-proxy

Rancher Active Proxy 镜像说明

镜像概述

Rancher Active Proxy（RAP）是一款针对Rancher平台设计的一体化主动反向代理工具，基于jwilder/nginx-proxy理念开发，使用Rancher-gen-rap替代docker-gen实现服务发现，通过容器标签而非环境变量配置代理规则，支持Let's Encrypt自动SSL证书管理，开箱即用。

核心功能

1. 反向代理服务：将外部请求路由至Rancher平台服务或独立容器。
2. Let's Encrypt集成：自动生成、续期SSL证书，支持SAN证书（多域名共享证书）。
3. 标签驱动配置：通过rap.host、rap.port等标签快速配置代理规则。
4. 多端口支持：允许代理监听多个端口，并为不同服务指定后端端口。
5. 协议兼容性：支持HTTP、HTTPS、uWSGI协议连接后端服务。
6. 自定义配置：通过文件自定义Nginx全局或单虚拟主机配置。
7. 基础认证：通过htpasswd文件实现虚拟主机身份验证。

使用场景

• Rancher微服务代理：为Rancher平台上的微服务提供统一访问入口。
• 独立容器代理：代理主机上的独立容器（如Rancher Server自身）。
• 多域名管理：通过SAN证书或多标签实现多域名代理。
• 环境隔离：使用RAP_NAME限制代理特定容器，实现开发/生产环境隔离。

配置说明

代理容器标签

RAP容器环境变量

挂载卷

部署示例

启动RAP容器

bash
docker run -d -p 80:80 -p 443:443 \
  -v /path/to/letsencrypt:/etc/letsencrypt \
  -v /path/to/htpasswd:/etc/nginx/htpasswd \
  -e DEFAULT_EMAIL="your-email@example.com" \
  adi90x/rancher-active-proxy

启动被代理容器

bash
docker run -d \
  -l rap.host="app.example.com" \
  -l rap.port="8080" \
  -l rap.le_host="app.example.com" \
  your-app-image

SAN证书配置示例

bash
docker run -d \
  -l rap.host="app.example.com,api.example.com" \
  -l rap.le_host="app.example.com;api.example.com" \
  your-app-image