ohiniba/orisha-gateway

Orisha微服务架构API网关镜像

镜像概述

本镜像为Orisha微服务架构提供API网关功能，基于Spring Cloud Gateway实现。作为微服务架构的统一入口，负责请求路由、负载均衡、流量控制、安全认证等核心功能，简化微服务间的通信与管理。

核心功能和特性

• 路由转发：根据预设规则将客户端请求转发至对应的微服务实例
• 负载均衡：支持多种负载均衡策略，优化服务资源分配
• 熔断降级：集成熔断机制，防止服务级联故障
• 请求限流：通过限流策略保护后端服务，防止流量过载
• 安全控制：支持认证授权、请求过滤等安全机制
• API文档聚合：统一管理微服务API文档，提供便捷的接口查阅方式

使用场景和适用范围

• Orisha微服务架构环境下的统一API入口
• 需要对微服务请求进行集中管理、监控和控制的场景
• 多客户端（Web、移动端等）访问微服务的统一接入层
• 需实现服务路由、负载均衡、安全防护等功能的微服务架构

使用方法和配置说明

基本运行命令

bash
docker run -d -p 8080:8080 --name orisha-api-gateway [镜像名称]:[版本]

环境变量配置

示例：带路由配置的启动

bash
docker run -d \
  -p 8080:8080 \
  -e SERVER_PORT=8080 \
  -e SERVICE_REGISTRY_ADDR=http://nacos:8848 \
  -e SPRING_CLOUD_GATEWAY_ROUTES='[{"id":"user-service","uri":"lb://user-service","predicates":[{"name":"Path","args":{"pattern":"/api/users/**"}}]}]' \
  --name orisha-api-gateway [镜像名称]:[版本]

docker-compose配置示例

yaml
version: '3'
services:
  api-gateway:
    image: docker.xuanyuan.run/[镜像名称]:[版本]
    ports:
      - "8080:8080"
    environment:
      - SERVER_PORT=8080
      - SERVICE_REGISTRY_ADDR=http://nacos:8848
      - SPRING_CLOUD_GATEWAY_ROUTES='[{"id":"order-service","uri":"lb://order-service","predicates":[{"name":"Path","args":{"pattern":"/api/orders/**"}}]}]'
    depends_on:
      - nacos
    restart: always

路由配置说明

路由配置通过SPRING_CLOUD_GATEWAY_ROUTES环境变量传入，采用JSON数组格式，每个路由对象包含：

• id：路由唯一标识
• uri：目标服务地址（支持lb://前缀表示负载均衡）
• predicates：路由断言规则（如路径匹配、请求方法匹配等）
• filters：路由过滤器（如路径重写、请求头修改等）