前言
大学毕业以后同学都去上班了，没空理我，我实在闲的无聊，就想着找几个机器人陪我聊天，久闻astrbot的大名，仙之人兮列如麻，趁着短暂的暑假，就想部署试试。
我也尝试过把Astrbot部署到本地电脑上，效果还是很不错的。不过我的舍友不允许我天天开电脑放在宿舍挂机，而且校园网也经常挂掉，对于astrbot的稳定运行并不是很友好。所以本次再部署是奔着部署在云服务器上来的，也顺便学点运维知识。
目前我已经成功部署在了自己的一台服务器上，本着坚持互联网分享精神，写下我的这次部署过程分享给大家，文章描述不当或者有错误的地方，欢迎大家的批评指正~
另外，附上Astrbot项目的地址，感谢各位开源大佬制作那么有意思的项目
Contributors to AstrBotDevs/AstrBot · GitHubgithub.com/AstrBotDevs/AstrBot
一、准备工作
想从零部署Astrbot聊天机器人，大致要满足下面3个主要条件：
一台云服务器
一个能用的AI API
一个能用的QQ小号
磨刀不误砍柴工，这章我们先从零解决这些条件，为后续部署铺平道路。
1.1 购置云服务器
我们的astrbot托管运行在云服务器上，需要各位事先在任意云服务器厂商平台租用一台云服务器，像是雨云、阿里云、腾讯云、京东云等等都可以。
考虑是从零开始部署，这里我以雨云这个云服务提供商为例，简要讲解如何购置一台云服务器。（阿里云，腾讯云这些都是可以的，只是笔者只剩雨云的优惠券了orz）
首先进入雨云的官网并完成注册，进入用户面板。
雨云 - 新一代云服务提供商www.rainyun.com/
在用户面板点击找到“云产品”并点击跳转，然后找到云服务器并点击“立即购买”
然后在购买选项界面可以看到有很多区域和网络线路方案，这里可以根据实际情况选择。不同的区域和网络线路价格会有所不同，这里我们优先选择国内的云服务器。
随后继续往下滑会让你选择KVM配置，简单理解CPU核心越多，内存越大，这个云服务器性能越强劲；带宽越大，网速越快，但是租金也会越高。如果单单只是部署一个astrobot尝尝新鲜，2核2GB内存绰绰有余，所以我们选择最便宜的这档就可以。
再往下滑，系统盘和公网IP保持默认即可。
随后是系统和软件安装，这里我们选择安装Ubuntu系统24.04 LTS版本
然后就可以点击立即购买付款了，如果之前你没有在雨云上购买过云服务器，这里就可以像笔者一样使用“新人首月5折券”，这样我们就可以花大概25元租用一个2核2g的云服务器一个月。
另外，点击立即购买后，如果之前注册完没有进行实名认证，系统会提醒你先完成实名认证，按照步骤完成再返回界面重新购买即可。
随后我们就拥有了一台云服务器实例，系统会自动跳转到控制台，可以看到已经出现了一个服务器卡片，等待几分钟，服务器将初始化完成。
服务器初始化完毕后，点击管理进入服务器信息看板，找到“远程连接”并记录下自己服务器的公网IP地址，远程用户名和登录密码。（注意，不要向陌生人透露自己的密码！）
这样，我们就获得了一台Linux系统的云服务器。
1.2 获得AI API
为了赋予astrbot聊天机器人大语言模型（LLM）能力，需要借助AI API请求调用LLM。
获取AI API的途径很多，可以去各家模型厂商（DeepSeek，Kimi，千问，GPT等）注册账号并创建API key，充值一定token额度即可调用对应模型的API。当然也可以选择使用中转站的API，但是中转站鱼龙混杂，水分比较大，我还是不太推荐没相关经验的好伙伴去尝试的。
我之前写过一篇文章介绍如何获得与调用AI API，感兴趣的读者可以阅读。
0成本上手！草履虫也能看懂的免费调用 DeepSeek API入门教程14 赞同 · 2 评论 文章
下面我们简要介绍获得DeepSeek官方API KEY的方法。
进入deepseek官网，点击“API开放平台”，然后跳转到登录界面，按照步骤完成登录验证。
DeepSeek | 深度求索www.deepseek.com/
请求API需要花费token，而token需要付费，所以登录并完成实名认证后，在界面“用量信息”充值余额，如果仅仅只是为了体验尝试，充个2元左右的额度即可，用多少充多少。笔者之前充值过10元，这里就不再展示充值流程。
完成充值后，点击API keys，然后点击创建API key，API key的名称随意填写，这里我填写为astrbot_test，随后点击创建
然后会弹出提示，让你记住这个API key。因为这个API key只会显示一次（忘记了只能销毁重新创建），这里我们复制并保存好API key，后续会用到。请注意，API key类似账号密码，请不要随便公开展示！
随后界面就会显示刚才我们创建好的API key，至此，我们的AI API也就准备好了。
1.3 创建QQ小号
QQ小号的创建就不再赘述了，主要是讲解一下QQ小号的作用和一些提醒。
创建QQ聊天机器人可以通过腾讯开放平台创建，但是这种方法的限制很多，而且体验并不是很好，所以我们需要有一个能正常添加好友、发送信息的QQ账号来充当聊天机器人的载体。
需要提醒的是，因为QQ对AI和机器人的使用比较严格，可能弄着弄着就把账号给弄封号了，所以这里格外强调使用一个不怎么常用、没什么好友、群聊的QQ账号。
至此我们就已经具备了部署聊天机器人的所有条件，往下的章节将具体介绍部署过程。
二、服务器环境部署
2.1 SSH程控制云服务器
在1.1节的最后，我们创建了一个Ubuntu系统服务器，并获得了服务器的公网IP和密码
为了对云服务器进行操作，我们需要利用这些信息实现对云服务器的远程控制，比较常见的方案是SSH远程连接。SSH远程连接很简单，在电脑的终端上敲击对应的指令就可以实现SSH连接控制云服务器。
不过我们一般还是会用一些专门的软件进行SSH连接，这里笔者使用的是finalshell，访问以下链接可以跳转到finalshell的下载界面。
如果您和笔者一样使用Win11，选择Windows x64版本下载安装即可
下载安装FinalShell完毕后，打开软件，点击蓝色的文件夹图标
然后在弹出的窗口的左上角点击“带+号的白色文件夹”，进一步选择“SSH连接(linux)”
然后在新跳出的配置界面中，名称随便填写，笔者习惯以“服务器厂商+IP”命名，然后主机填上自己云服务器的公网IP，端口保持为22不动，在下面的认证栏选择密码认证，用户名填写root（注意，如果是腾讯云，一般填的是“ubuntu”），密码则填写云服面板里给出的远程密码，然后其他配置保持不动，点击“确定”
然后双击刚创建好的服务器连接，即可进入到终端界面，第一次使用会提示“是否接受该密钥”，选择“接受并保存”即可。
终端界面显示连接主机成功，表明SSH连接已经建立
2.1 云服务器安装Docker
我们的astrbot运行在Docker容器之中，如果你是和我一样刚刚租用一个全新的云服务器，则需要先提前配置好Docker环境，如果你的服务器已经安装有Docker，这一小节可以跳过。
因为国内的网络环境问题，安装 Docker 的可能会遇到各种各样奇怪的问题。我的个人的经验是，使用什么厂商的云服务器，可以先去对应厂商的文档里找到相应的 Docker 安装教程。这里给出雨云、阿里云和腾讯云服务器的 Docker 安装文档，相关读者根据文档指引安装 Docker 即可。
在Linux上安装Docker和Docker Compose - 云服务器ECS（ECS）-阿里云帮助中心
轻量应用服务器 安装 Docker 并配置镜像加速源_腾讯云
根据文章步骤，将以下指令按照步骤依次复制粘贴到finalshell建立好的服务器终端中执行。指令执行需要一定时间，请耐心等待。
1.依次执行以下命令，添加 Docker 软件源
sudo apt-get update
sudo apt-get install ca-certificates curl -y
sudo install -m 0755 -d /etc/apt/keyrings
null
null
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.ascn https://mirrors.cloud.tencent.com/docker-ce/linux/ubuntu/ \
null
sudo apt-get update2.安装Dokcer
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin如果出现如下界面，输入"Y",然后回车即可
3.安装完成后，输入以下命令启动Docker服务
sudo systemctl start docker4.输入以下命令检查Docker是否安装成功
sudo docker info输出以下类似信息即表示安装成功
为了能正常拉取后续的astrbot镜像，还需要配置docker的镜像源加速
1.创建 daemon.json 配置并打开文件
请在终端依次输入这两条指令
sudo mkdir -p /etc/docker
sudo vim /etc/docker/daemon.json2.点按键盘上“i”键，进入编辑模式，此时终端底部会提示“INSERT”
复制粘贴以下内容
{
registry-mirrors": [
https://docker.m.daocloud.io
]
}
然后按下键盘“esc”键退出编辑模式，键盘敲击:wq并回车实现保存并退出
4.执行以下命令，重启 Docker 即可
sudo systemctl restart docker每一次编辑修改daemon.json 后请务必执行以上命令
2.2 安装 astrbot
astrbot的安装参照的是官方文档
使用 Docker 部署 AstrBot | AstrBotdocs.astrbot.app/deploy/astrbot/docker.html
在官方文档找到“和NapCat一起部署”
依次运行以下指令
mkdir astrbot
cd astrbot
wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml
sudo docker compose -f astrbot.yml up -d随后服务器将拉取astrbot和napcat的docker镜像并完成安装，两个文件比较大，受限于网速，可能需要等待许久才能完成，可以在雨云控制面板观察下载速度是否正常，判断有没有在正常下载。
然后通过以下命令查看Astrobot的日志
sudo docker logs -f astrbot
有如上的界面即证明安装成功
重点关注红框部分内容
AstrBot v4.26.7 WebUI is ready
➜ Local: http://localhost:6185
➜ Network: http://127.0.0.1:6185
➜ Network: http://172.18.0.3:6185
➜ Initial username: astrbot
➜ Initial password: AHny82FDu4RKAWGAhX3dmdlY
➜ Change it after logging in这里面提供的是astrbot的配置面板访问地址和端口，以及默认的用户名和密码，这个密码是随机生成的，请注意不要将其分享给陌生人，至此，Astrbot安装完成。
三、Astrbot的部署
安装好astrbot后，本章将简要介绍如何对astrbot进行基础配置，并启用QQ聊天机器人
3.1 Astrbot配置面板登录
在2.2节的最后，我们拿到了如下关键信息
➜ Local: http://localhost:6185
➜ Network: http://127.0.0.1:6185
➜ Network: http://172.18.0.3:6185第一行指明astrbot的访问端口，我这里是6185，则要前往雨云服务器的控制面板，找到“防火墙规则”并点击“新建防火墙规则”
然后配置如下，动作改为“允许”，业务端口输入6185，协议选择TCP
如果您使其他云服务器，也需要到对应的控制台找到防火墙规则，进行配置。下面是我之前的一台腾讯云服务器开放端口的过程。
然后将http://localhost:6185的localhost替换成自己服务器的公网ip，例如我这里应替换成http://211.161.232.124:6185，并打开浏览器复制并跳转到地址，进入astrbot面板，如下所示。
然后在用户名和密码栏分别填写当时得到的默认用户名和密码即可完成登录。
登录后面板会要求你重新设置新密码（当然也可以重新更改用户名），配置好新的用户名和密码即可进入面板，往后都会通过这里重新配置好的用户名和密码登录面板
3.2 配置聊天机器人
登录到Astrbot控制面板后，会进入欢迎界面，我们按步骤配置即可
1.配置AI模型
在AI模型配置界面，我们点击“新增”，然后选择“OpenAI Compatible”
随后我们需要配置模型的提供商ID、API key和API Base URL
提供商ID可以随便填，这里笔者填写deepseek
如果你曾和我在1.2配置过DeepSeek的API key，API key填写自己当时得到的API KEY，然后API Base URL填写https://api.deepseek.com，请注意，不同的AI API提供商，需要填写的Base URL是不同的。
然后点击一次“保存配置”，并下滑点击“获取模型列表”，稍等片刻可以显示可用模型，这里选择添加deepseek-v4-pro并保存即可完成AI模型的配置。然后点击配置框外空白处回到欢迎界面。
2.配置平台机器人
我们首先回到finalshell界面，确保自己处于astrbot文件夹内（可以在终端输入指令pwd确认）
终端输入指令ls确认存在napcat文件夹
然后在终端输入如下指令打开napcat配置文件夹内的webui.json 配置文件。
vim napcat/config/webui.json 
我们不对文件进行任何修改，只需要获取文件内重要信息
port": 6099,
"token": "81c6de868607",这里的port 6099是napcat服务开放的端口，token 81c6de868607是进入napcat界面的验证令牌，大家记住自己的端口和token（请不要把自己的token公开给别人！）
随后同样需要去云雨控制台开放服务器的6099端口
并通过浏览器输入211.161.232.124:6099（替换成自己主机的IP：端口号）访问napcat配置界面，并输入自己的token进行登录
这里会跳转到qq登录界面，我们选择密码登录，输入准备好的小号的QQ账号和密码，并在手机上完成登录验证
登录进napcat控制面板后，我们选择”网路配置“，可以发现已经自动启动了一个服务，点击”编辑“
这里这需要添加一个token，token内容任意，一般是一个比较复杂的密码，这里我填写abc114514，记住填好token，然后保存。
现在回到Astrbot的控制面板欢迎界面，选择配置平台机器人
消息平台类别我们选择OneBot v11，机器人名称任意填写，Token填入当时在napcat中配置的Token，然后保存。这样，我们的基本机器人就配置好了，可以根据需要在第三步选择允许Agent控制电脑。
然后来到控制面板的”机器人“界面，确保机器人已经打开
可以前往”更多功能“找到”平台日志“，检查机器人是否已经启动
这时就可以在QQ上向对应的小号QQ发送消息，测试机器人聊天功能，至此astrbot的基本部署已经成功实现
四、Astrbot基础配置介绍
这里简单介绍astrbot机器人的人格创建、配置文件修改以及插件使用。
4.1 机器人人格
在面板内可以创建机器人的人格模板，具体入口如下
这里我们主要是配置好该人格模板的ID和具体提示词内容，即可创建符合提示词要求的某一人格类型的AI聊天机器人，这里的提示词我让chatgpt随便生成了我妻由乃的人格设定。保存后即可完成人格设定。
4.2.配置文件设置
面板提供配置文件的修改，用于设定机器人调用的AI模型以及一些行为设定。除了默认配置外，我们可以新建配置，这里推荐一个人格对应一个配置。
在具体的配置页面，有AI配置，平台配置，插件配置和扩展功能四个配置项。
在AI配置中，我们主要是配置聊天机器人所使用的模型，人格和知识库等功能，比如我们在前面建立了一个我妻由乃人格，可以在这个配置里选择这个人格，并保存。
随后返回机器人界面，编辑我们的机器人，更改它的配置文件。更改配置文件后，机器人需要一定时间进行重启。
然后我们就可以测试配置后机器人的效果
更多配置文件的设置这里就不再展开，感兴趣的读者可以参看官方文档自行尝试
WebUI | AstrBotdocs.astrbot.app/use/webui.html
4.3 插件功能
Astrbot面板内置一个插件市场，里面有广大网友制作的各种插件，极大地丰富了聊天机器人的功能。
这里我随便以插件Anime1番剧剧集更新列表作为演示
安装后根据使用指南来调用插件，效果如下，还是很有意思的~
这样，我们就基于雨云的云服务器，完成了astrbot的部署。大家可以尝试调用不同的大预言模型，自行编写个性化的人格提示词，探索各式各样的插件，制作独属于自己的聊天机器人~
另外这个分享仅用于个人学习研究目的，请大家遵守AI的使用规范，保护好文章里提到的API key，服务器登陆密码等敏感信息~
Comments NOTHING