Workbuddy本地一键部署需四步：一、验证系统架构及curl/tar/Docker/docker-compose v2；二、下载执行签名安装脚本并以prod模式运行；三、离线环境用校验后的离线包解压后launch.sh启动；四、放证书、配域名、重启容器启用HTTPS。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地环境中快速部署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 提示。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、通过离线包方式部署（无外网环境）
当目标服务器无法访问公网时，可预先下载完整离线包，解压后直接启动，所有镜像与配置均已封装在归档内，不触发任何远程拉取行为。
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。
