Flutter多域名安全服务器插件multi_domain_secure_server的使用

Flutter多域名安全服务器插件multi_domain_secure_server的使用

简介

multi_domain_secure_server 是一个支持多个域名并动态解析 SecurityContext 的 SecureServerSocket。它允许你在同一台服务器上为不同的域名配置不同的 SSL/TLS 证书，从而实现多域名的安全通信。

使用方法

安装

首先，在你的 pubspec.yaml 文件中添加 multi_domain_secure_server 依赖：

dependencies:
  multi_domain_secure_server: ^latest_version

示例代码

以下是一个完整的示例代码，展示了如何使用 multi_domain_secure_server 创建一个多域名安全服务器，并为每个域名配置不同的 SSL/TLS 证书。

import 'dart:io';

import 'package:multi_domain_secure_server/multi_domain_secure_server.dart';

void main() async {
  // 为每个主机名定义一个 SecurityContext
  var hostnamesSecurityContexts = {
    'example.com': SecurityContext()
      ..setTrustedCertificates('path/to/example.com/cert.pem')
      ..usePrivateKey('path/to/example.com/private-key.pem', password: 'your_password'),
    'foo.com': SecurityContext()
      ..setTrustedCertificates('path/to/foo.com/cert.pem')
      ..usePrivateKey('path/to/foo.com/private-key.pem', password: 'your_password'),
  };

  // 创建一个安全服务器，监听 IPv4 地址的 8443 端口
  var server = await MultiDomainSecureServer.bind(
    InternetAddress.anyIPv4,
    8443,
    securityContextResolver: (hostname) {
      print('-- Resolving `SecurityContext` for hostname: $hostname');
      return hostnamesSecurityContexts[hostname];
    },
  );

  print('** Secure Server running: $server');

  // 监听新连接
  server.onAccept.listen((acceptedSocket) {
    print(
        '-- Accepted Socket: ${acceptedSocket.remoteAddress.address}:${acceptedSocket.remotePort}');
    
    // 处理客户端请求
    acceptedSocket.transform(Utf8Decoder()).listen((data) {
      print('-- Received data: $data');
      
      // 回应客户端
      acceptedSocket.write('Hello, $hostname!\n');
      acceptedSocket.close();
    });
  });
}

解释

1. 导入必要的库：我们导入了 dart:io 和 multi_domain_secure_server。
2. 定义 SecurityContext：为每个域名（如 example.com 和 foo.com）创建一个 SecurityContext，并设置对应的证书和私钥文件路径。如果你的私钥文件有密码保护，请提供密码。
3. 创建安全服务器：使用 MultiDomainSecureServer.bind 方法创建一个安全服务器，监听 IPv4 地址的 8443 端口。securityContextResolver 是一个回调函数，用于根据客户端请求的主机名动态解析 SecurityContext。
4. 监听新连接：通过 server.onAccept.listen 监听新连接。每当有新的客户端连接时，服务器会打印连接信息，并读取客户端发送的数据。服务器会回应客户端一条消息，然后关闭连接。

测试

你可以使用 curl 命令测试这个服务器。假设你已经启动了服务器，并且本地运行在 127.0.0.1:8443，你可以使用以下命令进行测试：

curl -v -k --resolve example.com:8443:127.0.0.1 https://example.com:8443/
curl -v -k --resolve foo.com:8443:127.0.0.1 https://foo.com:8443/