1427 字
7 分钟
AstrBot部署及其bot部署
2026-05-31

AstrBot部署#

  • 服务器基础配置#

    • 安装docker(建议使用linux系统,如ubuntu、centos等,Windows系统不太推荐)

这里建议安装服务器面板,如btpanel、1panel等,方便管理服务器,以下拿1panel为例

1panel的安装请参考1panel安装,1panel安装过程中没装docker会提示安装docker,可以在1panel安装过程中直接安装docker

这里安装完毕后去服务器提供商放行1panel的端口,之后也是放行astrbot的端口和napcat的端口,放行后就可以在浏览器访问这些了

偷懒的话可以在ssh远程执行以下命令安装1panel

Terminal window
# 非root用户安装的话前面加sudo
bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

一定要记住1panel的登录账号密码,后续会用到,否则无法登录1panel界面到时候回ssh改密码就很苦逼了

图3-1 1panel界面 上方是1panel的主界面,点击docker图标可以查看docker容器

图3-2 1panel docker容器

这里可以查看docker容器的详细信息,有几个容器,每个容器的状态,每个容器的端口映射等信息

点击图示的创建按钮可以创建一个新的docker容器

这里点命令输入以下命令可以创建一个新的docker容器(咱为什么不在终端输入呢?)

或者你在创建docker容器时名称随便取,镜像输入soulter/astrbot,暴露端口6185→6185,6199→6199,网络选择bridge或别的,但如果你要接入napcat的话一定要保证服务器的网络一样,否则连不上

Terminal window
mkdir astrbot
cd astrbot
sudo docker run -itd -p 6185:6185 -p 6199:6199 -v $PWD/data:/AstrBot/data -v /etc/localtime:/etc/localtime:ro -v /etc/timezone:/etc/timezone:ro --name astrbot soulter/astrbot:latest

此时就成功创建了一个新的docker容器,名字叫astrbot,镜像是soulter/astrbot,暴露了6185和6199端口了,接下来访问http://<服务器IP>:6185就可以访问astrbot的web界面了

注意

如果你是部署的v4.24.3及以下的版本,默认和账户密码是astrbot 如果你是部署的v4.24.4及以上的版本,默认账户是astrbot,密码是随机生成的,去日志看,第一次登录需要使用默认账户和密码登录,登录后会提示你修改密码,修改后就可以使用新的账户密码登录了

日志的密码位置如下文所示: [00:27:40.590] [Core] [INFO] [dashboard.server:523]: ✨✨✨

AstrBot v4.24.3 WebUI is ready

➜ Local: http://localhost:6185

➜ Initial username: astrbot

➜ Initial password: U*****************y

➜ Change it after logging in ✨✨✨ Set dashboard.host in data/cmd_config.json to enable remote access.

其中的Initial password: U*****************y就是默认密码,登录后记得修改密码哦

astrbot的web界面配置#

访问:http://<服务器IP>:6185/#/providers,是你的AI模型提供商,不会整?看下图

图3-3 astrbot的web界面

这里拿DeepSeek为例,其他的模型提供商配置方法类似,按照提示输入相关信息就可以了

图3-4 astrbot的web界面

这里的模型提供商地址是DeepSeek的地址,端口是DeepSeek的端口,API Key是DeepSeek的API Key,其他的模型提供商也是一样的,按照提示输入相关信息就可以了

如果你想用的AIAPI提供商不在列表里但官方兼容OpenAI格式,可以选择OpenAI Compatible,输入key再把base url改成你想用的AIAPI提供商的地址和端口就可以了

例如你想用的AIAPI提供商是xiaomi mimo,那就改成https://api.xiaomimimo.com/v1 ,其他同理

bot部署#

这里的bot部署是指部署到消息平台的bot,主要是指部署到QQ、微信、钉钉等平台的bot,以下以onebot v11协议的QQ为例

onebot协议的QQ bot部署(napcat)#

napcat部署并配置#

还记得上面我提的docker部署吗,这里派上用处了

新建一个docker容器,名字叫napcat,镜像输入mlikiowa/napcat-docker,网络配置和astrbot一样,暴露端口是6099→6099就行了

这里访问http://<服务器IP>:6099就可以访问napcat的web界面了

密钥逻辑和astrbot一样,去翻日志

然后登陆QQ,拿你bot的号扫web上的二维码登录,登录成功后就可以在napcat的web界面看到你的QQ了

napcat接入astrbot#

这里访问http://<服务器IP>:6099/webui/network,点击添加网络,选择Websocket客户端,输入以下信息

  • 名称:随便取
  • 地址:ws://<astrbot镜像所在IP>:6199/ws

这里镜像所在IP指网路中的IP地址,不是服务器的IP地址,怎么查看呢?在1panel的docker容器里找到astrbot容器,点击进去就可以看到镜像IP地址了

Token复制一下

  • 心跳间隔:10s(1000)
  • 重连间隔:10s(1000)

astrbot接入napcat#

访问http://<服务器IP>:6185/#/platforms选择OneBot v11,输入以下信息

  • 名称:随便取
  • 反向 Websocket地址(不用改):0.0.0.0
  • 反向 Websocket 端口:6199
  • 反向 Websocket Token:粘贴一下napcat的token
  • 其他的保持默认,保存后就可以了

测试一下#

astrbot和napcat启用后,napcat的猫猫日志里会显示连接成功,astrbot的日志里也会显示连接成功,这时候你就可以在QQ上测试一下了,发送消息到bot号看看能不能收到回复,如果能收到回复说明部署成功了,如果收不到回复说明哪里配置错了,检查一下配置吧(建议发help)

这里的bot部署只是以onebot v11协议的QQ为例,其他平台的bot部署方法类似,按照提示输入相关信息就可以了,其他平台的bot部署方法后续会更新到这篇文章里,敬请期待

另外,compasser(某头猫鱼龙)不兼容(雾),消息会被compasser吃掉,所以不建议使用compasser