gomicro/avenues

CORS Proxy 镜像文档

概述

该Docker镜像提供一个轻量级CORS（跨域资源共享）代理服务，旨在本地测试环境中整合多个微服务，创建统一的API访问入口，解决前端与后端微服务间的跨域请求问题。

核心功能与特性

• 跨域请求处理：实现CORS协议，支持不同源之间的API调用
• 微服务聚合：将多个独立微服务接口整合为单一API端点，简化访问路径
• 本地测试优化：专为本地开发场景设计，配置简单，快速部署
• 轻量级架构：镜像体积小巧，资源占用低，适合开发环境使用

使用场景与适用范围

• 本地开发微服务架构时，需要统一API访问入口
• 前端开发中需调用多个后端微服务接口，解决跨域限制问题
• 快速搭建本地测试环境，模拟生产环境中的API网关功能

使用方法

基本部署

使用以下命令启动CORS Proxy容器：

bash
docker run -d -p 8080:8080 --name cors-proxy [镜像名称]

配置参数

可通过环境变量进行基础配置：

• PROXY_PORT：代理服务监听端口，默认8080
• TARGET_SERVICES：需代理的微服务列表，格式为服务标识:服务URL，多个服务用逗号分隔
• CORS_ALLOWED_ORIGINS：允许的跨域请求源，默认*（允许所有源）

示例：整合多个微服务

假设本地有两个微服务：

• 用户服务：http://localhost:3000
• 订单服务：http://localhost:4000

启动代理命令：

bash
docker run -d -p 8080:8080 \
  -e TARGET_SERVICES="user:http://localhost:3000,order:http://localhost:4000" \
  -e CORS_ALLOWED_ORIGINS="http://localhost:5173" \
  --name cors-proxy [镜像名称]

访问方式：

• 用户服务：http://localhost:8080/user/[接口路径]
• 订单服务：http://localhost:8080/order/[接口路径]

注意事项

• 仅适用于本地测试环境，不建议用于生产环境
• 确保本地微服务已启动且可被容器访问（可使用--network=host参数共享主机网络）
• 复杂场景下建议参考镜像完整文档获取更多配置选项