Open.NAT 使用教程

Open.NAT 使用教程

Open.NAT Lightweight and easy-to-use class library to allow port forwarding in NAT devices with UPNP and/or PMP 项目地址: https://gitcode.com/gh_mirrors/op/Open.NAT

1. 项目介绍

Open.NAT 是一个轻量级且易于使用的类库，用于支持 UPNP（通用即插即用）和/或 PMP（端口映射协议）的 NAT 设备进行端口映射。NAT（网络地址转换）后的计算机无法从外部网络直接访问，这对于实现点对点或好友间的通信尤其不便。Open.NAT 的主要目标是简化 NAT 设备背后的计算机之间的通信，提供简洁的接口获取外部 IP 地址和映射端口，帮助实现点对点通信。

2. 项目快速启动

在开始使用 Open.NAT 之前，确保你的项目环境已安装 .NET 或 Mono。以下是使用 Open.NAT 的基本步骤：

首先，通过 NuGet 包管理器安装 Open.NAT：

Install-Package Open.NAT

然后，你可以使用以下代码进行设备发现和端口映射：

using System;
using System.Threading;
using Open.NAT;

class Program
{
    static async Task Main(string[] args)
    {
        var discoverer = new NatDiscoverer();
        var cts = new CancellationTokenSource(10000); // 设置超时时间为10秒
        var device = await discoverer.DiscoverDeviceAsync(PortMapper.Upnp, cts.Token);

        if (device == null)
        {
            Console.WriteLine("未发现设备。");
            return;
        }

        var ip = await device.GetExternalIPAsync();
        Console.WriteLine($"外部 IP 地址是: {ip}");

        var mapping = new Mapping(Protocol.Tcp, 1600, 1700, "示例映射");
        await device.CreatePortMapAsync(mapping);
        Console.WriteLine("端口映射成功。");
    }
}

在上述代码中，我们首先创建了一个 NatDiscoverer 实例来发现支持 UPNP 的 NAT 设备。如果设备在指定时间内被发现，它会获取外部 IP 地址并创建一个端口映射。

3. 应用案例和最佳实践

Open.NAT 在多种应用场景中都非常有用，以下是一些常见的使用案例：

• 在点对点游戏中，允许玩家通过 NAT 设备直接连接。
• 对于需要从外部网络访问的家庭媒体服务器，使用 Open.NAT 可以轻松映射端口。
• 在开发需要穿透 NAT 的应用程序时，Open.NAT 可以自动化端口映射过程。

最佳实践建议：

• 总是为端口映射指定一个描述性的名称，便于管理和识别。
• 当不再需要端口映射时，及时删除映射以避免资源浪费。
• 考虑到安全性，只在需要时开启端口映射，并确保关闭不需要的映射。

4. 典型生态项目

Open.NAT 被多个开源项目所使用，以下是一些典型的生态项目：

• War For The Overworld：一款使用 Open.NAT 实现网络对战的游戏。
• OpenRA：一个开源的即时战略游戏，利用 Open.NAT 进行玩家之间的连接。
• Interstellar RIFT：一款太空探索游戏，使用 Open.NAT 简化玩家之间的通信。

这些项目的成功运用证明了 Open.NAT 的实用性和稳定性，为开发者提供了强大的工具来处理 NAT 环境下的网络通信问题。

Open.NAT Lightweight and easy-to-use class library to allow port forwarding in NAT devices with UPNP and/or PMP 项目地址: https://gitcode.com/gh_mirrors/op/Open.NAT