netutil

package
v0.2.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 13, 2026 License: MIT Imports: 19 Imported by: 0

Documentation

Overview

Package netutil sets up the Linux networking for endpoints: veth pairs, routing and NAT.

Index

Constants

View Source
const DefaultMTU = 1500

DefaultMTU is the veth MTU when the network sets none.

View Source
const MaxHostEndpoints = 3

MaxHostEndpoints is how many endpoints tailscaled takes from TS_DEBUG_PRETENDPOINT; it drops more without a word.

Variables

View Source
var DefaultPortRange = PortRange{61000, 65535}

DefaultPortRange holds the external ports of tailscaled's WireGuard traffic. It lies above Linux's default ephemeral range (32768-60999), so the host's own connections do not use them.

View Source
var ErrNoPortMapping = errors.New("no external port mapped")

ErrNoPortMapping is HostEndpoints' error for a container whose tailscaled has no external port (portMapChain) at the moment, as while its rule is missing until the next SyncPortMappings.

Functions

func AddIPAMAddress added in v0.2.3

func AddIPAMAddress(nsPath, ifName, ip string) error

AddIPAMAddress puts the address Docker's IPAM assigned to an endpoint on the interface ifName in the namespace at nsPath, as a /32. tslink connects the container through its own veth subnet, but Docker lists the IPAM address in the container's /etc/hosts: a process that resolves its own name to it, as RabbitMQ's epmd does, must be able to reach it. A /32 adds no route, so the network's other addresses stay unreachable here.

func CleanupAllNAT

func CleanupAllNAT() error

CleanupAllNAT removes the entire custom chain and all its rules. This is useful for complete plugin cleanup.

func CleanupNAT

func CleanupNAT(vethHost string) error

CleanupNAT removes the FORWARD rules and the port mapping for a specific veth interface, and the port mappings of veths that are gone. The global MASQUERADE rule and chain structure are intentionally left in place.

func CleanupTailnetBlackhole

func CleanupTailnetBlackhole(nsPath string) error

CleanupTailnetBlackhole removes the routes added by SetupTailnetBlackhole. A namespace or route that is already gone is not an error.

Note that a container that stays attached to another network regains a path to the tailnet ranges through the host once these routes are removed.

func ConfigureHostEndpoints added in v0.2.2

func ConfigureHostEndpoints(c HostEndpointsConfig)

ConfigureHostEndpoints sets the addresses HostEndpointAddrs returns.

func ConfigurePortMapping added in v0.2.1

func ConfigurePortMapping(sport int, ports PortRange)

ConfigurePortMapping sets tailscaled's UDP port in the containers and the range of external ports SetupNAT maps it to. Rules in place keep their ports.

func CreateVethPair

func CreateVethPair(baseName string, mtu int) (string, string, error)

CreateVethPair creates a veth pair with the given base name and MTU (0 for DefaultMTU). Returns the host-side name and container-side name.

func DeleteVeth

func DeleteVeth(name string) error

DeleteVeth deletes a veth interface.

func HostEndpointAddrs added in v0.2.2

func HostEndpointAddrs() ([]netip.Addr, error)

HostEndpointAddrs returns the addresses tslink nodes advertise, as configured: none, the given ones, or the host's private addresses (selectHostAddrs).

func HostEndpoints added in v0.2.2

func HostEndpoints(vethHost string) ([]netip.AddrPort, error)

HostEndpoints returns the endpoints the tailscaled behind vethHost advertises: each of HostEndpointAddrs with its external port. None if no address is configured or found.

func ListenInNetNS

func ListenInNetNS(nsPath, addr string) (net.Listener, error)

ListenInNetNS opens a TCP listener on addr in the network namespace at nsPath. The socket belongs to the namespace it was created in, so it keeps listening there after the thread returns to the plugin's namespace, and only that namespace's processes reach a loopback address.

func MoveToNetNS

func MoveToNetNS(ifName string, nsPath string) error

MoveToNetNS moves a network interface to the specified network namespace.

