5分钟快速开始:使用Docker Compose部署Astron Agent

Astron Agent是一个企业级智能体工作流平台,本指南帮助您快速部署并运行一个本地实例。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Docker 20.10+ 必需
Docker Compose 2.0+ 必需

所需工具

终端或命令行界面

执行部署命令

必需

操作步骤

1

克隆项目仓库

从GitHub克隆Astron Agent的代码到本地。

克隆仓库
git clone https://github.com/iflytek/astron-agent.git

预期结果::输出类似 'Cloning into 'astron-agent'...' 表示成功。

确保已安装Git,否则从GitHub下载ZIP文件并解压。

2

进入项目目录

切换到克隆的目录以执行后续命令。

进入项目根目录
cd astron-agent

预期结果::终端提示符显示当前路径为astron-agent。

如果使用ZIP文件,请进入解压后的文件夹。

3

使用Docker Compose启动服务

运行Docker Compose命令来启动所有必需的服务。

在后台启动容器
docker-compose up -d

预期结果::输出类似 'Creating network...' 和 'Creating container...' 表示服务正在启动。

首次运行可能需要几分钟下载镜像,请确保网络连接稳定。

验证部署成功

检查服务是否正常运行并访问Web界面。

所有容器状态为 'Up' 在 'docker-compose ps' 输出中
在浏览器中打开 http://localhost 能看到Astron Agent前端

快速提示

配置

如果端口冲突,修改docker-compose.yml中的端口映射

故障排除

使用 'docker-compose logs' 查看日志以调试问题

常见问题

1

Docker Compose命令失败,提示权限不足

在Linux/macOS上使用sudo或以管理员身份运行,或在Windows上以管理员模式打开终端。

2

访问 http://localhost 时显示错误或无法连接

运行 'docker-compose ps' 确认容器状态,或检查防火墙设置是否允许本地端口。

下一步

探索Astron Cloud

访问 https://agent.xfyun.cn 免费试用云端版本,无需本地部署。

阅读详细文档

查看项目README中的部署指南和快速开始指南以了解更多功能。

助手