设备与安全

设备列表描述账户认识的安装身份和连接状态。设备在线、连接可达、已登录与已建立 E2EE 信任是不同状态。

理解设备状态

• 验证中：App 仍在确认账户或设备状态，不应提前显示未登录或离线。
• 已登录：设备拥有有效账户会话，不代表已经在线。
• 在线：账户目录可以看到设备连接，不代表当前控制请求已经送达。
• 可信：设备身份已经完成信任建立，可以使用受支持的加密控制通道。
• 直连可达：当前 App 可以通过本机、LAN 或自定义地址访问 Local API。

建立信任

首次跨设备连接时，核对 App 与目标 CLI 显示的设备身份或指纹，并在确认目标设备后建立信任。设备名称不能作为单独的信任依据。

生成二维码

开启“新设备确认”后，新设备登录页会生成有时效的 QR Code。

完成确认

使用当前可信 App 扫描新设备上正在显示的代码。

代码失效或不匹配

App 不保存待确认设备列表。代码过期或不匹配时，请在新设备上生成新的代码，再重新扫描。

不能在新设备确认开启时移除最后一台可信 App 设备。需要先关闭新设备确认，或先添加另一台可信设备。

E2EE 边界

设备之间的命令和内容在本机、局域网与账户中继路径上使用端到端加密，服务端不持有设备私钥。服务端仍可看到完成投递所需的元数据，例如设备、消息类型、时间和大小。

账户、预算、订阅及其他必须由服务端处理的数据不属于加密中继通道内容。E2EE 不会隐藏服务端为了提供这些功能而必须处理的数据。

设备密钥丢失后不能从服务端取回私钥。移除设备或轮换身份前，先确认还有其他可信设备可用于新设备确认。

撤销设备

撤销前

确认设备是否仍承担远程智能体、Remote Share 或路由来源。

撤销后

该安装身份需要重新登录和建立信任，才能恢复账户控制能力。

从设备列表撤销远程设备会立即使其退出并移出可信设备。

此操作不会远程删除该设备上的本地数据。当前 App 的“退出并移除此设备”还会删除本机设备密钥。

CLI 本地密钥轮换请使用：

originrouter security status

查看当前设备安全状态。

轮换账户设备身份：

originrouter security rotate

轮换 Local API 访问密钥：

originrouter local key rotate