ruban微服务代理 Docker镜像文档

镜像概述

ruban微服务代理是一个专为微服务架构设计的轻量级、高性能代理服务，旨在简化服务间通信、实现灵活的请求路由与流量管理。该镜像提供开箱即用的微服务治理能力，帮助开发者快速构建可靠、可扩展的分布式系统。

核心功能与特性

• 动态路由：支持基于服务名、路径、请求头的动态请求转发，适配复杂微服务拓扑结构
• 多负载均衡策略：内置轮询、加权轮询、最少连接数等算法，优化服务资源利用率
• 服务发现集成：兼容主流服务注册中心（Consul、Eureka、Nacos等），自动同步服务实例信息
• 流量控制：提供请求限流、熔断降级机制，保护后端服务免受流量峰值影响
• 健康检查：定期探测后端服务状态，自动剔除不可用节点，提升系统稳定性
• TLS加密：支持服务间通信加密，保障数据传输安全
• 监控可观测性：暴露Prometheus指标接口，便于集成监控系统追踪代理性能

使用场景与适用范围

• 微服务网关：作为系统入口层，统一接收客户端请求并路由至相应微服务
• 服务间通信代理：简化微服务集群内部跨服务调用，统一处理认证、授权与流量控制
• 多环境流量分发：在开发、测试、生产环境中，通过配置隔离不同环境的服务流量
• 灰度发布支持：结合路由规则实现部分服务实例的流量引流，验证新功能稳定性

使用方法与配置说明

快速启动

通过Docker命令快速启动基础代理服务：

docker run -d -p 8080:8080 --name ruban-proxy ruban/microservice-proxy:latest

Docker Compose部署

创建docker-compose.yml文件，集成Consul服务注册中心示例：

version: '3'
services:
  ruban-proxy:
    image: ruban/microservice-proxy:latest
    ports:
      - "8080:8080"
    environment:
      - PROXY_PORT=8080
      - SERVICE_REGISTRY_TYPE=consul
      - SERVICE_REGISTRY_URL=[***]
      - LOAD_BALANCE_STRATEGY=round_robin
      - LOG_LEVEL=info
    depends_on:
      - consul

  consul:
    image: consul:latest
    ports:
      - "8500:8500"

启动服务：

docker-compose up -d

核心配置参数

环境变量配置

配置文件挂载

对于复杂路由规则，可通过挂载config.yaml文件自定义配置：

routes:
  - service_name: user-service
    path_prefix: /api/users
    backend_service: user-service:8081
    timeout: 5000ms
    retries: 3
  - service_name: order-service
    path_prefix: /api/orders
    backend_service: order-service:8082
    load_balance:
      strategy: weighted
      weights:
        order-service-1: 3
        order-service-2: 7

挂载配置文件启动：

docker run -d -p 8080:8080 -v ./config.yaml:/etc/ruban/config.yaml ruban/microservice-proxy:latest

验证与监控

访问健康检查接口：

curl http://localhost:8080/health

查看Prometheus监控指标：

curl http://localhost:8080/metrics

注意事项

• 生产环境建议启用TLS加密并配置适当的限流策略
• 服务注册中心不可用时，代理将使用本地缓存的服务列表
• 复杂路由场景下推荐使用配置文件管理，而非环境变量
• 高并发场景下建议调整MAX_CONCURRENT_REQUESTS参数以匹配系统能力