CreeperCLI 让你能够从终端管理你的 Minecraft 服务器。在服务器上安装插件,并在电脑上安装 Node.js CLI,然后通过 TCP 连接。
浏览服务器文件,在你的编辑器中打开配置文件,完成后上传更改。你还可以传输文件、同步文件夹、运行控制台命令并查看服务器日志。TPS、内存和磁盘统计信息也可在同一终端中获取。
安装
- 将
CreeperCLI-1.0.0.jar 放入 plugins/ 目录并重启。
- 创建登录凭据:
/creepercli user add <name> <password>
- 安装 CLI:
npm install -g creepercli
- 登录:
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 赞助

为你的 Minecraft 服务器提供高性能、实惠的主机服务。高端硬件,即时设置,全天候支持。
在 nexeu.zip 获取主机托管服务
CreeperCLI lets you manage your Minecraft server from your terminal. Install the plugin on your server and the Node.js CLI on your computer, then connect over TCP.
Browse server files, open a config in your editor, and upload your changes when you're done. You can also transfer files, sync folders, run console commands, and watch the server log. TPS, memory, and disk stats are available from the same terminal.
Install
- Put
CreeperCLI-1.0.0.jar in plugins/ and restart.
- Create a login:
/creepercli user add <name> <password>
- Install the CLI:
npm install -g creepercli
- Log in:
creepercli login --host <ip> --port 45678
Commands
Simple CLI commands:
| Command |
What it does |
creepercli ls <path> |
List a directory |
creepercli cat <path> |
Show a file |
creepercli edit <path> |
Open a file in your editor, push it back on save |
creepercli cpush <local> <remote> |
Upload a file, checksum-verified |
creepercli cpull <remote> <local> |
Download a file |
creepercli csync <remote> <local> |
Sync a folder both ways |
creepercli exec <command> |
Run a console command, allowlist only |
creepercli log --grep <pattern> |
Watch the console, filtered |
creepercli stats |
Memory, disk, uptime |
creepercli tps |
TPS over 1, 5, and 15 minutes |
creepercli top |
Live process dashboard |
creepercli repl |
Interactive shell |
creepercli passwd |
Change your password |
creepercli totp setup |
Turn on 2FA |
creepercli logout |
End the session |
Or drop the prefix and use the shell instead:
creepercli repl
> ls /
> cat server.properties
> cd plugins
> exec list
> stats
> exit
The REPL saves your command history in ~/.creepercli/history, remembers your current directory between commands, and supports tab completion for paths and command names.
Server-side commands
| Command |
What it does |
/creepercli user add <name> <password> |
Create a user |
/creepercli user remove <name> |
Delete a user |
/creepercli user list |
List users |
/creepercli status |
Plugin status, banned IPs |
/creepercli reload |
Reload config |
/creepercli update |
Check for updates |
Workflows
To edit a server config, run creepercli edit plugins/WorldGuard/config.yml.
The file opens in your configured editor. Make your changes, save, and close the editor. CreeperCLI uploads the updated file and reports how many lines changed. It holds an edit lock while you work.
To save a copy of a server file on your computer, run creepercli cpull server.properties ./server.properties.backup.
To upload a local file, run creepercli cpush ./config.yml plugins/WorldGuard/config.yml.
To sync a server folder with a local folder, run creepercli csync plugins/WorldGuard ./config-templates. Sync works in both directions and asks before transferring files. Add --yes to skip those prompts.
To watch warnings and errors while saving them locally, run creepercli log --grep 'ERROR|WARN' | tee console.log.
Multi-server
The CLI stores one session per host:port in ~/.creepercli/creds, so you can hold sessions to several servers at once:
creepercli login --host 127.0.0.1 --port 45678
creepercli login --host 127.0.0.1 --port 45679
creepercli --port 45679 exec list
Common errors
| Code |
What it means |
E_AUTH_FAILED |
Wrong username or password. The server won't say which. |
E_TOTP_REQUIRED |
Account has 2FA on. Pass a TOTP code with the login. |
E_BANNED |
IP banned by fail2ban. Wait it out or use a different IP. |
E_RATE_LIMITED |
Too many commands. Slow down or raise limits.commands-per-second. |
E_ALLOWLIST_DENIED |
That console command isn't in exec.allowlist. Add it and /creepercli reload. |
E_PATH_ESCAPE |
Tried to read or write outside the sandbox. Symlink and .. escapes get rejected. |
E_LOCKED |
Someone else is editing that file. Wait, or run unlock. |
E_CHECKSUM_MISMATCH |
Transfer failed verification. The partial file is removed; retry. |
Security
The TCP port is like a door into your server for the CLI, so it stays locked down. Passwords are bcrypt-hashed, 2FA is optional but available, sessions expire after 15 idle minutes, and they stay bound to the IP that started them. The plugin throttles failed logins and bans IPs that keep failing. File access is jailed to the server folder, so .. and symlink tricks can't escape it. Every action lands in an append-only audit log.
By default, it listens on 0.0.0.0:45678. If you have SSH access to the machine, set network.host to 127.0.0.1 and connect through an SSH tunnel:
ssh -N -L 45678:127.0.0.1:45678 user@server
Run the server as a non-root OS user. CreeperCLI is a full admin channel: file access and console are included.
Settings
Everything lives in plugins/CreeperCLI/config.yml. When you update the plugin, missing keys get added on their own, so your config survives upgrades. The ones people touch most:
| Key |
What it controls |
Default |
network.host |
Bind address |
0.0.0.0 |
network.port |
TCP port |
45678 |
auth.session-timeout-minutes |
Idle session expiry |
15 |
sandbox.server-root |
Folder the sandbox jails in |
. |
exec.allowlist |
Console commands the CLI can run |
list, whitelist *, say *, restart |
limits.commands-per-second |
Per-session rate limit |
30 |
CreeperCLI gives you remote admin access to a Minecraft server. You're responsible for how you use it; the creator isn't liable for misuse. If you need help setting it up or troubleshooting, ask in our Discord server.
Sponsored by Nexeu Hosting

High-performance, affordable hosting for your Minecraft server. Premium hardware, instant setup, 24/7 support.
Get hosting at nexeu.zip
评论 0
登录后参与评分
还没有评论,来抢沙发吧