Update Netbird debug to probe correct data-plane ports
Build Hugo / build (push) Successful in 1m47s
Build Hugo / deploy (push) Failing after 1m15s

The Netbird server multiplexes management + signal + dashboard behind
Traefik on :443 (no separate :10000 signal port). The tunnel data plane
is WireGuard on 51820/udp and STUN on 3478/udp. Update the debug step to
probe those UDP ports plus a general outbound-UDP check (public STUN) to
determine whether the runner network blocks UDP egress -- the likely
cause of 'netbird up' timing out after the control plane connects fine.
This commit is contained in:
2026-07-25 01:46:28 +01:00
parent eb67d6361e
commit b05814980f
+34 -6
View File
@@ -71,13 +71,41 @@ jobs:
echo "=== DNS resolution ===" echo "=== DNS resolution ==="
getent hosts "$host" || nslookup "$host" || echo "DNS resolution FAILED for $host" getent hosts "$host" || nslookup "$host" || echo "DNS resolution FAILED for $host"
echo "=== HTTPS reachability (management API, :443) ===" # This deployment multiplexes management + signal + dashboard
curl -sS -o /dev/null -w "HTTP %{http_code} connect=%{time_connect}s total=%{time_total}s\n" \ # behind Traefik on :443 (gRPC-over-HTTP/2). There is no separate
--max-time 15 "https://${host}/" || echo "curl to management API FAILED" # :10000 signal port. The data plane is WireGuard on 51820/udp and
# STUN on 3478/udp -- those are the ports that actually matter for
# 'netbird up' to complete the tunnel handshake.
echo "=== Signal server port (:10000 gRPC) TCP check ===" echo "=== Control plane: HTTPS :443 (mgmt + signal via Traefik) ==="
timeout 10 bash -c "cat < /dev/null > /dev/tcp/${host}/10000" \ curl -sS -o /dev/null -w "HTTP %{http_code} connect=%{time_connect}s total=%{time_total}s\n" \
&& echo "TCP :10000 reachable" || echo "TCP :10000 NOT reachable (signal server / firewall?)" --max-time 15 "https://${host}/" || echo "curl to :443 FAILED"
ip="$(getent hosts "$host" | awk '{print $1; exit}')"
echo "Resolved IP: ${ip:-<none>}"
echo "=== Data plane: WireGuard 51820/udp (nc UDP probe) ==="
if command -v nc >/dev/null 2>&1; then
nc -zu -w 5 "$host" 51820 \
&& echo "UDP 51820 appears OPEN/reachable" \
|| echo "UDP 51820 probe returned non-zero (may be filtered/blocked -- prime suspect)"
else
echo "nc not available; installing..."
(apt-get update -qq && apt-get install -y -qq netcat-openbsd) >/dev/null 2>&1 || true
nc -zu -w 5 "$host" 51820 \
&& echo "UDP 51820 appears OPEN/reachable" \
|| echo "UDP 51820 probe returned non-zero (may be filtered/blocked -- prime suspect)"
fi
echo "=== STUN 3478/udp (nc UDP probe) ==="
nc -zu -w 5 "$host" 3478 \
&& echo "UDP 3478 appears OPEN/reachable" \
|| echo "UDP 3478 probe returned non-zero (may be filtered/blocked)"
echo "=== Outbound UDP allowed at all? (probe public STUN) ==="
nc -zu -w 5 stun.l.google.com 19302 \
&& echo "General outbound UDP works (reached Google STUN)" \
|| echo "General outbound UDP may be BLOCKED on this runner network"
echo "=== done (this step never fails the build) ===" echo "=== done (this step never fails the build) ==="
continue-on-error: true continue-on-error: true