从零开始部署 AstrBot：服务器购买到机器人上线完整教程

适用人群：零基础新手

预计耗时：30-60 分钟

难度：★★☆☆☆

前言

即使你是⑨也能学会的Astrbot部署教程！

观前提示：限于作者水平有限，如有错误欢迎指正！

本教程将从购买服务器开始，手把手教你完成宝塔面板安装、Docker 环境搭建、NapCat 消息平台部署、AstrBot 机器人上线全流程。

读完这篇教程，你也能拥有一个自己的 QQ 机器人。

第一章 购买服务器

1.1 购买步骤

以腾讯云为例：

1. 打开 腾讯云官网
2. 搜索「轻量应用服务器」
3. 选择「2核2G」配置
4. 系统镜像选择「宝塔Linux面板」
5. 完成支付

购买成功后，你会获得服务器的公网 IP 地址。

1.2 获取登录信息

安装完成后，终端会显示：

==================================================================
外网面板地址: https://你的IP:8888/abc12345
内网面板地址: https://你的IP:8888/abc12345
username: abcdefgh
password: 12345678
==================================================================

把这行信息复制保存下来。这就是你的宝塔面板登录地址、用户名和密码。

1.3 放行端口

如果是云服务器，需要在云服务商控制台的安全组中放行以下端口：

在腾讯云控制台 → 轻量应用服务器 → 防火墙 → 添加规则，放行上述端口。

1.4 登录宝塔

浏览器访问宝塔面板地址，输入用户名和密码，登录面板。

首次登录会弹出「推荐安装套件」窗口，点击「关闭」即可，我们后续手动安装需要的组件。

第二章 安装 Docker

2.1 为什么用 Docker

Docker 就像一个大集装箱，每个应用都打包在自己的容器里，互不干扰。安装、更新、卸载都非常方便，不会把系统环境搞乱。

2.2 通过宝塔安装

登录宝塔面板后：

1. 左侧菜单 → 软件商店
2. 顶部搜索框输入 Docker
3. 找到「Docker 管理器」
4. 点击「安装」

等待 2-3 分钟，安装完成后图标右上角会显示「已启动」。

2.3 验证安装

宝塔面板 → 终端（或 SSH 连接服务器），输入：

docker --version

输出类似 Docker version 24.0.7 表示安装成功。

2.4 配置镜像加速（推荐大陆服务器配置）

由于 Docker 官方镜像站在国内访问较慢，配置国内镜像源可以大幅提升下载速度。

1.左侧菜单 → Docker
2.顶部切换至[设置]标签
3.下方设置[加速URL]
4.点击确认

第三章 部署 AstrBot

3.1 创建数据目录

SSH 执行：

mkdir -p /opt/astrbot/data

3.2 拉取 AstrBot 镜像

宝塔面板 → Docker → 镜像 → 拉取镜像

输入：

soulter/astrbot:latest

点击确定，等待下载完成。

3.3 创建 AstrBot 容器

宝塔面板 → Docker → 容器 → 创建容器

逐项填写：

端口映射（添加以下三行）：

填写完成后点击创建。

3.4 检查容器状态

宝塔面板 → Docker → 容器

确认 napcat 和 astrbot 两个容器都显示运行中。

第四章 部署 NapCat（QQ 消息平台）

QQ 机器人需要一个消息平台来收发 QQ 消息。NapCat 是目前最稳定的免费方案。

4.1 拉取 NapCat 镜像

宝塔面板：

1. 左侧菜单 → Docker
2. 顶部切换至「本地镜像」标签
3. 左上角从仓库中拉取
4. 输入：mlikiowa/napcat-docker:latest
5. 点击确定

等待下载完成（约 1-2 分钟）。下载完成后在镜像列表中可以看到它。

4.2 创建配置目录

SSH 连接服务器执行：

mkdir -p /opt/napcat/config

4.3 创建 NapCat 容器

宝塔面板 → Docker → 容器 → 创建容器

逐项填写：

端口映射（点击「添加」按钮添加两行）：

填写完成后，点击创建。

4.4 登录 QQ

容器创建后会自动启动。点击容器列表中的 napcat → 日志：

# 如果日志中看不到登录url或token，可以 SSH 执行
docker logs napcat

跳转日志中的url，进入Napcat的WebUI界面，按页面引导进入主页面。

进入主页面后选择网络配置–新建–Websocket客户端

注意：URL需要与astrbot一致，如果均为docker部署可依照范例输入：

ws://localhost:(Astrbot的端口)/ws

设置完成后勾选启用，然后点击保存即可。

之后进入Astrbot配置aiocqhttp

跳转日志中的url，进入Napcat的WebUI界面，按页面引导进入主页面。
登录成功后，日志中会显示：

[INFO] 已连接到 QQ 服务器
[INFO] WebSocket 服务已启动

表示 QQ 登录成功，NapCat 工作正常。

第五章 测试验证

5.1 查看日志确认

点击 astrbot 容器 → 日志，确认看到类似输出：

[INFO] AstrBot 启动成功
[INFO] 已连接到 QQ 平台
[INFO] 消息监听已启动

5.2 发送测试消息

用另一个 QQ 号（不是你机器人登录的 QQ），添加机器人 QQ 为好友，发送：

/help

如果机器人回复了帮助信息，恭喜🎉，部署成功！

5.3 测试其他功能

你好
/plugin list
今天天气怎么样

第六章 常见问题

Q1：宝塔面板无法访问

检查服务器安全组是否放行了 8888 端口。在云服务商控制台添加安全组规则。

Q2：Docker 镜像下载太慢

已按照第三章的方法配置了镜像加速。如果仍然慢，可以换其他加速地址：

https://docker.m.daocloud.io
https://dockerproxy.com

Q3：NapCat 登录后立即掉线

可能是 QQ 账号安全策略导致。尝试：

1. 在本地电脑登录一次 QQ
2. 保持本地 QQ 在线的情况下，服务器 NapCat 重新扫码
3. QQ 设置中开启设备锁

Q4：AstrBot 面板无法打开

检查：

1. 宝塔安全 → 防火墙 → 是否放行 6180 端口
2. 云服务商安全组 → 是否放行 6180 端口
3. astrbot 容器是否在运行

Q5：机器人收到消息但不回复

检查 AstrBot 日志中 WebSocket 连接状态。通常是因为容器 IP 地址配置错误。执行以下命令确认 NapCat 容器的实际 IP：

docker inspect napcat | grep IPAddress

用查到的 IP 更新 AstrBot 配置。

Q6：服务器重启后机器人不工作

两个容器都已设置「重启策略：总是」，通常会自动恢复。如果没有：

docker start napcat
docker start astrbot

总结

完成以上步骤，你已经拥有：

• 一台带宝塔面板的服务器
• 一个运行在 Docker 中的 QQ 机器人
• 可视化的管理面板
• 可随时扩展的插件系统

这个架构非常灵活，以后可以轻松添加更多 Docker 应用，也不会相互冲突。

本文首发于 Linのblog，转载请注明出处。