SECURITY MODEL

中继可以转发,
但不能读懂。

手机和主机之间始终是 Noise NK 端到端加密。中继与主机、手机之间再用 Noise NK 完成身份认证和控制帧保护;TLS 是可选的额外传输层。中继只把应用数据当作密文转发,并暴露必要的路由元数据。

谁看见什么。

opencode 只绑定 127.0.0.1。主机端读取本机注册信息和密码,手机不接触 opencode 密码。

ANDROID手机端设备令牌 · 会话内容
LOCALHOST主机端opencode 密码 · 令牌哈希
中继:房间 / 身份 / 时间 · 应用数据为密文
观察点直连中继
手机 ↔ 主机应用数据Noise NK 密文Noise NK 密文
传输层ws://,仅局域网ws:// + Noise NK 认证;可选 wss:// TLS
中继可见—房间、subject 身份、连接时间、帧大小
中继不可见—提示词、回复、工具输入输出、文件内容
opencode 密码只留在主机只留在主机
01

主机生成配对码

包含主机 Noise 静态公钥、指纹、一次性 pair code 和传输线路;默认 5 分钟过期,可生成只读配对码。

02

手机核对指纹

手机显示主机指纹,和电脑上的输出逐段核对,避免连接到伪装的主机。

03

主机返回设备令牌

主机只保存 token 哈希和设备范围;手机把 token 保存在 Android SecureStore。

04

每次连接重新握手

X25519 临时密钥完成 Noise NK 握手,之后所有 OCRP 控制帧和代理负载都在受保护记录内。

密钥在哪里,
边界在哪里。

这套模型保护的是手机到主机之间的应用数据。它不试图防御已经失去控制权的电脑,也不隐藏中继需要的路由元数据。

数据位置保护方式
主机 Noise 私钥~/.config/ocremote/identity.json文件权限 0600,不离开主机
设备令牌手机 SecureStore;主机保存哈希可单独撤销设备
中继 subject secret手机 SecureStore;中继保存哈希长期有效,可 revoke
中继手机邀请一次性 phone invite绑定 room,使用后失效,默认短时有效
中继 Noise 静态私钥data/relay-identity.json0600;主机通过 /v1/info 获取并固定公钥,用于固定中继身份
可选 TLS 私钥运维提供的证书路径仅启用 wss 时使用,中继不自动生成 CA
中继仍能看到谁在什么时候连接、房间大小和流量模式。Noise 保护的是应用负载,不是元数据匿名性。开放主机登记受默认 3 台主机、每房间 3 台手机的上限约束,可用 admin revoke 释放名额。
构建application id可选 TLS 信任
Releaseapp.ocremote.androidAndroid 系统 CA 库
QAapp.ocremote.android.qa系统 CA + 开发测试 CA

Noise NK 不需要 CA,所有构建都能直接使用。只有启用 wss:// 且使用自签证书时,才需要把 CA 安装到 Android 系统信任库,或改用公共 CA 签发的证书。

中继认证与 TLS 排查 →