gardel/Mofox-Core

Fork 0

Files

enKl03b f94a4bcfc7 doc:部分文档修改

2025-03-21 21:27:16 +08:00

4.9 KiB

Raw Blame History

📦 Linux系统如何手动部署MaiMbot麦麦？

准备工作

一台联网的Linux设备（本教程以Ubuntu/Debian系为例）
QQ小号（QQ框架的使用可能导致qq被风控，严重（小概率）可能会导致账号封禁，强烈不推荐使用大号）
可用的大模型API
一个AI助手，网上随便搜一家打开来用都行，可以帮你解决一些不懂的问题
以下内容假设你对Linux系统有一定的了解，如果觉得难以理解，请直接用Windows系统部署Windows系统部署指南或使用Windows一键包部署

你需要知道什么？

如何正确向AI助手提问，来学习新知识
Python是什么
Python的虚拟环境是什么？如何创建虚拟环境
命令行是什么
数据库是什么？如何安装并启动MongoDB
如何运行一个QQ机器人，以及NapCat框架是什么

环境配置

1️⃣ 确认Python版本

需确保Python版本为3.9及以上

python --version
# 或
python3 --version

如果版本低于3.9，请更新Python版本，目前建议使用python3.12

# Debian
sudo apt update
sudo apt install python3.12
# Ubuntu
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.12

# 执行完以上命令后，建议在执行时将python3指向python3.12
# 更新替代方案，设置 python3.12 为默认的 python3 版本:
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1
sudo update-alternatives --config python3

建议再执行以下命令，使后续运行命令中的python3等同于python

sudo apt install python-is-python3

2️⃣ 创建虚拟环境

# 方法1：使用venv(推荐)
python3 -m venv maimbot
source maimbot/bin/activate  # 激活环境

# 方法2：使用conda（需先安装Miniconda）
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh
conda create -n maimbot python=3.9
conda activate maimbot

# 通过以上方法创建并进入虚拟环境后，再执行以下命令

# 安装依赖（任选一种环境）
pip install -r requirements.txt

数据库配置

3️⃣ 安装并启动MongoDB

安装与启动：请参考官方文档，进入后选择自己的系统版本即可
默认连接本地27017端口

NapCat配置

4️⃣ 安装NapCat框架

执行NapCat的Linux一键使用脚本(支持Ubuntu 20+/Debian 10+/Centos9)

curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh && sudo bash napcat.sh

如果你不想使用Napcat的脚本安装，可参考Napcat-Linux手动安装
使用QQ小号登录，添加反向WS地址: ws://127.0.0.1:8080/onebot/v11/ws

配置文件设置

5️⃣ 配置文件设置，让麦麦Bot正常工作

可先运行一次

# 在项目目录下操作
nb run
# 或
python3 bot.py

之后你就可以找到.env.prod和bot_config.toml这两个文件了关于文件内容的配置请参考：

🎀 新手配置指南 - 通俗易懂的配置教程，适合初次使用的猫娘
⚙️ 标准配置指南 - 简明专业的配置说明，适合有经验的用户

启动机器人

6️⃣ 启动麦麦机器人

# 在项目目录下操作
nb run
# 或
python3 bot.py

7️⃣ 使用systemctl管理maimbot

使用以下命令添加服务文件：

sudo nano /etc/systemd/system/maimbot.service

输入以下内容：

<maimbot_directory>：你的maimbot目录

<venv_directory>：你的venv环境（就是上文创建环境后，执行的代码source maimbot/bin/activate中source后面的路径的绝对路径）

[Unit]
Description=MaiMbot 麦麦
After=network.target mongod.service

[Service]
Type=simple
WorkingDirectory=<maimbot_directory>
ExecStart=<venv_directory>/python3 bot.py
ExecStop=/bin/kill -2 $MAINPID
Restart=always
RestartSec=10s

[Install]
WantedBy=multi-user.target

输入以下命令重新加载systemd：

sudo systemctl daemon-reload

启动并设置开机自启：

sudo systemctl start maimbot
sudo systemctl enable maimbot

输入以下命令查看日志：

sudo journalctl -xeu maimbot

其他组件(可选)

直接运行 knowledge.py生成知识库

常见问题

🔧 权限问题：在命令前加sudo
🔌 端口占用：使用sudo lsof -i :8080查看端口占用
🛡️ 防火墙：确保8080/27017端口开放

sudo ufw allow 8080/tcp
sudo ufw allow 27017/tcp

4.9 KiB Raw Blame History Unescape Escape