bot3.0 linux部署文档

重要提示

请不要拿测试版当正式版使用！测试版本可能存在不稳定性和未完善功能，仅用于测试目的。

更新日志 不懂群里Ciallo～(∠・ω< )⌒★​ 799915082

  • 25年6月23日 eta1：上线推送功能，支持配置文件热重载
  • 25年6月26日 beta2：集成Bili扫码功能，更新文件覆盖热重载
  • 25年7月7日 beta3：推送功能插件化，更新动态字体，增加风控检测
  • 25年7月26日 beta4:增加ws链接，增加自动关注，优化直播间重连 二维码显示
  • 25年10月15日 beta5:增加下播占位符 更新热重载机制 修复beta4部分bug 新增内置数据库
  • 25年10月16日 beta6:修复下播时长bug 应对b站风控 增加了备用的推送开关
  • 25年11月17日 beta7:重新开播提醒 掉线邮箱通知 atall参数优化 直播间风控检测优化 bug修复
  • 25年12月9日 beta8:更新底层 at全体成员次数不够使用群待办替代
  • 预告 26年?月出直播报告 新建文件ing 修复bug 做完直播报告准备上线正式版
  • 当前待完成功能：帮助菜单未做，直播报告未做，配置文档会随完善慢慢更新

3.0版本部署要求

  1. 使用云服务器：linux至少1c2g推荐2c4g 至少30g可用空间
  2. 系统至少Ubuntu2004、Debian11 不能使用centos
  3. 本地部署或使用ARM设备 需要7*24小时不关机 可以是linux开发板
  4. 导航页有3.0版本临时的配置网页 随测试版更新

nat云服务器推荐

❤️糖糕云❤️

常规部署方式

准备工作云服务器打开23333/24444/6099端口 nat机器映射端口不一样 本地请忽略

  1. 更新linux源（必要）
    bash <(curl -sSL https://linuxmirrors.cn/main.sh)
  2. 安装linux 字体库 （必要）
    sudo apt install -y fonts-noto-cjk fonts-wqy-zenhei fonts-noto-color-emoji fonts-freefont-ttf
  3. 安装Java17（必要）
    sudo apt install -y openjdk-17-jre
  4. 安装面板 MCSManager（选择使用）这里是为了方便管理不用每次维护都ssh
    sudo su -c "wget -qO- https://script.mcsmanager.com/setup_cn.sh | bash"
  5. linux安装NapCat（必要）qq和bot连接通信 shell安装 安装tui工具
    curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh && sudo bash napcat.sh
  6. 下载测试版 二选一
    wget https://starbot.hc9503.cn/3.0-beta8.zip
    wget http://mht.windcx.top:14757/bot3/3.0-beta8.zip

    下载完成后请解压文件：

    unzip 3.0-beta8.zip -d beta8
    点击下载
  7. 配置application.yml文件：文件内填入ws和http服务的端口号 或者使用提示的默认 token必填
  8. 网页配置datasource.json推送文件 更新到beta8测试版版本 ❤️点击配置❤️
  9. beta8:更新插件 内置了json文件部署 支持30次备份 安全机制自行添加 群文件获取
  10. NapCat打开web界面 密码在shell中有提示127.0.0.1:6099xxxtoken=密码
  11. 网页端配置NapCat：HTTP和websocket服务同时开启，按照yml文件对应填入 token必须一致
  12. mcsm实例创建 路径为3.0文件路径 启动命令粘贴start.sh 第二行 然后扫码登陆
  13. napcat如果需要更新 请删除napcat重新安装
  14. napcat如提示qq账号重复登录 linux使用pkill -9 qq 停止进程重启即可
  15. 当前为测试版本 在beta8文件内 执行du -sh */ 一个月检查一次删除logs日志和LiveDebug文件夹

Starbot 3.0 测试版 © 2026 | 文档页面 v2.1 | 最后更新: 2026年04月05日