Workbuddy一键安装教程详解

本文详细介绍了Workbuddy在本地环境的一键部署全流程，涵盖从系统依赖验证、在线脚本安装、离线包部署到HTTPS域名配置的四大核心步骤，兼顾新手友好性与企业级生产需求，尤其适合缺乏标准化安装经验但追求快速、安全、可控落地的技术用户——无论你身处受限网络还是需要对接自有域名，都能通过清晰指令和签名校验实现开箱即用。

如果您希望在本地环境中快速部署Workbuddy应用，但缺乏标准化安装引导，则可能是由于缺少清晰的初始化步骤与依赖配置指引。以下是完成Workbuddy一键安装的具体流程：

一、验证系统环境与前置依赖

Workbuddy依赖特定版本的运行时环境与工具链，安装前需确认基础组件已就位，避免后续构建失败。缺失任一依赖将导致脚本中断或服务无法启动。

1、打开终端，执行 uname -m 确认架构为 x86_64 或 aarch64。

2、运行 curl --version 和 tar --version 验证 curl 与 tar 已预装。

3、检查 Docker 是否可用：输入 docker version --format '{{.Server.Version}}'，输出应为有效版本号。

4、确认 docker-compose v2.x 已集成：执行 docker compose version，返回结果中包含 version v2 字样。

二、获取官方安装脚本并执行

Workbuddy 提供了经签名验证的 shell 安装器，该脚本自动拉取镜像、生成配置、启动容器组，无需手动编辑 YAML 文件。

1、使用 curl 下载安装脚本：curl -fsSL https://get.workbuddy.dev/install.sh -o install.sh。

2、赋予执行权限：chmod +x install.sh。

3、以非 root 用户运行安装器：./install.sh --mode=prod。

4、等待终端输出 [SUCCESS] Workbuddy containers are up and running 提示。

三、通过离线包方式部署（无外网环境）

当目标服务器无法访问公网时，可预先下载完整离线包，解压后直接启动，所有镜像与配置均已封装在归档内，不触发任何远程拉取行为。

1、在联网机器上执行：curl -fLO https://releases.workbuddy.dev/workbuddy-offline-v2.4.0.tar.gz。

2、校验 SHA256 值：sha256sum workbuddy-offline-v2.4.0.tar.gz，比对官网公布的哈希值是否一致。

3、将压缩包复制至目标服务器，解压：tar -xzf workbuddy-offline-v2.4.0.tar.gz。

4、进入解压目录，运行：./launch.sh --skip-pull。

四、启用 TLS 并绑定自定义域名

安装完成后默认使用 HTTP，若需启用 HTTPS 并接入已有域名，可通过内置 Nginx 反向代理模块注入证书，无需额外安装 Traefik 或 Caddy。

1、将 fullchain.pem 与 privkey.pem 放入 ./certs/ 目录。

2、修改 ./config/nginx/conf.d/default.conf 中的 server_name 行为实际域名。

3、重启服务组：docker compose down && docker compose up -d。

4、验证 HTTPS 可达：curl -I https://your-domain.com --insecure | head -1 应返回 HTTP/2 200。

到这里，我们也就讲完了《Workbuddy一键安装教程详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！