Could not connect to a default or fallback server betekent: BungeeCord draait, maar kon de speler niet doorsturen naar een toegestane startbestemming. De oorzaak ligt meestal in priorities, de backendstatus, het adres/de poort, de firewall, forwarding of protocolcompatibiliteit.

Open de backend-poort niet zomaar voor het hele internet om te troubleshooten. Test vanuit het perspectief van de proxy en sta alleen het geverifieerde pad daarvan toe. Het veilige eindbeeld laat de BungeeCord-setup-pillar zien.

Diagnoseboom

Bestaat elke priorities-naam onder servers?
├─ nee -> naam en hoofdlettergebruik corrigeren
└─ ja
   Is minstens één bestemming volledig opgestart?
   ├─ nee -> backend-startfout oplossen
   └─ ja
      Bereikt de proxy exact dit adres en deze poort?
      ├─ nee -> adres, allocatie, route en firewall controleren
      └─ ja
         Kloppen forwarding en versies?
         ├─ nee -> configuratie consistent corrigeren
         └─ ja -> eerste concrete proxy-/backend-stacktrace controleren

1. priorities vergelijken met servers

servers:
  lobby:
    address: <LOBBY-ADRES>:<POORT>
    restricted: false

listeners:
  - priorities:
      - lobby

lobby, Lobby en lobby zijn niet dezelfde sleutel. Elke vermelding in priorities moet onder servers bestaan. Bij meerdere bestemmingen probeert BungeeCord ze in volgorde; een kapotte eerste bestemming mag de tweede fallback niet eveneens blokkeren.

2. Backend daadwerkelijk opstarten

Een containerstatus „running" is niet genoeg. Lees het backendlog tot aan de voltooiingsmelding. Typische startblokkades zijn:

  • EULA niet geaccepteerd;
  • verkeerde Java-image;
  • beschadigde of incompatibele plugin-JAR;
  • wereld-/modfout;
  • poort al in gebruik;
  • server luistert op een andere allocatie.

Test daarna het concrete servers.<name>.address. Een ping naar het host-IP-adres bewijst niet dat de Minecraft-TCP-poort bereikbaar is.

3. Adres vanuit proxyperspectief controleren

127.0.0.1 wijst in de proxycontainer naar de proxycontainer zelf. Gebruik het alleen als backend en proxy aantoonbaar dezelfde netwerk-namespace delen. Bij gescheiden instanties heb je het backendadres nodig dat de proxy daadwerkelijk kan bereiken.

Foutpatronen:

Melding Typische betekenis
Connection refused er luistert niets op de doelpoort of een regel weigert actief
Timeout route of firewall laat pakketten vallen, doel hangt of adres is onjuist
Unknown host DNS-/hostnaamfout
Address already in use dubbele listener/poortconflict

Op game-serverhosting beschermt de actieve backend-guard de bewezen BungeeCord-paden. Als de proxy gestopt is of zijn concrete bron ontbreekt, blijft het backendpad bewust drop-only. Start de juiste proxy en wacht op de herbeoordeling, in plaats van de beschermingsregel te verwijderen.

4. Firewall gericht controleren

De firewall moet twee uitspraken tegelijk waarmaken:

  1. de bijbehorende proxy bereikt de backend-TCP-poort;
  2. een onafhankelijke bron bereikt hem niet.

Als beide mislukken, controleer dan eerst de concrete proxytoewijzing en bronresolutie. Als beide werken, is de backend onbeschermd. Een vrijgave voor een compleet shared-hosting- of Docker-subnet is geen nette oplossing.

5. Forwarding-waarden vergelijken

Voor klassieke BungeeCord met Paper/Spigot:

  • Proxy online_mode: true;
  • Proxy ip_forward: true;
  • Backend server.properties met online-mode=false;
  • Backend spigot.yml met settings.bungeecord: true;
  • Paper proxies.bungee-cord.online-mode: true, als de proxy online authenticeert.

Een melding zoals If you wish to use IP forwarding... wijst vaak op een inconsistente proxy-/backendconfiguratie. Wijzig deze waarden vanwege mogelijke UUID-wijzigingen alleen na een back-up en met de forwarding-veiligheidsgids.

6. Versie en plugins isoleren

Vergelijk het client-, proxy- en backendprotocol. Een open TCP-poort kan een join alsnog weigeren. Start indien mogelijk met een lobby zonder nieuw toegevoegde proxy-plugins. Installeer BungeeCord-plugins alleen op de proxy en Bukkit/Paper-plugins alleen op backends; de plugin-gids legt de niveaus uit.

Verwijder plugins niet blindelings uit een productieomgeving. Maak een back-up van plugins/ en de configuratie, wijzig één variabele in een kopie en draai bij falen terug.

7. Domein pas na het directe pad controleren

Test eerst het publieke proxy-IP-adres plus de poort. Werkt dat, maar het domein niet, onderzoek dan A/AAAA en SRV afzonderlijk. De SRV-targetnaam moet naar de proxy verwijzen. Gebruik de domein-/SRV-gids.

Eindcontrole

De fout is pas opgelost als TCP, Minecraft-ping en een echte lobby-join via de proxy groen zijn. Herhaal daarna de onafhankelijke negatieve test naar de backend. Gebruik voor een ombouw of versiewissel vooraf het back-up- en rollbackpad. Crossplay komt pas daarna aan bod; TCP en Geyser-UDP worden afzonderlijk gecontroleerd.

FAQ

Wat betekent de melding precies?

Dat BungeeCord zelf draait en de speler heeft geaccepteerd, maar hem niet aan een toegestane startbestemming kon overdragen. De proxy is daarmee niet de foutbron — de oorzaak ligt in priorities, in de backendstatus, in adres en poort, in de firewall, in forwarding of in de protocolversie.

Kan ik 127.0.0.1 als backendadres invoeren?

Alleen als proxy en backend aantoonbaar dezelfde netwerk-namespace delen. In de proxycontainer wijst 127.0.0.1 naar de proxycontainer zelf, niet naar de backend. Bij gescheiden instanties heb je het adres nodig waarop de proxy de backend daadwerkelijk bereikt.

Connection refused of timeout — wat is het verschil?

Connection refused betekent dat er niets luistert op de doelpoort of dat een regel actief weigert: meestal een niet-gestarte backend of een verkeerde poort. Een timeout wijst op een route of firewall die pakketten laat vallen, op een hangende bestemming of op een verkeerd adres.

Moet ik de backend-poort kort openen om te troubleshooten?

Nee. Een open offline-mode-backend-poort laat vreemden toe zich voor te doen als een willekeurige speler. Test in plaats daarvan vanuit het perspectief van de proxy. Blijft het backendpad geblokkeerd terwijl de proxy draait, controleer dan de concrete proxytoewijzing — en verwijder niet de beschermingsregel.

De TCP-poort is bereikbaar, de join mislukt toch — waar ligt dat aan?

Een open poort bewijst alleen dat er iets luistert. Mislukt de join daarna, vergelijk dan de client-, proxy- en backendprotocolversie en start testsgewijs een lobby zonder nieuw toegevoegde proxy-plugins. Controleer ook of BungeeCord-plugins per ongeluk op een backend staan.

Primaire bronnen