主机生成配对码
包含主机 Noise 静态公钥、指纹、一次性 pair code 和传输线路;默认 5 分钟过期,可生成只读配对码。
SECURITY MODEL
手机和主机之间始终是 Noise NK 端到端加密。中继与主机、手机之间再用 Noise NK 完成身份认证和控制帧保护;TLS 是可选的额外传输层。中继只把应用数据当作密文转发,并暴露必要的路由元数据。
opencode 只绑定 127.0.0.1。主机端读取本机注册信息和密码,手机不接触 opencode 密码。
| 观察点 | 直连 | 中继 |
|---|---|---|
| 手机 ↔ 主机应用数据 | Noise NK 密文 | Noise NK 密文 |
| 传输层 | ws://,仅局域网 | ws:// + Noise NK 认证;可选 wss:// TLS |
| 中继可见 | — | 房间、subject 身份、连接时间、帧大小 |
| 中继不可见 | — | 提示词、回复、工具输入输出、文件内容 |
| opencode 密码 | 只留在主机 | 只留在主机 |
包含主机 Noise 静态公钥、指纹、一次性 pair code 和传输线路;默认 5 分钟过期,可生成只读配对码。
手机显示主机指纹,和电脑上的输出逐段核对,避免连接到伪装的主机。
主机只保存 token 哈希和设备范围;手机把 token 保存在 Android SecureStore。
X25519 临时密钥完成 Noise NK 握手,之后所有 OCRP 控制帧和代理负载都在受保护记录内。
这套模型保护的是手机到主机之间的应用数据。它不试图防御已经失去控制权的电脑,也不隐藏中继需要的路由元数据。
| 数据 | 位置 | 保护方式 |
|---|---|---|
| 主机 Noise 私钥 | ~/.config/ocremote/identity.json | 文件权限 0600,不离开主机 |
| 设备令牌 | 手机 SecureStore;主机保存哈希 | 可单独撤销设备 |
| 中继 subject secret | 手机 SecureStore;中继保存哈希 | 长期有效,可 revoke |
| 中继手机邀请 | 一次性 phone invite | 绑定 room,使用后失效,默认短时有效 |
| 中继 Noise 静态私钥 | data/relay-identity.json | 0600;主机通过 /v1/info 获取并固定公钥,用于固定中继身份 |
| 可选 TLS 私钥 | 运维提供的证书路径 | 仅启用 wss 时使用,中继不自动生成 CA |
admin revoke 释放名额。
| 构建 | application id | 可选 TLS 信任 |
|---|---|---|
| Release | app.ocremote.android | Android 系统 CA 库 |
| QA | app.ocremote.android.qa | 系统 CA + 开发测试 CA |
Noise NK 不需要 CA,所有构建都能直接使用。只有启用 wss:// 且使用自签证书时,才需要把 CA 安装到 Android 系统信任库,或改用公共 CA 签发的证书。