Add Troubleshooting relayed connections teaching page (#791)

* docs: add Troubleshooting relayed connections teaching page

Adds a help-section teaching doc that walks junior admins from
'Connection type: Relayed' to a fixed P2P connection (or a justified
stop): mental model, the four players (NAT/Signal/STUN/Relay), ICE
candidate reading, an elimination-based decision flow, a port-forwarding
escape hatch, a worked walkthrough, and when relay is the right answer.

Moves the troubleshooting-oriented sections (Checking Your Connection
Type, Tips for Improving P2P Success) out of Understanding NAT and
Connectivity, leaving it purely conceptual with pointers to the new
page. Adds sidebar entry and a pointer from troubleshooting-client.

* fix: correct nftables example for STUN outbound rule

The STUN service runs on UDP 80/443/3478/5555, but the example rule
allowed TCP/443. Also note that nftables resolves hostnames at
ruleset-load time only, which matters for a dynamic geo-distributed
endpoint pool.
This commit is contained in:
Jack Carter
2026-06-12 18:49:45 +02:00
committed by GitHub
parent 9cf8498a33
commit b34404102f
5 changed files with 268 additions and 113 deletions

View File

@@ -839,6 +839,10 @@ export const docsNavigation = [
title: 'Troubleshooting client issues',
href: '/help/troubleshooting-client',
},
{
title: 'Troubleshooting relayed connections',
href: '/help/troubleshooting-relayed-connections',
},
{ title: 'Report bugs and issues', href: '/help/report-bug-issues' },
{
title: 'Support Matrix',