管理服务器

用 Saba-chan 运营游戏服务器的日常工作流程,从添加、启动、监控服务器,到备份、计划任务、邀请好友以及与 Discord 集成。

管理服务器

本文档从用户的角度介绍如何使用 Saba-chan。即使不碰模块代码、不自己编写扩展,仅凭这一页也足以为朋友们运营一两台游戏服务器。

安装请参阅 入门指南,机器人配对请参阅 Discord 机器人 & Server-chan。这里假设你已经完成安装,重点介绍打开 GUI 时该点什么、该看什么。


1. 整体概念:GUI 是遥控器,守护进程负责运行服务器

请先记住:关闭 GUI 窗口并不会关闭游戏服务器。

  • saba-chan-gui(窗口):向守护进程发送命令并绘制界面的遥控器。CLI(saba-chan-cli)也扮演同样的角色。
  • saba-core(守护进程):在后台运行、负责启动和监管游戏服务器的核心进程。运行服务器、备份、计划任务和 Discord 连接全部由守护进程处理。
  • 游戏服务器进程:由守护进程启动的实际服务器(java、PalServer.exe 等)。

因此日常运维大致如下:

  1. 启动 GUI,守护进程随之启动(如果已在运行,GUI 会连接到它)。
  2. 朋友们快要上线时,在服务器界面点击 启动。
  3. 游戏期间可以最小化或关闭窗口。关闭时可在 仅关闭界面(守护进程继续运行)和 全部退出(守护进程也会停止)之间选择。若要让服务器继续运行,请选择 仅关闭界面。
  4. 玩完后,再次打开 GUI 并点击 停止。

关闭电脑也会关闭游戏服务器。守护进程只在你自己的电脑上运行。如果需要 24/7 全天候运行,请使用专用主机。


2. 创建第一个服务器(简要总结)

完整流程请参阅 入门指南。简而言之:

  1. 在 服务器 界面点击 添加服务器。
  2. 选择 作为新服务器添加。如果你已经有服务器文件夹,可改用 迁移现有服务器 进行关联(文件保留在原位置)。
  3. 选择游戏(Minecraft / Palworld / Project Zomboid / Terraria 等),然后设置服务器名称和推荐预设。
  4. 如果游戏有需要同意的条款,在这里同意。例如 Minecraft 需要先同意 Minecraft EULA 才能启动服务器(§3.7)。
  5. 点击 添加服务器。服务器文件会自动下载,进度显示在服务器界面上。
  6. 安装完成后,服务器会出现在列表中。

服务器 的名称可以随意取,例如“和朋友玩 MC”“周末僵毁”等。在 Discord 命令中,可以用服务器名称或游戏名称(别名)指代服务器。服务器停止时,可以用名称旁的铅笔按钮重命名。


3. 日常工作流程

选择一个服务器后,右侧会打开它的界面。顶部是 启动/停止 按钮和状态,下方是各个标签页。显示哪些标签页取决于游戏。

标签页内容
控制台服务器输出和命令输入(仅限有控制台的游戏)
命令游戏定义的命令(例如 Palworld 的公告、玩家列表)
设置游戏设置(端口、最大人数、密码等)
Saba-chanSaba-chan 操作服务器的设置:自动重启、内存上限、停止等待时间、启动参数预览、游戏聊天转发
备份与计划创建和恢复备份、计划任务
Discord在 Discord 里称呼这台服务器和命令的词
记录谁在何时启动、停止或发送了命令
信息端口、版本、运行时间、最近的退出记录、检查服务器、打开服务器文件夹、删除服务器

3.1 启动 / 停止 / 重启

  • 启动:守护进程会先检查条款是否已同意并运行模块的检查,然后启动服务器。如果检查发现严重问题,服务器不会启动,并显示原因。
  • 停止:发送游戏的正常停止命令(例如 Minecraft 的 stop、Zomboid 的 quit)并等待。如果服务器在停止等待时间(默认 30 秒,因游戏而异,可以在 Saba-chan 标签页中修改)内没有退出,就会被强制结束。
  • 重启:一步完成停止 → 启动。已连接的玩家会被短暂断开。

3.2 查看控制台 / 发送命令

  • 控制台 标签页实时显示游戏服务器的输出。
  • 输入命令并按 Enter,即可发送到服务器控制台(stdin)。Minecraft 示例:say hi!、op FriendNick。按 ↑ 可调出之前的命令。
  • 命令按 stdin → REST → RCON 的顺序发送。没有控制台的游戏(例如只能通过 REST API 控制的 Palworld)通过 命令 标签页中预定义的命令来操作。只有没有其他路径的游戏才使用 RCON,使用守护进程为每个实例分配的端口和随机密码,并且只通过回环地址(127.0.0.1)连接。
  • 控制台可以弹出为单独的窗口;在 Windows 上,在终端中打开 会打开 CLI 控制台。
  • 守护进程会为每个服务器在内存中保留最近的控制台行(最多 10,000 行),同时写入服务器文件夹 logs/ 下的文件。

