Docker实战搭建AstrBot：拥有自己的全平台AI聊天助手

• 一、认识AstrBot
• 1.1 项目AstrBot解读
• 1.2 能力亮点：AstrBot
• 二、本次实践安排
• 2.1 本地环境安排
• 2.2 实践内容概述
• 三、检查本地环境
• 3.1 Docker服务状态核验
• 3.2 Docker版本核验
• 3.3 检查docker compose 版本
• 四、AstrBot 镜像拉取
• 五、AstrBot 服务的部署
• 5.1 部署目录的建立
• 5.2 AstrBot容器的建立
• 5.3 AstrBot 容器状态核验
• 5.4 容器日志核验
• 六、AstrBot 服务访问
• 6.1 打开AstrBot 初始页
• 6.2 进入AstrBot账户
• 6.3 AI模型参数配置
• 6.4 测试对话
• 七、实践总结

一、认识AstrBot

1.1 项目AstrBot解读

1.2 能力亮点：AstrBot

1. 免费且完全开源：项目公开全部代码并遵循开源协议，既可由社区共同建设，也支持自由定制。
2. 大语言模型对话、多模态交互、技能调用、知识库检索与人设配置均获支持，Agent 编排、MCP 协议和自动上下文压缩也涵盖在内，由此形成强大的 AI 交互能力。
3. 在主流 Agent 开发与编排平台中，Dify、阿里云百炼以及扣子（Coze）等均能无缝兼容，因而实现广泛的第三方平台对接。
4. 从社交到办公平台均可覆盖，QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 等各大主流渠道得到原生支持，实现全渠道多平台适配。
5. 插件生态丰富，已有超过 1000 个覆盖各类实用场景的现成插件，并支持一键安装，可快速扩展功能。
6. 代码执行及 Shell 调用由隔离运行环境保障安全，并能复用会话级别的资源，这构成了安全的 Agent 沙箱机制。
7. 机器人的日常配置与运维管理工作，借助直观的网页用户界面得到极大简化，这正是便捷的 WebUI 管理能力。
8. 现代化的 Web 聊天界面：内置独立的 Web 聊天 UI，自带 Agent 沙箱环境与联网搜索功能，开箱即用。
9. 为满足全球不同地区用户的本地化使用需求，系统内置多语言切换能力，由此提供国际化（i18n）支持。

二、本次实践安排

2.1 本地环境安排

2.2 实践内容概述

三、检查本地环境

3.1 Docker服务状态核验

root@jeven:~# systemctl status docker● docker.service - Docker Application Container Engine Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled) Active: active (running) since Thu 2026-02-05 00:27:40 CST; 1s agoTriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID: 841698 (dockerd)Tasks: 65 Memory: 73.5M (peak: 77.1M)CPU: 975ms CGroup: /system.slice/docker.service

3.2 检查Docker版本

root@jeven:~# docker -vDocker version 28.5.0, build 887030f

3.3 检查docker compose 版本

root@jeven:~# docker compose versionDocker Compose version v2.39.4

四、拉取AstrBot 镜像

root@jeven:~# docker pull soulter/astrbot:v4.25.1v4.25.1: Pulling from soulter/astrbot57fb71246055: Already exists797809503061: Already exists759e0c85a86e: Already existsb33ff618953d: Already exists91e5207f7536: Pull completebff77dc5fbe1: Pull completea35c81515acb: Pull completed5fb4df24609: Pull completeDigest: sha256:d26eacf8aba492ae09ef781038ceea08a7c6f3bffbe222dbd8679ce642ed5c5fStatus: Downloaded newer image for soulter/astrbot:v4.25.1docker.io/soulter/astrbot:v4.25.1

五、AstrBot 服务的部署

5.1 部署目录的建立

mkdir -p /data/astrbot/data&& cd/data/astrbot/

chmod -R 777 /data/astrbot/

5.2 创建AstrBot容器

docker run -d --restart always --name astrbot -p 6185:6185 -p 6199:6199 -v $(pwd)/data:/AstrBot/data -v /etc/localtime:/etc/localtime:ro -e TZ=Asia/Shanghai soulter/astrbot:v4.25.1

vim docker-compose.yaml

version: '3'services:astrbot:image: soulter/astrbot:v4.25.1container_name: astrbotrestart: alwaysports: # mappings description: https://github.com/AstrBotDevs/AstrBot/issues/497- "6185:6185" # 必选，AstrBot WebUI 端口- "6199:6199" # 可选, QQ 个人号 WebSocket 端口# - "6195:6195" # 可选, 企业微信 Webhook 端口# - "6196:6196" # 可选, QQ 官方接口 Webhook 端口environment:- TZ=Asia/Shanghaivolumes:- ./data:/AstrBot/data# - /etc/timezone:/etc/timezone:ro- /etc/localtime:/etc/localtime:ro

docker compose up -d

5.3 AstrBot 容器状态核验

root@jeven:/data/astrbot# docker compose psWARN[0000] /data/astrbot/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusionNAMEIMAGE COMMANDSERVICE CREATED STATUS PORTSastrbot soulter/astrbot:v4.25.1 "python main.py" astrbot 2 minutes ago Up 2 minutes 0.0.0.0:6185->6185/tcp, [::]:6185->6185/tcp, 0.0.0.0:6199->6199/tcp, [::]:6199->6199/tcp

5.4 容器日志核验

docker compose logs

六、AstrBot 服务访问

6.1 打开AstrBot 初始页

6.2 进入AstrBot账户

docker compose logs

6.3 AI模型参数配置

6.4 测试对话

七、实践总结