Remodex安全设计完全解析6步搞懂iPhone远程控制Codex的端到端加密X25519握手、AES-256-GCM与防重放【免费下载链接】remodexRemote Control for Codex.项目地址: https://gitcode.com/gh_mirrors/re/remodexRemodex是一款让 iPhone 无线远程控制 Mac 上 Codex 的开源本地优先工具它用一套自研的端到端加密E2EE通道保护你在路上发出的每一条指令。本文将带你拆解 Remodex 安全设计的三大核心X25519 密钥协商握手、AES-256-GCM 加密信封以及多层防重放机制——即使中继服务器看到你的流量也拿不到一比特明文。为什么远程控制需要端到端加密Remodex 的工作方式很直接Codex 运行时留在你的 Mac 上iPhone 通过一个中继relay建立 WebSocket 连接进行远程操控。这里有个朴素的问题中继服务器会不会看到我的提示词、工具调用和 git 输出答案写在 relay/README.md 里——中继只是运输跳板不是可信应用服务器✅ 安全会话建立后中继收不到任何明文应用负载⚠️ 中继仍能看到连接元数据和握手控制消息会话 ID、设备 ID、公钥、nonce 提示词、工具调用、Codex 响应、git 输出全部端到端加密iPhone 上的 Remodex 会话界面底部标注 Chats are End-to-end encrypted.png)安全通道的 6 个建立步骤整个加密会话由 6 步构成对应 README.md 中的Security and Privacy章节实现集中在 secure-transport.js步骤发生了什么为什么重要1️⃣ 生成身份密钥桥端在 Mac 上生成并持久化一对Ed25519长期身份密钥设备的身份证用于后续签名认证2️⃣ 展示配对二维码二维码携带中继地址、会话 ID、桥端设备 ID、身份公钥、过期时间首次配对的信任锚点5 分钟自动过期3️⃣ 交换临时密钥iPhone 与桥端交换全新的X25519临时密钥对和 32 字节随机 nonce前向保密密钥用完即弃泄露历史密文也解不开4️⃣ 桥端签名认证桥端用 Ed25519 身份密钥对握手转录transcript签名iPhone 用二维码里的公钥验证证明对面真的是那台 Mac防中间人5️⃣ 手机反向签名iPhone 用自己的 Ed25519 身份密钥签名 client-auth 转录桥端验证双向认证Mac 也确认对面是可信手机6️⃣ 派生会话密钥双方用HKDF-SHA256派生两条方向的AES-256-GCM密钥之后所有消息都装进带单调计数器的加密信封一条信道两个方向的独立密钥互不干扰第 3 步的临时密钥生成可以在 secure-transport.js#L207 看到generateKeyPairSync(x25519) 32 字节随机 serverNonce第 6 步的密钥派生则在 secure-transport.js#L339-L354盐值来自握手转录的 SHA-256派生信息里还绑定会话 ID、双方设备 ID 和 keyEpoch防止密钥被挪用到别的会话。加密信封解剖为什么每条消息都带计数器握手成功后每条应用消息都会被打包成一个加密信封encryptedEnvelope其字段结构定义在 secure-transport.js#L790-L809kind: encryptedEnvelope ← 消息类型 sessionId: 所属安全会话 keyEpoch: 密钥世代号 sender: mac / iphone发送方向 counter: 单调递增计数器 ciphertext: AES-256-GCM 密文 tag: GCM 认证标签两个设计细节值得留意 nonce 不是随机的而是方向 计数器GCM 模式最怕 nonce 重用一旦重用会彻底破坏认证加密。Remodex 用确定性方案——12 字节 nonce 由 1 个方向字节Mac 发1手机发2 11 字节计数器拼成见 secure-transport.js#L909-L918。计数器严格递增nonce 天然不重复而且 nonce 本身不需要传输只需加密密钥 counter 即可解出。GCM 认证标签tag解密前先校验 tag密文被篡改哪怕 1 个比特解密也会直接失败而不是产出乱码。这就是认证加密的含金量。防重放机制三道防线 ️攻击者如果截获了一条合法密文并原样重发会怎样Remodex 用了三层防御防线一单调计数器硬校验桥端收到信封时若counter lastInboundCounter直接拒绝secure-transport.js#L480iPhone 端做完全对称的检查CodexServiceSecureTransport.swift#L1017。同一条消息发两次第二次必被丢弃。防线二keyEpoch 密钥世代每次全新握手都会递增 keyEpoch并作为信封的必填字段校验。旧会话的密文拿到新会话里keyEpoch 对不上直接拒收。防线三bridgeReplayEpoch 进程纪元每次桥端进程启动都会生成一个随机的 16 字节重放纪元secure-transport.js#L57。序列号是进程级的——重启后从 1 重新开始。如果只比数字手机可能把新进程的第 1 条误认为旧进程的第 1 条而纪元标签让这种数字比较失效的场景也能被明确识别。这三层组合起来意味着截获的历史密文无法重放篡改的密文无法解密跨会话/跨进程的消息也无法混入。可信重连不用每次都扫二维码首次配对成功后两侧会互相记住对方桥端把手机身份公钥写入trustedPhonessecure-device-state.js#L114-L131持久化在~/.remodex/device-state.json权限0o600macOS 上还会镜像到 KeychainiPhone把 Mac 的受信任记录存入 Keychain之后重连走trusted_reconnect模式桥端会核对手机身份公钥是否与登记值一致一旦不一致就报phone_identity_changed错误secure-transport.js#L181-L196——换手机重新扫码即可自动顶替旧手机。还有一个贴心的细节加密追赶secure catch-up。桥端维护一个有界的出站缓冲最多 500 条 / 10MBsecure-transport.js#L33-L34网络抖动断线重连后手机通过resumeState告知自己上次处理到哪条序列号桥端把错过的加密消息按序补发secure-transport.js#L405-L460。缓冲区里只存手机确认真的收到过之前的消息中继闪断也不会让你漏掉任何输出。密钥都放在哪里密钥存储位置保护方式Mac 身份密钥Ed25519~/.remodex/device-state.json文件权限 0o600 Keychain 镜像备份手机身份密钥 / 受信任 Mac 记录iOS Keychain系统级硬件保护iPhone 上的历史消息本地加密存储Keychain 托管的 AES 密钥静态加密会话密钥AES-256-GCM仅内存进程退出即销毁从不落盘小结Remodex 的安全模型可以浓缩为一句话传输层relay只能转发不能阅读。X25519 临时密钥 双向 Ed25519 转录签名→ 防中间人保证握手双方身份可信HKDF-SHA256 派生方向性 AES-256-GCM 密钥→ 应用负载端到端加密 认证防篡改单调计数器 keyEpoch bridgeReplayEpoch→ 三层防重放历史密文毫无用处对于新手用户你完全不需要配置任何安全参数——扫码配对时上面这套机制已经全部在后台运转了。如果你想深入阅读核心源码入口是 phodex-bridge/src/secure-transport.js桥端和 CodexServiceSecureTransport.swiftiPhone 端中继的透明实现则在 relay/ 目录下任何人都可以审计或自行部署。【免费下载链接】remodexRemote Control for Codex.项目地址: https://gitcode.com/gh_mirrors/re/remodex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考