workbuddy安装失败因内核参数不满足要求，需修改/etc/sysctl.conf：一、增大somaxconn至65535、file-max至2097152等；二、调tcp_fin_timeout为30、启用tcp_tw_reuse；三、设swappiness=10、overcommit_memory=1、vfs_cache_pressure=50。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试安装WorkBuddy，但安装脚本报错“内核参数不满足要求”或“系统参数低于阈值”，则很可能是Linux系统中部分关键内核参数未达到WorkBuddy运行所需的最小值。WorkBuddy在初始化阶段会校验net.core.somaxconn、net.ipv4.tcp_fin_timeout、fs.file-max等参数，若任一值过低，将中止安装流程。以下是修改sysctl.conf以优化相关参数的具体操作：
一、增大连接队列与文件句柄上限
WorkBuddy依赖高并发短连接处理能力，需提升套接字最大连接数（somaxconn）和系统级最大打开文件数（file-max），否则在服务启动初期即因资源不足而失败。
1、以root权限编辑系统配置文件：sudo nano /etc/sysctl.conf
2、在文件末尾追加以下四行配置：
net.core.somaxconn = 65535
fs.file-max = 2097152
net.ipv4.ip_local_port_range = 1024 65535
net.core.netdev_max_backlog = 5000
3、执行命令使配置立即生效：sudo sysctl -p
4、验证修改结果：sysctl net.core.somaxconn fs.file-max，输出值应与上述设定一致。
二、调整TCP连接回收与重用策略
WorkBuddy客户端与后端服务间存在高频建连/断连行为，若tcp_fin_timeout过长或tcp_tw_reuse禁用，会导致TIME_WAIT连接堆积，耗尽可用端口，触发安装校验失败。
1、继续在/etc/sysctl.conf中添加以下两行：
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
net.ipv4.tcp_fin_timeout = 30
net.ipv4.tcp_tw_reuse = 1
2、再次运行加载命令：sudo sysctl -p
3、检查当前TCP状态分布：ss -s | grep "TCP:"，确认time-wait连接数不再持续攀升。
三、优化内存与虚拟内存管理参数
WorkBuddy在加载模型与缓存索引时对内存分配响应敏感，vm.swappiness过高或vm.overcommit_memory设置不当，易导致mmap失败或OOM Killer误杀进程，被安装脚本识别为内核环境不可靠。
1、在/etc/sysctl.conf中补充以下三行：
vm.swappiness = 10
vm.overcommit_memory = 1
vm.vfs_cache_pressure = 50
2、执行sudo sysctl -p应用变更。
3、确认生效：cat /proc/sys/vm/swappiness应返回10，cat /proc/sys/vm/overcommit_memory应返回1。
