TunnelMC

插件

· 作者 spider2742

通过 ngrok、cloudflared 和 playit 隧道将任何服务器端口暴露到互联网——无需额外的端口分配。

0 本站下载 0 关注 更新于 2 个月前

最新 1.5.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

TunnelMC ?

通过 ngrok、cloudflared 或 playit.gg 将任何本地端口暴露到互联网——无需进行端口分配。包含一个完整的基于浏览器的管理仪表板。

TunnelMC 是一个 Bukkit/Spigot/Paper 插件,它会自动下载并管理 ngrok、cloudflared 和/或 playit.gg,为任何本地端口创建隧道,并在隧道就绪时将公共 URL 广播到控制台和所有在线 OP(管理员)。


? 1.5.0 新功能:可靠性与安全性修复

这是一次基于系统性审计的维护版本,同时增加了一项功能以跟上 ngrok 的变更:

  • 新增:ngrok 隧道现在可以使用保留/静态域名。 ngrok 已将域名选择移至其自己的仪表板(“Choose your URL”)——在那里选择一个,将其放入新的 hostname 字段中,它会随 --url 一起传递。留空则每次启动时随机生成域名,与之前相同。
  • 修复:编辑隧道可能会静默清除其保存的 authtoken/cfToken。 编辑表单正确地从不向浏览器发送密钥,但保存不相关的更改(如切换自动启动)会用空白值覆盖存储的令牌,导致隧道在下一次启动时失效。保存时空白秘密字段现在会保留现有值;只有实际的新值才会覆盖它。
  • 修复:隧道名称中包含撇号会导致该隧道卡片上的每个操作按钮失效。 Start/Stop/Restart/Delete/Copy 按钮现在对包含 '、" 或 \ 的名称、URL 和 ID 进行了正确的转义处理。
  • 修复:将隧道重命名为已存在的隧道名称会导致旧隧道成为孤儿进程。 旧隧道的进程仍在运行,但没有任何东西跟踪它,并且它完全从 config.yml 中消失。现在如果尝试重命名到已使用的名称,将被拒绝。
  • 修复:在启动后立即点击停止可能会导致未跟踪的隧道进程继续运行, 并且在稍后即使你明确停止了它,它在仪表板上也会重新显示为“运行状态”。启动/停止的竞争条件不再允许输掉竞争的启动进程接管其进程。
  • 修复:playit.gg 的“Try Again”按钮在被拒绝或取消链接尝试后的长达约 11 分钟内,可能会返回一个过期的会话声明, 而不是发布一个新的代码。
  • 修复:未经清理的隧道名称可能将 ngrok 的每隧道配置文件写入预期目录之外。 现在隧道名称被限制为字母、数字、_ 和 -。
  • 修复:编辑任何隧道可能会静默清除保存的 ngrok 保留域名至空白, 因为持久化路径在每次保存时都会从头重建所有隧道的条目。
  • 修复:格式错误的仪表板 API 请求可能会返回一个空的、无法解释的服务器错误, 日志中没有任何内容。现在不良请求会获得清晰的 JSON 错误,并且真实原因会在服务器端记录。
  • 改进:错误日志记录 对于 playit/ngrok/cloudflared 下载和连接失败的情况,现在始终包含异常类型(如果没有消息,则包含抛出位置),而不仅仅是有时打印裸 "null"。

✨ 功能特性

? 三种隧道提供商 — ngrok、cloudflared 和 playit.gg,可针对每个隧道进行配置。自由混合使用。

? UDP + 静态地址 (playit.gg) — 这是此处唯一提供稳定 UDP 地址的提供商,专为 Bedrock/Geyser 设计。也可提供仅 TCP 以及组合 TCP+UDP 隧道(需要 playit premium)。

? 多个 ngrok 账户 — 每个 ngrok 隧道都有自己独立的 authtoken(v3 必需)。同时运行不同的账户。

? 零设置快速隧道 — Cloudflared 快速隧道开箱即用,无需账户。

? 自定义域名 — Cloudflared 命名隧道通过 Cloudflare Zero Trust 为您提供持久的自定义主机名。

?️ Web 仪表板 — 完整的管理界面。直接从浏览器实时创建/编辑/删除隧道、下载二进制文件、更改设置。

⚡ 自动下载 — 检测操作系统和 CPU 架构,在首次使用时下载正确的二进制文件。之后永久缓存。

? 即时 URL 广播 — 一旦隧道就绪,URL 就会发送到控制台和所有在线 OP。

? 完整的命令支持 — /tunnel 命令支持所有功能的 Tab 补全。

? 自动重启与崩溃循环保护 — 隧道在失败后自动重启。如果在短时间内失败次数过多,则停止重试。

? 健康检查 — ngrok 隧道获得 API 级别的检查;cloudflared 隧道获得进程存活检查。

? Pterodactyl 兼容 — 隧道是出站连接,因此永远不需要额外的端口分配。


? 安装

  1. 将 TunnelMC.jar 放入 plugins/ 文件夹
  2. 启动服务器 —— TunnelMC 会生成配置文件,如果未配置任何隧道,则通过 cloudflared 自动暴露仪表板
  3. 在浏览器中打开打印出的 URL
  4. 从仪表板配置隧道,或编辑 config.yml 并运行 /tunnel reload

⚙️ 配置

auto-start: false
default-region: "us"       # ngrok 隧道的备用区域
notify-ops: true
auto-restart: true
restart-delay-seconds: 10
max-restarts: 5
crash-window-seconds: 60
health-check-interval-seconds: 30

dashboard:
  enabled: true
  port: 8090
  bind-address: "127.0.0.1"
  password: "changeme"
  auto-expose-on-first-run: true

