TunnelForgeCoreNet 2.1.13

TunnelForgeCoreNet

TunnelForgeCoreNet — кроссплатформенная .NET Standard 2.1 библиотека для управления виртуальными сетевыми интерфейсами TUN/TAP на Windows и Linux. Предоставляет единый API для создания, чтения, записи и настройки туннеля.

Основные возможности

• Унифицированный API для Windows (Wintun через TunnelForge.WinTun) и Linux (/dev/net/tun).
• Создание виртуального интерфейса с произвольным именем и буфером (Windows).
• Синхронное и асинхронное чтение/запись пакетов.
• Событийная модель получения пакетов (OnPacketReceived).
• Помощники для настройки интерфейса: IP, маска/префикс, шлюз.
• Утилиты для разбора IPv4 заголовков и формирования UDP, TCP, ICMP пакетов.
• Builder-флюент TunnelForgeCoreBuilder для упрощённого создания туннеля.
• Максимальный размер пакета — 65535 байт.
• Автоматическое определение платформы и корректный выбор нативного кода.

Поддерживаемые платформы

• .NET Standard 2.1 (совместимо с .NET Core 3.x, .NET 6/7/8).
• Windows x64 (Wintun).
• Linux amd64 (TUN/TAP).

Установка

dotnet add package TunnelForgeCoreNet

Быстрый старт

using System;
using System.Threading;
using System.Threading.Tasks;
using TunnelForgeCoreNet;
using TunnelForgeCoreNet.Core;
using TunnelForgeCoreNet.Configurator;

class Program
{
    static async Task Main()
    {
        // 1. Создаём туннель через билдер
        var tunnel = new TunnelForgeCoreBuilder()
            .WithName("tun0")
            .WithCapacity(0x20000)  // 128 KiB
            .Build();

        // 2. Настраиваем сетевой интерфейс
        NetworkConfigurator.Configure(
            iface: "tun0",
            ip: "192.168.100.10",
            mask: 24,
            gateway: "192.168.100.1"
        );

        // 3. Подписываемся на событие получения пакета и включаем приём
        tunnel.OnPacketReceived += packet =>
        {
            Console.WriteLine($"Packet received: {packet.Length} bytes");
            // эхо-ответ
            tunnel.WritePacket(packet);
        };

        using var cts = new CancellationTokenSource();
        await tunnel.StartReceivingAsync(cts.Token);

        Console.WriteLine("Нажмите Enter для выхода...");
        Console.ReadLine();

        // 4. Останавливаем приём и освобождаем ресурсы
        cts.Cancel();
        tunnel.StopReceiving();
        tunnel.Dispose();
    }
}

Основной API

public interface ITunnelForgeCore : IDisposable
{
    void CreateTun(string name, uint capacity = 0x100000);
    Task CreateTunAsync(string name, uint capacity = 0x100000, CancellationToken ct = default);
    byte[]? ReadPacket();
    Task<byte[]?> ReadPacketAsync(CancellationToken ct = default);
    void WritePacket(ReadOnlySpan<byte> data);
    Task WritePacketAsync(ReadOnlyMemory<byte> data, CancellationToken ct = default);
    event Action<byte[]> OnPacketReceived;
    Task StartReceivingAsync(CancellationToken ct = default);
    void StopReceiving();
    bool IsRunning { get; }
    string? LinuxInterfaceName { get; }
}

Пример вызовов

Настройка сети (NetworkConfigurator)

public static void Configure(
    string iface,
    string ip,
    int mask = 24,         // префикс длины в битах
    string? gateway = null // требуется только для Linux
)

• Windows: устанавливает IP+маску через netsh.
• Linux: задаёт IP/префикс, поднимает интерфейс и добавляет маршрут через ip.

Утилиты (Utils)

• IpHeader: парсинг IPv4 заголовка (Version, IHL, TTL, Protocol, Src/Dst).
• UdpPacketBuilder: сборка UDP заголовка + вычисление checksum.
• TcpPacketBuilder: сборка TCP заголовка + вычисление checksum с псевдо-заголовком.
• IcmpPacketBuilder: сборка ICMP Echo Request + checksum.

Примеры и samples/

В папке samples/ консольное приложение демонстрирует:

• TunnelForgeCoreBuilder и NetworkConfigurator.
• Асинхронный приём с событием OnPacketReceived.
• Эхо-сервер поверх туннеля.

Сборка и запуск samples

Windows

cd samples
dotnet build -c Release
.
# поместите рядом wintun.dll
./samples.exe

Linux

cd samples
sudo dotnet build -c Release
sudo ./samples

Лицензия

MIT License — подробности в LICENSE.txt.