LinuxGSM v26.4.0 常用 CLI 命令与工具详解

LinuxGSM v26.4.0 实例脚本 19 条命令逐条实测：usage 全菜单与别名表、status 命令移除说明、start/stop/restart、details/postdetails、monitor/test-alert、backup/update/update-lgsm、console/debug/send、skeleton/developer、tmux 独立 socket 机制与多实例边界；回显全部实测照抄（2026-11-02）。

LinuxGSMLinuxGSMCLI工具游戏服务器Minecraft2026/11/03

LinuxGSM v26.4.0 常用 CLI 命令与工具详解

目标：把 LinuxGSM v26.4.0 实例脚本（./mcserver）的全部 19 条命令逐条实测讲透——生命周期（start/stop/restart）、信息（details/postdetails）、保活（monitor/test-alert）、运维（backup/update/check-update/update-lgsm/install/auto-install）、交互（console/debug/send）、辅助（skeleton/developer/sponsor），含 usage 全菜单、别名表、status 命令已移除的实测说明、tmux 独立 socket 机制与多实例边界。全部命令与回显实机执行照抄（实测时间 2026-11-02）。配置参数含义见《LinuxGSM v26.4.0 配置参数详解》。

一、环境信息

  • 操作系统：Ubuntu 24.04.5 LTS（x86_64），tmux 3.4，Java openjdk 25.0.4.1
  • 实测时间：2026-11-02
  • LinuxGSM 版本：v26.4.0；实例：mcserver（Minecraft 服务端 26.3）
  • 运行用户：lgsm（uid 1001，家目录 /home/lgsm）；示例登录账号 root / admin，口令 q1w2e3r4
  • 所有命令形如 ./mcserver <命令> [参数]，在实例脚本所在目录执行；回显中的 fetching GitHub [...] ... OK 是模块首次拉取，缓存后不再出现
  • 部署与配置背景：《Ubuntu 24.04 安装 LinuxGSM v26.4.0 指南》《LinuxGSM v26.4.0 配置参数详解》

二、命令总览：usage 全菜单

不带参数或传未知命令都会打印完整用法菜单（实测照抄）：

Usage: ./mcserver [option]

LinuxGSM - Minecraft - Version v26.4.0
https://linuxgsm.com/mcserver

Commands
start         st   | Start the server.
stop          sp   | Stop the server.
restart       r    | Restart the server.
monitor       m    | Check server status and restart if crashed.
test-alert    ta   | Send a test alert.
details       dt   | Display server information.
postdetails   pd   | Post details to termbin.com (removing passwords).
skeleton      sk   | Create a skeleton directory.
update-lgsm   ul   | Check and apply any LinuxGSM updates.
update        u    | Check and apply any server updates.
check-update  cu   | Check if a gameserver update is available
backup        b    | Create backup archives of the server.
console       c    | Access server console.
debug         d    | Start server directly in your terminal.
send          sd   | Send command to game server console.
install       i    | Install the server.
auto-install  ai   | Install the server without prompts.
developer     dev  | Enable developer Mode.
sponsor       s    | Sponsorship options.

19 条命令、每条一个短别名（第二列）。按用途分四组：

组命令一句话
生命周期start / stop / restart起停与重启，停止走优雅通道
信息与保活details / postdetails / monitor / test-alert状态核对、诊断上传、掉线自救、告警链路验证
更新与备份install / auto-install / update / check-update / update-lgsm / backup游戏服务端与 LinuxGSM 自身的双线更新、存档备份
交互与辅助console / debug / send / skeleton / developer / sponsor控制台附着、前台排障、注入命令、目录骨架、开发模式

三、status 命令已移除（旧教程高频坑）

实测传 status：

Error! Unknown command: ./mcserver status

随后即打印上文的 usage 菜单。v26.4.0 已没有 status 命令，网上旧教程里的 ./mcserver status 全部失效。替代入口：

