Docker打造专属全平台AI聊天助手：AstrBot极速部署

• 一、认识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. 从大语言模型对话、多模态交互，到知识库检索、人设配置及自动上下文压缩，均被纳入强大的 AI 交互体系；该体系还涵盖 Agent 编排、MCP 协议与技能调用。
3. 面向主流 Agent 开发与编排平台，第三方对接范围覆盖扣子（Coze）、Dify、阿里云百炼等，并实现无缝兼容。
4. 从社交渠道到办公场景，系统均可原生适配，覆盖 Telegram、Slack、QQ、微信公众号、企业微信、飞书、钉钉等各大主流平台。
5. 插件生态十分丰富：现成插件数量超过 1000 个，可覆盖各类实用场景，并能通过一键安装快速扩展功能。
6. Agent 沙箱机制安全：通过隔离运行环境保障代码执行和 Shell 调用的安全，同时允许在会话级别复用资源。
7. WebUI 管理方便：直观的网页用户界面让机器人的日常配置更简单，也显著降低了运维管理工作的复杂度。
8. 无需额外搭建即可使用联网搜索和 Agent 沙箱环境；两项功能均已随独立的 Web 聊天 UI 内置，构成现代化的 Web 聊天界面。
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 测试对话

七、实践总结