From 62409aa996b8de40fef341e371429d16addf1f72 Mon Sep 17 00:00:00 2001 From: Louis Shawn Date: Wed, 11 Feb 2026 09:19:12 +0800 Subject: [PATCH] config: clarify unsupported prefixes warnings --- hscontrol/types/config.go | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/hscontrol/types/config.go b/hscontrol/types/config.go index 4068d72e..3b24d3d9 100644 --- a/hscontrol/types/config.go +++ b/hscontrol/types/config.go @@ -856,7 +856,9 @@ func prefixV4() (*netip.Prefix, error) { ipSet, _ := builder.IPSet() if !ipSet.ContainsPrefix(prefixV4) { log.Warn(). - Msgf("Prefix %s is not in the %s range. This is an unsupported configuration.", + Msgf("`prefixes.v4` is set to %s, which is outside the supported %s range. "+ + "Headscale only supports prefixes within this range (including subsets); "+ + "custom ranges are unsupported and may break client connectivity.", prefixV4Str, tsaddr.CGNATRange()) } @@ -881,7 +883,9 @@ func prefixV6() (*netip.Prefix, error) { if !ipSet.ContainsPrefix(prefixV6) { log.Warn(). - Msgf("Prefix %s is not in the %s range. This is an unsupported configuration.", + Msgf("`prefixes.v6` is set to %s, which is outside the supported %s range. "+ + "Headscale only supports prefixes within this range (including subsets); "+ + "custom ranges are unsupported and may break client connectivity.", prefixV6Str, tsaddr.TailscaleULARange()) }