EmptyNetWeb

插件

· 作者 JohnDingleSin

将轻量级 Web 服务器嵌入你的 Minecraft 服务器,允许你从插件的 web 目录中提供静态文件。

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

最新 1.1.0 · 26.3 · Paper / Purpur

一键开服(送7天)

EmptyNetWeb

[重要]:已添加对 26.3 版本的支持,但测试仍在进行中。如果您在使用 26.3 时遇到任何错误或问题,请使用我们的错误报告表单提交。

EmptyNetWeb 是一个轻量级的 Paper 插件,它将一个零依赖的 HTTP Web 服务器直接嵌入到您的 Minecraft 服务器中。当服务器启动时,该插件会自动启动一个 HTTP 监听器,从插件数据文件夹内的专用目录提供静态网站文件。

这意味着您可以直接从您的 Minecraft 服务器托管网站、着陆页、API 文档或任何静态内容——无需 Apache、Nginx 或任何外部托管服务。

示例


工作原理

嵌入式 Web 服务器使用 com.sun.net.httpserver.HttpServer ——这是一个内置的 JDK 类,不需要任何外部依赖。它:

  • 在独立的缓存线程池中运行
  • 支持任何文件类型(HTML、CSS、JS、图片、字体等)
  • 根据文件扩展名自动检测 MIME 类型
  • 通过规范化请求路径来防止目录遍历攻击
  • 如果 Web 根目录为空,则创建默认的 index.html
  • 支持优雅关闭,为进行中的请求提供 2 秒的宽限期

安装

  1. 下载 releases 页面中的 EmptyNetWeb-1.0.0.jar
  2. 放置 JAR 文件到服务器的 plugins/ 文件夹中
  3. 重启您的 Paper 服务器(或使用 /reload——尽管建议重启)
  4. 插件将自动创建以下结构:
/plugins/EmptyNetWeb/
├── config.yml
└── web/
    └── index.html
  1. 打开浏览器并导航至 http://your-server-ip:8080/

配置

插件的配置文件位于 /plugins/EmptyNetWeb/config.yml:

# 嵌入式 Web 服务器监听的端口。
# 默认值:8080
port: 8080

# 当客户端连接到 Web 服务器时,是否在服务器控制台中打印消息。
# 默认值:true
notify-on-connect: true

# 是否将客户端连接记录到文件中。
# 日志存储在:/plugins/EmptyNetWeb/logs/
# 每条记录包含客户端的 IP 地址和时间戳。
# 默认值:false
log-connections: false

配置选项

选项 类型 默认值 描述
port 整数 8080 Web 服务器监听的 HTTP 端口
notify-on-connect 布尔值 true 当客户端连接时显示控制台消息
log-connections 布尔值 false 将每次连接(IP + 时间戳)记录到文件中以供审计

提供 Web 内容

将您的静态文件放置在 /plugins/EmptyNetWeb/web/ 中。目录结构完全由您决定。

示例结构

/plugins/EmptyNetWeb/web/
├── index.html
├── about.html
├── css/
│   └── style.css
├── js/
│   └── script.js
├── images/
│   ├── logo.png
│   └── background.jpg
└── fonts/
    └── custom-font.woff2

URL 映射

文件路径 URL
web/index.html http://localhost:8080/
web/about.html http://localhost:8080/about.html
web/css/style.css http://localhost:8080/css/style.css
web/images/logo.png http://localhost:8080/images/logo.png

注意: 如果请求的是目录(例如 /css/),服务器将在该目录内查找 index.html。如果不存在,则返回 404。


连接日志

当在 config.yml 中设置 log-connections: true 时,插件会将每个 HTTP 请求记录到 /plugins/EmptyNetWeb/logs/connections.log。

日志格式

[2026-07-24 12:30:45] Connection from 192.168.1.100 - /index.html
[2026-07-24 12:31:02] Connection from 192.168.1.100 - /css/style.css
[2026-07-24 12:32:18] Connection from 10.0.0.5 - /images/logo.png

每条记录包含:

  • 时间戳 — 请求的日期和时间(服务器本地时间)
  • 客户端 IP — 发起请求的客户端的 IP 地址
  • 请求路径 — 被请求的 URI 路径

安全性

  • 目录遍历保护: 服务器会规范化所有请求路径,并拒绝包含 .. 序列的请求,从而防止客户端访问 Web 根目录之外的文件。
  • 无外部依赖: Web 服务器仅使用 JDK 内置类,减少攻击面。
  • 可配置端口: 您可以更改端口以避免与其他服务冲突。

支持的文件类型

扩展名 MIME 类型
.html text/html; charset=utf-8
.css text/css; charset=utf-8
.js application/javascript
.json application/json
.png image/png
.jpg/.jpeg image/jpeg
.gif image/gif
.svg image/svg+xml
.ico image/x-icon
.woff/.woff2 font/woff / font/woff2
.ttf font/ttf
.otf font/otf
.pdf application/pdf
.zip application/zip
.xml application/xml
.txt text/plain
(其他) application/octet-stream

支持

如需反馈问题或提交评测,请访问 表单。

赞助支持

ChunkHost

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源