mirror of
https://github.com/nonebot/nonebot2.git
synced 2024-11-28 08:12:14 +08:00
81 lines
2.6 KiB
Markdown
81 lines
2.6 KiB
Markdown
# 部署
|
||
|
||
## 基本部署
|
||
|
||
NoneBot 所基于的 python-aiocqhttp 库使用的 web 框架是 Quart，因此 NoneBot 的部署方法和 Quart 一致（[Deploying Quart](https://pgjones.gitlab.io/quart/tutorials/deployment.html)）。
|
||
|
||
Quart 官方建议使用 Hypercorn 来部署，这需要一个 ASGI app 对象，在 NoneBot 中，可使用 `nonebot.get_bot().asgi` 获得 ASGI app 对象。
|
||
|
||
具体地，通常在项目根目录下创建一个 `run.py` 文件如下：
|
||
|
||
```python
|
||
import os
|
||
import sys
|
||
|
||
import nonebot
|
||
|
||
import config
|
||
|
||
nonebot.init(config)
|
||
bot = nonebot.get_bot()
|
||
app = bot.asgi
|
||
|
||
if __name__ == '__main__':
|
||
bot.run()
|
||
```
|
||
|
||
然后使用下面命令部署：
|
||
|
||
```python
|
||
hypercorn run:app
|
||
```
|
||
|
||
另外，NoneBot 配置文件的 `DEBUG` 项默认为 `True`，在生产环境部署时请注意修改为 `False` 以提高性能。
|
||
|
||
## 使用 Docker Compose 与 酷Q 同时部署
|
||
|
||
Docker Compose 是 Docker 官方提供的一个命令行工具，用来定义和运行由多个容器组成的应用。通过建立一个名为 `docker-compose.yml` 的文件，可以将部署过程中需要的参数记录在其中，并由单个命令完成应用的创建和启动。
|
||
|
||
`docker-compose.yml` 文件的示例如下：
|
||
|
||
```yaml
|
||
version: "3"
|
||
services:
|
||
|
||
cqhttp:
|
||
image: richardchien/cqhttp:latest
|
||
volumes:
|
||
- "./coolq:/home/user/coolq" # 用于保存COOLQ文件的目录
|
||
environment:
|
||
- COOLQ_ACCOUNT=123456 # 指定要登陆的QQ号，用于自动登录
|
||
- FORCE_ENV=true
|
||
- CQHTTP_USE_HTTP=false
|
||
- CQHTTP_USE_WS=false
|
||
- CQHTTP_USE_WS_REVERSE=true
|
||
- CQHTTP_WS_REVERSE_API_URL=ws://nonebot:8080/ws/api/
|
||
- CQHTTP_WS_REVERSE_EVENT_URL=ws://nonebot:8080/ws/event/
|
||
depends_on:
|
||
- nonebot
|
||
ports: 9000:9000 # noVNC 端口，用于从浏览器控制 酷Q
|
||
|
||
nonebot:
|
||
build: ./nonebot # 构建nonebot执行环境，Dockerfile见下面的例子
|
||
expose:
|
||
- "8080"
|
||
environment:
|
||
- TZ=Asia/Shanghai
|
||
volumes:
|
||
- "./qbot:/root/qbot" # 项目文件所在目录
|
||
command: python3 /root/qbot/bot.py
|
||
```
|
||
|
||
部分说明见注释。NoneBot 运行环境由文件 `./nonebot/Dockerfile` 控制构建。如果项目中使用了第三方库，可以在这一步骤进行安装。`Dockerfile` 内容例如：
|
||
|
||
```Dockerfile
|
||
FROM alpine
|
||
RUN apk add --no-cache tzdata python3 py3-multidict py3-yarl && \
|
||
pip3 install --no-cache-dir "nonebot[scheduler]"
|
||
```
|
||
|
||
上述文件编辑完成后，输入命令 `docker-compose up` 即可一次性启动酷Q和 NoneBot（可通过 `docker-compose up -d` 在后台启动。更多 Docker Compose 用法见 [官方文档](https://docs.docker.com/compose/reference/overview/)。
|