Linux 手动部署
TIP
系统建议: Ubuntu 22+/Debian 12+/CentOS 9+（非以上系统python需要手动配置，若使用docker可忽略）
配置要求: 1H2G以上
部署Astrbot
一、手动部署
DANGER
此部署方式需要你有一些Linux和Python基础，否则不建议用此方式部署
零基础建议选择Docker一键部署
- 检查环境，确保为
Python3.12以上.
bash
python3 --version- 安装环境(Debian12为例)
bash
sudo apt update # 更新软件源
# sudo apt upgrade -y # 可选执行：更新软件包，防止部分软件包版本太低导致问题
sudo apt install -y python3-full python3-dev python3-venv python3-pip # 安装python3完整包
sudo apt install git # 安装git工具
# 若是国内网络环境，请继续执行以下命令，以更换pypi源为阿里源，加速pypi软件包下载:
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple
pip config set install.trusted-host mirrors.aliyun.com- 下载Astrbot官方仓库
bash
git clone https://github.com/AstrBotDevs/AstrBot.git # 从官方仓库下载
# 若是国内网络环境，请通过githubproxy下载，以加速网络访问:https://github.akams.cn/，例如：
# 全球/海外/港澳台
git clone https://github.com/AstrBotDevs/AstrBot.git
# 大陆地区#1
git clone https://gh-proxy.com/https://github.com/AstrBotDevs/AstrBot.git
# 大陆地区#2
git clone https://cdn.gh-proxy.com/https://github.com/AstrBotDevs/AstrBot.git- 创建并激活Python虚拟环境
这样可以避免影响系统环境！
bash
cd Astrbot # 进入Astrbot文件夹
python3 -m venv venv # 在Astrbot/venv下创建虚拟环境
source venv/bin/activate # 激活虚拟环境- 安装python依赖包
bash
# !!! 请确保你现在位于Astrbot文件夹内
# !!! 请确保已经激活虚拟环境
pip install -r requirements.txt # 安装依赖
#如下载过慢可更换国内源
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple # 使用阿里源安装依赖- 创建简单启动脚本
bash
touch start.sh # 新建启动文件
vim start.sh # 编辑启动文件按下I进入编辑模式
输入以下内容后:
vim
source venv/bin/activate
python3 main.py完成后按下ESC后输入:wq保存并退出
- 启动Astrbot
INFO
使用screen来保持后台开启，具体使用请自行查询
bash
screen -S astrbot # 创建astrbot screen窗口
bash start.sh # 执行启动脚本等待启动完成后，按下Ctrl+A+D退出screen窗口
- 进入Astrbot控制台
浏览器打开：http://[你的服务器ip]:6185/ 进入Astrbot控制台，输入默认的用户名密码（均为astrbot），进入后按要求修改密码即可。
若你的服务器并非独立ip，请 转发 6185端口到其他端口，并打开相应端口的网页，服务商防火墙/安全组 需 放行 ！
配置Astrbot
进入Astrbot控制台
http://[你的服务器ip]:6185/
接入QQ：消息平台->新增适配器->接入QQ个人号（aiocqhttp）
选项保持默认，勾选启用
WARNING
如果你需要在公网使用（即绑定到0.0.0.0）
建议在Token中填入 强密码 ，与此同时Napcat端也需要填入相应的Token
前往Astrbot官方文档 查看如何接入平台适配器
配置大模型API：服务提供商