Nest中的SocketIO网关配置(WebSocketGateway)

网关

Nest 中,网关只是一个用 @WebSocketGateway() 装饰器注解的类。从技术上讲,网关与平台无关,这使得它们在创建适配器之后就可以与任何 WebSockets 库兼容。有两个开箱即用的WS平台:socket.iows

WebSocketGateway常用配置

在 NestJS 中,WebSocketGateway 是一个装饰器,用于创建 WebSocket 服务器。它可以接受一个可选的配置对象,该对象允许你自定义 WebSocket 服务器的各种属性。以下是一些常见的配置选项及其解释:

  1. port:指定 WebSocket 服务器监听的端口。如果未指定,WebSocket 服务器将共享由 HTTP 服务器使用的端口。
  2. namespacepath:定义一个命名空间或路径,这允许你在同一个端口上运行多个 WebSocket 服务器。
  3. server:允许你传递一个现有的 HTTP 或 HTTPS 服务器实例,WebSocket 服务器将附加到此实例。
  4. transport :指定底层传输协议。Nest 支持两种传输协议:Transport.TCPTransport.REDIS
  5. options :这是一个对象,允许传递更多的自定义配置,这些配置依赖于底层使用的 WebSocket 库(如 wssocket.io)。例如,你可以设置 cors 来允许跨域请求。
  6. cors:配置跨源资源共享(CORS)选项,例如允许的源、方法等。
  7. allowEIO3 :这是一个特定于 socket.io 的选项,当设置为 true 时,允许与较旧版本的 Engine.IO 协议兼容。

这些配置选项提供了高度的灵活性,使你能够根据应用程序的需要定制 WebSocket 服务器。在使用这些选项时,你应该根据你的具体需求和底层 WebSocket 库的文档进行选择和配置。

CORS(Cross-Origin Resource Sharing)

CORS 是一种安全机制,用于控制不同源之间的资源共享。在 WebSocket 和 HTTP 服务器上配置 CORS 可以决定哪些外部源被允许与你的服务器通信。在 WebSocketGateway 中配置 CORS 通常涉及以下几个方面:

  • Origin: 指定哪些源(网站)可以访问你的 WebSocket 服务器。可以是一个具体的 URL,也可以是一个返回布尔值的函数,或者是一个包含多个 URL 的数组。
  • Methods : 指定允许的 HTTP 请求方法,如 GET, POST 等。
  • Allowed Headers: 指定允许的 HTTP 请求头。
  • Credentials: 布尔值,指示是否允许发送凭证(如 cookies)。
  • Exposed Headers: 指定允许暴露给外部的响应头。
  • Max Age: 设置预检请求(pre-flight request)的最大缓存时间。

例如:

ts 复制代码
@WebSocketGateway({
  cors: {
    origin: 'https://example.com',
    methods: ['GET', 'POST'],
    allowedHeaders: ['my-custom-header'],
    credentials: true
  }
})

Options

options 是一个更广泛的配置对象,用于提供特定于底层 WebSocket 库的配置。这些选项取决于你使用的库(如 ws, socket.io 等)。一些常见的 options 包括:

  • 传输层相关选项:例如,可以设置传输模式、序列化和反序列化机制等。
  • 安全相关选项:例如 SSL/TLS 配置,这对于 HTTPS WebSocket 连接非常重要。
  • 性能相关选项:如连接超时时间、心跳检测间隔等。
  • 兼容性选项 :例如 allowEIO3socket.io 中用于兼容老版本的 Engine.IO

例如,使用 socket.io 的配置可能是这样的:

php 复制代码
javascriptCopy code
@WebSocketGateway(80, {
  options: {
    path: '/websockets/',
    serveClient: false,
    pingInterval: 10000,
    pingTimeout: 5000,
    cookie: false
  }
})

这里的 options 对象配置了 WebSocket 连接的路径、服务客户端脚本、心跳检测间隔和超时时间以及是否发送 cookie。

corsoptions 提供了控制 WebSocket 服务器安全性和行为的重要手段。正确配置这些参数有助于确保你的 WebSocket 服务既安全又高效。在配置时,最好参考你所使用的 WebSocket 库的文档,以了解所有可用的配置选项和它们的具体含义。

参考链接

-Nest官网 -SocketIO-

相关推荐
前端(从入门到入土)3 分钟前
前端请求后端服务403(Invalid CORS request)
前端
蓝天白云下遛狗30 分钟前
goole chrome变更默认搜索引擎为百度
前端·chrome
come112341 小时前
Vue 响应式数据传递:ref、reactive 与 Provide/Inject 完全指南
前端·javascript·vue.js
musk12122 小时前
electron 打包太大 试试 tauri , tauri 安装打包demo
前端·electron·tauri
万少2 小时前
第五款 HarmonyOS 上架作品 奇趣故事匣 来了
前端·harmonyos·客户端
OpenGL3 小时前
Android targetSdkVersion升级至35(Android15)相关问题
前端
rzl023 小时前
java web5(黑马)
java·开发语言·前端
Amy.Wang3 小时前
前端如何实现电子签名
前端·javascript·html5
今天又在摸鱼3 小时前
Vue3-组件化-Vue核心思想之一
前端·javascript·vue.js
蓝婷儿3 小时前
每天一个前端小知识 Day 21 - 浏览器兼容性与 Polyfill 策略
前端