3.3 同时运行多个服务器

  • 可以为同一款游戏创建多个服务器(例如“原版 MC”和“整合包 MC”),也可以同时运行不同的游戏。
  • 每个服务器的端口(游戏用来接受玩家连接的编号)不能重复。创建新服务器时,Saba-chan 会错开默认端口以免与其他服务器冲突;如果端口确实重复,服务器界面会显示警告。端口可在 设置 标签页中修改。
  • 每多一个服务器,都会多占用电脑的内存和 CPU。添加前请先确认电脑的配置。

3.4 崩溃检测与自动重启

  • 服务器退出时,守护进程会判断原因:手动停止、游戏内停止、崩溃 或 原因不明。判定结果记录在 信息 标签页的 最近的退出记录 中。
  • 如果被判定为 崩溃,默认会自动重启服务器。第一次重启在 5 秒后进行,之后每次等待时间翻倍。10 分钟内重启超过 3 次后,它会停止重启,需要你自己启动服务器。
  • 可以在 Saba-chan 标签页的 自动重启 中修改:
    • 崩溃后重启:明确因错误退出时(默认开启)。
    • 原因不明时也重启:也涵盖无法判断的情况,例如从任务管理器结束进程(默认关闭)。
  • 你自己从 Saba-chan 或游戏内停止的服务器不会被重启。

3.5 内存上限(Windows)

  • 在 Saba-chan 标签页的 内存上限 中,可以限制服务器及其子进程合计可使用的内存(MB)。超过上限时,服务器会被停止。
  • 留空表示不限制。对于 Java 服务器,请设置为比 -Xmx 高 1–2 GB。
  • 仅限 Windows;重启服务器后生效。

3.6 启动参数预览

  • 对于使用启动参数的游戏,Saba-chan 标签页中的 启动参数预览 会在不实际启动的情况下,显示按当前设置启动服务器时的命令行。
  • 在 额外参数 中填写的、设置界面中没有的参数(例如 -players=16 -useperfthreads)会在启动时原样传递。格式错误的值会直接在预览中标出。
  • 密码等值会被遮蔽为 ***。

3.7 同意条款(Minecraft EULA 等)

  • 如果游戏服务器有需要同意的条款,在创建服务器或首次启动时会出现 需要同意协议 对话框。阅读原文,勾选复选框,然后点击 同意并启动。
  • 只能在这台电脑的 GUI 或 CLI 中同意。如果有人在条款同意之前尝试从 Discord 启动服务器,请先在电脑上同意。

4. 备份与计划任务

这些功能位于 备份与计划 标签页。计划任务在所有服务器上都可以使用,备份列表和备份操作只在支持备份的游戏中显示。

4.1 备份

  • 立即备份 会压缩世界和存档文件。保存哪些内容由游戏模块决定(Minecraft 为世界文件夹)。如果服务器正在运行,会先向游戏发送保存命令(Minecraft 的 save-all 等)。
  • 备份列表会显示每个备份的类型:手动、计划、更新前、恢复前。
  • 恢复 仅在服务器停止时可用。恢复前会先把当前状态再备份一次,所以即使选错了备份也可以撤销。
  • 手动备份不会被自动清理。其他备份(计划、更新前、恢复前)最多保留 计划备份保留数量(默认 10)个,超出时从最旧的开始删除。
  • 备份文件保存在服务器(实例)文件夹内。删除服务器也会删除其备份,因此请把重要的备份复制到其他地方。

4.2 计划任务

使用 添加任务,可以按固定间隔(每 N 分钟)或每天的固定时间(HH:MM,电脑的时区)自动执行以下操作。

任务作用
备份在服务器运行时进行备份
重启如果服务器正在运行则重启
公告如果服务器正在运行则在游戏内发送消息
更新检查游戏服务器更新,有更新则应用(如果服务器原本在运行,会重启服务器)
  • 重启和更新任务可以提前在游戏内提醒玩家(例如提前 10, 5, 1 分钟)。公告和提醒仅在游戏支持公告命令时可用。
  • 守护进程重启后,间隔任务会从那时起重新计时。守护进程关闭期间错过时间的任务,事后不会被集中补执行。

5. 让朋友连接进来

如果你已经搭好了游戏服务器但朋友进不来,几乎总是以下三种情况之一。

5.1 在同一 Wi-Fi(局域网)中的朋友

无需额外设置。只需使用服务器电脑的内网 IP(例如 192.168.0.10)和端口连接即可。

5.2 外部的朋友:路由器支持端口转发

