Ocelot 是一个专为 .NET 平台设计的开源 API 网关,特别适用于微服务架构。它运行在 ASP.NET Core 上,主要功能是将多个后端服务的 API 统一暴露给客户端,同时集中处理路由、认证、限流、负载均衡、日志记录等横切关注点。
核心功能与作用
Ocelot 的本质是一个中间件集合,它拦截进入的 HTTP 请求,根据配置决定如何转发到下游服务。它不替代后端业务逻辑,而是作为请求的“前门”存在。
常见用途包括:
统一入口:所有客户端请求通过单一地址访问,后端服务对客户端透明 请求路由:根据路径将请求转发到对应的服务,比如 /users → 用户服务,/orders → 订单服务 认证与授权:在网关层验证 JWT Token,避免每个服务重复处理 限流与熔断:防止突发流量压垮后端服务 请求聚合:将多个服务调用合并为一个响应(需额外开发)在 .NET 中的基本使用步骤
要在 ASP.NET Core 项目中使用 Ocelot,通常按以下方式配置:
-
安装 NuGet 包:
在项目中添加 Ocelot 和 Ocelot.Provider.Consul(如需服务发现)等包 添加配置文件:
创建 ocelot.json 文件定义路由规则,例如:
{
"Routes": [
{
"UpstreamPathTemplate": "/api/users/{everything}",
"UpstreamHttpMethod": [ "Get", "Post" ],
"DownstreamPathTemplate": "/{everything}",
"DownstreamScheme": "http",
"DownstreamHostAndPorts": [
{ "Host": "localhost", "Port": 5001 }
]
}
]
}
注册服务与中间件:在 Program.cs 中添加:
builder.Services.AddOcelot();
app.UseOcelot().Wait();
集成身份验证示例
若使用 JWT,可在 ocelot.json 中配置认证:
"AuthenticationOptions": {
"AuthenticationProviderKey": "Bearer",
"AllowedScopes": []
}
然后在 Program.cs 中添加 JWT 验证:
builder.Services.AddAuthentication("Bearer")
.AddJwtBearer("Bearer", options => {
options.Authority = "https://your-auth-server";
options.TokenValidationParameters.ValidateAudience = false;
});
基本上就这些。Ocelot 让你在 .NET 生态中快速搭建一个轻量级 API 网关,适合中小规模微服务系统。虽然功能不如 Kubernetes Ingress 或商业网关强大,但胜在简单、可控、易于调试。
