如何使用Docker Compose一键启动WorkBuddy？配置文件样例

一、准备docker-compose.yml配置文件

万事开头先备好“图纸”。这个docker-compose.yml文件，就是整个WorkBuddy服务栈的蓝图。它把后端API、前端界面、数据库这几个核心组件，以及它们之间的端口、环境变量和启动依赖关系，都清清楚楚地定义好了。文件写得对不对，直接决定了后面能不能一键跑起来。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

操作起来很简单：在你打算部署的目录里，新建一个名为docker-compose.yml的纯文本文件。然后，把下面这段配置内容原封不动地复制进去：

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 --version，看看是否输出了Docker的版本号。再敲docker-compose --version（或者docker compose version，取决于你的安装方式），确认Compose插件也可用。

如果哪个命令提示“未找到”，那就得先回头把Docker Desktop或者Docker Engine连同Compose插件安装配置好。这是基础，绕不过去。

三、执行一键启动命令

基础打牢，接下来就是见证“一键化”魔力的时刻。这个步骤会读取当前目录下的配置文件，自动完成拉取镜像、创建网络和存储卷，并按照依赖关系依次启动所有服务。

具体操作：打开终端，切换到存放docker-compose.yml的那个目录。然后，运行核心命令：docker-compose up -d。

稍等片刻，终端会滚动显示创建网络、拉取镜像、启动容器的过程。当你看到各服务后面出现done的状态提示，就差不多了。为了保险起见，可以再运行docker-compose ps检查一下，确认backend、frontend和db三个服务的状态都是Up。这就表示所有容器都在后台正常运行起来了。

四、验证服务可访问性

容器跑起来了，不代表服务就一定可用。最后这一步验证是关键，确保各个端口都能正常响应，服务之间也能通联。

通常分三步走：

首先，打开浏览器，访问http://localhost:3000。如果WorkBuddy的前端登录页面能加载出来，前端服务就算妥了。

接着，在终端里用curl -I http://localhost:8000/health这个命令探一下后端。如果返回200 OK的HTTP状态码，说明后端健康检查接口是通的。

最后，验证数据库。执行命令docker-compose exec db psql -U workbuddy -d workbuddy -c "\l"，它能连接到容器内的PostgreSQL并列出数据库。如果能看到workbuddy库在列表中，就证明数据库服务也准备就绪了。

走完这四步，从配置、检查环境、启动到验证，一个完整的WorkBuddy服务栈就已经通过Docker Compose在本地部署完成了。整个过程清晰连贯，几乎是“开箱即用”的体验。