自建中继节点

Codux Mobile 通过 Iroh 传输与桌面端配对。它优先走点对点直连；中继只在两台设备需要互相发现、或无法直连时转发流量。桌面端始终是真正的终端宿主，中继看不到你解密后的内容。

对大多数人来说，中继就是 设置 → 远程 里的一个选择——不用管地址：

选项	何时用
全球	默认，开箱即用。
国内（腾讯云） / 国内（阿里云）	国内用户更快的路径。内置——选一下就行。
自定义	你自己的中继节点（见下）。

什么时候需要自建中继

• 你的手机和桌面经常处在公共路径慢或被屏蔽的网络。
• 你希望配对/连接的元数据留在自己可控的基础设施上。
• 你想要一个离用户更近、延迟更低的中继。

部署一个私有 Iroh 中继

Codux 的中继就是一个标准的 Iroh 中继——Codux 用的是 iroh 1.0，所以请部署相匹配的中继版本。

1. 准备一台主机和一个域名。 中继需要通过 HTTPS 可达，所以你需要一台公网服务器和一个带 TLS 的域名（例如 relay.example.com）。Iroh 中继自己终结 TLS（Let’s Encrypt 或你自己的证书）。
2. 运行 iroh-relay 服务。 从 Iroh 项目获取（cargo install iroh-relay，或用预编译二进制），写一份设置好域名和 TLS 的中继配置并启动。具体配置和参数请按你 iroh 版本参考官方 Iroh 中继文档。
3. 开放端口。 放通 HTTPS（443 端口），让客户端能访问 https://relay.example.com。

中继不需要任何 Codux 专属软件——它就是普通的 Iroh 中继基础设施。

在 Codux 里注册中继

在桌面端：

1. 打开 Codux → 设置 → 远程。
2. 把中继设为 自定义，在 自定义中继地址（Custom Relay URL） 里填入你的地址，例如 https://relay.example.com。
3. 如果你的中继需要 bearer 令牌，填一下 中继鉴权（Relay Authentication）。
4. 重新配对一次手机端，让二维码反映新的路径。

这样手机在无法直连时，就会通过你自己的中继连到桌面端。

中继不做什么

• 不运行你的终端——桌面端才是宿主。
• 不存储 AI 会话、记忆或项目文件。
• 看不到解密后的终端内容；流量在 Iroh 的 QUIC 连接上端到端加密。