totem/yoda-proxy

Yoda Proxy 镜像说明

镜像概述

Yoda Proxy是一个动态代理解决方案，结合Haproxy、etcd和confd实现灵活的代理配置管理。它支持HTTP与TCP协议，可通过etcd动态更新代理规则，适用于微服务架构下的服务路由、负载均衡及蓝绿部署等场景。

核心功能

• 动态配置更新：通过etcd存储代理配置，confd实时同步并生成Haproxy配置文件，无需重启代理服务。
• 多协议支持：同时支持HTTP和TCP代理模式。
• SNI SSL证书管理：从Amazon S3 bucket获取SNI证书，实现多域名HTTPS支持。
• 蓝绿部署：通过切换etcd中的上游服务配置，快速实现蓝绿部署切换。
• ACL访问控制：支持对主机和路径设置允许/拒绝的ACL规则。

使用场景

• 微服务架构中的服务路由与负载均衡。
• 需要动态调整代理规则的场景（如服务扩容/缩容）。
• 蓝绿部署或金丝雀发布时的流量切换。
• 多域名HTTPS服务的代理（通过SNI）。

配置说明

前提条件

• Docker v1.1+
• etcd服务
• etcdctl（或其他etcd客户端工具）

部署示例

无SNI SSL证书运行

bash
sudo docker run --name yoda --rm -t -i -P -p 80:80 -p 443:443 totem/yoda-proxy

带SNI SSL证书运行（需Amazon S3账号）

bash
sudo docker run --name yoda --rm -t -i -v /dev/log:/dev/log -P -p 80:80 -p 443:443 \
-e AWS_ACCESS_KEY_ID=<<S3_ACCESS_KEY_ID>> \
-e AWS_SECRET_ACCESS_KEY=<<S3_SECRET_KEY>> \
-e S3_YODA_BUCKET=<<S3_BUCKET_NAME>> \
-e SYNC_CERTS=true totem/yoda-proxy

使用Docker Compose（无SNI证书）

bash
docker-compose up yoda

Etcd配置

上游服务（Backend Servers）

注册HTTP上游服务：

bash
etcdctl set /yoda/upstreams/<<upstream-name>>/endpoints/<<service-name>> <<service-host>>:<<service-port>>

示例：

bash
etcdctl set /yoda/upstreams/backend-abc.myapp.com/endpoints/node1 10.12.12.101:80

注册TCP上游服务需额外设置模式：

bash
etcdctl set /yoda/upstreams/backend-rabbitmq/mode tcp

主机与路径配置

设置路径代理：

bash
etcdctl set /yoda/hosts/abc.myapp.com/locations/home/path /
etcdctl set /yoda/hosts/abc.myapp.com/locations/home/upstream backend-abc.myapp.com

蓝绿部署切换：

bash
etcdctl set /yoda/hosts/abc.myapp.com/locations/home/upstream backend-abc.myapp.com-v2

TCP代理配置

添加TCP监听器（如RabbitMQ）：

bash
etcdctl set /yoda/global/listeners/tcp/rabbitmq-main/bind 0.0.0.0:5672
etcdctl set /yoda/global/listeners/tcp/rabbitmq-main/upstream backend-rabbitmq