TunnelForgeCoreNet 2.1.3

TunnelForgeCoreNet

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

• Windows — Wintun (через TunnelForge.WinTun)
• Linux — стандартный /dev/net/tun

Возможности

• Поддержка Windows (Wintun) и Linux (TUN/TAP) с единым API.
• Создание виртуального интерфейса с произвольным именем.
• Чтение и запись сетевых пакетов через поток байтов.
• Автоматическое определение платформы и вызов соответствующего нативного кода.
• Максимальный размер пакета — 65535 байт.
• Управление жизненным циклом интерфейса (создание, закрытие).

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

• .NET Standard 2.1 (совместимость с .NET Core 3.x, .NET 6/7/8)
• Windows x64 (через Wintun)
• Linux amd64 (через /dev/net/tun)

Установка

dotnet add package TunnelForgeCoreNet

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

using System;
using TunnelForgeCoreNet;

class Program
{
    static void Main()
    {
        using var tunnel = new TunnelForgeCore();
        
        // Создаём виртуальный интерфейс с именем tun0 (на Linux) или "MyTun" (Windows)
        tunnel.CreateTun("tun0");

        // Читаем пакет (блокирующий вызов)
        byte[]? packet = tunnel.ReadPacket();
        if (packet != null)
        {
            Console.WriteLine($"Прочитано {packet.Length} байт");

            // Обрабатываем пакет, затем можем записать обратно
            tunnel.WritePacket(packet);
        }

        // Интерфейс автоматически закроется при Dispose
    }
}

API

Технические детали реализации

Windows (Wintun)

• Используется библиотека TunnelForge.WinTun для взаимодействия с Wintun.
• Генерируется GUID адаптера, создаётся сессия.
• Чтение пакетов через WintunReceivePacket, запись через WintunAllocateSendPacket.
• Освобождение ресурсов через WintunEndSession и WintunCloseAdapter.

Linux (/dev/net/tun)

• Открывается файл /dev/net/tun.
• Через ioctl с флагами IFF_TUN | IFF_NO_PI создаётся туннель с указанным именем.
• Используется поток FileStream для чтения и записи байтов.
• При закрытии поток корректно освобождается.

Требования и права

• Windows: права администратора или соответствующие разрешения для создания Wintun адаптера.
• Linux: права root или CAP_NET_ADMIN для создания и управления TUN интерфейсом.

Сборка нативных компонентов

• Wintun-библиотеки и Go нативный код поставляются как отдельные зависимости (TunnelForge.WinTun для Windows).
• Linux использует стандартные системные вызовы без сторонних бинарников.

Лицензия

MIT License — полный текст доступен в файле LICENSE.txt.