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 目前尚未提供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. MaiBot WebUI 默认端口 18001，访问地址：http://您的服务器IP:18001
  2. 在"麦麦适配器设置"页面，修改工作模式为"预设模式"，然后选择"部署方式"为Docker
  3. 在相同页面点击"聊天控制"选项，添加群聊黑白名单
  4. 在1Panel的"应用商店"页面重启"maibot"，更新适配器设置

WARNING

使用 WebUI 保存适配器配置之后，WebUI 的重启功能并不会重启适配器，必须在 1Panel 重启整个应用。

安装插件 ​

插件路径位于：

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.12.0dev-202512200545124.9.83

参考 ​