Fleck 项目常见问题解决方案

1. 项目基础介绍和主要编程语言

Fleck 是一个用 C# 编写的 WebSocket 服务器实现。它源自 Nugget 项目，但 Fleck 不需要继承、容器或额外的引用。Fleck 不依赖于 HttpListener 或 HTTP.sys，这意味着它可以在 Windows 7 和 Server 2008 等主机上运行。Fleck 支持多种 WebSocket 版本，包括 Hixie-Draft-76/Hybi-00、Hybi-07、Hybi-10 和 Hybi-13。此外，Fleck 还支持安全 WebSocket (wss://) 和子协议协商。

2. 新手在使用 Fleck 项目时需要注意的 3 个问题及详细解决步骤

问题 1：如何启动 Fleck WebSocket 服务器？

解决步骤：

1. 创建 WebSocket 服务器实例： 首先，创建一个 WebSocketServer 实例，指定 WebSocket 服务器的地址和端口。

   var server = new WebSocketServer("ws://0.0.0.0:8181");
   

2. 配置服务器事件处理： 配置服务器的事件处理程序，例如 OnOpen、OnClose 和 OnMessage。

   server.Start(socket =>
   {
       socket.OnOpen = () => Console.WriteLine("Open");
       socket.OnClose = () => Console.WriteLine("Close");
       socket.OnMessage = message => socket.Send(message);
   });
   

3. 启动服务器： 调用 Start 方法启动 WebSocket 服务器。

   server.Start(socket =>
   {
       // 事件处理代码
   });
   

问题 2：如何启用安全 WebSocket (wss://)？

解决步骤：

1. 创建 WebSocket 服务器实例： 创建一个 WebSocketServer 实例，指定 wss:// 作为协议，并指定端口。

   var server = new WebSocketServer("wss://0.0.0.0:8431");
   

2. 配置 SSL 证书： 为服务器配置 SSL 证书，指定证书文件路径。

   server.Certificate = new X509Certificate2("MyCert.pfx");
   

3. 启动服务器： 调用 Start 方法启动 WebSocket 服务器。

   server.Start(socket =>
   {
       // 事件处理代码
   });
   

问题 3：如何进行子协议协商？

解决步骤：

1. 创建 WebSocket 服务器实例： 创建一个 WebSocketServer 实例，指定 ws:// 作为协议，并指定端口。

   var server = new WebSocketServer("ws://0.0.0.0:8181");
   

2. 配置支持的子协议： 设置 SupportedSubProtocols 属性，指定服务器支持的子协议。

   server.SupportedSubProtocols = new[] { "superchat", "chat" };
   

3. 启动服务器并处理子协议： 启动服务器，并在事件处理中访问协商的子协议。

   server.Start(socket =>
   {
       var negotiatedSubProtocol = socket.ConnectionInfo.NegotiatedSubProtocol;
       // 处理子协议
   });
   

通过以上步骤，新手可以顺利解决在使用 Fleck 项目时可能遇到的常见问题。