MaiBot 文档中心

Appearance

1Panel 部署 ​

作者：梦归云帆

安装 curl ​

bash
sudo apt update
sudo apt install -y curl
bash
sudo yum install -y curl
bash
sudo dnf install -y curl
bash
sudo pacman -S --noconfirm curl
bash
sudo zypper install -y curl

安装 ​

目的：将maibot APP文件夹放在/opt/1panel/resource/apps/local/下 你可以使用我们提供的自动脚本，也可以选择手动安装

bash
curl -fsSL -o install_MaiBot_1Panel.bash https://raw.githubusercontent.com/Puiching-Memory/MaiBot-1Panel/MaiBot/apps/maibot/install.bash
bash install_MaiBot_1Panel.bash

在1Panel面板中完成后续部署 ​

1panel提供的Docker镜像在拉取napcat镜像时会出现问题，建议添加更多镜像源，参考：https://status.anye.xyz/

WARNING

本应用不内置 NapCat，请单独部署 NapCat，并在 ./docker-config/adapters/config.toml 中配置对应的连接地址。 你可以使用我们的NapCat APP集成，位于https://github.com/Puiching-Memory/MaiBot-1Panel/tree/napcat

WARNING

本应用不内置数据库可视化工具（如 Chat2DB / SQLite-Web），如需使用请在 1Panel 中单独安装对应应用，或自行以 Docker 方式部署，并连接到 ./data/MaiBot/MaiBot.db。

NOTE

相关项目： https://github.com/Fahaxikiii/napcat-1panel 该第三方项目允许将 NapCat 部署为独立 1Panel 应用。它默认连接到Host network。

NapCat 配置说明： ​

  1. 打开应用日志，找到NapCat WebUI 临时token
  2. 打开web UI，使用临时token登录
  3. 在网络配置中，添加新的webSocket客户端，地址填写 ws://maibot_adapters:8095（或你在 config.toml 中配置的地址）
  4. (可选)，添加新的http服务器，地址填写 0.0.0.0:<端口号>

安装后，MaiBot需要调整配置： ​

  1. 进入应用安装目录
  2. ./docker-config/adapters/config.toml 调整群聊白名单
  3. ./docker-config/mmc/model_config.toml 调整模型和API Key等配置
  4. ./docker-config/mmc/bot_config.toml 调整机器人设置
  5. 点击重启应用以生效

示例配置文件 ​

  • model_config_qwen.toml - 全部使用阿里云百炼 Qwen 模型的配置文件
  • Qwen 模型价格查询：价格表
  • Qwen VL 系列模型回复较慢，请延长超时时间，至少30~60秒

安装插件 ​

插件路径位于：

bash
/opt/1panel/apps/local/maibot/localmaibot/data/MaiMBot/plugins

Docker DNS 解析 ​

所有容器均加入 1panel-network，因此可以通过服务名直接解析并互通：

  • maibot_adapters → MaiBot 适配器容器
  • maibot → MaiBot 核心容器

代办事项 ​

  • [ ] 1Panel 目前不接受小于1w星的应用上架

EULA ​

  • 安装默认同意MaiBot EULA（不确定该策略是否合理，请在issue中反馈）

兼容性矩阵 ​

MaiBot版本Adapters版本NapCat版本
0.11.0
(dev-6d70cf7)		0.5.5
(dev-20251005093201)		4.9.14
0.11.1
(dev-69a6116)		0.5.5
(dev-20251005093201)		4.9.25
0.11.2
(0.11.2-beta)		0.5.5
(dev-20251005093201)		4.9.70
0.11.3
(0.11.3-beta)		0.5.5
(dev-20251005093201)		4.9.72

参考 ​