CreeperCLI

插件

· 作者 demonzdevelopment

通过终端远程管理 Minecraft。文件、控制台、命令

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

最新 1.1.1 · 26.3 · Bukkit / BungeeCord

一键开服(送7天)

CreeperCLI 让你能够从终端管理你的 Minecraft 服务器。在服务器上安装插件,并在电脑上安装 Node.js CLI,然后通过 TCP 连接。

浏览服务器文件,在你的编辑器中打开配置文件,完成后上传更改。你还可以传输文件、同步文件夹、运行控制台命令并查看服务器日志。TPS、内存和磁盘统计信息也可在同一终端中获取。

安装

  1. 将 CreeperCLI-1.0.0.jar 放入 plugins/ 目录并重启。
  2. 创建登录凭据:/creepercli user add <name> <password>
  3. 安装 CLI:npm install -g creepercli
  4. 登录:creepercli login --host <ip> --port 45678

命令

简单 CLI 命令:

命令 功能
creepercli ls <path> 列出目录
creepercli cat <path> 显示文件内容
creepercli edit <path> 在编辑器中打开文件,保存后推送回去
creepercli cpush <local> <remote> 上传文件(带校验和验证)
creepercli cpull <remote> <local> 下载文件
creepercli csync <remote> <local> 双向同步文件夹
creepercli exec <command> 运行控制台命令(仅限白名单)
creepercli log --grep <pattern> 过滤查看控制台日志
creepercli stats 内存、磁盘、运行时间
creepercli tps 过去 1、5 和 15 分钟的 TPS
creepercli top 实时进程仪表盘
creepercli repl 交互式 Shell
creepercli passwd 更改密码
creepercli totp setup 启用双重认证 (2FA)
creepercli logout 结束会话

或者去掉前缀,直接使用 Shell:

creepercli repl
> ls /
> cat server.properties
> cd plugins
> exec list
> stats
> exit

REPL 将命令历史保存在 ~/.creepercli/history 中,在命令之间记住当前目录,并支持路径和命令名称的 Tab 补全。

服务端命令

命令 功能
/creepercli user add <name> <password> 创建用户
/creepercli user remove <name> 删除用户
/creepercli user list 列出用户
/creepercli status 插件状态、被封禁的 IP
/creepercli reload 重新加载配置
/creepercli update 检查更新

工作流程

要编辑服务器配置文件,请运行 creepercli edit plugins/WorldGuard/config.yml。

文件将在你配置的编辑器中打开。进行修改、保存并关闭编辑器。CreeperCLI 会上传更新后的文件并报告更改了多少行。在你工作期间,它会保持编辑锁定。

要在本地保存服务器文件的副本,请运行 creepercli cpull server.properties ./server.properties.backup。

要上传本地文件,请运行 creepercli cpush ./config.yml plugins/WorldGuard/config.yml。

要将服务器文件夹与本地文件夹同步,请运行 creepercli csync plugins/WorldGuard ./config-templates。同步是双向的,并在传输文件前进行确认。添加 --yes 以跳过这些提示。

要在本地保存的同时查看警告和错误,请运行 creepercli log --grep 'ERROR|WARN' | tee console.log。

多服务器

CLI 在每个 host:port 上存储一个会话:~/.creepercli/creds,因此你可以同时保持多个服务器的会话:

creepercli login --host 127.0.0.1 --port 45678
creepercli login --host 127.0.0.1 --port 45679
creepercli --port 45679 exec list

常见错误

代码 含义
E_AUTH_FAILED 用户名或密码错误。服务器不会说明具体是哪一个。
E_TOTP_REQUIRED 账户已启用 2FA。登录时需提供 TOTP 验证码。
E_BANNED IP 被 fail2ban 封禁。等待解封或使用其他 IP。
E_RATE_LIMITED 命令过多。放慢速度或增加 limits.commands-per-second。
E_ALLOWLIST_DENIED 该控制台命令不在 exec.allowlist 中。将其添加并执行 /creepercli reload。
E_PATH_ESCAPE 尝试读取或写入沙箱外部。符号链接和 .. 逃逸尝试将被拒绝。
E_LOCKED 其他人正在编辑该文件。等待,或运行 unlock。
E_CHECKSUM_MISMATCH 传输验证失败。部分文件已被移除;请重试。

安全性

TCP 端口就像通往服务器的门供 CLI 使用,因此它受到严格限制。密码经过 bcrypt 哈希处理,2FA 是可选但可用的,空闲会话 15 分钟后过期,且会话绑定到启动它们的 IP。插件会限制失败的登录尝试,并封禁持续失败的 IP。文件访问被限制在服务器文件夹的沙箱内,因此 .. 和符号链接技巧无法逃逸。每个操作都会记录在仅追加的审计日志中。

默认情况下,它在 0.0.0.0:45678 上监听。如果你可以 SSH 访问该机器,请将 network.host 设置为 127.0.0.1 并通过 SSH 隧道连接:

ssh -N -L 45678:127.0.0.1:45678 user@server

以非 root OS 用户身份运行服务器。CreeperCLI 是一个完整的管理通道:包括文件访问和控制台权限。

设置

所有内容都位于 plugins/CreeperCLI/config.yml 中。当你更新插件时,缺失的键会自动添加,因此你的配置在升级后会保留。人们最常修改的项:

键 控制内容 默认值
network.host 绑定地址 0.0.0.0
network.port TCP 端口 45678
auth.session-timeout-minutes 空闲会话过期时间 15
sandbox.server-root 沙箱限制的文件夹 .
exec.allowlist CLI 可运行的控制台命令 list, whitelist *, say *, restart
limits.commands-per-second 每会话速率限制 30

CreeperCLI 为你提供对 Minecraft 服务器的远程管理访问。你需对自己如何使用它负责;创作者不对滥用行为承担责任。如果你在设置或故障排除方面需要帮助,请在我们的 Discord 服务器中提问。


由 Nexeu Hosting 赞助

nexeu-sponsor

为你的 Minecraft 服务器提供高性能、实惠的主机服务。高端硬件,即时设置,全天候支持。

在 nexeu.zip 获取主机托管服务


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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源