技能介绍

要解决什么问题

FreeLLMAPI 作为本地 LLM 代理网关，在 Windows 上长期跑不稳：npm install 可能因 better-sqlite3 原生编译失败而中断、React 面板未构建导致 client/dist/index.html 缺失、进程崩溃后无人拉起。另一个痛点是登录 Windows 后弹出的黑色 CMD 窗口——旧的 .cmd 启动脚本每次开机都会闪一下。这个技能把进程守护、崩溃恢复、静默启动三件事整理成一套可复用的运维流程。

核心能力与关键步骤

PM2 进程守护：通过 ecosystem.config.cjs 启动服务，进程崩溃时按指数退避自动重启。注意不要在 ecosystem 配置里设 NODE_ENV=production，否则服务端强制要求 64 字符 hex 的 ENCRYPTION_KEY，缺失就直接拒绝启动。

开机复活：pm2 save 把进程列表写入 ~/.pm2/dump.pm2，守护进程重启后执行 pm2 resurrect 即可恢复。Windows 没有 init 系统，pm2 startup 不可用，改用 Startup 文件夹里的 VBS 脚本，用 Run(..., 0, False) 做到完全隐藏窗口。

密钥管理：ENCRYPTION_KEY 以 AES-GCM 加密 api_keys 表里的上游凭据。一旦数据落库再更换 key，所有加密的 API key 都会失效，只能去面板重新录入。

适用边界与注意点

443 端口桥接不归 PM2 管：Codex WSS bridge 需要管理员权限，只能通过 PowerShell RunAs 手动拉起，进程消失后没有自动恢复机制。
系统代理是头号杀手：Windows 系统代理会劫持 DNS 解析，绕过本地 hosts 和 bridge，agent 域名必须全部加进 ProxyOverride，改完要重启 agent 进程才生效。
统一 key 会静默轮换：账号体系启用后 unified_api_key 可能失效，客户端一律使用账号在面板生成的 API key。
本技能仅覆盖 PM2 运维环节，不涉及上游 provider 的路由策略与限流配置。