为保障WorkBuddy后端高可用，需配置健康检查：一、Apache用mod_proxy_hcheck设/helthz路径、15秒间隔；二、Nginx通过upstream_check_module配/ping路径、10秒间隔；三、腾讯云CLB控制台设/health路径、10秒间隔；四、宝塔环境用脚本+systemd动态管理后端状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在部署 WorkBuddy 时需确保其后端服务的高可用性，则必须为负载均衡器配置有效的健康检查机制。健康检查通过定期探测后端实例状态，自动隔离异常节点，防止流量转发至不可用服务。以下是针对 WorkBuddy 部署场景配置健康检查路径与频率的具体方法：
一、使用 Apache mod_proxy_hcheck 配置 HTTP 健康检查
Apache 2.4.33+ 支持 mod_proxy_hcheck 模块，可对 WorkBuddy 后端节点执行主动 HTTP 探测，适用于部署在 Apache 反向代理层的场景。该方式无需修改应用代码，仅通过配置即可生效。
1、确认已启用必要模块：加载 mod_proxy、mod_proxy_balancer 和 mod_proxy_hcheck。
2、在
3、设置 hcmethod=HTTP 表示采用 HTTP 请求探测；
4、设置 hcuri=/healthz 作为检查路径——该路径需由 WorkBuddy 应用暴露并返回 2xx 状态码；
5、设置 hcinterval=15 表示每 15 秒执行一次探测，兼顾及时性与后端压力；
6、设置 hcfail=3 和 hcpass=2，即连续 3 次失败标记为 down、连续 2 次成功恢复为 up，避免因瞬时抖动误判。
二、在 Nginx 中通过 upstream_check_module 启用主动健康检查
Nginx 原生不支持主动健康检查，但可通过第三方模块 nginx_upstream_check_module 实现。该方式适用于 WorkBuddy 部署在 Nginx 反向代理后、且已编译该模块的环境，支持 TCP 或 HTTP 层探测。
1、确认 Nginx 已编译支持 upstream_check：执行 nginx -V 2>&1 | grep -o 'upstream_check'，有输出即表示可用；
2、在 http 块顶部添加 upstream 定义，包含 check 指令：
3、设置 check interval=10 rise=2 fall=3 timeout=3 type=http，其中 interval=10 表示每 10 秒探测一次；
4、设置 check_http_send "HEAD /ping HTTP/1.0\r\n\r\n"，使用 HEAD 方法降低开销；
5、设置 check_http_expect_alive http_2xx，要求响应状态码为 2xx 才视为健康；
6、保存配置后执行 nginx -t && nginx -s reload 生效。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、通过腾讯云 CLB 控制台配置弹性负载均衡健康检查
若 WorkBuddy 部署于腾讯云 CVM 实例并使用 CLB（Cloud Load Balancer），应直接在控制台配置健康检查参数。该方式无需修改服务器配置，由 CLB 侧统一管理，适合云原生部署场景。
1、登录腾讯云控制台，进入【弹性负载均衡 > 负载均衡器】页面；
2、单击目标 CLB 实例名称，进入详情页；
3、选择【后端服务器组】页签，点击目标服务器组后的【设置】按钮；
4、在健康检查配置中，将 检查路径 设为 /health，确保 WorkBuddy 应用已实现该端点并返回 200；
5、将 检查间隔 设为 10 秒，健康阈值 设为 2 次，不健康阈值 设为 3 次；
6、协议选择 HTTP，端口填写 WorkBuddy 实际监听端口（如 8080）；
7、单击【确定】完成配置。
四、在宝塔面板 Nginx 配置中嵌入自定义健康检查脚本
当无法使用 upstream_check 模块或云平台 CLB 时，可在宝塔环境中部署轻量级外部健康检查脚本，通过修改 Nginx upstream 的 server 状态实现故障剔除。该方式依赖系统级脚本，灵活性高，适用于私有化部署。
1、在服务器上创建检查脚本 /opt/workbuddy_health.sh，内容为 curl -I -s http://127.0.0.1:8080/health | head -n1 | grep "200 OK"；
2、赋予执行权限：chmod +x /opt/workbuddy_health.sh；
3、配置 systemd 服务文件 /etc/systemd/system/workbuddy-check.service，设置 ExecStart=/opt/workbuddy_health.sh 并启用定时器；
4、脚本检测失败时，自动写入临时文件 /tmp/backend_down，Nginx 配置中通过 map 指令读取该文件状态；
5、在 upstream 块中使用 server 192.168.1.10:8080 down; 指令动态注释对应后端；
6、每次脚本运行后触发 nginx -s reload 重载配置。