需求用实测入口
快速判断活没活（并自动救活）monitorChecking session ... OK + Querying port ... OK
看状态与全量信息details末行 Status: STARTED
看游戏内实时输出console / 读 ~/log/console/见第六章

四、生命周期命令实测

4.1 start

./mcserver start

实测回显（motd 为 LinuxGSM Test Server 时）：

[ .... ] Starting mcserver: LinuxGSM Test Server
[  OK  ] Starting mcserver: LinuxGSM Test Server
[  OK  ] Starting mcserver: LinuxGSM Test Server

第一行 OK = tmux 会话建立，第二行 OK = 查询端口探活通过。启动失败时第二行会是 [ FAIL ] Starting mcserver: Unable to start ...（配置篇 3.2 的误配案例）。

4.2 stop

./mcserver stop

实测回显：

[ .... ] Stopping mcserver: LinuxGSM Test Server
[ .... ] Stopping mcserver: Graceful: sending "stop"
[ .... ] Stopping mcserver: Graceful: sending "stop": 1
[  OK  ] Stopping mcserver: Graceful: sending "stop": 2 ... OK

Graceful: sending "stop" 表示向游戏控制台注入 stop 等待落盘（stopmode="5"），数字是等待秒数。游戏不吃 stop 指令的（如某些老引擎），才需要调 stopmode 换通道——编号表见配置篇第五章。

4.3 restart

./mcserver restart

实测回显即 stop 段 + start 段的串联（stop 在已停时会显示 [ SKIP ] Stopping mcserver: LinuxGSM Test Server is already stopped）。改配置后必须 restart 才生效，这是配置篇第九章验证法的第一步。

五、信息命令实测

5.1 details：全量状态卡片

./mcserver details

实测完整回显（凭据打码）：

Distro Details
================================================================================
Date:         Mon Nov  2 17:00:42 UTC 2026
Distro:       Ubuntu 24.04.5 LTS
Arch:         x86_64
Kernel:       7.0.0-38-generic
Environment:  unavailable
Uptime:       0d, 2h, 55m
tmux:         3.4
glibc:        2.39
Java:         openjdk version "25.0.4.1" 2026-08-18

Server Resource
================================================================================
CPU
Model:      Intel(R) Core(TM) i7-14700KF
Cores:      6
Threads:    6
Frequency:  3417.47MHz per logical CPU
Avg Load:   3.06, 2.28, 2.00

Memory
Mem:       total  used   free   cached  available
Physical:  16GB   6.8GB  8.3GB  6.7GB   8.3GB
Swap:      4.0GB  628KB  4.0GB

Storage
Filesystem:  overlay
Total:       443G
Used:        330G
Available:   95G

Network
IP:           0.0.0.0
Internet IP:  13.114.109.76

Minecraft Resource Usage
================================================================================
CPU Used:  68.1%
Mem Used:  3.4%   545MB

Storage
Total:        130M
Serverfiles:  129M

Minecraft Server Details
================================================================================
Server name:    LinuxGSM
Branch:         release
Server IP:      0.0.0.0:25565
Internet IP:    13.114.109.76:25565
Query enabled:  true
RCON password:  <安装时随机生成，打码>
Maxplayers:     20
Game mode:      survival
Status:         STARTED
Query Check:    https://ismygameserver.online/minecraft/13.114.109.76:25565

mcserver Script Details
================================================================================
Script name:       mcserver
LinuxGSM version:  v26.4.0
Update on start:   off
User:              lgsm
Location:          /home/lgsm
Config file:       /home/lgsm/serverfiles/server.properties

Backups
================================================================================
No Backups created

Command-line Parameters
================================================================================
java -Xmx1024M -jar ./minecraft_server.jar nogui

Ports
================================================================================
Change ports by editing the parameters in:
/home/lgsm/serverfiles/server.properties

Useful port diagnostic command:
ss -tuplwn | grep java

DESCRIPTION  PORT   PROTOCOL  LISTEN
Game         25565  tcp       1
Query        25565  udp       1
RCON         25575  tcp       0

