McLinuxBridge (MCLB)

插件

· 作者 RonoMH

在你的服务器上的 Linux/macOS 或 Windows 终端中,直接从 Minecraft 聊天界面或控制台面板异步执行并实时流式传输命令。

0 本站下载 0 关注 更新于 3 周前

最新 1.1.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

概览

一款超轻量、高效的跨平台服务器管理插件,旨在通过服务器控制台或游戏聊天窗口,建立与主机操作系统之间的直接实时命令管道。

无论您的服务器运行在 Linux、Windows 还是 macOS 上,MCLinuxBridge 都会自动检测底层操作系统,并通过原生系统 Shell(bash、/bin/sh、cmd.exe 或 zsh)干净地路由命令。


Sad Update

我不打算在这个项目上投入太多精力了。我想不出新的功能点,我需要同时查看 GitHub 和 Modrinth,而且代码和构建过程总是失败。这并不意味着我不会继续这个项目,当然我会的,但不会太频繁。

警告

重要提示: 许多免费托管服务(如 freemcserver.net)严格禁止进程执行,导致在尝试运行 Shell 命令时出现 bash: Exec failed, error: 13 (Permission denied) 错误。

  • 自定义插件支持: 您需要一个允许上传自定义 .jar 文件(或通过 SFTP 访问)的主机来安装此工具。不支持自定义插件的主机在其默认插件列表中不会提供此类工具!

重要提示 2: 除非您是具有特定配置需求的进阶用户,否则请始终使用 5.0 或更高版本。如果缺少 LuckPerms 插件或未进行配置,4.0 及更低版本允许所有连接的玩家无限制地执行终端命令。

从 5.0 版本开始,内置的安全补丁默认将命令执行权限限制为操作员(OP)账户,即使未安装外部权限插件,也能保护您的服务器安全。

使用警告与政策

重要提示: 本插件严格用于管理和系统诊断目的。使用此工具绕过主机限制、运行后台加密货币挖矿程序或滥用免费层系统资源,直接违反了大多数主机的服务条款(ToS)。这样做很可能导致您的主机账户被立即暂停。


主要功能

  • 多操作系统执行引擎: 在运行时自动检测主机操作系统属性,并调用正确的原生 Shell(Windows 上的命令提示符,macOS 上的 Zsh,或 Linux 上的 Bash/SH)。
  • 原生 Java 文件系统回退机制: 包含内置的 Java 文件读取器(/mclinux list、/mclinux disk),可绕过受限容器中的 OS 级二进制限制。
  • 自动嵌入 Fastfetch: 将便携式 fastfetch 二进制文件直接捆绑在 JAR 文件中,并在服务器首次启动时自动提取并安装到 plugins/MCLinuxBridge/bin/ 中。
  • 可配置命令白名单: 生成本地 config.yml 文件,允许服务器管理员启用安全过滤器并将执行权限限制为明确批准的基命令。
  • 动态 Tab 补全下拉菜单: 在游戏聊天中按 Tab 键会打开交互式选项框,建议基命令(help、web、disk、reload、cancel、free、df、uname、ls)。
  • 内置 Java Web 文件浏览器: 直接在端口 12732 上托管一个零依赖、深色模式的 HTTP 文件浏览器,用于基于浏览器的目录检查。
  • 实时异步流式传输: 生成后台工作线程以逐行捕获终端日志,而不会冻结您的主要游戏刻循环。
  • 进程中断控制: 包含 /mclinux cancel 子命令,可按需强制终止活动或挂起的后台任务。
  • 看门狗保护: 应用自动 30 秒的执行超时,以防止挂起进程损害主机硬件资源。

使用指南

确保您的用户账户拥有适当的操作员特权,或者通过服务器 Web 面板直接执行命令:

  • /mclinux help - 显示游戏内命令指南和使用概览。
  • /mclinux web - 显示您内置的 Java Web 文件浏览器的链接。
  • /mclinux disk - 运行原生 Java 存储诊断(绕过 Shell 权限锁定。这些是为了更易于使用和那些不允许在终端中使用 bash 的主机而设计的。)
  • /mclinux reload - 热重载您的 config.yml 白名单设置。
  • /mclinux cancel - 强制终止任何当前正在运行的后台进程。
  • /mclinux <command> - 执行原始终端或命令提示符条目(如果 config.yml 允许)。

快速系统诊断

  • /mclinux free -h (RAM 占用和内存池分析)
  • /mclinux df -h (硬盘空间分配跟踪)
  • /mclinux uname -a (内核发行版和 OS 架构详细信息)

配置指南 (config.yml)

首次安装 MCLinuxBridge 时,会在您的 plugins/McLinuxBridge/ 文件夹中自动生成一个 config.yml 文件。

默认情况下,安全防护开箱即用(whitelist-enabled: true)。这将把游戏内的执行限制在安全列表中的诊断和实用命令范围内,防止意外破坏系统或文件。

默认配置文件

# 设置为 true 以严格限制仅执行下面列出的命令。
# 设置为 false 以允许完整、无限制的终端命令执行(仅限管理员/OP)。
whitelist-enabled: true

# 当启用白名单时,允许的基命令显式列表。
whitelisted-commands:
  - "help"
  - "fastfetch"
  - "cancel"
  - "free"
  - "df"
  - "uname"
  - "ls"
  - "cat"

如何安全地添加新命令

如果您希望授予服务器管理员访问特定终端工具的权限,而不完全开放整个操作系统,请保持白名单启用并遵循以下步骤:

  1. 打开文件:找到并编辑 plugins/McLinuxBridge/config.yml。
  2. 添加你的命令:在引号内将工具的基名添加到 whitelisted-commands(白名单命令)下。
    whitelisted-commands:
      - "help"
      - "fastfetch"
      - "ping"
      - "mkdir"
    
  3. 保存并应用:保存文件,并在游戏中运行 /mclinux reload 以即时应用更改,无需重启服务器。

重要安全提示:仅将你完全信任的命令添加到列表中。例如,将 rm 或 del 等基础工具加入白名单,将使任何拥有插件权限的人能够删除文件。为了最安全的部署,请保持 whitelist-enabled: true。

安全警告

此插件会暴露对底层操作系统执行的直接访问权限。 它仅应部署在私有的本地测试网络或受信的独立节点上。在多用户环境中运行时,服务器管理员应利用内置的 config.yml 白名单来限制可用的命令。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源