Workbuddy Linux部署需依次完成环境检查、Docker及Compose安装、克隆部署仓库、配置数据库与JWT密钥、最后启动容器集群；各步骤缺一不可，须严格按序执行以确保服务正常运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您需要在 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 端口。
