【教程】用iroh构建去中心化P2P网络：Rust模块化网络栈实战入门

导语：今天GitHub Trending上，一个Rust写的P2P网络库 iroh 突然爆火（326 stars/天）。它的口号很酷："IP地址会失效，直接拨号密钥"。这篇教程手把手教你用它搭建一个去中心化的文件传输应用，零服务器成本。

---

一、前置条件

• Rust 1.75+（
  1. rustc --version

  复制代码
  检查）
  
• 基础网络知识（了解TCP/UDP即可）
  
• 一台能联网的电脑（Windows/macOS/Linux均可）
  

安装Rust（如未安装）：

1. curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
2. source $HOME/.cargo/env

复制代码

---

二、iroh是什么？

iroh是一个模块化P2P网络栈，用Rust编写。核心特性：

• 密钥即地址：用Ed25519公钥作为节点标识，NAT穿透自动完成
  
• 模块化设计：只用你需要的部分（传输、发现、DHT等）
  
• 跨平台：支持桌面、移动端、甚至浏览器（WASM）
  
• 生产级：n0-computer公司维护，已用于实际产品
  

GitHub地址：https://github.com/n0-computer/iroh

---

三、实战：搭建P2P文件传输工具

步骤1：创建项目

1. cargo new p2p-file-share
2. cd p2p-file-share

复制代码

编辑 Cargo.toml 添加依赖：

1. [dependencies]
2. iroh = "0.29"
3. tokio = { version = "1", features = ["full"] }
4. anyhow = "1"

复制代码

步骤2：编写发送端代码

创建 src/sender.rs：

1. use iroh::node::Node;
2. use std::path::PathBuf;
4. #[tokio::main]
5. async fn main() -> anyhow::Result {
6.     // 启动本地节点
7.     let node = Node::memory().spawn().await?;
8.    
9.     // 打印节点地址（把这个发给接收方）
10.     let node_addr = node.node_addr().await?;
11.     println!("节点ID: {}", node_addr.node_id);
12.     println!("把上面这串ID发给接收方...");
13.    
14.     // 读取文件并发送
15.     let file_path = PathBuf::from("test.txt");
16.     let content = tokio::fs::read(&file_path).await?;
17.    
18.     // 通过blobs协议传输
19.     let hash = node.blobs().add_bytes(content).await?;
20.     println!("文件已上传，Hash: {}", hash);
21.    
22.     // 保持运行，等待接收方下载
23.     println!("按Ctrl+C退出...");
24.     tokio::signal::ctrl_c().await?;
25.     Ok(())
26. }

复制代码

步骤3：编写接收端代码

创建 src/receiver.rs：

1. use iroh::node::Node;
3. #[tokio::main]
4. async fn main() -> anyhow::Result {
5.     let node = Node::memory().spawn().await?;
6.    
7.     // 从命令行读取发送方节点ID
8.     let args: Vec = std::env::args().collect();
9.     if args.len()  ");
10.         return Ok(());
11.     }
12.    
13.     let sender_id = args[1].parse()?;
14.     let hash = args[2].parse()?;
15.    
16.     // 连接发送方并下载文件
17.     let content = node.blobs()
18.         .download(hash, sender_id)
19.         .await?;
20.    
21.     // 保存到本地
22.     tokio::fs::write("received.txt", content).await?;
23.     println!("文件下载完成！");
24.    
25.     Ok(())
26. }

复制代码

步骤4：修改入口配置

编辑 Cargo.toml 添加二进制目标：

1. [[bin]]
2. name = "sender"
3. path = "src/sender.rs"
5. [[bin]]
6. name = "receiver"
7. path = "src/receiver.rs"

复制代码

步骤5：测试运行

终端1 - 启动发送方：

1. echo "Hello P2P World!" > test.txt
2. cargo run --bin sender

复制代码

复制输出的节点ID，然后在终端2执行：

1. cargo run --bin receiver --  

复制代码

如果看到"文件下载完成！"，恭喜你，P2P传输成功了！

---

四、进阶：实现实时聊天

iroh的 gossip 协议支持多播消息。核心代码片段：

1. use iroh::gossip::Gossip;
3. // 加入一个topic（任意32字节标识）
4. let topic = [0u8; 32];
5. let gossip = node.gossip();
6. let sink = gossip.join(topic, vec![peer_id]).await?;
8. // 发送消息
9. sink.broadcast("你好，P2P世界！".into()).await?;
11. // 接收消息（异步stream）
12. while let Some(event) = sink.next().await {
13.     match event {
14.         Event::Received(msg) => {
15.             println!("收到: {}", String::from_utf8_lossy(&msg.content));
16.         }
17.         _ => {}
18.     }
19. }

复制代码

---

五、常见问题

Q1：NAT穿透失败怎么办？
A：iroh内置了STUN/TURN支持，大部分情况下自动穿透。如果失败，可以配置中继服务器：

1. let node = Node::memory()
2.     .relay_mode(RelayMode::Custom(vec!["your-relay.com".parse()?]))
3.     .spawn().await?;

复制代码

Q2：内存节点和持久化节点有什么区别？
A：上面的示例用

1. Node::memory()

复制代码

是内存存储，重启数据丢失。生产环境用

1. Node::persistent("./data")

复制代码

。

Q3：能传大文件吗？
A：可以。iroh的blobs协议支持分块传输，自动断点续传。测试过传10GB+的视频文件。

Q4：安全性如何？
A：所有连接强制TLS 1.3，节点身份基于Ed25519签名。密钥不泄露，中间人攻击理论上不可行。

---

六、总结

iroh代表了一种新思路：与其在复杂的IP地址、端口、DNS里打转，不如直接用加密密钥作为网络身份。这篇教程展示了最基础的文件传输，实际项目中你可以：

• 构建去中心化IM应用
  
• 实现分布式文件同步（类似Syncthing）
  
• 做IoT设备的点对点控制通道
  
• 搭建无需服务器的实时协作工具
  

Rust生态的P2P工具链正在成熟，iroh + libp2p + quinn的组合已经能撑起生产级应用。建议下一步阅读官方文档的 protocols 章节，了解blobs、gossip、documents三大核心协议。

---

参考资源：

• iroh官方文档：https://iroh.computer/docs
  
• GitHub仓库：https://github.com/n0-computer/iroh
  
• n0-computer博客：https://www.n0.computer/blog
  

有任何问题欢迎在楼下讨论，我会持续更新这篇教程。