OriginRouter App连接 CLI
连接 OriginRouter CLI
App 可以通过本机直连、局域网或自定义地址、账户中继三种方式连接 CLI。三种方式可以同时存在,App 使用稳定设备 ID 合并同一台设备。
本机直连
适用于桌面 App 控制当前电脑的场景,无需登录账户。
首次安装
尚未安装 CLI 时,先完成CLI 概览与安装中的安装和 originrouter setup。
已有安装
已有安装只需确认服务处于运行状态。
originrouter service status
originrouter local config show
originrouter local key show
按顺序执行:确认服务运行状态、查看 Local API 地址和端口,最后检查本机设备密钥。
桌面 App 默认尝试 127.0.0.1:7437。如果服务在线但没有连接,检查 Local API 端口和设备密钥是否匹配。
局域网或自定义地址
仅当 App 不在目标 CLI 所在电脑上、且两台设备位于同一可信网络时,才需要这一步。在目标 CLI 所在电脑的终端执行:--bind 0.0.0.0 让 Local API 监听网卡,--allow-lan on 允许局域网连接;两者缺一不可,设备密钥验证仍然有效。
originrouter local config set --bind 0.0.0.0 --allow-lan on
originrouter service restart
随后在 App 中添加目标 IP、域名与端口。App 会连接并验证设备 ID,验证失败时不会静默合并到已有设备。完成连接后,如果不再需要局域网访问,可在 CLI 执行 originrouter local config set --allow-lan off。
账户中继
适合手机、异地网络或没有可直连地址的设备:
originrouter login
originrouter remote setup
originrouter service status
按顺序执行:登录账户、登记远程能力,最后确认服务状态。
目标 CLI
目标 CLI 应已完成CLI 概览与安装中的 originrouter setup。
连接前确认
- App 和 CLI 已登录同一账户。
- 目标 CLI 在线,并已进入可信设备目录。
- 执行
remote setup前,已在“模型服务控制”中启用要共享的模型,并允许远程使用。
账户中继的职责
账户中继负责认证、路由与密文投递,不替代 CLI 执行命令或审批策略。
成功判据
- App 只显示一台合并后的目标设备,而不是重复的本机与账户设备。
- 设备详情能显示 CLI 版本和至少一条可用连接路径。
- 模型服务控制能够读取目标设备快照。
- 智能体控制能够加载该设备的活动或历史会话。