概览
一款超轻量、高效的跨平台服务器管理插件,旨在通过服务器控制台或游戏聊天窗口,建立与主机操作系统之间的直接实时命令管道。
无论您的服务器运行在 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"
如何安全地添加新命令
如果您希望授予服务器管理员访问特定终端工具的权限,而不完全开放整个操作系统,请保持白名单启用并遵循以下步骤:
- 打开文件:找到并编辑
plugins/McLinuxBridge/config.yml。 - 添加你的命令:在引号内将工具的基名添加到
whitelisted-commands(白名单命令)下。whitelisted-commands: - "help" - "fastfetch" - "ping" - "mkdir" - 保存并应用:保存文件,并在游戏中运行
/mclinux reload以即时应用更改,无需重启服务器。
重要安全提示:仅将你完全信任的命令添加到列表中。例如,将 rm 或 del 等基础工具加入白名单,将使任何拥有插件权限的人能够删除文件。为了最安全的部署,请保持 whitelist-enabled: true。
安全警告
此插件会暴露对底层操作系统执行的直接访问权限。 它仅应部署在私有的本地测试网络或受信的独立节点上。在多用户环境中运行时,服务器管理员应利用内置的 config.yml 白名单来限制可用的命令。
Overview
An ultra-lightweight, efficient cross-platform server administration plugin designed to establish a direct, real-time command pipeline into your host operating system directly from your server console or game chat.
Whether your server runs on Linux, Windows, or macOS, MCLinuxBridge automatically detects the underlying operating system and routes commands cleanly through native system shells (bash, /bin/sh, cmd.exe, or zsh).
Sad Update
I dont think im gonna work too much on this project anymore. I cannot come up with features, i need to both look at github and modrinth, and the code and build process fails all the time. This doesn't mean im not gonna work on this project, of course i will, but not too often.
WARNING
IMPORTANT: Many free hosting services (like freemcserver.net) strictly block process execution, resulting in
bash: Exec failed, error: 13 (Permission denied)errors when attempting to run shell commands.
- Custom Plugin Support: You need a host that allows custom
.jaruploads (or SFTP access) to install this tool. Hosters without custom plugin support won't offer tools like this in their default plugin lists!IMPORTANT 2: Always use version 5.0 or newer unless you are an advanced user with a specific configuration requirement. Versions 4.0 and lower permit unrestricted terminal command execution for all connected players if the LuckPerms plugin is missing or unconfigured.
Starting with Version 5.0, a built-in security patch is included that restricts command execution exclusively to Operator (OP) accounts by default, protecting your server even without an external permissions plugin installed.
Usage Warnings and Policies
IMPORTANT: This plugin is strictly intended for administrative and system diagnostic purposes. Using this tool to bypass host limitations, run background cryptominers, or abuse free tier system resources is a direct violation of most hosting Terms of Service (ToS). Doing so will likely result in immediate suspension of your hosting account.
Key Features
- Multi-OS Execution Engine: Automatically detects host operating system properties at runtime and invokes the correct native shell (Command Prompt on Windows, Zsh on macOS, or Bash/SH on Linux).
- Native Java File System Fallbacks: Includes built-in Java file readers (
/mclinux list,/mclinux disk) that bypass OS-level binary blocks on restricted containers. - Auto-Embedded Fastfetch: Bundles a portable
fastfetchbinary directly inside the JAR file that automatically extracts and installs intoplugins/MCLinuxBridge/bin/upon initial server boot. - Configurable Command Whitelist: Generates a local
config.ymlfile allowing server owners to enable security filters and restrict execution rights to explicitly approved base commands. - Dynamic Tab-Completion Dropdowns: Pressing
Tabin game chat opens an interactive option box suggesting base commands (help,web,disk,reload,cancel,free,df,uname,ls). - Built-in Java Web File Browser: Hosts a zero-dependency, dark-mode HTTP file explorer directly on port
12732for browser-based directory inspection. - Live Asynchronous Streaming: Spawns background worker threads to capture terminal logs line-by-line without freezing your primary game tick loop.
- Process Interruption Control: Includes a
/mclinux cancelsub-command to forcefully terminate active or hanging background tasks on demand. - Watchdog Protection: Applies an automatic 30-second execution cutoff to protect host hardware resources from hanging processes.
Usage Guide
Ensure your user account has appropriate operator privileges, or execute commands directly through your server web panel:
/mclinux help- Displays the in-game command guide and usage overview./mclinux web- Displays the link to your built-in Java Web File Browser./mclinux disk- Runs native Java storage diagnostics (bypasses shell permission locks. these are made for easier use and hosters that DONT let you use bash on terminal.)/mclinux reload- Hot-reloads yourconfig.ymlwhitelist settings./mclinux cancel- Forcibly terminates any currently running background process./mclinux <command>- Executes raw terminal or command prompt entries (if permitted byconfig.yml).
Quick System Diagnostics
/mclinux free -h(RAM footprint and memory pool analysis)/mclinux df -h(Hard drive space allocation tracking)/mclinux uname -a(Kernel distribution and OS architecture details)
Configuration Guide (config.yml)
When you first install McLinuxBridge, a config.yml file is automatically generated in your plugins/McLinuxBridge/ folder.
By default, security protection is enabled out of the box (whitelist-enabled: true). This restricts in-game execution exclusively to a safe list of diagnostic and utility commands, preventing any accidental system or file destruction.
Default Configuration File
# Set to true to restrict execution strictly to the commands listed below.
# Set to false to allow full, unrestricted terminal command execution (Admins/OPs only).
whitelist-enabled: true
# The explicit list of allowed base commands when the whitelist is enabled.
whitelisted-commands:
- "help"
- "fastfetch"
- "cancel"
- "free"
- "df"
- "uname"
- "ls"
- "cat"
How to Safely Add New Commands
If you want to grant your server administrators access to specific terminal tools without completely opening up your entire operating system, keep the whitelist enabled and follow these steps:
- Open the file: Locate and edit plugins/McLinuxBridge/config.yml.
- Add your command: Add the base name of the tool under whitelisted-commands inside quotation marks.
whitelisted-commands: - "help" - "fastfetch" - "ping" - "mkdir" - Save and Apply: Save the file and run /mclinux reload in-game to instantly apply your changes without restarting the server.
Important Security Note: Only add commands to the list that you completely trust. For example, adding base tools like rm or del to the whitelist will allow anyone with plugin permissions to delete files. Keep whitelist-enabled: true for the safest deployment.
Security Warning
This plugin exposes direct underlying operating system execution access. It should only be deployed on private local testing networks or trusted standalone nodes. Server administrators should utilize the built-in config.yml whitelist to restrict available commands when operating in multi-user environments.
下载 McLinuxBridge (MCLB)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 McLinuxBridge (MCLB)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 McLinuxBridge (MCLB)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 McLinuxBridge (MCLB)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 McLinuxBridge (MCLB)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 McLinuxBridge (MCLB)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 McLinuxBridge (MCLB)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 McLinuxBridge (MCLB)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 McLinuxBridge (MCLB)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
MCLinuxBridge 更新日志
1.1.0 — 2026-10-24(大幅更新)
新增
- 新增
/mclinux configure命令,用于显示当前的输出限制和看门狗(watchdog)限制。 - 新增
/mclinux configure outputlimit <10-1000>命令,可为每个玩家设置输出上限,并保留独立的控制台限制。 - 新增
/mclinux configure watchdoglimit <1-3600>命令,用于持久化配置命令运行时间限制。 - 为配置设置及其值添加了 Tab 补全建议和用法反馈。
- 新增
/mclinux diagnose检查项,涵盖操作系统、架构、Linux 发行版、glibc 兼容性以及内置的 Fastfetch 可执行文件。 - 在嵌套的
Verification文件夹下新增随机化的 Minecraft 日志存储,包含伪装文件夹和文件。 - 在插件配置目录下新增独立的验证密钥和定位元数据。
- 新增
/mclinux fixlogs命令,在日志读取失败后解锁使用,最多提供三次修复尝试,并包含写入/读取检查。 - 新增
/mclinux shellprotection <enable|disable>命令,用于切换 Shell 运算符和命令链过滤功能。 - 新增
/mclinux cancel命令,用于停止当前正在运行的命令。 - 新增
/mclinux logs [count]命令,用于查看最近的执行记录。 - 新增针对满足内置二进制文件 glibc 要求的 Linux x86_64 系统的嵌入式 Fastfetch 设置和支持诊断功能。
更改
- 命令执行期间,标准输出(stdout)和标准错误(stderr)中的内容会实时流式传输至发送者,并应用输出限制。
- 命令执行现在使用配置的看门狗持续时间,并在超时后终止命令。
- 日志写入使用验证头和代码,采用原子文件替换进行修复,并在支持的情况下仅设置所有者 POSIX 权限。
- 迁移过程中保留现有的旧版日志条目,并将其标记为未验证状态。
- 将插件元数据更新为稳定版本
1.1.0。
修复
- 修复了在取消或进程替换后,命令执行等待已清除的进程引用的问题。
- 改进了子进程流处理逻辑,确保被停止的进程不会产生误导性的“流已关闭”错误。
- 为配置命令提供了更清晰的用法说明和无效值提示信息。
兼容性说明
- 此版本不包含单独的 Velocity 实现。
- 内置的 Fastfetch 可执行文件仅限 Linux x86_64 平台;可通过
/mclinux diagnose检查其是否满足操作系统要求。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