mirror of https://github.com/Mai-with-u/MaiBot.git
20 KiB
20 KiB
麦麦的docker本地部署教程
适用系统：Debian系Linux（Ubuntu/Debian及其衍生系统） 系统要求：推荐2核2G内存 测试环境：Ubuntu Server 24.04 LTS（全新安装） 部署方式：本地镜像构建
1 更新系统并安装docker
更新系统
apt换源(可选)
cat <<'EOF' > /etc/apt/sources.list.d/ubuntu.sources Types: deb URIs: https://mirror.nju.edu.cn/ubuntu Suites: noble noble-updates noble-backports Components: main restricted universe multiverse Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg Types: deb URIs: http://security.ubuntu.com/ubuntu/ Suites: noble-security Components: main restricted universe multiverse Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg EOF
更新系统
sudo apt-get update
sudo apt-get upgrade -y
安装一些基础软件包
sudo apt-get install ca-certificates wget curl gnupg vim -y
安装docker
使用脚本安装docker
# 此处使用了GitHub镜像代理
wget https://gh-proxy.net/https://raw.githubusercontent.com/docker/docker-install/master/install.sh
# 赋权
chmod +x install.sh
# 使用镜像源安装
./install.sh --mirror Aliyun
出现docker信息即为成功
+ sudo -E sh -c docker version
Client: Docker Engine - Community
Version: 28.0.4
API version: 1.48
Go version: go1.23.7
Git commit: b8034c0
Built: Tue Mar 25 15:07:16 2025
OS/Arch: linux/amd64
Context: default
Server: Docker Engine - Community
Engine:
Version: 28.0.4
API version: 1.48 (minimum version 1.24)
Go version: go1.23.7
Git commit: 6430e49
Built: Tue Mar 25 15:07:16 2025
OS/Arch: linux/amd64
Experimental: false
containerd:
Version: 1.7.26
GitCommit: 753481ec61c7c8955a23d6ff7bc8e4daed455734
runc:
Version: 1.2.5
GitCommit: v1.2.5-0-g59923ef
docker-init:
Version: 0.19.0
GitCommit: de40ad0
================================================================================
To run Docker as a non-privileged user, consider setting up the
Docker daemon in rootless mode for your user:
dockerd-rootless-setuptool.sh install
Visit https://docs.docker.com/go/rootless/ to learn about rootless mode.
To run the Docker daemon as a fully privileged service, but granting non-root
users access, refer to https://docs.docker.com/go/daemon-access/
WARNING: Access to the remote API on a privileged Docker daemon is equivalent
to root access on the host. Refer to the 'Docker daemon attack surface'
documentation for details: https://docs.docker.com/go/attack-surface/
================================================================================
docker跟换镜像源
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<EOF
{
"registry-mirrors": [
"https://docker.1ms.run",
"https://docker.xuanyuan.me"
]
}
EOF
重载docker
sudo systemctl daemon-reload
sudo systemctl restart docker
2 开始安装麦麦
选择分支：
稳定版：
main
开发版：
main-fix
克隆麦麦
稳定版执行：
git clone -b main https://gh-proxy.net/https://github.com/MaiM-with-u/MaiBot.git
开发版执行：
git clone -b main-fix https://gh-proxy.net/https://github.com/MaiM-with-u/MaiBot.git
克隆完成后会出现 MaiBot文件夹
成功执行示例
非命令请勿执行
test@test:~$ git clone -b main https://gh-proxy.net/https://github.com/MaiM-with-u/MaiBot.git
Cloning into 'MaiBot'...
remote: Enumerating objects: 6876, done.
remote: Counting objects: 100% (2139/2139), done.
remote: Compressing objects: 100% (328/328), done.
remote: Total 6876 (delta 1972), reused 1848 (delta 1807), pack-reused 4737 (from 2)
Receiving objects: 100% (6876/6876), 3.51 MiB | 120.00 KiB/s, done.
Resolving deltas: 100% (4701/4701), done.
test@test:~$ ll
total 60
drwxr-x--- 5 test test 4096 Mar 28 15:01 ./
drwxr-xr-x 3 root root 4096 Mar 28 14:17 ../
-rw-r--r-- 1 test test 220 Mar 31 2024 .bash_logout
-rw-r--r-- 1 test test 3771 Mar 31 2024 .bashrc
drwx------ 2 test test 4096 Mar 28 14:17 .cache/
-rwxrwxr-x 1 test test 22577 Mar 28 14:36 install.sh*
drwxrwxr-x 9 test test 4096 Mar 28 15:01 MaiBot/
-rw-r--r-- 1 test test 807 Mar 31 2024 .profile
drwx------ 2 test test 4096 Mar 28 14:17 .ssh/
-rw-r--r-- 1 test test 0 Mar 28 14:29 .sudo_as_admin_successful
-rw-rw-r-- 1 test test 167 Mar 28 14:36 .wget-hsts
然后进入到 MaiBot中并创建配置文件文件夹
# 进入到 MaiBot
cd MaiBot
# 创建文件夹docker-config
mkdir docker-config
配置文件
创建配置文件
# bot_config.toml
cp template/bot_config_template.toml docker-config/bot_config.toml
# .env.prod
cp template.env docker-config/.env.prod
修改配置文件
vim docker-config/bot_config.toml
vim docker-config/.env.prod
vim基础使用：
:w保存
:wq保存退出
:q退出
:q!强制退出
docker的额外配置
配置 .env.prod
执行
vim docker-config/.env.prod
HOST=0.0.0.0 # 修改此处为0.0.0.0
PORT=8080
ENABLE_ADVANCE_OUTPUT=false
# 插件配置
PLUGINS=["src2.plugins.chat"]
# 默认配置
# 如果工作在Docker下，请改成 MONGODB_HOST=mongodb
MONGODB_HOST=mongodb # 修改此处为mongodb
MONGODB_PORT=27017
DATABASE_NAME=MegBot
# 也可以使用 URI 连接数据库（优先级比上面的高）
# MONGODB_URI=mongodb://127.0.0.1:27017/MegBot
# MongoDB 认证信息，若需要认证，请取消注释以下三行并填写正确的信息 # 启用mongodb密码
MONGODB_USERNAME=maimbot
MONGODB_PASSWORD=maimbot@123
MONGODB_AUTH_SOURCE=admin
#key and url
CHAT_ANY_WHERE_BASE_URL=https://api.chatanywhere.tech/v1
SILICONFLOW_BASE_URL=https://api.siliconflow.cn/v1/
DEEP_SEEK_BASE_URL=https://api.deepseek.com/v1
# 定义你要用的api的key(需要去对应网站申请哦)
DEEP_SEEK_KEY=
CHAT_ANY_WHERE_KEY=
SILICONFLOW_KEY=
# 定义日志相关配置
CONSOLE_LOG_LEVEL=INFO # 自定义日志的默认控制台输出日志级别
FILE_LOG_LEVEL=DEBUG # 自定义日志的默认文件输出日志级别
DEFAULT_CONSOLE_LOG_LEVEL=SUCCESS # 原生日志的控制台输出日志级别（nonebot就是这一类）
DEFAULT_FILE_LOG_LEVEL=DEBUG # 原生日志的默认文件输出日志级别（nonebot就是这一类）
bot_config.toml根据需要自行配置
执行
vim docker-config/bot_config.toml
修改 docker-compose.yml
执行
vim docker-compose.yml
services:
napcat:
container_name: napcat
environment:
- TZ=Asia/Shanghai
- NAPCAT_UID=${NAPCAT_UID}
- NAPCAT_GID=${NAPCAT_GID} # 让 NapCat 获取当前用户 GID,UID，防止权限问题
ports:
- 6099:6099
restart: unless-stopped
volumes:
- napcatQQ:/app/.config/QQ # 持久化 QQ 本体
- napcatCONFIG:/app/napcat/config # 持久化 NapCat 配置文件
- ./docker-data:/MaiMBot/data # NapCat 和 NoneBot 共享此卷，否则发送图片会有问题 # 修改此处卷为直接挂载目录
image: mlikiowa/napcat-docker:latest
mongodb:
container_name: mongodb
environment:
- TZ=Asia/Shanghai
- MONGO_INITDB_ROOT_USERNAME=maimbot # 此处设置用户
- MONGO_INITDB_ROOT_PASSWORD=maimbot@123 # 此处设置密码
expose:
- "27017"
ports: # 此处新增port (可选) | 注意：映射此端口需注意安全问题，非常推荐去给mongo设置一个用户密码
- 27017:27017
restart: unless-stopped
volumes:
- mongodb:/data/db # 持久化 MongoDB 数据库
- mongodbCONFIG:/data/configdb # 持久化 MongoDB 配置文件
image: mongo:latest
maimbot:
container_name: maimbot
environment:
- TZ=Asia/Shanghai
- EULA_AGREE=35362b6ea30f12891d46ef545122e84a # 此处增加eula哈希，填写这两行即为同意eula
- PRIVACY_AGREE=2402af06e133d2d10d9c6c643fdc9333 # 此处增加eula哈希，填写这两行即为同意eula
expose:
- "8080"
restart: unless-stopped
depends_on:
- mongodb
- napcat
volumes:
- napcatCONFIG:/MaiMBot/napcat # 自动根据配置中的 QQ 号创建 ws 反向客户端配置
- ./docker-config/bot_config.toml:/MaiMBot/config/bot_config.toml # Toml 配置文件映射 # 修改此处卷映射到./docker-config/bot_config.toml
- ./docker-data:/MaiMBot/data # NapCat 和 NoneBot 共享此卷，否则发送图片会有问题 # 修改此处卷映射，和napcat保持一致
- ./docker-config/.env.prod:/MaiMBot/.env.prod # Toml 配置文件映射 # 修改此处卷映射到./docker-config/.env.prod
image: maimbot:local # 修改镜像为本地构建maimbot:local
volumes:
maimbotCONFIG:
maimbotDATA:
napcatQQ:
napcatCONFIG:
mongodb:
mongodbCONFIG:
修改Dockerfile
执行
vim Dockerfile
FROM nonebot/nb-cli:latest
# 设置工作目录
WORKDIR /MaiMBot
# 先复制依赖列表
COPY requirements.txt .
# 安装依赖（这层会被缓存直到requirements.txt改变）
RUN pip install --upgrade -r requirements.txt -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple # 此处使用pipy清华源
# 然后复制项目代码
COPY . .
VOLUME [ "/MaiMBot/config" ]
VOLUME [ "/MaiMBot/data" ]
EXPOSE 8080
ENTRYPOINT [ "nb","run" ]
构建和启动麦麦
拉取镜像
执行
sudo docker pull nonebot/nb-cli:latest
构建镜像
执行
# 注意不要漏了最后的点
sudo docker build -t maimbot:local .
成功执行示例
非命令请勿执行
test@test:~/MaiBot$ sudo docker pull nonebot/nb-cli:latest
latest: Pulling from nonebot/nb-cli
2f44b7a888fa: Pull complete
3f00b3697662: Pull complete
9f2fc8d8f9bd: Pull complete
4ea8b799d366: Pull complete
1adff455ff8c: Pull complete
753ba2fdde1a: Pull complete
3a27ebb4ce99: Pull complete
55c18539212d: Pull complete
Digest: sha256:53400b4e5ae9cb5bb516e0b002b05cffe8d3af7b79bd88398734077a1100376c
Status: Downloaded newer image for nonebot/nb-cli:latest
docker.io/nonebot/nb-cli:latest
test@test:~/MaiBot$ sudo docker build -t maimbot:local .
[+] Building 95.9s (10/10) FINISHED docker:default
=> [internal] load build definition from Dockerfile 0.0s
=> => transferring dockerfile: 457B 0.0s
=> [internal] load metadata for docker.io/nonebot/nb-cli:latest 0.0s
=> [internal] load .dockerignore 0.0s
=> => transferring context: 99B 0.0s
=> [1/5] FROM docker.io/nonebot/nb-cli:latest 0.1s
=> [internal] load build context 0.1s
=> => transferring context: 2.08MB 0.1s
=> [2/5] WORKDIR /MaiMBot 1.6s
=> [3/5] COPY requirements.txt . 0.0s
=> [4/5] RUN pip install --upgrade -r requirements.txt -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple 78.8s
=> [5/5] COPY . . 0.2s
=> exporting to image 15.0s
=> => exporting layers 15.0s
=> => writing image sha256:6e1a6a83b50ae921d79f2dbe73fcc850c07612bcd88db811e76c0e1b8823ccef 0.0s
=> => naming to docker.io/library/maimbot:local
启动麦麦
执行
sudo NAPCAT_UID=$(id -u) NAPCAT_GID=$(id -g) docker compose up -d
成功执行示例
非命令请勿执行
test@test:~/MaiBot$ sudo NAPCAT_UID=$(id -u) NAPCAT_GID=$(id -g) docker compose up -d
[+] Running 16/16
✔ napcat Pulled 156.1s
✔ 6414378b6477 Pull complete 15.8s
✔ 490f82e472ca Pull complete 78.5s
✔ d4e6c35d58ce Pull complete 78.5s
✔ f382006ebcb6 Pull complete 78.6s
✔ 60f813bb54e0 Pull complete 79.1s
✔ 34e85b395e26 Pull complete 155.8s
✔ mongodb Pulled 95.6s
✔ 5a7813e071bf Pull complete 22.3s
✔ cf12757b6444 Pull complete 22.4s
✔ 20cfb5e922d1 Pull complete 27.1s
✔ d11968535d8a Pull complete 29.4s
✔ c711ee204b1d Pull complete 31.1s
✔ 4fc65ca4253f Pull complete 33.7s
✔ dacd77ad2ef6 Pull complete 95.3s
✔ 5fa69bd3db1e Pull complete 95.3s
[+] Running 8/8
✔ Network maibot_default Created 0.2s
✔ Volume "maibot_napcatCONFIG" Created 0.0s
✔ Volume "maibot_napcatQQ" Created 0.0s
✔ Volume "maibot_mongodb" Created 0.0s
✔ Volume "maibot_mongodbCONFIG" Created 0.0s
✔ Container napcat Started 3.0s
✔ Container mongodb Started 3.1s
✔ Container maimbot Started 1.2s
查看麦麦状态
执行
sudo docker compose ps
成功执行示例
非命令请勿执行
test@test:~/MaiBot$ sudo docker compose ps
WARN[0000] The "NAPCAT_UID" variable is not set. Defaulting to a blank string.
WARN[0000] The "NAPCAT_GID" variable is not set. Defaulting to a blank string.
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
maimbot maimbot:local "nb run" maimbot 4 minutes ago Up 4 minutes
mongodb mongo:latest "docker-entrypoint.s…" mongodb 4 minutes ago Up 4 minutes 0.0.0.0:27017->27017/tcp, [::]:27017->27017/tcp
napcat mlikiowa/napcat-docker:latest "bash entrypoint.sh" napcat 4 minutes ago Up 4 minutes 0.0.0.0:6099->6099/tcp, [::]:6099->6099/tcp
然后进入napcat的web页面进行配置
地址为：<你的ip>:6099
websocket地址为：ws://maimbot:8080/onebot/v11/ws
3. 常用管理命令
| 功能 | 命令 |
|---|---|
| 查看状态 | sudo docker compose ps |
| 查看日志 | sudo docker compose logs -f maimbot --tail=1000 |
| 停止麦麦 | sudo docker compose down |
| 重启麦麦 | sudo docker compose restart |