OmniRoute 修复

问题

omniroute.service 启动后卡在 ⏳ Starting server...,一直不完成。

根因

~/.omniroute/server/.pid 文件残留(含有旧进程 PID),导致 OmnIRoute 认为服务已在运行,跳过初始化流程。

同时 storage.sqlite.probe-failed-* 文件表明前一次启动时健康检查失败但未清理。

修复

  1. systemctl --user stop omniroute.service
  2. rm -f ~/.omniroute/storage.sqlite.probe-failed-*
  3. rm -rf ~/.omniroute/server/
  4. systemctl --user start omniroute.service

结果

✔ OmniRoute is running! (started in 5.2s)
  Dashboard:  http://${LOCALIP}:20128
  API Base:   http://${LOCALIP}:20128/v1

状态

  • 服务已运行 ✅
  • 99 个模型可用(auto/best-free、ddgw/gpt-4o-mini 等)
  • 需要 onboarding:首次使用需在 dashboard 配置 provider keys
  • 未配置前 API 调用返回空响应

下一步

需要时在浏览器打开 http://${LOCALIP}:20128/login 点 Start Onboarding 配置。

2026-10-09 Codex 审阅说明

已纠正 unit 名拼写。删除 SQLite/目录的命令是当时修复记录,不是通用可逆修复;复用前需确认数据作用与备份。模型目录返回 99 个条目只证明列举成功,不等于全部可调用或免费。