Введение: когда имена не работают

Ошибка «Unknown host» появляется в консоли сервера при попытке подключиться к внешним сервисам (Mojang API, базам данных, веб-хукам Discord). Сервер не может преобразовать доменное имя (например, session.minecraft.net) в IP-адрес. Это ломает аутентификацию, интеграцию с Discord и другие функции. В этом гайде — диагностика и решение DNS-проблем на сервере Minecraft.

Причина 1: DNS-серверы не настроены или недоступны

Серверная машина не может достучаться до DNS-серверов (например, 8.8.8.8 Google DNS).

Решение:

• Проверьте DNS: nslookup google.com. Если не резолвится — проблема с DNS.
• Пропишите DNS-серверы вручную: Google (8.8.8.8, 8.8.4.4) или Cloudflare (1.1.1.1).
• На Linux: отредактируйте /etc/resolv.conf.
• На Windows: настройки сетевого адаптера → IPv4 → DNS.

Причина 2: Файрвол блокирует DNS-запросы (порт 53)

DNS работает по порту 53 UDP/TCP. Если брандмауэр блокирует этот порт — DNS не работает.

Решение:

• Разрешите исходящие подключения на порт 53 UDP и TCP в брандмауэре.

Причина 3: Проблемы на стороне Mojang

Если ошибка только для session.minecraft.net, а остальные сайты резолвятся — проблема на стороне Mojang.

Решение:

• Проверьте статус серверов Mojang на help.minecraft.net.
• Ждите восстановления.

Причина 4: Сервер в Docker-контейнере без доступа к DNS хоста

Docker-контейнеры по умолчанию используют DNS хост-машины, но иногда эта связь ломается.

Решение:

• В docker-compose.yml добавьте: dns: 8.8.8.8.

💡 Совет профи

Для критичных сервисов (аутентификация) используйте IP-адреса вместо доменных имён в конфигурациях, где это возможно. Это исключает DNS из цепочки отказа. Но помните, что IP серверов Mojang могут меняться — регулярно проверяйте.