SakBot

Appearance

快速部署 ​

这是什么？ ​

基于 .NET 10 开发的一站式管理面板 适配 OneBot 11 标准协议。

SakBot 集成了 Minecraft 玩家管理、跨服聊天、用户系统（签到/货币/称号）、机器人白名单、仪表盘监控、自动更新等功能。

环境要求 ​

  • Windows 版本：开箱即用
  • Linux 版本：需要安装 Chrome 浏览器环境

文件获取方式 ​

通过 下载列表 获取对应版本 如果下载速度缓慢 可添加 QQ交流群 获取

  • Windows
    • SakBot_Windows — 精简版
    • SakBot_Windows_Complete — 完整版
  • Linux
    • SakBot_Linux — 精简版
    • SakBot_Linux_Complete — 完整版

Windows 部署教程 ​

1. 下载并解压 ​

下载对应版本后，将压缩包解压到任意目录（建议路径不含中文和空格）。

2. 启动 SakBot ​

双击 SakBot.exe 即可启动，首次启动会自动：

  • 创建 Data/ 目录，生成数据库文件

3. 访问管理面板 ​

启动成功后，浏览器访问 http://localhost:5100 进入 Web 管理面板。

4. 常见问题 ​

端口被占用

如果 5100 端口被占用，可修改 appsettings.json 中的 Listen.Port 配置项。

Linux 部署教程 ​

1. 安装系统依赖库 ​

SakBot 已内置 chrome-headless-shell，仅需安装运行所需的系统依赖库：

bash
# Debian / Ubuntu 24.04+
apt update
apt install -y libglib2.0-0t64 libnss3 libnspr4 libatk1.0-0t64 libatk-bridge2.0-0t64 libcups2t64 libdrm2 libdbus-1-3 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libasound2t64
ldconfig

Ubuntu 22.04 及更早版本

旧版系统包名不带 t64 后缀，使用以下命令：

bash
apt install -y libglib2.0-0 libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libdbus-1-3 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libasound2
bash
# CentOS / RHEL
yum install -y glib2 nss nspr atk at-spi2-atk cups-libs libdrm dbus-libs libxkbcommon libXcomposite libXdamage libXfixes libXrandr mesa-libgbm pango cairo alsa-lib

2. 安装中文字体 ​

Chrome headless 渲染签到图、背包预览等需要中文字体支持，否则中文会显示为方框：

bash
# Debian / Ubuntu
apt install -y fonts-noto-cjk

# CentOS / RHEL
yum install -y google-noto-cjk-fonts

3. 下载并解压 ​

下载 Linux 版本后解压到目标目录：

bash
tar -xzf SakBot_Linux_对应版本号.tar.gz -C /opt/SakBot
cd /opt/SakBot

4. 赋予执行权限 ​

bash
chmod +x SakBot

5. 启动 SakBot ​

bash
./SakBot

首次启动会自动创建 Data/ 目录并生成数据库文件。

6. 访问管理面板 ​

启动成功后，浏览器访问 http://<服务器IP>:5100 进入 Web 管理面板。