network

type BridgeConfig ¶

type BridgeConfig struct {
	// Name is the bridge interface name (e.g. "jerboa-br0").
	Name string
	// CIDR is the gateway IP with CIDR mask (e.g. "10.0.0.1/24").
	CIDR string
}

BridgeConfig holds the parameters for a Linux bridge interface.

type Forwarder ¶

type Forwarder struct {
	// contains filtered or unexported fields
}

Forwarder publishes guest ports on the host by proxying real listening sockets to the guest over the bridge.

It replaces iptables DNAT, which never worked for host-local access (the PREROUTING rule matched the wrong direction) and is invisible to WSL2's localhost forwarding (a DNAT rule opens no listening socket, so a Windows host cannot reach it). A userspace listener is a normal socket: reachable from the host itself and mirrored by WSL2 to the Windows side.

func StartForwarder(guestIP string, ports []PortForward) (*Forwarder, error)

func (f *Forwarder) Close()

type Network ¶

type Network struct {
	ID        string    `json:"id"`
	Name      string    `json:"name"`
	Subnet    string    `json:"subnet"`
	Gateway   string    `json:"gateway"`
	Bridge    string    `json:"bridge"`
	Driver    string    `json:"driver"`
	CreatedAt time.Time `json:"created_at"`
}

type PortForward ¶

type PortForward struct {
	HostPort  uint16
	GuestPort uint16
	Protocol  string
}

PortForward describes a single host-to-guest port forwarding rule.

type Store ¶

type Store struct {
	// contains filtered or unexported fields
}

func NewStore(dir string) (*Store, error)

func (s *Store) AllocateIP(name string) (net.IP, error)

func (s *Store) Create(name, subnet, driver string) (*Network, error)

func (s *Store) Get(name string) (*Network, error)

func (s *Store) List() ([]*Network, error)

func (s *Store) ReleaseIP(name string, ip string) error

func (s *Store) Remove(name string) error

type TAP ¶

type TAP struct {
	// contains filtered or unexported fields
}

TAP manages a TAP network interface.

func Create(cfg TAPConfig) (*TAP, error)

func (t *TAP) Destroy() error

func (t *TAP) Name() string

type TAPConfig ¶

type TAPConfig struct {
	// Name is the interface name (e.g. "jerboa-tap0"). Truncated to 15 chars.
	Name string
	// Bridge is the Linux bridge to attach to (e.g. "jerboa-br0").
	Bridge string
}

TAPConfig holds the parameters for a TAP device.