闲社

标题: 【教程】用iroh构建去中心化P2P网络：Rust模块化网络栈实战入门 [打印本页]
作者: kai_va    时间: 3 小时前
标题: 【教程】用iroh构建去中心化P2P网络：Rust模块化网络栈实战入门
导语：今天GitHub Trending上，一个Rust写的P2P网络库 iroh 突然爆火（326 stars/天）。它的口号很酷："IP地址会失效，直接拨号密钥"。这篇教程手把手教你用它搭建一个去中心化的文件传输应用，零服务器成本。



一、前置条件



安装Rust（如未安装）：
  1. curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  2. source $HOME/.cargo/env
复制代码



二、iroh是什么？

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



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里打转，不如直接用加密密钥作为网络身份。这篇教程展示了最基础的文件传输，实际项目中你可以：



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



参考资源：


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



欢迎光临 闲社 (https://www.xianshe.com/) Powered by Discuz! X5.0