OriginRouter CLI服务与后台进程

服务与后台进程

后台进程负责保持 Local API、远程控制连接和需要脱离当前终端继续运行的任务。系统服务命令让它在当前用户登录后自动启动，因此 App 和其他 CLI 客户端无需一直占用一个终端窗口。

首次安装或修改服务配置后，使用 originrouter service install 和 originrouter service start 将后台进程交由系统运行。需要临时调试或查看前台日志时，再直接运行 originrouter daemon。

仅需确认服务是否在线或设备是否已连接时，可在 App 中查看状态。安装、绑定、重启或排查后台进程时，请使用 CLI 命令；连接流程见App 连接 CLI。

在当前终端运行后台进程

originrouter daemon

参数	用途
`--relay <url>`	设置中继服务地址
`--relay-mode auto\|cloud\|local\|custom`	选择中继来源；`auto` 在登录后使用认证云连接，否则保持本地
`--device <device-id>`	覆盖设备标识
`--local-port <port>`	设置 Local API 端口
`--bind 127.0.0.1\|0.0.0.0`	设置监听地址
`--allow-lan`	明确允许局域网访问

默认应使用回环地址。仅在网络可信、Local API 访问令牌有效且确实需要让其他设备连接时，才绑定 0.0.0.0。

originrouter daemon-port 从 daemon.state.json 读取正在运行的 Local API 地址。它找不到运行状态时返回非零状态，并提示先启动后台进程。

originrouter service install
originrouter service start
originrouter service status

按顺序执行：

支持的动作是 install、start、stop、restart、status 和 uninstall。每个动作都支持 --dry-run，用于在不写入系统配置的情况下检查将要执行的命令。

服务机制

服务按平台使用当前用户范围的系统机制。

安装与启动

安装服务后，再运行 service start 启动后台进程。

自动启动

“开机启动”实际是当前用户登录或用户会话启动时启动：macOS 使用 LaunchAgent，Linux 使用 systemctl --user，Windows 使用登录触发的任务。它不等同于系统启动阶段的 root 服务。

卸载影响

卸载会删除服务配置，但不会自动删除账户、模型服务、路由或会话数据。

originrouter local config show
originrouter local config set \
  --port 43110 \
  --bind 127.0.0.1 \
  --allow-lan off \
  --relay-mode auto

先使用 local config show 查看当前值，再根据需要执行 local config set；修改后重启服务使配置生效。

可用设置包括 --port、--bind、--allow-lan on|off、--relay-mode auto|cloud|local|custom 和 --relay-url。修改后重启服务，再用 daemon-port 和 App 连接状态确认结果。

命令	运行方式
`claude [args...]`	原生 Claude Code TUI，加上 OriginRouter 远程控制
`codex [args...]`	原生 Codex TUI，加上 OriginRouter 远程控制
`claude-terminal` / `claude-sdk`	托管 Claude 智能体 SDK 会话
`codex-terminal` / `codex-app-server`	托管 Codex app-server 会话
`run -- <command>`	在 OriginRouter 包装层中运行普通子进程，并传播子进程退出状态

--native-config 会保留原生智能体的认证、模型、环境和配置，只增加远程控制。

如果一次协作运行已经交给后台服务管理，本地终端断开不代表它已停止。先恢复服务，再运行 collaboration show 或 attach 检查实际状态。