TunnelMC (Туннел МС)

Плагин для серверов Майнкрафт, который открывает локальные порты в интернет через ngrok, cloudflared или playit.gg без выделения портов у хостинга. Подходит, чтобы дать игрокам адрес сервера, открыть веб-панель или подключить Майнкрафт Бедрок через Geyser; управлять туннелями можно командами и через браузерную панель.

Возможности

• Создаёт HTTP-, TCP- и UDP-туннели через ngrok, cloudflared и playit.gg; для каждого туннеля выбирается свой сервис.
• Автоматически скачивает нужные исполняемые файлы для системы и процессора, а готовый публичный адрес выводит в консоль и отправляет онлайн-операторам.
• Веб-панель позволяет создавать, изменять, запускать, останавливать и удалять туннели, скачивать компоненты и менять настройки.
• Может автоматически запускать туннели, перезапускать их после сбоя и прекращать попытки при частых сбоях за короткое время.
• Быстрые туннели cloudflared работают без учётной записи, но дают случайный HTTP-адрес. Именованные туннели cloudflared используют постоянное доменное имя и требуют токен Cloudflare Zero Trust.
• Для ngrok у каждого туннеля задаётся собственный authtoken; можно указать закреплённый домен в hostname.
• playit.gg поддерживает UDP-адреса для Майнкрафт Бедрок. Тип туннеля задаётся значением playit-type: "minecraft-bedrock".

Команды

Для всех команд используется /tunnel.

• /tunnel start [name] — запустить все туннели или указанный.
• /tunnel stop [name] — остановить все туннели или указанный.
• /tunnel restart [name] — перезапустить туннели.
• /tunnel url [name] — показать публичные адреса.
• /tunnel status — вывести состояние всех туннелей.
• /tunnel download ngrok, /tunnel download cloudflared, /tunnel download playit — скачать компонент выбранного сервиса.
• /tunnel playit claim — вывести ссылку для привязки аккаунта playit.gg.
• /tunnel playit status — показать состояние привязки playit.gg.
• /tunnel playit unlink — отвязать playit.gg и остановить его туннели.
• /tunnel dashboard — показать сведения о порте веб-панели.
• /tunnel reload — перечитать config.yml и перезапустить туннели.

Права

TUNNELMC.admin — доступ к управлению плагином; по умолчанию есть у операторов.

Настройка

Основные параметры находятся в config.yml:

• auto-start — автозапуск туннелей;
• notify-ops — отправка адреса операторам;
• auto-restart, restart-delay-seconds, max-restarts и crash-window-seconds — перезапуск и защита от циклических сбоев;
• health-check-interval-seconds — период проверки состояния;
• dashboard.enabled, dashboard.port, dashboard.bind-address и dashboard.password — веб-панель;
• tunnels — список туннелей с параметрами name, port, provider, protocol, токенами и доменными именами.

Имена туннелей могут содержать только латинские буквы, цифры, _ и -.

Требования

Работает на Bukkit, Spigot, Paper и Purpur, а также на Linux, macOS и Windows с процессорами x64 или ARM64. Требуется Java 25 или новее. Для Pterodactyl дополнительные выделенные порты не нужны: туннели создают исходящие соединения.