简介#

本篇文章将从头手把手：

通过命令行搭建起 mcsmanager 服务器面板，依靠它作为服务器终端和文件管理；
使用樱花内网映射服务来做公网地址，仅使用其魔改版 frpc 客户端，通过启动脚本且仅需命令行无需 GUI 使用；
并结合自定义域名，设置 SRV 类型 DNS 记录，确定最终的服务器地址。

依据标题所说，目前搭建 Minecraft 服务器最推荐的设备就是 MacMini_M4 了，能耗比几乎拉满；因此本篇教程是针对 arm64 架构的 macOS 系统，且使用默认终端 shell-Zsh 的命令行，真正手把手跑后台，也避免了 GUI 使用不熟练的理解问题。

MCSManager 面板安装#

这是官方文档：快速开始 | MCSmanager

官方文档并没有提供 MacOS 系统的教程，但是根据 up 主一只会魔法的梨所发布的视频【MC 开服】macOS 如何本地安装 MCSManager 可知，macOS 本身提供了类似 Unix 的命令行环境，只需要提供 Darwin 内核依靠 arm64 的 M4 芯片所需要的依赖，便可以把 Linux 软件移植到 macOS_M4 运行。

下面将结合官方 Linux 教程，下载 arm64_macOS 所需依赖，安装 MCSManager。

运行时环境 nodeJS#

MCSManager 所需的运行环境，用于构建 web 服务器，便于我们从浏览器操作服务器。

这里是node 官方的下载页面，下面将先安装Homebrew：

1
# 这里默认你的macOS没有任何命令行操作历史，因此先安装Homebrew工具
2
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash
3

4
# 将homebrew添加进Zsh(默认终端)的PATH(环境变量)
5
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile && source ~/.zprofile
6

7
#  测试查看brew版本
8
brew --version

参数说明：

PATH环境变量，是针对 macOS 的默认终端Zsh，你可以通过echo $SHELL来查看当前终端类型；
/opt/homebrew/bin/brew是 M 系列芯片安装的默认位置，Intel 芯片位置可能不同，自行查询；
~代表当前用户，也即此 PATH 只添加到当前用户的Zsh终端中

下面是安装 node(包含 npm 包管理器)：

1
# 通过homebrew安装
2
brew install node@24
3

4
# 为node24添加软链接
5
brew link node@24
6

7
# 测试查看node版本
8
node -v

tips：这里已经确保homebrew添加进了 PATH 环境变量，由于安装的 node 是具体版本，所以需要手动创建软链接，以便于在终端中使用命令。

安装 Java#

既然是搭建 Java 的 Minecraft 服务器，那当然需要 Java 了，在官方文档中也提出了某些 Java 版本对应的 Minecraft 版本，这里我只安装 Java17 和 Java21：

1
# 通过brew安装openjdk17
2
brew install openjdk@17
3

4
# 添加软链接
5
brew link openjdk@17
6

7
# 检测版本
8
java -version
9

10
# 安装openjdk21
11
brew install openjdk@21
12

13
# 先取消旧链接，再添加新软链接
14
brew unlink openjdk@17
15
brew link openjdk@21
16

17
# 检测版本
18
java -version
19

20
# 查看当前Java的绝对路径
21
ls -l /opt/homebrew/bin/java
22
# 得到类似信息
23
lrwxr-xr-x  1 remote  admin  36 Dec  7 17:25 /opt/homebrew/bin/java -> ../Cellar/openjdk@21/21.0.9/bin/java
24
# 那么你的Java绝对路径为
25
/opt/homebrew/Cellar/openjdk@21/21.0.9/bin/java

学会查看 Java 的绝对路径，后面将使用绝对路径写启动脚本。

MCSManager 本体#

依照官方教程，获取安装包并执行安装脚本：

1
# 前往用户家目录
2
cd ~
3

4
# 获取安装包并解压
5
curl -O https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz
6
tar -xzf mcsmanager_linux_release.tar.gz
7

