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. 人设配置、知识库检索、技能调用和自动上下文压缩均包含在内，MCP 协议与 Agent 编排也得到支持；这套强大的 AI 交互能力还全面覆盖多模态交互及大语言模型对话。
3. 主流 Agent 开发与编排平台均可无缝兼容，其中包括扣子（Coze）、阿里云百炼和 Dify，由此实现广泛的第三方平台对接。
4. 对各大主流社交与办公平台实现全渠道适配，Telegram、Slack、微信公众号、钉钉、飞书、企业微信和 QQ 均获原生支持。
5. 各类实用场景由超过 1000 个现成插件覆盖，功能通过一键安装便能极速扩展，由此形成丰富的插件生态。
6. 会话级别的资源能够复用；同时，安全的 Agent 沙箱机制以隔离运行环境保障 Shell 调用和代码执行的安全性。
7. WebUI 管理便捷：直观的网页用户界面让机器人的日常配置及运维管理工作得到大幅简化。
8. 联网搜索功能和 Agent 沙箱环境随独立的 Web 聊天 UI 一并内置，无须额外准备即可使用，构成现代化的 Web 聊天界面。
9. 全球不同地区用户的本地化使用需求，可由系统内置的多语言切换能力轻松满足，这便是国际化（i18n）支持。

二、本次实践安排

2.1 规划本地运行环境

hostname	IP地址	操作系统版本	Docker发行版本	部署项目	备注
jeven	192.168.3.88	Ubuntu 24.04.2 LTS	28.5.0	AstrBot	——

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 测试对话

七、实践总结