端口转发是路由器的一项设置,用来把外部的连接转交给服务器电脑。

  1. 在路由器管理页面中,将游戏端口转发到服务器电脑的内网 IP。
  2. 把地址 <公网 IP>:<端口> 告诉朋友。可以在 whatismyip.com 等网站查到你的公网 IP。
  3. 在 Windows 防火墙中,允许该端口的入站流量(从外部进来的连接)。

5.3 外部的朋友:无法进行端口转发

学校或公司网络、运营商 CGNAT 之后以及访客 Wi-Fi 上,端口转发常常被封锁。即使在这些网络中,你也可以通过 Server-chan 从 Discord 启动和停止服务器。

  • 在 GUI 的 Discord 界面中,用 连接 Discord 服务器 获取代码,然后在你的 Discord 服务器中用 /saba connect 斜杠命令输入该代码。
  • 之后,你的朋友就可以在 Discord 中启动、停止服务器或查看其状态。
  • 详细流程请参阅 Discord 机器人 & Server-chan。

Server-chan 只转发控制命令(启动/停止/状态等),不转发游戏流量。如果朋友无法直接连接到游戏服务器,你可能还需要额外的方案(例如 ZeroTier、Tailscale)。


6. 使用 Discord 机器人:一页总结

机器人配对后,许多日常操作都可以在 Discord 中完成,无需打开 GUI。消息命令的格式为 <前缀> <服务器> <命令>,默认前缀是 Saba-chan(可在机器人设置中修改)。<服务器> 使用服务器名称或游戏名称(别名)。

场景在 Discord 中输入(默认前缀)
“今天开 MC 吧”Saba-chan minecraft start
“服务器现在开着吗?”Saba-chan minecraft status
“关掉吧”Saba-chan minecraft stop
“都有哪些服务器?”Saba-chan list
“我能输入什么?”Saba-chan help

每个服务器还会有自己的 /<服务器名称> 斜杠命令。完整命令列表和别名注册方法请参阅 命令。

关于机器人本身的设置、配对以及 Server-chan 的工作原理,请参阅 Discord 机器人 & Server-chan。


7. 更新与清理

7.1 更新 Saba-chan

  • Saba-chan 会定期检查已签名的版本列表,有新版本时在 GUI 中显示 有可用更新 通知。
  • 在 设置 → Saba 存储 的 组件 标签页中,可以按组件(核心、模块、扩展等)下载并应用更新。对于核心等需要替换正在运行的文件的组件,安装程序(saba-chan-installer)会短暂停止守护进程、替换文件,然后只重新启动有变化的部分。如果只有守护进程发生了变化,应用窗口保持不动,只重新启动守护进程。
  • 由于守护进程会重启,请在没有人玩的时候应用更新。

7.2 更新游戏服务器

  • 游戏服务器有新版本时,服务器界面上会出现 更新 按钮。可在服务器停止时应用。
  • 会先自动创建一个 更新前 备份(针对支持备份的游戏)。
  • 也可以用 更新 计划任务(§4.2)在设定时间自动应用更新。

7.3 删除服务器

  • 在 信息 标签页用 删除服务器 删除。服务器必须先停止才能删除。
  • 对于由 Saba-chan 下载并创建的服务器,服务器文件夹(包括游戏服务器文件和备份)会被整个删除。请先复制你需要的世界或备份。
  • 对于通过 迁移现有服务器 关联的服务器,原文件夹中的游戏文件会保留不动。

7.4 卸载 Saba-chan

  • 在 Windows 的 设置 → 应用 → 安装的应用 中卸载 Saba-chan。
  • 卸载程序会先正常停止正在运行的服务器,然后删除安装文件夹、数据文件夹(%APPDATA%\saba-chan\)和快捷方式。由 Saba-chan 创建的服务器的文件和备份默认也位于这个数据文件夹中,因此请在卸载前复制想保留的世界。勾选 保留游戏服务器 后,服务器文件、世界、备份和各服务器的设置会保留;勾选 保留设置 后,应用设置和 Discord 连接会保留,重新安装后可直接继续使用。如果另一个 Saba-chan 安装仍在使用该数据文件夹,则不会删除它。

8. 出现问题时

  • 如果控制台中出现红色的行,先原样搜索那条消息。Saba-chan 显示的是游戏服务器自身的输出,未作修改。
  • 信息 标签页中的 检查服务器 和 诊断日志 会检查配置问题以及最近日志中的已知错误。
  • 如果仍未解决,故障排查 页面整理了常见场景及其解决方法。
  • 如果遇到新问题,请附上控制台输出提交到 GitHub Issues。GUI 日志保存在 %APPDATA%\saba-chan\logs\ 中,点击顶部的守护进程状态后弹出的窗口中,可以用 打开日志文件夹 打开该文件夹。附上这些文件能大大加快诊断速度。