Files
tailscale/health/args.go
Jonathan Nobels 273a9b4a4b health, ipn/ipnlocal, tsconst: warn when the selected or forced exit node is unusable
updates tailscale/corp#33007

When a selected exit node can't carry internet traffic, blackhole default
routes are installed and all internet traffic is dropped. That is the
correct behavior -- better to drop than leak to the local network, as
documented on ipn.Prefs.ExitNodeID -- but it was entirely silent: the
stable-ID lookup in nodeBackend.updateRouteManagerPrefs misses without a
log line, and Status leaves ExitNodeStatus nil. The user sees a healthy
Tailscale with no internet.

Add an exit-node-unavailable health warning covering every way the
selection can fail to carry traffic, reported via health.ArgExitNodeReason.

The warning names the exit node, caching its display name while it is
still a peer so the name survives its departure, and falls back to the
stable ID or IP. When the selection is mandated by the ExitNodeID or
ExitNodeIP policy settings, the message tells the user to contact their
network administrator instead of suggesting they pick another exit node.

Signed-off-by: Jonathan Nobels <jonathan@tailscale.com>
2026-08-28 11:10:52 -04:00

62 lines
2.7 KiB
Go

// Copyright (c) Tailscale Inc & contributors
// SPDX-License-Identifier: BSD-3-Clause
package health
// Arg is a type for the key to be used in the Args of a Warnable.
type Arg string
const (
// ArgAvailableVersion provides an update notification Warnable with the available version of the Tailscale client.
ArgAvailableVersion Arg = "available-version"
// ArgCurrentVersion provides an update notification Warnable with the current version of the Tailscale client.
ArgCurrentVersion Arg = "current-version"
// ArgDuration provides a Warnable with how long the Warnable has been in an unhealthy state.
ArgDuration Arg = "duration"
// ArgError provides a Warnable with the underlying error behind an unhealthy state.
ArgError Arg = "error"
// ArgMagicsockFunctionName provides a Warnable with the name of the Magicsock function that caused the unhealthy state.
ArgMagicsockFunctionName Arg = "magicsock-function-name"
// ArgDERPRegionID provides a Warnable with the ID of a DERP server involved in the unhealthy state.
ArgDERPRegionID Arg = "derp-region-id"
// ArgDERPRegionName provides a Warnable with the name of a DERP server involved in the unhealthy state.
// It is used to show a more friendly message like "the Seattle relay server failed to connect" versus
// "relay server 10 failed to connect".
ArgDERPRegionName Arg = "derp-region-name"
// ArgServerName provides a Warnable with the hostname of a server involved in the unhealthy state.
ArgServerName Arg = "server-name"
// ArgServerName provides a Warnable with comma delimited list of the hostname of the servers involved in the unhealthy state.
// If no nameservers were available to query, this will be an empty string.
ArgDNSServers Arg = "dns-servers"
// ArgDomains provides a Warnable with a comma-delimited list of domain
// names involved in the unhealthy state.
ArgDomains Arg = "domains"
// ArgExitNodeName provides a Warnable with a human-readable identifier for
// the selected exit node: its display name if it is (or recently was) a
// known peer, otherwise its stable node ID or IP address. It is empty if
// no particular exit node has been selected.
ArgExitNodeName Arg = "exit-node-name"
// ArgExitNodeReason provides a Warnable with the reason the selected exit
// node cannot carry internet traffic: "not-in-tailnet", "no-exit-routes",
// or "not-yet-selected". It lets GUIs distinguish the cases without
// parsing the rendered message.
ArgExitNodeReason Arg = "exit-node-reason"
// ArgExitNodePolicyForced is "true" when the selected exit node is
// mandated by the ExitNodeID or ExitNodeIP policy settings, meaning the
// user cannot resolve the problem themselves and should contact their
// network administrator.
ArgExitNodePolicyForced Arg = "exit-node-policy-forced"
)