53AIHub

环境要求

• 可执行 sudo 的 Linux/macOS 环境（一键安装脚本需要）
• 已安装 Docker（https://docs.docker.com/get-docker/）
• 已安装 Docker Compose（https://docs.docker.com/compose/install/）
• 可访问外网，以便下载安装脚本或拉取镜像

安装与启动步骤

1. 1一键安装（推荐）

   官方推荐方式，直接运行一行安装脚本，脚本执行完毕后按终端提示完成后续设置。需要 sudo 权限。

   sudo curl -fsSL https://download.53ai.com/install.sh | bash

   复制

2. 2访问管理面板

   安装完成后用浏览器打开本地地址，进入管理后台并开始初始化设置；云服务版本可改为访问 hub.53ai.com 申请。

3. 3克隆代码仓库

   Docker 安装方式的第一步，把 53AIHub 仓库拉到本地并进入目录。

   git clone https://github.com/53ai/53aihub.git
   cd 53aihub

   复制

4. 4启动 Docker 容器

   进入仓库内的 docker 目录，用 compose 文件后台启动全部服务，首次会拉取镜像，耗时较长。

   cd docker
   docker compose up -d

   复制

5. 5自定义配置

   按 .env.example 注释复制生成 .env 并修改取值，也可调整 docker-compose.yaml 的镜像版本、端口映射或挂载卷。

   cd docker
   cp .env.example .env

   复制

6. 6重载配置

   修改配置后重新执行 compose 命令使改动生效，无需重新克隆仓库。

   cd docker
   docker compose up -d

   复制

关键配置

如何确认成功

一键脚本执行完按提示完成设置后，浏览器打开 http://localhost:3000 能进入管理面板并开始初始化，即部署成功。

常见问题

注意事项

• 一键安装脚本使用 sudo 执行，请确认脚本来源可信后再运行。
• 仓库文档中未列出默认端口以外的参数，端口映射可在 docker-compose.yaml 中调整。
• 云服务免费版对 Agent 数量和注册用户数有限制（10 个 Agent、100 个用户）。
• 更完整的本地部署与使用说明见官方文档 https://docs.53ai.com/。