8
# 删除压缩包，进入项目目录
9
rm mcsmanager_linux_release.tar.gz
10
cd mcsmanager/
11

12
# 为安装脚本授予完全权限并运行
13
chmod 775 ./install.sh
14
sh ./install.sh

接下来，就需要安装 macOS_M4 所需要的依赖PTY和Zip-tools：

1
# 前往目标目录
2
cd ~/mcsmanager/daemon/lib/
3

4
# 安装arm64的pty
5
curl -O https://github.com/MCSManager/PTY/releases/download/latest/pty_darwin_arm64
6

7
# 安装arm64的zip-tools
8
curl -O https://github.com/MCSManager/Zip-Tools/releases/download/latest/file_zip_darwin_arm64

下面执行启动脚本，进行测试，(通过Ctrl+C来终止)：

./start-daemon.sh
./start-web.sh: 这是官方的 web 页面启动脚本。

由于有两个脚本，所以需要两个终端来执行，这也是官方文档中的最终使用教程。

下面我将两个脚本注册为 launchd 系统服务，长期保持在后台，且自动恢复，实现无痕长期运行。

launchd 系统服务#

我们需要先创建一个日志目录，用来存储脚本的运行消息：

1
# 创建日志目录
2
mkdir -p ~/mcsmanager/logs
3

4
# 创建系统服务plist文件(使用nano编辑器)
5
sudo nano /Library/LaunchDaemons/com.mcsmanager.daemon.plist

com.mcsmanager.daemon.plist文件内容大致如下：

1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3
<plist version="1.0">
4
<dict>
5
    <key>Label</key>
6
    <string>com.mcsmanager.daemon</string>
7

8
    <key>ProgramArguments</key>
9
    <array>
10
        <string>这里填写你的start-daemon.sh脚本绝对路径</string>
11
    </array>
12

13
    <key>RunAtLoad</key>
14
    <true/>
15

16
    <key>KeepAlive</key>
17
    <true/>
18

19
    <key>WorkingDirectory</key>
20
    <string>这里填写你的mcsmanager绝对路径</string>
21

22
    <key>EnvironmentVariables</key>
23
    <dict>
24
        <key>PATH</key>
25
        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
26
    </dict>
27

28
    <key>StandardOutPath</key>
29
    <string>这里填写你的daemon.log日志文件绝对路径</string>
30

31
    <key>StandardErrorPath</key>
32
    <string>这里填写你的daemon-error.log日志文件绝对路径</string>
33

34
    <key>UserName</key>
35
    <string>这里填写你的服务运行用户名</string>
36
</dict>
37
</plist>

参数说明(将文件中的中文改成所需参数)，假设我们的用户名是test：

start-daemon.sh脚本绝对路径举例：/Users/test/mcsmanager/start-daemon.sh
mcsmanager绝对路径举例：/Users/test/mcsmanager/
daemon.log日志文件绝对路径举例(上文中已经创建了 logs 用来存储日志)：/Users/test/mcsmanager/logs/daemon.log
daemon-error.log日志文件绝对路径举例：/Users/test/mcsmanager/logs/daemon-error.log
服务运行用户名举例：test

创建 web 界面脚本的 plist 服务文件：

1
# 使用nano编辑器编辑文件
2
sudo nano /Library/LaunchDaemons/com.mcsmanager.web.plist

com.mcsmanager.web.plist文件内容大致如下，依据上文举例的以test用户名为例，请按需调整：

1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3
<plist version="1.0">
4
<dict>
5
    <key>Label</key>
6
    <string>com.mcsmanager.web</string>
7

8
    <key>ProgramArguments</key>
9
    <array>
10
        <string>/Users/test/mcsmanager/start-web.sh</string>
11
    </array>
12

13
    <key>RunAtLoad</key>
14
    <true/>
15

16
    <key>KeepAlive</key>
17
    <true/>
18

19
    <key>WorkingDirectory</key>
20
    <string>/Users/test/mcsmanager/</string>
21

22
    <key>EnvironmentVariables</key>