tunnels:
  # Cloudflared 快速隧道 —— 无需账户,随机 URL,仅限 HTTP
  - name: "dashboard"
    port: 8090
    provider: "cloudflared"
    auto-start: true

  # 具有自己账户令牌的 ngrok HTTP 隧道
  - name: "noderunner"
    port: 8080
    provider: "ngrok"
    protocol: "http"
    region: "us"
    authtoken: "your-ngrok-token-here"

  # 来自不同账户的 ngrok TCP 隧道
  - name: "gameserver"
    port: 25565
    provider: "ngrok"
    protocol: "tcp"
    region: "eu"
    authtoken: "another-account-token"

  # 具有保留/静态域名的 ngrok 隧道(从 ngrok 仪表板中选择)
  - name: "stable-mc"
    port: 25565
    provider: "ngrok"
    protocol: "tcp"
    authtoken: "your-ngrok-token-here"
    hostname: "your-reserved-domain.ngrok-free.dev"

Cloudflared 命名隧道 — 持久化自定义域名

  • name: "mc" port: 25565 provider: "cloudflared" token: "your-cloudflare-zero-trust-token" hostname: "mc.yourdomain.com"

playit.gg — 请先在仪表板(Settings 选项卡)中链接账户;Bedrock 仅支持 UDP

  • name: "bedrock" port: 19132 provider: "playit" playit-type: "minecraft-bedrock" auto-start: true

---

## ? 命令与权限

**权限:** `tunnelmc.admin` *(默认:OP)*

| 命令 | 描述 |
|---|---|
| `/tunnel start [name]` | 启动所有或指定名称的隧道 |
| `/tunnel stop [name]` | 停止所有或指定名称的隧道 |
| `/tunnel restart [name]` | 重启所有或指定名称的隧道 |
| `/tunnel url [name]` | 显示公共 URL |
| `/tunnel status` | 显示所有隧道状态 |
| `/tunnel download ngrok` | 下载 ngrok 二进制文件 |
| `/tunnel download cloudflared` | 下载 cloudflared 二进制文件 |
| `/tunnel download playit` | 下载 playit 二进制文件 |
| `/tunnel playit claim` | 打印用于链接 playit.gg 账户的链接 |
| `/tunnel playit status` | 显示 playit.gg 链接状态 |
| `/tunnel playit unlink` | 取消链接 playit.gg 并停止其隧道 |
| `/tunnel dashboard` | 显示仪表板端口信息 |
| `/tunnel reload` | 重新加载配置并重启隧道 |

---

## ? 服务商对比

| | ngrok | Cloudflared Quick | Cloudflared Named | playit.gg |
|---|:---:|:---:|:---:|:---:|
| 需要账户 | ✅ 免费 | ❌ 无需 | ✅ 免费 | ✅ 免费 |
| HTTP 隧道 | ✅ | ✅ | ✅ | ✅ (通过 TCP) |
| TCP 隧道 | ✅ | ❌ | ✅ | ✅ (Java 预设免费;自定义 TCP 需高级版) |
| UDP 隧道 | ❌ | ❌ | ❌ | ✅ (免费 — Bedrock 预设及自定义 UDP) |
| 持久化 URL | 仅限付费 | ❌ | ✅ | ✅ |
| 多账户支持 | ✅ (每隧道) | — | — | — |
| macOS 构建 | ✅ | ✅ | ✅ | ⚠️ TunnelMC 编译版 |

---

## ⚠️ 免费计划说明

**ngrok 免费版:** 同时只能运行一个活动隧道,每次重启时 URL 随机变化,有带宽限制。所有 ngrok v3 隧道均需 Authtoken。使用每隧道 authtoken 可以利用多个免费账户来绕过单隧道限制。

**Cloudflared quick tunnels:** 仅支持 HTTP,使用随机的 `*.trycloudflare.com` URL,无带宽限制。

**Cloudflared named tunnels:** 需要 Cloudflare 账户(免费),支持任意协议,提供持久化的自定义域名。

---

## ? Pterodactyl

无需额外分配端口 — 隧道均为出站连接。仪表板也绑定在本地,因此不需要分配端口。

**下载缓慢?** 如果手动安装耗时超过 30 秒,TunnelMC 会发出警告并提供手动安装步骤。将二进制文件放置在 `plugins/TunnelMC/ngrok/ngrok`、`plugins/TunnelMC/cloudflared/cloudflared` 或 `plugins/TunnelMC/playit/playitd`,然后重启服务器即可。

---

## ? 兼容性

| | |
|---|---|
| **平台** | Bukkit, Spigot, Paper, Purpur |
| **Minecraft** | 1.21.x – 26.2.x |
| **Java** | 25+ (使用 Java 25 编译) |
| **操作系统** | Linux, macOS, Windows |
| **架构** | x64, ARM64 |

> ⚠️ **macOS + playit.gg:** ngrok 和 cloudflared 提供官方 macOS 构建版本,可正常运行。playit.gg 不提供 — 仪表板的 Settings 选项卡提供了由 TunnelMC 编译的版本(SHA-256 已验证)或自行编译的说明。

---

## ? 相关插件

**[NodeRunner](https://modrinth.com/plugin/noderunner)** — 在 Minecraft 服务器内运行 Node.js Discord 机器人。

**[PyRunner](https://modrinth.com/plugin/pyrunner)** — 在 Minecraft 服务器内运行 Python Discord 机器人。

*TunnelMC 与这两款插件完美搭配 — 为端口 8080 建立 cloudflared quick tunnel 即可让它们的仪表板公开访问,且无需任何端口分配。*

---

*由 [Spider](https://github.com/Spider2742) 开发*

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源