需满足操作系统、硬件、依赖、权限及网络五方面要求：确认内核≥5.4、发行版匹配、macOS≥12；内存≥2GB、磁盘≥5GB、CPU≥2核；OpenSSL≥1.1.1f、SQLite3≥3.30.0、glibc≥2.31；配置非root用户权限与端口绑定能力；确保config.workbuddy.dev:443可达。
如果您计划在本地系统中安装 workbuddy 应用，则需确保硬件、操作系统及依赖组件满足其运行所需的最低配置。以下是完成安装前必须执行的准备工作：
一、确认操作系统兼容性
Workbuddy 当前仅支持特定版本的操作系统，不兼容旧内核或非标准发行版。安装前需验证当前系统是否在官方支持列表中，避免因内核版本过低或 ABI 不匹配导致服务无法启动。
1、打开终端，输入 uname -r 查看 Linux 内核版本，确认不低于 5.4。
2、执行 cat /etc/os-release 检查发行版名称与版本号，确保为 Ubuntu 20.04/22.04、Debian 11/12 或 CentOS Stream 9。
3、若使用 macOS，运行 sw_vers，确认系统版本不低于 macOS 12 (Monterey)。
二、检查硬件资源可用性
Workbuddy 后端服务对内存与磁盘 I/O 较为敏感，资源不足将引发进程崩溃或响应超时。安装前须确保物理资源未被其他高负载服务长期占用。
1、执行 free -h 查看可用内存，确保空闲 RAM ≥ 2GB（推荐 ≥ 4GB）。
2、运行 df -h / 检查根分区剩余空间，确保 ≥ 5GB 可用容量。
3、输入 lscpu | grep 'CPU\(s\)' | head -2 确认逻辑 CPU 核心数 ≥ 2。
三、验证必要运行时依赖
Workbuddy 依赖特定版本的 OpenSSL、SQLite3 和 GLIBC，缺失或版本错配将导致二进制加载失败。需逐项校验并补全缺失组件。
1、执行 openssl version，确认输出版本号 ≥ 1.1.1f。
2、运行 sqlite3 --version，确保版本 ≥ 3.30.0。
3、输入 ldd --version 并比对 glibc 版本，Linux 系统要求 ≥ 2.31。
四、配置非 root 用户执行权限
Workbuddy 安装脚本默认拒绝以 root 身份运行，且需目标用户具备对安装目录的读写权限及网络绑定能力（如监听 8080 端口）。须提前完成用户权限适配。
1、执行 whoami 确认当前登录用户名。
2、运行 getent group netdev，若无输出则需创建 netdev 组并添加当前用户。
3、使用 sudo setcap 'cap_net_bind_service=+ep' /usr/bin/python3 授予 Python 绑定特权端口能力（如需监听 80/443）。
五、预置网络访问策略
Workbuddy 初始化阶段需从指定域名拉取配置模板与证书链，防火墙或代理策略若拦截相关 HTTPS 请求，将中断安装流程。须开放对应出站连接。
1、执行 curl -I https://config.workbuddy.dev/health 测试基础连通性，HTTP 状态码应为 200。
2、运行 timeout 5 nc -zv config.workbuddy.dev 443 验证 TLS 端口可达性。
3、若企业环境启用透明代理，需设置 export HTTPS_PROXY=http://proxy.internal:3128 并验证代理连通性。
