workbuddy可通过docker-compose.yml一键部署：创建配置文件定义backend、frontend、db服务，确保docker与compose已安装，执行docker-compose up -d启动，再通过浏览器访问localhost:3000及curl验证服务状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望快速部署WorkBuddy服务，Docker Compose提供了一种声明式方式来定义和运行多容器应用。以下是通过docker-compose.yml文件一键启动WorkBuddy的具体操作步骤：
一、准备docker-compose.yml配置文件
该配置文件用于定义WorkBuddy所需的服务组件（如后端API、前端界面、数据库等），并指定各服务的镜像、端口映射、环境变量及依赖关系。正确编写此文件是启动成功的前提。
1、创建一个名为docker-compose.yml的纯文本文件，保存在您计划部署的目录中。
2、将以下内容完整复制粘贴至该文件中：
version: '3.8'
services:
backend:
image: workbuddy/backend:latest
ports:
- "8000:8000"
environment:
- DATABASE_URL=postgresql://workbuddy:password@db:5432/workbuddy
depends_on:
- db
frontend:
image: workbuddy/frontend:latest
ports:
- "3000:3000"
environment:
- API_BASE_URL=http://localhost:8000
db:
image: postgres:15-alpine
environment:
- POSTGRES_DB=workbuddy
- POSTGRES_USER=workbuddy
- POSTGRES_PASSWORD=password
volumes:
- pgdata:/var/lib/postgresql/data
volumes:
pgdata:
二、确保Docker与Docker Compose已就绪
Docker引擎和Docker Compose必须已安装并正常运行，否则无法解析和执行docker-compose.yml文件中的指令。
1、在终端中执行docker --version，确认输出包含Docker版本号。
2、执行docker-compose --version或docker compose version（取决于安装方式），验证Compose可用。
3、若任一命令报错，请先完成Docker Desktop或Docker Engine与Compose插件的安装与启动。
三、执行一键启动命令
该步骤将读取当前目录下的docker-compose.yml，拉取所需镜像（如本地不存在），创建网络、卷，并按依赖顺序启动所有服务。
1、打开终端，切换到存放docker-compose.yml的目录。
2、运行命令：docker-compose up -d。
3、等待终端返回类似Creating network "workbuddy_default" with the default driver及各服务状态为done的提示。
4、执行docker-compose ps，确认backend、frontend、db三者状态均为Up。
四、验证服务可访问性
启动完成后需验证各服务端口是否正常响应，确保HTTP接口与数据库连接通路畅通。
1、在浏览器中访问http://localhost:3000，应加载WorkBuddy前端登录页。
2、在终端中执行curl -I http://localhost:8000/health，返回HTTP状态码200 OK表示后端健康。
3、执行docker-compose exec db psql -U workbuddy -d workbuddy -c "\l"，列出数据库列表以确认PostgreSQL已就绪。
