Iroh 1.0 发布：基于键拨号的网络库正式稳定

Iroh 1.0 – 稳定的基于键的网络栈

Iroh 1.0 是基于键拨号网络库的首次稳定发布，提供基于 QUIC 的多路径、NAT 穿透栈，可在 Rust、Python、Node.js、Swift 和 Kotlin 中使用，同时保证在次要版本之间的线协议兼容性。

---

为什么基于键拨号优于 IP 地址

• 键由用户控制。 键由设备生成，当设备在网络之间切换时永不改变，不同于可能在没有警告的情况下消失的 IP 地址。
• 键同时充当安全标识符。 同一把用于保护连接的加密密钥可用于身份、权限和归属，使互联网变成“安全的本地主机”。
• 直连占据流量主导。 在典型的 Iroh 会话中，约 95 % 的数据直接在对等节点之间流动，降低云出口成本和整体路由跳数。

1.0 版核心技术特性

特性	功能说明	重要性
QUIC 多路径	实现 IETF 草案 draft‑ietf‑quic‑multipath，在单个连接内管理多条路由，并在条件变化时热切换路径。	通过使用最佳可用路径而无需重新连接，提高了弹性和延迟。
QUIC NAT 穿透	遵循 draft‑seemann‑quic‑nat‑traversal，在 NAT 之上建立加密直连。	消除手动端口转发或外部 VPN 的需求。
本地优先模式	检测并连接同一局域网内的设备，无需经过互联网。	实现离线点对点通信，降低对中继的依赖。
WASM 支持	编译为 WebAssembly 并在浏览器中运行。	为基于网页的 P2P 应用打开大门，无需本地二进制。
自定义传输插件	允许第三方 crate 提供替代传输方式（例如 BLE、LoRa、Tor）。	将 Iroh 扩展到超出 IPv4/IPv6 与中继传输的范围，保持核心代码库简洁。
语言绑定	官方为 Python、Node.js、Swift 和 Kotlin 提供 FFI，除原生 Rust crate 外。	让开发者在移动、桌面和服务器应用中嵌入 Iroh，无需编写 Rust。

稳定性保证

• 线协议稳定性： 任意 iroh v1 端点都可以与任意其他 iroh v1 端点通信，且不受次要版本或语言绑定的影响。
• 版本策略： 将来语言 API 的更改可能独立发布，但任何破坏线协议的更改都将伴随主版本号的提升。
• 公共中继生命周期： v1.0 的中继将持续运行至生命周期结束；旧的中继（v0.35x）支持至 2026 年 12 月 31 日，而金丝雀版（0.9x）已被弃用。

采用数据

• 在过去 30 天内，公共中继上创建了超过 2 亿端点。
• Iroh 已被用于视频流、 大语言模型训练、 安全聊天、 游戏、 文件传输以及许多其他工作负载。
• 该库在生产环境中运行于 数十万台设备 上。

---

社区洞察与常见问题

"Iroh 是一个随时可用的拨号任意设备网络库。可从现成协议生态系统中进行组合…" – 官方博客

自定义传输与可扩展性

"Iroh 开箱即支持 IPv4、IPv6 和中继传输，但我们添加了实现自定义传输的能力。现有的实验性传输包括 Tor、Nym 和 BLE。" – [rklaehn, iroh 开发者]

*自定义传输位于独立的 crate 中，避免了错综复杂的特性标志迷宫。开发者可以在不修改核心库的情况下插入 BLE、LoRa、Wi‑Fi Aware 或 Tor。

与现有 Mesh/VPN 方案的比较

• Tailscale 风格的打洞： 用户报告称 Iroh 感觉像 “作为 Rust crate 的 Tailscale 风格打洞”(colinmarc)。不同于 Tailscale，基于键的地址嵌入在应用中，消除了对单独账户服务的需求。
• WireGuard 与 Iroh 对比： 虽然 WireGuard 提供底层 VPN，Iroh 在应用层运行，提供内置多路复用、NAT 穿透和自定义传输钩子。
• Yggdrasil、Netbird、Zerotier： 多位评论者请求“对比”页面；共识是 Iroh 的独特卖点是 基于键拨号抽象 与 可插拔传输栈 的结合。

用户突出的使用案例

• 生产环境的机器学习训练： 有用户报告使用 Iroh 构建分布式大语言模型训练系统，并且更倾向于它而非 libp2p。
• 游戏开发： 一个 TypeScript SDK 示例展示了为家庭游戏之夜快速原型化多人游戏的方式。
• 安全聊天与消息传递： 社区成员设想基于 Iroh 加密键连接的类似 Signal 的应用。

社区的未解问题

问题	答案/讨论概述
Iroh 会取代 IP 地址吗？	Iroh 旨在作为 补充层 与 IP 并存，而非全面取代 (MostlyStable)。
密钥轮换如何工作？	博客未涉及；鼓励开发者将密钥视为凭证，并通过库的身份 API 进行轮换。
是否有 DHT 或人类可读的命名？	目前没有内置 DHT；项目计划通过更高层协议（例如 DNS 风格的查询）公开发现机制。
我能运行自己的中继而不暴露其 IP 吗？	中继类似 STUN/TURN 服务器；自行托管需要暴露可访问的地址，但中继流量是加密且限速的。
性能与 WireGuard 相比如何？	未发布直接基准测试；用户报告 95 % 流量为直连，暗示延迟可与调优良好的 VPN 相媲美。

入门指南

1. 阅读快速入门指南 – docs.iroh.computer/quickstart.
2. 选择语言绑定 – Rust crate、Python (pip install iroh)、Node.js (npm i iroh)、Swift（通过 Swift Package Manager）或 Kotlin（通过 Maven Central）。
3. 生成密钥 并将其用作任意设备的拨号地址。
4. 运行公共中继 或依赖托管的 n0 预设实现开箱即用的连接。
5. 如需 BLE、LoRa 或 Tor 等自定义传输，请扩展（参见自定义传输博客文章获取实现细节）。

展望

• 未来发布 可能独立提升语言 API，同时保持线协议稳定直至主版本号变更。
• 商业支持 通过托管中继和企业 SLA 提供；公共中继保持开源并限速。
• 社区成长 通过 Discord、Reddit 以及 GitHub 上的开源仓库进行鼓励。

Iroh 1.0 标志着基于键的、多路径、跨语言网络库的里程碑，承诺让点对点连接像标准库调用一样易于嵌入。