使用 systemd 启动/关闭 Minecraft 服务器

Question 1

在浏览了几次手册页后（是的，第一次从来没有答案......），我想出了一个解决方案......但不起作用。经过更多浏览后，我终于想出了最优雅的解决方案。

[Unit]
Description=Minecraft server
After=local-fs.target network.target

[Service]
WorkingDirectory=/home/minecraft/minecraft_server
User=minecraft
Group=minecraft
Type=forking
# Run it as a non-root user in a specific directory

ExecStart=/usr/bin/screen -h 1024 -dmS minecraft ./minecraft_server.sh
# I like to keep my commandline to launch it in a separate file
# because sometimes I want to change it or launch it manually
# If it's in the WorkingDirectory, then we can use a relative path

# Send "stop" to the Minecraft server console
ExecStop=/usr/bin/screen -p 0 -S minecraft -X eval 'stuff \"stop\"\015'
# Wait for the PID to die - otherwise it's killed after this command finishes!
ExecStop=/bin/bash -c "while ps -p $MAINPID > /dev/null; do /bin/sleep 1; done"
# Note that absolute paths for all executables are required!

[Install]
WantedBy=multi-user.target

这确实比我原来的脚本更好看！然而，也有一些回归。

如果我想将命令传递到服务器控制台，那么我必须制作一个单独的脚本来完成它。
运行systemctl start minecraft或后systemctl stop minecraft，请务必检查systemctl status minecraft，因为这些命令根本不会给出任何输出，即使它们实际上失败了。与脚本相比，这是唯一的主要回归 - “始终检查你的输出”是 IT 中的第一条规则，但 systemd 似乎并不关心它......
另外，我希望 systemd 能够管理服务关闭，而无需“等待 PID 终止”解决方法。在旧的 init 脚本中，我必须手动执行此操作，因为它是一个脚本，而 systemd 正在尝试消除对相同事物的复杂脚本的需求；它消除了手动编写所有超时脚本并杀死没有死掉的人的需要，但是“等待 pid 死掉”是下一个最常见的事情，我们仍然需要编写脚本。

Answer

在浏览了几次手册页后（是的，第一次从来没有答案......），我想出了一个解决方案......但不起作用。经过更多浏览后，我终于想出了最优雅的解决方案。

[Unit]
Description=Minecraft server
After=local-fs.target network.target

[Service]
WorkingDirectory=/home/minecraft/minecraft_server
User=minecraft
Group=minecraft
Type=forking
# Run it as a non-root user in a specific directory

ExecStart=/usr/bin/screen -h 1024 -dmS minecraft ./minecraft_server.sh
# I like to keep my commandline to launch it in a separate file
# because sometimes I want to change it or launch it manually
# If it's in the WorkingDirectory, then we can use a relative path

# Send "stop" to the Minecraft server console
ExecStop=/usr/bin/screen -p 0 -S minecraft -X eval 'stuff \"stop\"\015'
# Wait for the PID to die - otherwise it's killed after this command finishes!
ExecStop=/bin/bash -c "while ps -p $MAINPID > /dev/null; do /bin/sleep 1; done"
# Note that absolute paths for all executables are required!

[Install]
WantedBy=multi-user.target

这确实比我原来的脚本更好看！然而，也有一些回归。

如果我想将命令传递到服务器控制台，那么我必须制作一个单独的脚本来完成它。
运行systemctl start minecraft或后systemctl stop minecraft，请务必检查systemctl status minecraft，因为这些命令根本不会给出任何输出，即使它们实际上失败了。与脚本相比，这是唯一的主要回归 - “始终检查你的输出”是 IT 中的第一条规则，但 systemd 似乎并不关心它......
另外，我希望 systemd 能够管理服务关闭，而无需“等待 PID 终止”解决方法。在旧的 init 脚本中，我必须手动执行此操作，因为它是一个脚本，而 systemd 正在尝试消除对相同事物的复杂脚本的需求；它消除了手动编写所有超时脚本并杀死没有死掉的人的需要，但是“等待 pid 死掉”是下一个最常见的事情，我们仍然需要编写脚本。

Question 2

tl;dr：根本不要使用屏幕。使用RCON来控制服务器。

我意识到屏幕一直是管理 Minecraft 服务器的事实上的标准，但在尝试了这两种方法之后，我得出的结论是 RCON 以一种更简洁的方式解决了控制问题。

在屏幕会话中运行服务器的原因是，您可以使用屏幕会话将命令填充到服务器的标准输入中，从而将命令发送到服务器。您还可以直接附加到屏幕会话以使用服务器的交互式控制台。这些都是重要的功能，但屏幕并不是实现它们的唯一方法。

Minecraft 支持 RCON 协议进行远程管理。您可以在本地使用它与服务器交互。我用麦克康命令行工具，它可以发送单个命令或作为交互式终端。这比屏幕更强大，而且可以说更不那么老套（通过发送命令eval总是stuff让我畏缩）。

我的minecraft.service文件如下所示：

[Unit]
Description=Minecraft Server
After=network.target

[Service]
Type=simple
User=minecraft
Group=minecraft
WorkingDirectory=/srv/minecraft
ExecStart=/usr/local/bin/minecraft/start
ExecStop=/usr/local/bin/minecraft/stop
Restart=always

[Install]
WantedBy=default.target

该start脚本只是运行服务器可执行文件：

#!/bin/sh

cd /srv/minecraft
java -Xmx12G -Xms12G \
  -XX:+UnlockExperimentalVMOptions \
  -XX:+UseG1GC \
  -XX:G1NewSizePercent=50 \
  -XX:MaxGCPauseMillis=50 \
  -XX:+AlwaysPreTouch \
  -jar server.jar nogui

该stop脚本向服务器发送命令并等待进程停止：

#!/bin/sh

/usr/local/bin/minecraft/rcon stop

while kill -0 $MAINPID 2>/dev/null
do
  sleep 0.5
done

该rcon脚本只是一个简写：

#!/bin/sh

mcrcon -H localhost -P 25575 -p "password omitted" $@

我的脚本对 RCON 端口和密码进行了硬编码，但您可以轻松地从server.properties文件中获取它们。另外，mcrcon如果您愿意，将通过环境变量而不是命令行参数接受它们。

其他注意事项：

您必须在server.properties文件中启用 RCON，但您可以在防火墙中关闭该端口以防止远程使用它。
要启动交互式终端会话，只需rcon不带参数运行（或直接调用 mcrcon）。
要查看服务器日志，请使用journalctl。我用它来将我的所有日志发送到 Discord webhook。

编辑：另一个答案中的评论声称 SIGINT 将导致 Minecraft 服务器正常停止，就像发送命令一样stop。如果是这样，那么只发送 SIGINT 而不是使用 RCON 来停止服务器会更简单，因此可以说更好。 RCON 对于其他管理任务仍然有用。

Answer