Docker一键部署启动PaiFlow Agent实战项目（派派工作流AI企业级工作流编排）

之前做派聪明 RAG 项目的时候，有球友反馈一上来就被 Kafka、ElasticSearch 的前置环境卡死了，所以后来我们提供了 Docker 部署版本——甭管那些细节，闭着眼启动 Docker，然后启动项目了，前置条件一个不用操心。

很多同学表示友好友好，实在太友好了。

到派派工作流这个项目，虽然前置环境需要的不多，只需要 MySQL、Redis 和 MinIO，但我们打算继续保持优良的传统，给大家提供 Docker 的一键启动版本。

一、二哥构建

为了让大家对整个过程有个清晰的认知，我画了一张图来解释 Docker 是怎么把代码变成可运行的服务的。

姑且叫它“多阶段构建”吧。你可以把它想象成“厨房”和“餐厅”的关系：我们在一个装满工具的“厨房容器”里把代码做成“菜”（编译成 Jar 包或静态文件），然后把“菜”端到一个干净清爽的“餐厅容器”里运行。

这样做出来的镜像体积小，运行效率也高。

理解了原理后，大家需要做的就是进入到 docker/PaiFlow 文件夹下，执行 docker-compose up -d --build命令就可以了。

等它构建完事就好了。

也许你对 Dockerfile 里的内容感到好奇，我们把三个核心服务的构建过程拆解开来看看。

01、后端构建 (Dockerfile.backend)

这是 hub Java 后端服务的构建过程。

# 1. 定义“厨房”：使用 Maven 和 JDK 21 的镜像作为构建环境
# 这个镜像标签 (Tag) 包含了丰富的信息：
# - 3.9.9：代表 Maven 的版本是 3.9.9
# - ...

19 条评论

喷喷3.0 ૢ 2026年04月11日 16:56

引用原文：这通常是因为 mysql 数据库编码配置不正确导致的，可以通过在 docker 脚本中挂载本地 mysql 配置文件解决

@派聪明如何进行挂载

喷喷3.0 ૢ 2026年04月11日 16:49

@派聪明这步具体怎么操作

int main（🥳） 2026年03月23日 19:58

引用原文：访问 hub 后端：http://localhost:8080/actuator/health

这里应该是 http://localhost:7880/actuator/health 下面有截图

头像 2026年03月13日 23:49

! core-agent Warning pull access denied for core-agent, repository does not. docker compose的时候很多显示pull access denied了，这是什么原因呢？

回复1 取消回复

头像 2026年03月14日 00:08

试了一下，docker镜像配置 "registry-mirrors": [ "https://docker.xuanyuan.me" ] 的时候，docker compose 会有interrupt 提示，删除镜像源再下载，不会有interrupt，但是有一部分镜像pull access denied。之后再添加镜像源，重新compose后，没有报错，但是打开127.0.0.1:1881会提示我拒绝连接。。。。。不知道该咋办了

17799176100 2026年03月12日 15:29

引用原文：docker compose up -d

@派聪明 PS D:\.UESTC\java\PaiFlow-main\docker\PaiFlow> docker compose up -d time="2026-03-12T15:29:16+08:00" level=warning msg="D:\\.UESTC\\java\\PaiFlow-main\\docker\\PaiFlow\\ｄｏｃｋｅｒ－ｃｏｍｐｏｓｅ．ｙａｍｌ: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion" [+] up 5/7 ✔ Network paiflow_paiflow-network Created 0.0s ✘ Container paiflow-minio Error dependency minio failed to start 1.3s ✔ Container paiflow-console-frontend Created 0.1s - Container paiflow-mysql Waiting 2.2s - Container paiflow-redis Waiting 2.2s ✔ Container paiflow-core-workflow-java Created 0.1s ✔ Container paiflow-console-hub Created 0.1s dependency failed to start: container paiflow-minio is unhealthy

派聪明 2026年03月12日 15:30

根据错误信息，MinIO 容器启动失败导致整个服务中断。以下是排查和解决方案： --- ### **核心问题** MinIO 容器健康检查失败（`unhealthy`），可能原因包括： 1. **端口冲突**：宿主机 `9000` 或 `9001` 端口被占用（如本地 MySQL/Redis）。 2. **资源不足**：MinIO 启动时内存/CPU 不足。 3. **配置错误**：MinIO 初始化参数问题。 4. **镜像版本兼容性**：使用的 MinIO 镜本可能存在已知问题。 --- ### **解决步骤** #### 1. **检查端口占用** ```bash netstat -ano | findstr ":9000" # Windows lsof -i :9000 # macOS/Linux ``` - 若被占用，修改 `docker-compose.yaml` 中 MinIO 的端口映射： ```yaml ports: - "9001:9000" # 改为其他端口（如 9001:9000, 9002:9001） ``` #### 2. **查看 MinIO 容器日志** ```bash docker logs paiflow-minio ``` - 常见错误： - `FATAL Unable to initialize backend`：存储路径权限问题 → 检查 `volumes` 挂载目录。 - `Connection refused`：端口冲突或资源不足。 #### 3. **调整资源限制** 在 `docker-compose.yaml` 中为 MinIO 添加资源限制： ```yaml minio: image: minio/minio:RELEASE.2025-07-23T15-54-02Z deploy: resources: limits: memory: 512M # 根据实际内存调整 ``` #### 4. **验证 MinIO 配置** - 确保 `.env` 中 MinIO 配置正确： ```env MINIO_ROOT_USER=minioadmin MINIO_ROOT_PASSWORD=minioadmin ``` - 手动测试 MinIO 命令： ```bash docker exec paiflow-minio mc alias set local http://localhost:9000 minioadmin minioadmin ``` #### 5. **更换 MinIO 镜像版本** 若镜像版本问题，尝试其他稳定版本（如 `RELEASE.2024-07-23T15-54-02Z`）： ```yaml minio: image: minio/minio:RELEASE.2024-07-23T15-54-02Z ``` #### 6. **重启服务** ```bash docker compose down docker compose up -d --force-recreate minio # 仅重建 MinIO ``` --- ### **预防措施** - **端口冲突**：部署前关闭本地 MySQL/Redis 或修改端口映射。 - **资源监控**：通过 `docker stats` 观察容器资源使用情况。 - **健康检查优化**：在 `docker-compose.yaml` 中调整 MinIO 健康检查超时时间： ```yaml healthcheck: test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"] interval: 30s timeout: 10s retries: 3 ``` > **提示**：若问题仍存在，尝试在 Windows 上以管理员权限运行 Docker Desktop，避免权限冲突。

要记得常笑哦 2026年03月09日 15:35

引用原文：docker compose up -d --build

拉取很慢，是需要科学上网吗？

腼腆的白昼 2026年02月25日 14:14

为啥ｄｏｃｋｅｒ－ｃｏｍｐｏｓｅ．ｙａｍｌ的前端部分注释了

沉默王二 2026年02月28日 11:06

代码重新提交了。

berlin 2026年02月24日 20:18

哪个源可以直接拉去啊

回复2 取消回复

我是这些"registry-mirrors": [ "https://docker.xuanyuan.me", "https://huecker.io", "https://dockerhub.timeweb.cloud", "https://noohub.ru", "https://docker.m.daocloud.io", "https://dockerproxy.com", "https://hub.rat.dev" ]

展开剩余 1 条回复

嗷呜 2026年02月24日 14:45

gitcode里的docker配置文档怎么把前端相关的注释掉了，我说怎么一直打包不上😭

沉默王二 2026年02月28日 11:09

一、二哥构建

01、后端构建 (Dockerfile.backend)

热门评论

19 条评论

目录

划线评论