supercorp/supergateway

supergateway 官方Docker镜像文档

1. 镜像概述

本镜像为supercorp-ai开源项目https://github.com/supercorp-ai/supergateway%E7%9A%84%E5%AE%98%E6%96%B9Docker%E5%B0%81%E8%A3%85%EF%BC%8C%E7%94%A8%E4%BA%8E%E7%AE%80%E5%8C%96%E9%AB%98%E6%80%A7%E8%83%BDAPI%E7%BD%91%E5%85%B3%E7%9A%84%E9%83%A8%E7%BD%B2%E4%B8%8E%E8%BF%90%E8%A1%8C%E6%B5%81%E7%A8%8B%E3%80%82supergateway%E6%98%AF%E4%B8%80%E6%AC%BE%E8%BD%BB%E9%87%8F%E7%BA%A7%E4%BC%81%E4%B8%9A%E7%BA%A7API%E7%BD%91%E5%85%B3%EF%BC%8C%E5%85%B7%E5%A4%87%E8%AF%B7%E6%B1%82%E8%B7%AF%E7%94%B1%E3%80%81%E6%B5%81%E9%87%8F%E6%8E%A7%E5%88%B6%E3%80%81%E5%AE%89%E5%85%A8%E9%98%B2%E6%8A%A4%E7%AD%89%E6%A0%B8%E5%BF%83%E8%83%BD%E5%8A%9B%EF%BC%8C%E5%B9%BF%E6%B3%9B%E9%80%82%E7%94%A8%E4%BA%8E%E5%BE%AE%E6%9C%8D%E5%8A%A1%E6%9E%B6%E6%9E%84%E5%8F%8AAPI%E7%AE%A1%E7%90%86%E5%9C%BA%E6%99%AF%E3%80%82%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E7%94%B1%E9%A1%B9%E7%9B%AE%E5%9B%A2%E9%98%9F%E7%BB%B4%E6%8A%A4%EF%BC%8C%E7%A1%AE%E4%BF%9D%E4%B8%8E%E4%B8%8A%E6%B8%B8%E4%BB%A3%E7%A0%81%E7%89%88%E6%9C%AC%E5%90%8C%E6%AD%A5%EF%BC%8C%E5%B9%B6%E6%8F%90%E4%BE%9B%E6%A0%87%E5%87%86%E5%8C%96%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E9%85%8D%E7%BD%AE%E6%96%B9%E6%A1%88%E3%80%82

2. 核心功能与特性

• 智能请求路由：支持基于路径、域名、请求头的多维度路由策略，灵活匹配后端服务
• 动态负载均衡：内置轮询、加权轮询、IP哈希等算法，优化服务资源利用率
• API安全防护：集成JWT/OAuth2.0认证、API密钥管理及请求签名验证机制
• 流量控制能力：支持限流、熔断、降级等流量治理功能，保障系统稳定性
• 可观测性集成：原生支持Prometheus指标暴露与ELK日志收集，便于监控分析
• 高可用部署：支持集群模式部署，通过健康检查与自动恢复实现服务高可用
• 配置灵活性：提供环境变量注入、配置文件挂载及动态配置更新三种配置方式

3. 使用场景与适用范围

• 企业级API管理平台：统一管理内外部API接口，实现访问控制与版本管理
• 微服务流量入口：作为微服务架构的统一流量入口，处理跨服务通信与协议转换
• 多环境一致性部署：在开发、测试、生产环境中提供一致的网关运行环境
• API安全网关：对外部API请求进行认证、授权与合规性检查，保护后端服务
• 混合云架构桥接：实现多云环境或混合架构中不同服务集群的请求转发

4. 使用方法与配置说明

4.1 基本部署命令

通过docker run快速启动基础网关服务：

bash
docker run -d -p 8080:8080 --name supergateway supercorp-ai/supergateway:latest

说明：默认暴露8080端口作为网关服务端口，首次启动将使用内置默认配置

4.2 环境变量配置

通过环境变量自定义基础配置，常用参数如下：

示例：自定义端口与日志级别

bash
docker run -d -p 9000:9000 \
  -e GATEWAY_PORT=9000 \
  -e LOG_LEVEL=DEBUG \
  -e ADMIN_PASSWORD=SecurePass2024! \
  --name supergateway supercorp-ai/supergateway:latest

4.3 配置文件挂载

复杂场景建议通过挂载配置文件实现精细化配置，配置文件采用YAML格式：

1. 创建本地配置文件（示例config.yaml）：

yaml
server:
  port: 8080
  readTimeout: 30s
  writeTimeout: 30s

routes:
  - id: "user-service"
    uri: "http://user-service:8081"
    predicates:
      - Path=/api/users/**filters:
      - name: "RateLimiter"
        args:
          redisAddress: "redis:6379"
          limit: 100
          period: 60

monitor:
  prometheus:
    enabled: true
    path: "/metrics"

2. 挂载配置文件启动容器：

bash
docker run -d -p 8080:8080 \
  -v $(pwd)/config.yaml:/etc/supergateway/config.yaml \
  --name supergateway supercorp-ai/supergateway:latest

4.4 Docker Compose集成示例

在微服务架构中，可通过docker-compose.yml实现网关与依赖服务的协同部署：

yaml
version: '3.8'

services:
  supergateway:
    image: supercorp-ai/supergateway:latest
    container_name: supergateway
    ports:
      - "8080:8080"
      - "9090:9090"  # 管理界面端口
    environment:
      - LOG_LEVEL=INFO
      - ADMIN_PASSWORD=SuperSecret!2024
      - REDIS_HOST=redis
    volumes:
      - ./config.yaml:/etc/supergateway/config.yaml
      - gateway-logs:/var/log/supergateway
    depends_on:
      - redis
      - user-service
    restart: unless-stopped

  redis:
    image: redis:7-alpine
    volumes:
      - redis-data:/data

  user-service:
    image: your-registry/user-service:latest
    environment:
      - SPRING_PROFILES_ACTIVE=prod

volumes:
  gateway-logs:
  redis-data:

4.5 常用运维命令

• 查看实时日志：

  bash
  docker logs -f --tail 100 supergateway
  

• 进入容器调试：

  bash
  docker exec -it supergateway /bin/sh
  

• 配置热更新（修改挂载配置文件后执行）：

  bash
  docker kill -s SIGHUP supergateway
  

• 版本升级：

  bash
  docker pull supercorp-ai/supergateway:latest && docker restart supergateway
  

5. 注意事项

• 安全加固：生产环境必须修改默认管理员密码，并限制管理界面访问IP
• 资源配置：根据流量规模调整容器资源限制（推荐配置：至少2核CPU/4GB内存）
• 持久化存储：日志与配置文件建议使用外部挂载卷，避免容器重建导致数据丢失
• 版本管理：生产环境建议使用具体版本标签（如:v1.2.3）而非:latest
• 备份策略：定期备份关键配置文件，避免配置丢失影响服务恢复

6. 官方资源

• 项目仓库：https://github.com/supercorp-ai/supergateway
• 完整配置文档：https://github.com/supercorp-ai/supergateway/blob/main/docs/config-reference.md
• Docker Hub镜像页：https://hub.docker.com/r/supercorp-ai/supergateway
• 问题反馈：https://github.com/supercorp-ai/supergateway/issues