.NET Core API网关Ocelot(十)【Websockets】

最新推荐文章于 2025-06-05 09:02:02 发布

转载最新推荐文章于 2025-06-05 09:02:02 发布 · 1.6k 阅读

2 ·

CC 4.0 BY-SA版权

原文链接：https://blog.youkuaiyun.com/WuLex

NET Core API网关Ocelot 专栏收录该内容

22 篇文章

订阅专栏

本文介绍如何使用Ocelot代理WebSocket和SignalR通信。通过在应用程序中启用WebSockets和SignalR，配置ocelot.json文件，Ocelot能够代理WebSocket流量和SignalR通信至下游服务。此外，还支持负载均衡、路由和服务发现，但某些功能如头信息处理和HTTP客户端填充暂不支持。

Ocelot额外支持代理websockets。这个功能在问题 212中被提出。

为了是Ocelot代理websocket，你需要做如下事情。

在你的Configure方法中，你要告知应用程序使用WebSockets。

 Configure(app =>
{
    app.UseWebSockets();
    app.UseOcelot().Wait();
})

然后在你的ocelot.json中添加如下代码，用于配置WebSockets代理一个Route。

{
     "DownstreamPathTemplate": "/ws",
     "UpstreamPathTemplate": "/",
     "DownstreamScheme": "ws",
     "DownstreamHostAndPorts": [
         {
             "Host": "localhost",
             "Port": 5001
         }
     ],
 }

使用这个配置，Ocelot将匹配所有进入/的Websocket流量并将其代理到localhost:5001/ws。更清晰的解释一下就是，Ocelot将接收来自上游客户端的消息，并将它们代理到下游服务，从下游服务接收消息并将这些消息代理到上游客户端。

SignalR

Ocelot支持代理SignalR。在发行344中要求此功能。

为了使Websocket代理与Ocelot一起使用，您需要执行以下操作。

安装Microsoft.AspNetCore.SignalR.Client 1.0.2，您可以尝试其他软件包，但此软件包已经过测试。

不要在IISExpress中运行它，也不要在IIS功能中安装websockets功能

在您的Configure方法中，您需要告诉您的应用程序使用SignalR。

 Configure(app =>
{
    app.UseWebSockets();
    app.UseOcelot().Wait();
})

然后在您的ocelot.json中添加以下内容以使用SignalR代理Route。请注意，通常的Ocelot路由规则适用的主要是设置为“ws”的方案。

  {
 "ReRoutes": [
   {
     "DownstreamPathTemplate": "/{catchAll}",
     "DownstreamScheme": "ws",
     "DownstreamHostAndPorts": [
       {
         "Host": "localhost",
         "Port": 50000
       }
     ],
     "UpstreamPathTemplate": "/gateway/{catchAll}",
     "UpstreamHttpMethod": [ "GET", "POST", "PUT", "DELETE", "OPTIONS" ]
   }
]
}