Status:	STARTED

读法：Server name/Maxplayers/Game mode 对应 server.properties（配置篇第八章），Command-line Parameters 对应 javaram/startparameters（配置篇第三章），Ports 段直接给出 ss -tuplwn | grep java 诊断命令，Backups 段在跑过 backup 后会列出归档（5.2 之后可见）。

5.2 postdetails：一键脱敏求助

./mcserver postdetails

实测回显：

Please share the following url for support:
https://termbin.com/qiubb

把 details 全量内容（自动剔除密码字段）上传 termbin 并返回短链，GitHub Issue 求助时直接贴链接。注意：它只脱敏 LinuxGSM 层凭据，server.properties 里游戏自生成的密钥不在其列——分享前自己过目（配置篇第八章）。

六、交互命令实测

6.1 console 与 tmux 独立 socket 机制

./mcserver console 的本质是附着到实例专属 tmux 会话。实测进程表（ps -ef | grep tmux）：

lgsm  19940  ...  tmux -L mcserver-24e91d1d new-session -d -x 80 -y 23 -s mcserver java -Xmx2048M -jar ./minecraft_server.jar nogui

socket 文件在 /tmp/tmux-1001/（1001 是 lgsm 的 uid）。关键实测结论：每个实例用独立 tmux socket（-L mcserver-<hash>），普通 tmux ls 看不到 LinuxGSM 的会话——直接敲 tmux ls 的回显是：

error connecting to /tmp/tmux-1001/default (No such file or directory)

要手工查看会话，用实例的 socket 名：

tmux -L mcserver-24e91d1d ls

💡 技术拓展：「console 附着」与「读日志文件」的差别——

方式实时性可否输入适用
./mcserver console（tmux attach）实时可（consoleinteract="yes"）在线管理：op、白名单、热重载
tail -f ~/log/console/mcserver-console.log准实时（consolelogging="on" 时落盘）否排障取证、脚本分析
./mcserver send "<命令>"注入后异步单向自动化/不想占用交互终端

退出 console 用 Ctrl+b d（detach），不会停服；直接关终端窗口同样只是 detach。

6.2 send：向游戏控制台注入命令

./mcserver send "list"

实测回显：

[ .... ] Send mcserver: Sending command to console: "list"
[  OK  ] Send mcserver: Sending command to console: "list"

命令进入游戏控制台，结果落在 console 日志（实测片段）：

[17:01:33] [Server thread/INFO]: System chat: There are 0 of a max of 20 players online:

list 是 Minecraft 的控制台指令，LinuxGSM 的 send 只负责透传——游戏认什么就能发什么。

6.3 debug：前台直跑排障

./mcserver debug

实测回显（头部信息 + 交互确认，非交互执行会卡确认）：

Minecraft Debugging
=================================
Distro:          Ubuntu 24.04.5 LTS
Architecture:    x86_64
Kernel:          7.0.0-38-generic
tmux:            3.4
Avg Load:        2.44, 2.67, 2.39
Free Memory:     8.0GB
Free Disk:       94G
Game Server IP:  0.0.0.0:25565
Internet IP:     13.114.109.76:25565
Start parameters:
java -Xmx2048M -jar ./minecraft_server.jar nogui

Use debug for identifying server issues only!
Press CTRL+c to drop out of debug mode.
Warning! If mcserver is already running it will be stopped.

确认后 debug 会先停掉现有会话再绕过 tmux 前台启动，游戏日志直接刷在终端（实测片段）：

[ .... ] Debugging mcserver: Starting debug
[  OK  ] Debugging mcserver: Starting debug
Starting net.minecraft.server.Main
[17:10:02] [Server thread/INFO]: Starting minecraft server version 26.3
[17:10:02] [Server thread/INFO]: Starting Minecraft server on *:25565

Ctrl+c 退出 debug 后记得 ./mcserver start 恢复正常托管（实测回显见 4.1）。debug 的价值：启动失败时前台能看到第一手异常（如配置篇的 joptsimple 秒退），比翻日志快。

