UPnP

插件

· 作者 TheBozzz34

这个简单的插件允许你的服务器使用 UPnP 在支持的路由器上自动打开网络端口。

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

最新 2.0-SNAPSHOT · 1.21 · Paper / Purpur

一键开服(送7天)

UPnP

一款轻量级的 Minecraft 插件,通过 UPnP(通用即插即用)自动打开服务器端口,无需在兼容的路由器上手动配置端口转发。

功能

  • 自动端口映射:在插件启动时自动开启你的 Minecraft 服务器端口
  • 自定义端口支持:为 Dynmap、Geyser 或语音聊天等插件配置额外端口
  • 协议灵活性:支持 TCP 和 UDP 端口映射
  • 自动清理:可选择在服务端关闭时释放端口
  • 零配置:开箱即用,拥有合理的默认设置
  • 轻量级:对服务器性能影响极小

工作原理

该插件使用 UPnP 协议 与你的路由器通信,并自动创建端口转发规则。这意味着玩家可以直接连接到你的服务器,而无需你手动配置路由器。

安装

  1. 从 Releases 下载最新版本
  2. 将 JAR 文件放入服务器的 plugins 文件夹中
  3. 重启服务器
  4. 插件将自动打开你的服务器端口

配置

首次运行后,编辑 plugins/UPnP/config.yml:

# 是否在服务器停止时关闭端口(推荐:true)
close-ports-on-stop: true

# 通过 bStats 启用匿名使用统计
bstats: true

# 要开放的 TCP 端口(默认包含服务器端口)
tcp:
  - 25565      # Minecraft 服务器
  - 8123       # Dynmap(示例)

# 要开放的 UDP 端口
udp:
  - 19132      # Geyser/Bedrock(示例)

常见端口示例

  • Minecraft Java: 25565 (TCP)
  • Dynmap: 8123 (TCP)
  • Geyser/Bedrock: 19132 (UDP)
  • BlueMap: 8100 (TCP)
  • Simple Voice Chat: 24454 (UDP)

要求

  • Minecraft 1.20 或更高版本(可能兼容旧版本)
  • 支持 UPnP 的路由器
  • 路由器已启用 UPnP(通常默认已启用)

故障排除

端口无法打开

  1. 检查路由器是否启用了 UPnP(请参阅路由器手册)
  2. 验证这些端口未被其他应用程序占用
  3. 查看服务器日志以获取错误信息
  4. 出于安全原因,某些 ISP 或路由器会阻止 UPnP

安全注意事项

虽然 UPnP 很方便,但它确实会在你的网络上开放端口。只开放你实际需要的端口,并且如果你不经常使用该插件,请考虑在路由器上禁用 UPnP。

统计

本插件使用 bStats 收集匿名使用统计数据。你可以在配置文件或全局的 plugins/bStats/config.yml 中禁用此功能。在 bStats 查看统计数据。

许可证

本模组遵循 GNU Lesser General Public License v3.0 only (LGPL-3.0-only) 许可。

这对用户和开发者的含义

  • 你可以在整合包中使用本模组(包括商业整合包)。
  • 你可以在服务器上运行本模组,包括付费或托管服务器。
  • 其他模组可以在任何许可下依赖或集成此模组。
  • 闭源模组和启动器可以链接到此模组。

你必须做的事情

  • 如果你修改了本模组的源代码,必须以相同的 LGPL-3.0-only 许可证发布这些修改。
  • 你必须允许用户独立替换或更新此模组(例如,作为普通 JAR 分发)。

你不需要做的事情

  • 你不需要开源你的整个模组、服务器或整合包。
  • 仅仅因为玩家连接,你不需要发布服务器源代码。
  • 如果你只是依赖此模组,你不需要将项目授权给 LGPL。

许可证历史

2026年1月3日之前发布的版本遵循 AGPL-3.0-only 许可。你可以在此处阅读更多关于变更的信息 here。

2026年1月3日及之后发布的版本遵循 LGPL-3.0-only 许可。

完整许可证文本,请参阅 LICENSE 文件。

鸣谢

基于 weupnp 库构建。


注意:本插件按原样提供。始终确保你了解在网络中开放端口的安全风险。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源