Linux部署教程：高效上手指南

本文详细介绍了在 Linux 系统上从零部署 Workbuddy 应用的完整流程，涵盖环境检查、Docker 与 Compose 安装、代码仓库克隆、数据库与 JWT 密钥等关键配置，以及最终容器集群的启动与验证；步骤严谨、环环相扣，既适合初学者按图索骥快速上手，也为运维人员提供了可复现、高可靠的一站式部署指南。

如果您需要在 Linux 系统上部署 Workbuddy 应用，则需完成环境准备、依赖安装、服务配置与启动等关键环节。以下是完成 Workbuddy Linux 部署的详细步骤：

一、确认系统环境与基础依赖

Workbuddy 要求运行在具备特定内核版本与基础工具链的 Linux 发行版上，确保系统满足最低运行条件是部署成功的前提。缺失必要组件可能导致后续构建失败或服务无法启动。

1、执行 uname -r 检查内核版本，确认不低于 4.15。

2、运行 lsb_release -a 或 cat /etc/os-release 查看发行版信息，支持 Ubuntu 20.04+、Debian 11+、CentOS 8+（含 Stream）及 Rocky Linux 8+。

3、使用 apt update && apt install -y curl wget git gnupg2 ca-certificates（Debian/Ubuntu）或 dnf install -y curl wget git gnupg2 ca-certificates（RHEL/CentOS/Rocky）安装基础工具。

二、安装并配置 Docker 与 Docker Compose

Workbuddy 官方推荐以容器化方式部署，Docker 提供隔离运行时环境，Docker Compose 管理多服务编排。跳过此步将无法拉取镜像或启动核心服务。

1、执行 curl -fsSL https://get.docker.com | sh 下载并安装 Docker 社区版。

2、运行 systemctl enable --now docker 启用并启动 Docker 服务。

3、下载 Docker Compose 二进制文件：curl -L "https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose。

4、赋予可执行权限：chmod +x /usr/local/bin/docker-compose，并验证：docker-compose version。

三、获取 Workbuddy 部署资源

官方未提供预编译安装包，必须通过 Git 克隆标准部署仓库以获得最新 docker-compose.yml、环境变量模板及配置目录结构。

1、创建部署目录：mkdir -p /opt/workbuddy && cd /opt/workbuddy。

2、克隆官方部署仓库：git clone https://github.com/workbuddy-org/deploy.git .（注意末尾点号）。

3、检查关键文件是否存在：ls -l docker-compose.yml .env.example config/，确认三项均存在。

4、复制环境模板：cp .env.example .env，后续将在此文件中填写数据库地址、JWT 密钥等敏感参数。

四、配置数据库与服务参数

Workbuddy 依赖 PostgreSQL 存储业务数据，且需通过 .env 文件显式声明连接信息与运行时行为，错误配置将导致服务启动后立即退出。

1、编辑环境文件：nano .env。

2、修改 DB_HOST=postgres 为实际 PostgreSQL 服务地址；若复用容器内网，保持默认即可。

3、设置 DB_PORT=5432、DB_NAME=workbuddy、DB_USER=wbuser、DB_PASSWORD=strong_password_here，确保与 PostgreSQL 初始化凭据一致。

4、生成并填入 JWT_SECRET 字段：执行 openssl rand -hex 32，将输出结果完整粘贴至该字段值位置。

五、启动 Workbuddy 容器集群

在配置就绪后，Docker Compose 将依据 docker-compose.yml 拉取镜像、创建网络、初始化数据库并启动应用服务与反向代理，所有服务需同步就绪才能对外提供访问。

1、执行 docker-compose up -d --build 启动全部服务（首次运行会自动构建前端镜像）。

2、查看服务状态：docker-compose ps，确认 app、postgres、nginx 三列状态均为 Up。

3、检查应用日志：docker-compose logs -f app，等待出现 Server listening on port 3000 提示后停止跟踪。

4、验证端口监听：ss -tlnp | grep ':80\|:443'，确认 nginx 容器已绑定主机 80/443 端口。

到这里，我们也就讲完了《Linux部署教程：高效上手指南》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！