七、保活与告警命令实测

7.1 monitor

./mcserver monitor

实测回显：

[ .... ] Monitoring mcserver: Checking session ... CHECKING
[  OK  ] Monitoring mcserver: Checking session ... OK
[ .... ] Monitoring mcserver: Querying port: gsquery: 127.0.0.1:25565 : 0/1 ... QUERYING
[  OK  ] Monitoring mcserver: Querying port: gsquery: 127.0.0.1:25565 : 0/1 ... OK

两步：tmux 会话存在性 + 查询端口应答。任一失败会尝试拉起并（启用时）发告警。安装篇第七章的 cron 每 5 分钟跑的就是它。回显里的 gsquery 是 querymode=2 下的实际回退实现（配置篇第七章）。

7.2 test-alert

./mcserver test-alert

实测回显（全渠道未启用）：

[ .... ] Sending Alert mcserver: NOT SET
[ WARN ] Sending Alert mcserver: More Info not enabled
[ WARN ] Sending Alert mcserver: Discord alerts not enabled
[ WARN ] Sending Alert mcserver: Email alerts not enabled
[ WARN ] Sending Alert mcserver: Gotify alerts not enabled
[ WARN ] Sending Alert mcserver: IFTTT alerts not enabled
[ WARN ] Sending Alert mcserver: Pushbullet alerts not enabled
[ WARN ] Sending Alert mcserver: Pushover alerts not enabled
[ WARN ] Sending Alert mcserver: Telegram Messages not enabled
[ WARN ] Sending Alert mcserver: Rocketchat alerts not enabled
[ WARN ] Sending Alert mcserver: Slack alerts not enabled
[ WARN ] Sending Alert mcserver: Matrix alerts not enabled
[ WARN ] Sending Alert mcserver: ntfy alerts not enabled

12 个渠道逐一报 not enabled——启用哪个就在 secrets-*.cfg 配哪个（配置篇第四章），再跑本命令直到对应渠道报 OK。

八、更新与备份命令实测

8.1 check-update 与 update

./mcserver check-update

实测回显：

[ .... ] Check for Update mcserver: Checking for update: mojang.com
[  OK  ] Check for Update mcserver: Checking local build: mojang.com
[  OK  ] Check for Update mcserver: Checking remote build: mojang.com
[  OK  ] Check for Update mcserver: Checking for update: mojang.com

No update available
* Local build: 26.3
* Remote build: 26.3
* Branch: release

update 走同样的检查再下载（实测末段同为 No update available）。有更新时 update 会下载并提示重启生效；改 branch/mcversion 后跑 update 即可切版本通道（配置篇 3.3）。

8.2 update-lgsm（LinuxGSM 自身升级）

./mcserver update-lgsm

实测回显：

checking GitHub module [ query_gsquery.py ] ... SKIP
checking GitHub module [ update_mc.sh ] ... SKIP
[  OK  ] Updating LinuxGSM mcserver: Updating modules

SKIP 表示本地模块与 GitHub 一致。游戏服务端更新（update）与工具自身更新（update-lgsm）是两条独立线，互不触发。

8.3 backup

./mcserver backup

实测完整回显：

[ .... ] Backup mcserver: Starting backup
[ INFO ] Backup mcserver: Starting backup: No previous backups found
[ WARN ] Backup mcserver: mcserver will be restarted
[ WARN ] Backup mcserver: mcserver will be restarted: 3
[ WARN ] Backup mcserver: mcserver will be restarted: 2
[ WARN ] Backup mcserver: mcserver will be restarted: 1
[ WARN ] Backup mcserver: mcserver will be restarted
[ .... ] Stopping mcserver: LinuxGSM
[ .... ] Stopping mcserver: Graceful: sending "stop"
[ .... ] Stopping mcserver: Graceful: sending "stop": 1
[  OK  ] Stopping mcserver: Graceful: sending "stop": 2 ... OK
[ INFO ] Backup mcserver: A total of 129M will be compressed.
[ .... ] Backup mcserver: Backup (129M) mcserver-2026-11-02-170206.tar.gz, in progress ... ... OK
[  OK  ] Backup mcserver: Completed: mcserver-2026-11-02-170206.tar.gz, total size 120M
[ .... ] Starting mcserver: LinuxGSM
[  OK  ] Starting mcserver: LinuxGSM
[  OK  ] Starting mcserver: LinuxGSM

