以下是与WCF中继的一个对比表：
| WCF中继 | 混合连接 | |
| 建立本地和云之间的安全连接 | √ | √ |
| 无需修改防火墙添加入站端口 | √ | √ |
| 无需对网络配置做重大修改 | √ | √ |
| 基于开放标准协议 | Χ（只支持WCF） | √ |
| 跨平台支持 | Χ（只支持Windows） | √ |
| 多语言支持 | Χ（只支持.NET） | √ |
下面主要分三种情况来介绍混合连接的使用：
一． 基于混合连接SDK
二． 基于Azure Web App混合连接工具
三． 基于PortBridge示例程序
创建混合连接
可以登陆Azure中国门户网站，按照界面提示一步步创建。也可以通过PowerShell命令，如下。
# login to Azure China with your accountLogin-AzureRmAccount -Environment AzureChinaCloud$rgName = "relaydemorg"$namespaceName = "relaydemons"$location = "China East"$hcName = "hcdemo"New-AzureRmResourceGroup -Name $rgName -Location $locationNew-AzureRmRelayNamespace -ResourceGroupName $rgName -Name $namespaceName -Location $locationNew-AzureRmRelayHybridConnection -Namespace $namespaceName -ResourceGroupName $rgName -Name $hcName -RequiresClientAuthorization $true
创建出来混合连接字符串就是sb://relaydemons.servicebus.chinacloudapi.cn/hcdemo
基于混合连接SDK
目前微软官方提供了两个SDK，一个是.NET语言版本，另一个是Node.JS版本。两个SDK也都开源在Github上：azure-relay-net，azure-relay-node。
本地服务（监听者）
首先本地服务端作为监听者，需要要使用具有监听权限的连接字符串，创建一个出站的WebSocket连接，也就是注册到Azure中继服务上。如果本地有多个监听者，那么进入的访问请求会随机地发送。一个混合连接最多支持25个监听者。
private const string ConnectionString = "connection string with listen permission";// Listenvar listener = new HybridConnectionListener(ConnectionString);await listener.OpenAsync();// AcceptHybridConnectionStream relayConnection = await listener.AcceptConnectionAsync();// Readvar reader = new StreamReader(relayConnection);var line = await reader.ReadLineAsync();// OutputConsole.WriteLine(line); // Closeawait relayConnection.CloseAsync(CancellationToken.None);
外部服务（发送者）
发送者提供具有发送权限的连接字符串（不是必须如果建立混合连接时没有要求客户端认证，不过从安全角度考虑，推荐要求认证），与混合连接服务建立WebSocket连接，最终会与一个监听者建立起连接，从而进行沟通。
private const string ConnectionString = "connection string with send permission";// Connectvar client = new HybridConnectionClient(ConnectionString);
HybridConnectionStream relayConnection = await client.CreateConnectionAsync();// Writevar writer = new StreamWriter(relayConnection) { AutoFlush = true };await writer.WriteLineAsync("hello from outside");// Closeawait relayConnection.CloseAsync(CancellationToken.None);
当然，因为搭建的WebSocket是双向通道，所以本地服务端也可以发送消息到外部服务端的。
连接字符串
前面提到需要用到不同权限的连接字符串，总共有三种权限管理，监听和发送，可以根据需要创建不同权限搭配的安全访问策略，然后在它的具体界面里会自动生成相应的连接字符串，直接复制使用即可，如下图。
如果本地服务不能或者不希望被修改成调用SDK，比如云端Web App调用本地的Web Api或者SQL数据库，那该如何使用混合连接呢？Azure Web App已经整合里混合连接，可以很方便的配置，而不需要对本地服务做任何修改。
完整代码示例可查看我的Github。
基于Azure Web App混合连接工具
目前Azure中国还没有支持混合连接的整合，不过已经在路上了，应该会很快就可上线。以下用Azure全球来演示，最终Azure中国也会是同样的体验。
配置混合连接端节点
登陆azure门户网站，找到你的web app，在设置下面点击网络，在展开的页面中点击“配置你的混合连接端节点”，打开页面如下：
点击“下载连接管理工具”下载，后面会用到。
点击“添加混合连接”，在打开的页面里面点击添加，如下图。填入相应信息，其中名称可以自定义，而端节点主机必须是运行你本地服务的机器名称，端节点端口也是本地服务所在端口。命名空间选择前面已经创建好的，也可以这里创建新的。
创建完成后，把前面下载的连接管理工具安装在运行本地服务的机器上。然后打开混合连接管理工具，点击“Configure another Hybrid Connection”，这个时候会弹出登陆框，输入你的azure订阅账户登陆后，会显示当前订阅中已有的混合连接，如下图。
选择配置了正确端节点的混合连接，然后点击“Save”保存。这个混合连接就会将本地与云端web app建立起连接，状态显示为”Connected”。
这样，在web app里面就可以通过”端节点名称：端口“的方式来访问本地的服务了。比如我这里演示的，我在本地运行了一个web api服务（api/values）在16782端口，返回字符串”value from on-premises <本地机器名称>”，然后通过混合连接，云端web app就可以很简单的访问本地服务了，代码如下：
using (var httpClient = new HttpClient())
{ var onPremSvcUri = "http://mc-allenl-01:16782/api/values"; using (var response2 = httpClient.GetAsync(onPremSvcUri).Result)
{ if (response2.IsSuccessStatusCode)
{
ViewBag.Message = $"{response2.Content.ReadAsStringAsync().Result}";
}
}
}
结果：
对于其他本地服务，比如SQL服务，也可以用同样的方式连接。
基于PortBridge示例程序
如果外部服务不是用Azure Web App，又该如何使用混合连接呢？可以通过混合连接来实现端口转发，从而建立连接通道。微软官方示例PortBridge正是演示了这种功能。接下来，我们用它来演示在云端虚拟机中的web应用调用本地web api。
创建以本地服务所运行的机器为名称的混合连接（演示名称mc-allenl-01），如何创建请参照文章最开始的PowerShell命令。并分别创建发送和监听权限的共享访问策略。
将PortBridge下载并编译，修改PortBridgeServerAgent.exe.config文件中portBridge相关配置，其中targetHost配置成本地服务所运行的机器名称，端口则为本地服务所在端口，本示例配置如下。然后将整个文件夹复制到本地服务所运行的机器上，并双击PortBridgeServerAgent.exe运行。
<portBridge serviceBusNamespace="allenlrelaydemo.servicebus.chinacloudapi.cn" serviceBusAccessRuleName="listen" serviceBusAccessRuleKey="******"> <hostMappings> <add targetHost="mc-allenl-01" allowedPorts="16785"/> </hostMappings></portBridge>
修改PortBridgeClientAgent.exe.config文件中portBridgeAgent的相关配置，其中targetHost设置成本地服务所运行的机器名称，localTcpPort设为你期望使用访问的端口，remoteTcpPort则为本地服务所运行的端口，本示例配置如下。将整个文件夹复制到Azure虚拟机中，并双击PortBridgeClientAgent.exe运行。
<portBridgeAgent serviceBusNamespace="allenlrelaydemo.servicebus.chinacloudapi.cn" serviceBusAccessRuleName="send" serviceBusAccessRuleKey="******"> <portMappings> <port localTcpPort="81" targetHost="mc-allenl-01" remoteTcpPort="16782"> <firewallRules> <rule source="127.0.0.1"/> <rule sourceRangeBegin="10.0.0.0" sourceRangeEnd="10.255.255.255"/> </firewallRules> </port> </portMappings></portBridgeAgent>
在Azure虚拟机中访问http://localhost:81/api/values，没有运行PortBridge之前是会失败的，但开启PortBridge，也就是通过混合连接建立通道之后，就会访问成功，如下所示：
