Could not connect to a default or fallback server означает: BungeeCord запущен, но не смог передать игрока ни на одну разрешённую стартовую цель. Причина обычно кроется в priorities, статусе бэкенда, адресе/порте, файрволе, форвардинге или совместимости протокола.

Не открывай порт бэкенда для всего интернета ради отладки. Тестируй с точки зрения прокси и по-прежнему разрешай только его проверенный путь. Безопасную целевую картину показывает опорное руководство по настройке BungeeCord.

Дерево диагностики

Существует ли каждое имя из priorities среди servers?
├─ нет -> исправь имя и регистр
└─ да
   Запущена ли полностью хотя бы одна цель?
   ├─ нет -> устрани ошибку запуска бэкенда
   └─ да
      Достигает ли прокси именно этого адреса и порта?
      ├─ нет -> проверь адрес, аллокацию, маршрут и файрвол
      └─ да
         Совпадают ли форвардинг и версии?
         ├─ нет -> согласованно исправь конфигурацию
         └─ да -> проверь первый конкретный стектрейс прокси/бэкенда

1. Сравни priorities со servers

servers:
  lobby:
    address: <LOBBY-ADRESSE>:<PORT>
    restricted: false

listeners:
  - priorities:
      - lobby

lobby, Lobby и lobby — это разные ключи. Каждая запись в priorities должна существовать в servers. При нескольких целях BungeeCord пробует их по порядку; сломанная первая цель не должна скрывать и вторую резервную.

2. Убедись, что бэкенд действительно запущен

Статуса контейнера «running» недостаточно. Читай лог бэкенда до сообщения о завершении запуска. Типичные блокираторы запуска:

  • EULA не принят;
  • неправильный образ Java;
  • повреждённый или несовместимый JAR-файл плагина;
  • ошибка мира/мода;
  • порт уже занят;
  • сервер слушает на другой аллокации.

Затем протестируй конкретный servers.<name>.address. Пинг по IP хоста не доказывает, что TCP-порт Minecraft доступен.

3. Проверь адрес с точки зрения прокси

127.0.0.1 в контейнере прокси указывает на сам контейнер прокси. Используй его только тогда, когда доказано, что бэкенд и прокси используют одно и то же сетевое пространство имён. При раздельных инстансах тебе нужен адрес бэкенда, доступный именно с прокси.

Шаблоны ошибок:

Сообщение Типичное значение
Connection refused на целевом порту никто не слушает или правило активно отклоняет подключение
Timeout маршрут или файрвол отбрасывает пакеты, цель зависла или адрес неверен
Unknown host ошибка DNS/имени хоста
Address already in use конфликт из-за дублирующегося листенера/порта

На game-serverhosting активная защита бэкенда (Backend-Guard) охраняет проверенные пути BungeeCord. Если прокси остановлен или отсутствует его конкретный источник, путь к бэкенду намеренно остаётся только для сброса пакетов (drop-only). Запусти нужный прокси и дождись повторной проверки, вместо того чтобы удалять защитное правило.

4. Прицельно проверь файрвол

Файрвол должен одновременно соответствовать двум условиям:

  1. соответствующий прокси достигает TCP-порта бэкенда;
  2. независимый источник не может его достичь.

Если не выполняется ни одно из условий, сначала проверь конкретное сопоставление прокси и разрешение источника. Если работают оба, бэкенд не защищён. Открытие доступа для всей подсети общего хостинга или Docker — это не чистое решение проблемы.

5. Сравни значения форвардинга

Для классического BungeeCord с Paper/Spigot:

  • Прокси online_mode: true;
  • Прокси ip_forward: true;
  • Бэкенд server.properties с online-mode=false;
  • Бэкенд spigot.yml с settings.bungeecord: true;
  • Paper proxies.bungee-cord.online-mode: true, если прокси выполняет онлайн-аутентификацию.

Сообщение вроде If you wish to use IP forwarding... часто указывает на несогласованную конфигурацию прокси и бэкенда. Меняй эти значения — из-за возможной смены UUID — только после резервного копирования и с помощью руководства по безопасному форвардингу.

6. Изолируй версию и плагины

Сравни протокол клиента, прокси и бэкенда. Открытый TCP-порт всё равно может отклонить подключение. По возможности запусти lobby без недавно добавленных плагинов прокси. Устанавливай плагины BungeeCord только на прокси, а плагины Bukkit/Paper — только на бэкендах; руководство по плагинам объясняет эти уровни.

Не удаляй плагины вслепую на продакшене. Сделай резервную копию plugins/ и конфигурации, измени одну переменную в копии и откатись назад в случае неудачи.

7. Проверяй домен только после прямого пути

Сначала протестируй публичный IP прокси вместе с портом. Если он работает, а домен — нет, отдельно исследуй A/AAAA и SRV. Имя цели SRV должно указывать на прокси. Используй руководство по домену/SRV.

Финальная проверка

Ошибка считается устранённой только тогда, когда TCP, пинг Minecraft и реальный вход в lobby через прокси проходят успешно. После этого повтори независимый негативный тест к бэкенду. Перед перестройкой или сменой версии сначала используй путь резервного копирования и отката. Кроссплей идёт только после этого; TCP и Geyser-UDP проверяются отдельно.

FAQ

Что именно означает это сообщение?

Что сам BungeeCord запущен и принял игрока, но не смог передать его ни на одну разрешённую стартовую цель. Таким образом, прокси не является источником ошибки — причина кроется в priorities, статусе бэкенда, адресе и порте, файрволе, форвардинге или версии протокола.

Можно ли указать 127.0.0.1 в качестве адреса бэкенда?

Только если доказано, что прокси и бэкенд используют одно и то же сетевое пространство имён. В контейнере прокси 127.0.0.1 указывает на сам контейнер прокси, а не на бэкенд. При раздельных инстансах тебе нужен адрес, по которому прокси действительно достигает бэкенда.

Connection refused или Timeout — в чём разница?

Connection refused означает, что на целевом порту никто не слушает или правило активно отклоняет подключение: чаще всего это незапущенный бэкенд или неверный порт. Timeout указывает на маршрут или файрвол, отбрасывающий пакеты, на зависшую цель или на неверный адрес.

Стоит ли ненадолго открыть порт бэкенда для отладки?

Нет. Открытый порт бэкенда в offline-режиме позволяет посторонним выдавать себя за любого игрока. Вместо этого тестируй с точки зрения прокси. Если путь к бэкенду остаётся заблокированным, хотя прокси работает, проверь конкретное сопоставление прокси — и не удаляй защитное правило.

TCP-порт доступен, но подключение всё равно не удаётся — в чём причина?

Открытый порт доказывает лишь то, что что-то слушает. Если подключение всё равно не удаётся, сравни версии протокола клиента, прокси и бэкенда и попробуй запустить lobby без недавно добавленных плагинов прокси. Также проверь, не оказались ли плагины BungeeCord случайно установлены на бэкенде.

Первоисточники