23
    <dict>
24
        <key>PATH</key>
25
        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
26
    </dict>
27

28
    <key>StandardOutPath</key>
29
    <string>/Users/test/mcsmanager/logs/web.log</string>
30

31
    <key>StandardErrorPath</key>
32
    <string>/Users/test/mcsmanager/logs/web-error.log</string>
33

34
    <key>UserName</key>
35
    <string>test</string>
36
</dict>
37
</plist>

最后，确保服务文件属于 root，并加载配置，启动服务：

1
# 文件所属
2
sudo chown root:wheel /Library/LaunchDaemons/com.mcsmanager.daemon.plist
3
sudo chown root:wheel /Library/LaunchDaemons/com.mcsmanager.web.plist
4

5
# 加载配置
6
sudo launchctl load /Library/LaunchDaemons/com.mcsmanager.daemon.plist
7
sudo launchctl load /Library/LaunchDaemons/com.mcsmanager.web.plist
8

9
# 启动服务
10
sudo launchctl start com.mcsmanager.daemon
11
sudo launchctl start com.mcsmanager.web
12

13
# 查看服务是否运行
14
sudo launchctl list | grep mcsmanager
15

16
# 查看日志
17
tail -f ~/mcsmanager/logs/daemon.log
18
tail -f ~/mcsmanager/logs/web.log

如果需要停止该服务，请按下列执行：

1
# 先终止服务
2
sudo launchctl stop com.mcsmanager.daemon
3
sudo launchctl stop com.mcsmanager.web
4

5
# 卸载配置
6
sudo launchctl unload /Library/LaunchDaemons/com.mcsmanager.daemon.plist
7
sudo launchctl unload /Library/LaunchDaemons/com.mcsmanager.web.plist

使用面板搭建服务器#

现在我们已经成功部署了 mcsmanager，如果你在使用 MacMini 的 GUI，也就是说你是本机，请在浏览器输入http://127.0.0.1:23333访问面板，如果你是远程环境，请自行解决内部网络问题。

mcsmanager-1

在 web 页面内使用 Minecraft 模板创建服务器，都是懒人操作，这里不做详细步骤说明了。

mcsmanager-2

现在假设你已经创建了一个实例并进入了 web 后台页面，你需要对服务器启动命令进行设置。

mcsmanager-3

按照图中的例子，1.21.4的 Minecraft 需要jdk21版本来运行，内存限制为最小 2G 最高 4G，使用 UTF-8 编码输入输出，且我的服务端核心名为paper-1.21.4-232.jar，则启动命令为： /opt/homebrew/Cellar/openjdk@21/21.0.9/bin/java -Xms2G -Xmx4G -Dfile.encoding=utf-8 -Dstdout.encoding=utf-8 -Dstderr.encoding=utf-8 -Djline.terminal=jline.UnsupportedTerminal -jar paper-1.21.4-232.jar -nogui

樱花内网穿透#

如果你会使用 GUI 来运行官方的启动器客户端，是否有过要保持开启该软件的困扰？

这里将用 frpc 的方式来启用隧道，并将启动脚本注册为系统服务，实现无痕穿透。

这是官方的 frpc 下载页面：软件下载 | SakuraFrp

创建隧道#

进入官方隧道列表

选择创建隧道，任意选物理位置较近的节点，按照下面的配置：

Minecraft_Java 版服务器，是通过 TCP 协议通信的，比较特殊，端口不进行更改默认为 25565。

sfrp 命令启用隧道#

这里我们是 Mac_mini_M4 硬件，因此选择左侧macOS Apple Silicon (arm64)，复制下载链接。

1
# 进入用户家目录，创建SakuraFrp文件夹并进入
2
cd ~
3
mkdir sakura_frp
4
cd sakura_frp/
5

6
# 下载樱花官方frpc
7
curl -O https://nya.globalslb.net/natfrp/client/frpc/0.51.0-sakura-12.3/frpc_darwin_arm64
8

9
# 授予执行权限
10
chmod +x frpc_darwin_arm64
11