流程即「停服→压缩→重启」（stoponbackup="on" 默认行为）。产物落 ~/lgsm/backup/（实测）：

total 120M
-rw-rw-r-- 1 lgsm lgsm 120M Nov  2 17:02 mcserver-2026-11-02-170206.tar.gz

跑过一次后，details 的 Backups 段不再是 No Backups created 而是列出该归档。保留策略 maxbackups/maxbackupdays 见配置篇第六章。

8.4 install 与 auto-install

安装篇第五章已完整实测：install 逐项交互确认，非交互执行报 ERROR Installing mcserver: Unable to read an answer: no input available；自动化场景用 auto-install（或 yes | ./mcserver install）。

九、辅助命令实测

9.1 skeleton：目录骨架预览

./mcserver skeleton

实测生成 ./skel 目录树（完整回显）：

[ .... ] Skeleton mcserver: Creating skeleton directory
[  OK  ] Skeleton mcserver: Creating skeleton directory: ./skel
.
./skel
./skel/home
./skel/home/lgsm
./skel/home/lgsm/.cache
./skel/home/lgsm/.cache/JNA
./skel/home/lgsm/.cache/JNA/temp
./skel/home/lgsm/lgsm
./skel/home/lgsm/lgsm/backup
./skel/home/lgsm/lgsm/config-default
./skel/home/lgsm/lgsm/config-default/config-game
./skel/home/lgsm/lgsm/config-default/config-lgsm
./skel/home/lgsm/lgsm/config-default/config-lgsm/mcserver
./skel/home/lgsm/lgsm/config-lgsm
./skel/home/lgsm/lgsm/config-lgsm/mcserver
./skel/home/lgsm/lgsm/data
./skel/home/lgsm/lgsm/lock
./skel/home/lgsm/lgsm/modules
./skel/home/lgsm/lgsm/tmp
./skel/home/lgsm/log

用途：批量部署前预览 LinuxGSM 将创建的目录结构，或做配置模板。用完可 rm -rf skel。

9.2 developer：开发模式

yes | ./mcserver developer

实测回显：

fetching GitHub [ command_dev_debug.sh ] ... OK
[ .... ]
[  OK  ] Enabled dev-debug
core_exit.sh exiting with code: 0

developer 同样带交互确认（实测用管道喂 yes）。开启后命令执行会输出模块加载/退出细节（如末行的 core_exit 码），排障 LinuxGSM 自身问题时用；再跑一次选 no 即关闭。

9.3 sponsor

./mcserver sponsor

实测回显为赞助信息横幅（LinuxGSM 的 ASCII 标识 + https://linuxgsm.com/sponsor 入口），无副作用，纯展示。

十、多实例边界（实测踩坑）

想给第二个 Minecraft 服起名 mc2 直接跑 bash linuxgsm.sh mc2，实测：

fetching GitHub [ serverlist.csv ] ... OK
[ FAIL ] Unknown game server

mcserver 这类短名必须命中 serverlist.csv 的 144 款列表，自造名字不行。同一款游戏多开（如两个 Minecraft 服）的官方姿势是每个实例一个 Linux 用户：再建 lgsm2 用户，重复安装篇流程，两边各自持有 ~/mcserver。tmux 会话名同为 mcserver 但 socket 各自独立（/tmp/tmux-<uid>/mcserver-<hash>），互不冲突——这正是 6.1 实测「普通 tmux ls 看不到」的原因。

十一、参考链接

LinuxGSM v26.4.0 常用 CLI 命令与工具详解 - Quzuo