SuperAPI AI 工具集

omniroute-cli-admin

部署与运维

查看项目

更新于 10-15 21:10

技能介绍

用途:通过 omniroute CLI 管理 OmniRoute 服务器的生命周期与运维。需先安装 omniroute CLI,安装方式与全局参数见 CLI 入口技能。

主要能力: 服务器生命周期:直接运行 omniroute 启动服务(默认端口 20128),omniroute serve 为显式别名,可用 --port 覆盖端口、--no-open 禁止自动打开浏览器、--mcp 以 MCP 服务器(stdio 传输)启动;omniroute stop 停止、omniroute restart 重启;omniroute dashboard(别名 open)打开面板,omniroute status 查看运行状态(运行时长、请求数、提供商)。 初始化:omniroute setup 为交互式向导;非交互式用于 CI/Docker,可传 --password、--add-provider、--provider、--api-key、--test-provider,也可用环境变量 OMNIROUTE_SETUP_PASSWORD、OMNIROUTE_PROVIDER、OMNIROUTE_PROVIDER_NAME、OMNIROUTE_PROVIDER_BASE_URL、OMNIROUTE_API_KEY、OMNIROUTE_DEFAULT_MODEL、DATA_DIR。 诊断:omniroute doctor 执行完整健康检查,支持 --json、--no-liveness、--host、--liveness-url;检查配置、数据库、存储/加密、端口、Node 运行时、原生二进制(better-sqlite3)、内存、服务存活;任一检查失败退出码非零,便于 CI 使用。 备份恢复:omniroute backup 将配置与 SQLite 数据库快照到 ~/.omniroute/backups/;omniroute restore 交互式选择快照恢复。 自启:omniroute autostart enable/disable/status;Linux 创建 systemd 用户服务并启用 linger,桌面会话另加 XDG 自启项(--tray);macOS 用 LaunchAgent plist;Windows 用注册表启动项。 隧道:omniroute tunnel list/create/stop,支持 cloudflare、tailscale、ngrok,隧道 URL 可作为远程机器的 OMNIROUTE_BASE_URL。 配置与环境:omniroute config show、env show/get/set(set 为临时,重启失效)。 恢复:omniroute reset-password 重置管理员密码;omniroute reset-encrypted-columns 先干跑,--force 会清空 SQLite 中加密凭据,仅在 STORAGE_ENCRYPTION_KEY 丢失时使用。 日志:omniroute logs 支持 --json、--search、--follow。更新:omniroute update 检查新版本并提示更新。

限制与排错:doctor 提示 STORAGE_ENCRYPTION_KEY 缺失时,需在 .env 设置或执行 reset-encrypted-columns --force 后重新录入凭据;原生二进制失败时在应用目录执行 npm rebuild better-sqlite3;cloudflare 隧道卡住需先安装 cloudflared(brew install cloudflare/cloudflare/cloudflared)。