func RemoveHostIsolation

func RemoveHostIsolation() error

RemoveHostIsolation removes the host's tailnet isolation, and tolerates its absence.

func SetupBypassRoute

func SetupBypassRoute(nsPath, ifName, gatewayIP string) error

SetupBypassRoute sends tailscaled's own traffic through the tslink veth, whatever the container's default route. A task on an overlay network defaults via docker_gwbridge, and Docker may detach that network before tslink's: tailscaled would then lose the control plane before it can log out, and the device would linger.

func SetupContainerRouting

func SetupContainerRouting(
	nsPath string,
	ifName string,
	containerIP string,
	gatewayIP string,
) error

SetupContainerRouting sets up routing inside the container namespace.

func SetupHostIsolation

func SetupHostIsolation(bridges []string) error

SetupHostIsolation installs the host's tailnet isolation, or restores it: rules another program removed, and jumps it pushed down. bridges are the interface names of Docker's bridge networks, which containerInterfaces may not match. It changes nothing that is in place, so it can run periodically.

func SetupHostRouting

func SetupHostRouting(vethHost string, hostIP string) error

SetupHostRouting sets up routing on the host side for internet access.

func SetupInterfaceInNS

func SetupInterfaceInNS(nsPath string, ifName string, newName string) error

SetupInterfaceInNS sets up an interface inside a network namespace.

func SetupNAT

func SetupNAT(vethHost string) error

SetupNAT sets up MASQUERADE for traffic from the container. Uses a custom chain (TS-CNI-FORWARD) for organized rule management. vethHost must have its address: the container's tailscaled gets its own external port (see portMapChain).

func SetupTailnetBlackhole

func SetupTailnetBlackhole(nsPath string) error

SetupTailnetBlackhole installs unreachable routes for the tailnet ranges in the main table of the container namespace. tailscaled's policy rules consult table 52 first, so peers it can reach still route via tailscale0.

The IPv4 route is mandatory. The IPv6 route may fail when IPv6 is disabled in the namespace; that is accepted only if the namespace has no route to the IPv6 range anyway.

func SetupVethIsolation

func SetupVethIsolation(port int) error

SetupVethIsolation installs the veth isolation, or restores it, letting only replies and UDP to port from tslink's veths through to them. It also installs TSLINK-WG-IN and syncs the veths' WireGuard port mappings (SyncPortMappings). IPv4 only: the veths have no other addresses than link-local IPv6 ones. It changes nothing that is in place, so it can run periodically.

func SyncPortMappings added in v0.2.1

func SyncPortMappings() error

SyncPortMappings maps the tailscaled behind each of the host's veths to a port of its own, unless it has one, and removes the mappings of addresses no veth has. It changes nothing that is in place, so it can run periodically: it maps containers whose veth an older version set up, and removes the mappings of veths that went away with their container.

func UsedVethSubnets

func UsedVethSubnets() (map[netip.Prefix]bool, error)

UsedVethSubnets returns the /30 subnets in tslink's veth range that links of the current network namespace have addresses in.

func VethIPv4

func VethIPv4(name string) (string, error)

VethIPv4 returns the IPv4 address in tslink's veth range of the link name.

Types

type HostEndpointsConfig added in v0.2.2

type HostEndpointsConfig struct {
	Off   bool
	Addrs []netip.Addr
}

HostEndpointsConfig selects the addresses tslink nodes advertise: none if Off, Addrs if given, and otherwise the host's private addresses.

type PortRange added in v0.2.1

type PortRange struct{ First, Last int }

PortRange is an inclusive range of ports.

func ParsePortRange added in v0.2.1

func ParsePortRange(s string) (PortRange, error)

ParsePortRange parses "first-last", ports from 1024 to 65535.

func (PortRange) Contains added in v0.2.1

func (r PortRange) Contains(port int) bool

Contains reports whether port is in the range.

func (PortRange) String added in v0.2.1

func (r PortRange) String() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL