VpnHood.Net.VpnAdapters.LinuxTun
9.1.875
dotnet add package VpnHood.Net.VpnAdapters.LinuxTun --version 9.1.875
NuGet\Install-Package VpnHood.Net.VpnAdapters.LinuxTun -Version 9.1.875
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="VpnHood.Net.VpnAdapters.LinuxTun" Version="9.1.875" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="VpnHood.Net.VpnAdapters.LinuxTun" Version="9.1.875" />
<PackageReference Include="VpnHood.Net.VpnAdapters.LinuxTun" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add VpnHood.Net.VpnAdapters.LinuxTun --version 9.1.875
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: VpnHood.Net.VpnAdapters.LinuxTun, 9.1.875"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package VpnHood.Net.VpnAdapters.LinuxTun@9.1.875
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=VpnHood.Net.VpnAdapters.LinuxTun&version=9.1.875
#tool nuget:?package=VpnHood.Net.VpnAdapters.LinuxTun&version=9.1.875
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
VpnHood.Net.VpnAdapters.LinuxTun
The Linux VPN adapter of VpnHood: a TUN device, a virtual network interface that
the host's traffic is routed into, whose IP packets a VPN reads and writes. It implements
VpnHood.Net.VpnAdapters.Abstractions.
dotnet add package VpnHood.Net.VpnAdapters.LinuxTun
How it works
LinuxTunVpnAdapteris anIVpnAdapter: make it with aLinuxVpnAdapterSettings, whoseAdapterNamenames the interface (LinuxTunVpnAdapter.GetValidAdapterNamederives a valid one from any name), and use it as the Abstractions quick start usesNullVpnAdapter.- The TUN device is the process's own: the kernel removes it, with its routes, when the process ends, a crash
included. Its alias carries a tag made from the settings'
AppId, so a start can tell a device the app left, which it removes, from another app's interface of the same name, which refuses the start; an untagged TUN device of the name, as versions before tags made, is taken for the app's own while it is up. - A start sets the interface's addresses and routes with
ip, and its MTU when the options give one, and tries to keep NetworkManager off the interface. Its DNS servers go to systemd-resolved, with the routing domain~., which sends them every name no other link has a more specific domain for, or else toresolvconf; the start fails when/etc/resolv.confwould still name another server. While they are set, an nftables rule tries to send them the DNS queries over TCP or UDP port 53 that the host forwards, such as a container's, for the local network or a server systemd-resolved knows. - systemd-resolved sends a name under an interface's own DNS domain, as a network's DHCP gives one, to that
interface's servers, whatever the routes say. With
VpnAdapterOptions.UseExclusiveDnsthe adapter takes the DNS domains off the other interfaces while it is up and gives them back when it stops, so those names are asked of the VPN's servers too. A start fails where an interface still has a domain after that: for one that systemd-networkd manages, systemd 245 and 249 (Ubuntu 20.04 and 22.04) leave it there, and 255 and later take it off. The adapter does the same again after a change of the host's network, and stops if it fails there; a domain a network sets later without such a change stays until the next start. - For a server,
UseNatmasquerades each virtual network, IPv4 and IPv6, out of the interface of the default route of its IP version, withiptablesandip6tablesrules in chains of the adapter's own (vpnhood_nat_and its name), and turns on forwarding for the whole host, for the IP versions it translates. For IPv6 it first setsaccept_rato 2 on every interface that takes router advertisements now (one that does not forward yet, withaccept_raat 1), other than the adapter's own, so the host keeps the IPv6 routes it has from them. A start withUseNatremoves the chains an earlier run left, as after a crash, of both IP versions. There is no app filter. - Call
LinuxTunVpnAdapter.RemoveLeftoverswhen the app starts: it removes the DNS settings a crashed run left, and gives the other interfaces their DNS domains back.
Requirements
- Linux, and root: the adapter runs
ip,sysctl,resolvectlorresolvconf,iptables,nftandudevadmthrough bash. - For NAT, a default route of each IP version it translates.
- systemd-resolved, with
/etc/resolv.conflinked to it, or aresolvconfwith an exclusive mode, as openresolv's, for the VPN's DNS servers; nftables for the DNS of containers; iptables for NAT.
License
LGPL-2.1-only. See the VpnHood repository.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net11.0 is compatible. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net11.0
- VpnHood.Net.VpnAdapters.Abstractions (>= 9.1.875)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on VpnHood.Net.VpnAdapters.LinuxTun:
| Package | Downloads |
|---|---|
|
VpnHood.Core.Client.Devices.Linux
VpnHood client device provider for Linux: the app's side, and what its VPN host shares |
|
|
VpnHood.Core.Client.VpnServices.Host.Linux
VpnHood's VPN service on Linux: the VPN host's half, which runs the engine |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 9.1.875 | 25 | 11/16/2026 |
| 9.1.874 | 51 | 11/15/2026 |
| 9.1.864 | 123 | 11/3/2026 |
| 9.0.860 | 125 | 10/31/2026 |
| 9.0.859.16-prerelease | 111 | 10/30/2026 |
| 9.0.857 | 129 | 10/20/2026 |
| 9.0.856 | 121 | 10/19/2026 |
| 9.0.855 | 125 | 10/13/2026 |
| 8.2.853.11-prerelease | 124 | 10/5/2026 |
| 8.2.853 | 140 | 9/23/2026 |
| 8.2.852 | 142 | 9/23/2026 |