12
# 添加软链接到Homebrew，注册名为sfrp
13
# 原因是brew已经在环境变量PATH里了
14
# 这里的test要替换成你的用户名
15
ln -s /Users/test/sakura_frp/frpc_darwin_arm64 /opt/homebrew/bin/sfrp
16

17
# 检测版本
18
sfrp -v

至此，已经可以使用官方提到的类似格式frpc -f <访问密钥>:<隧道ID 1>[,隧道ID 2[,隧道ID 3...]]来启动隧道。而具体到我们现在的环境，举例密钥为wdnmdtoken6666666，隧道 ID1 为114514，隧道 ID2 为114516，则命令为：

1
# 启用两个隧道
2
sfrp -f wdnmdtoken6666666:114514,114516

这样仍然不能解决该终端需要一直保持开启的痛点，下面将提供一个脚本start_sfrp.sh来保存配置，并注册至 launchd，在系统后台自动运行，且如果有新隧道或更换用户，只需要对start_sfrp.sh内容进行修改，重载服务配置即可。

樱花穿透 launchd 服务#

1
# 进入目标路径
2
cd ~/sakura_frp/
3

4
# 创建编辑start_sfrp.sh脚本
5
nano start_sfrp.sh

start_sfrp.sh脚本内容大致如下(注意替换test用户名)：

1
#!/bin/bash
2

3
FRPC_PATH="/Users/test/sakura_frp/frpc_darwin_arm64"
4

5
ACCESS_KEY="<key>"
6
TUNNEL_IDS="<tunnel_id>"
7

8
exec $FRPC_PATH -f $ACCESS_KEY:$TUNNEL_IDS

参数说明：

<key>:替换为你的访问密钥，在官方后台首页可获得。
<tunnel_id>：替换为你的隧道 ID，访问官方隧道列表，无需复制，已经展示出来了，例如114514和1114516；如果你是单隧道，只填写数字即可，如果是多隧道，以英文,隔开，例如TUNNEL_IDS="114514,114516"。

1
# 添加执行权限
2
chmod +x start_sfrp.sh
3

4
# 创建日志目录
5
mkdir log
6

7
# 创建服务plist文件
8
sudo nano /Library/LaunchDaemons/com.frp.sfrp.plist

com.frp.sfrp.plist文件内容大致如下(将test替换为你的用户名)：

1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3
<plist version="1.0">
4
<dict>
5
    <key>Label</key>
6
    <string>com.frp.sfrp</string>
7

8
    <key>ProgramArguments</key>
9
    <array>
10
        <string>/Users/test/sakura_frp/start_sfrp.sh</string>
11
    </array>
12

13
    <key>KeepAlive</key>
14
    <true/>
15

16
    <key>RunAtLoad</key>
17
    <true/>
18

19
    <key>StandardOutPath</key>
20
    <string>/Users/test/sakura_frp/log/sfrp_stdout.log</string>
21
    <key>StandardErrorPath</key>
22
    <string>/Users/test/sakura_frp/log/sfrp_stderr.log</string>
23

24
    </dict>
25
</plist>

1
# 设置权限
2
sudo chown root:wheel /Library/LaunchDaemons/com.frp.sfrp.plist
3

4
# 加载服务并运行
5
sudo launchctl load /Library/LaunchDaemons/com.frp.sfrp.plist
6
sudo launchctl start com.frp.sfrp
7

8
# 查看日志
9
tail -f ~/sakura_frp/log/sfrp_stdout.log
10
tail -f ~/sakura_frp/log/sfrp_stderr.log

此时在官方隧道列表，可以看到隧道已被启用。

如果你的脚本内容发生更改，请重载 launchd 服务：

1
sudo launchctl stop com.frp.sfrp
2
sudo launchctl unload /Library/LaunchDaemons/com.frp.sfrp.plist
3
sudo launchctl load /Library/LaunchDaemons/com.frp.sfrp.plist
4
sudo launchctl start com.frp.sfrp