tailscale/tailscale · error · ErrGatewayRange

skipping portmap; gateway range likely lacks support

Error message

skipping portmap; gateway range likely lacks support

What it means

Error "skipping portmap; gateway range likely lacks support" thrown in tailscale/tailscale.

Source

Thrown at net/portmapper/portmappertype/portmappertype.go:30

	"time"

	"tailscale.com/feature"
	"tailscale.com/net/netmon"
	"tailscale.com/types/logger"
	"tailscale.com/util/eventbus"
)

// HookNewPortMapper is a hook to install the portmapper creation function.
// It must be set by an init function when buildfeatures.HasPortmapper is true.
var HookNewPortMapper feature.Hook[func(logf logger.Logf,
	bus *eventbus.Bus,
	netMon *netmon.Monitor,
	disableUPnPOrNil,
	onlyTCP443OrNil func() bool) Client]

var (
	ErrNoPortMappingServices = errors.New("no port mapping services were found")
	ErrGatewayRange          = errors.New("skipping portmap; gateway range likely lacks support")
	ErrGatewayIPv6           = errors.New("skipping portmap; no IPv6 support for portmapping")
	ErrPortMappingDisabled   = errors.New("port mapping is disabled")
)

// ProbeResult is the result of a portmapper probe, saying
// which port mapping protocols were discovered.
type ProbeResult struct {
	PCP  bool
	PMP  bool
	UPnP bool
}

// Client is the interface implemented by a portmapper client.
type Client interface {
	// Probe returns a summary of which port mapping services are available on
	// the network.
	//
	// If a probe has run recently and there haven't been any network changes

View on GitHub (pinned to cfe32b8be6)

When it happens

Trigger: Thrown at net/portmapper/portmappertype/portmappertype.go:30 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tailscale/tailscale@cfe32b8be6 (2026-08-15). Data as JSON: /api/errors/29f19210e2fd3b89. Report an issue: GitHub.