開発効率爆上げ！Rust製P2Pライブラリ iroh徹底解説

n0-computer/iroh

レジ「いらっしゃいませ～！」

あなた「（スマホ片手に）いや～、困ったなぁ。最近、プロジェクトでデータ共有するのに、DropboxとかGoogle Driveとか使ってるんですけど、なんかこう、もっとスマートな方法ないかなって。」

レジ「おや、それはお困りですね！もしかして、ソフトウェアエンジニアさんですか？」

あなた「え、なんで分かりました！？（笑）」

レジ「実は私、以前はAIアシスタントだったんですよ。それで、今お話しされていた『データ共有』、それにピッタリのすごい技術があるんです！」

あなた「へぇ！どんなのですか？」

レジ「それがですね、巷で『魔法のP2Pデータ共有ライブラリ』と呼ばれている『iroh』なんです！」

あなた「イロ…？なんか聞いたことあるような、ないような…」

レジ「はい！正式名称は『n0-computer/iroh』。Rust製の、リアルタイムなP2P（ピア・ツー・ピア）データ共有ライブラリなんです。まさに『just works』、使ってみると本当に驚きますよ！」

あなた「P2P…ってことは、サーバーとかいらないってことですか？」

レジ「その通りです！普通のクラウドサービスだと、どこかのサーバーにデータを置いて、そこからダウンロードする形ですよね。でもirohを使えば、データを共有したい人同士が直接つながって、やり取りできるんです。例えるなら、宅配便じゃなくて、直接手渡しするようなイメージですね！」

あなた「へえ！それって、どんな時に便利なんですか？」

レジ「ソフトウェアエンジニアさんにとっては、もうメリットだらけですよ！いくつかご紹介しますね。」

レジ「例えば、こんなシーンで役立ちます！」

大容量ファイルの共有が爆速に！ 「プロジェクトで数GBもある学習データやビルド成果物を共有する時、クラウド経由だと時間もお金もかかりますよね？ irohなら、直接やり取りするので、ネットワーク環境が良ければ驚くほど速いんです。ダウンロードを待つイライラから解放されます！」

オフライン環境でのデータ共有 「インターネットが繋がりにくい現場や、完全にオフラインの環境で作業する時、どうしてますか？ USBメモリでデータのやり取りとか、結構手間じゃないですか？ irohなら、ローカルネットワークさえあれば、インターネットなしでもデータ共有ができちゃいます。災害時の情報共有とかにも使えそうですよね！」

リアルタイムコラボレーションの土台に 「共同でドキュメントを編集したり、コードをレビューしたり、リアルタイム性が求められる作業ってありますよね。irohはリアルタイムにデータが同期されるので、そういったコラボレーションツールのバックエンドとしても使えます。共同開発がもっとスムーズになりますよ！」

プライバシーとセキュリティの向上 「大事なデータを外部のサーバーに置くのって、ちょっと心配になることありませんか？ irohはP2Pなので、データが第三者のサーバーを経由しません。これにより、データ漏洩のリスクを減らし、プライバシーを守ることができます。秘匿性の高いプロジェクトには特にオススメです。」

開発・テスト環境の構築 「開発中のサービスで、複数のインスタンス間でデータ同期が必要な場合、モックサーバーを立てたり、複雑な設定をしたり、結構面倒ですよね。irohを使えば、各インスタンスが直接データを共有できるので、開発・テスト環境の構築がシンプルになります。」

レジ「では、実際にirohを導入して、簡単に使ってみる方法を見ていきましょう！」

あなた「おお！実践的で助かります！」

レジ「Rustプロジェクトにirohを追加するのはとっても簡単です。Cargo.toml ファイルに依存関係を追加するだけ！」

[dependencies]
iroh = "0.13" # バージョンは最新のものを確認してください
tokio = { version = "1", features = ["full"] } # 非同期処理のためにtokioも必要です

レジ「もし初めてRustを使うのであれば、Rust公式ウェブサイトからrustupをインストールしてくださいね。」

レジ「では、超シンプルなファイル共有の例を見てみましょう。Aさんがファイルを提供して、Bさんがそれを受け取る、という流れです。」

Aさん（ファイルを提供する側
src/main.rs）

use iroh::{node::Node, rpc_protocol::ShareMode, bytes::Bytes};
use tokio::io::AsyncWriteExt;
use std::path::PathBuf;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // irohノードを初期化
    let node = Node::builder().spawn().await?;
    println!("Irohノードを起動しました。ID: {}", node.node_id());

    let file_content = Bytes::from_static(b"Hello from iroh!");
    let file_path = PathBuf::from("my_shared_file.txt");

    // ファイルをirohにインポート
    let doc = node.docs.create().await?;
    let entry = doc.set_bytes(file_path.clone(), file_content.clone(), ShareMode::Private).await?;
    
    // 共有用のチケットを生成
    let ticket = doc.share_read_ticket(&entry).await?;
    
    println!("ファイルを共有しました。チケット: {}", ticket);
    println!("このチケットをBさんに渡してください。");
    
    // Ctrl+Cで終了するまで待機
    tokio::signal::ctrl_c().await?;
    println!("ノードをシャットダウンします。");

    Ok(())
}

レジ「AさんのPCでこのコードを実行すると、『チケット』という長い文字列が表示されます。これが共有に必要な情報です。これをBさんに伝えます。」

Bさん（ファイルを受け取る側
src/main.rs）

use iroh::{node::Node, rpc_protocol::ShareMode, bytes::Bytes};
use tokio::io::AsyncWriteExt;
use std::path::PathBuf;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Aさんから受け取ったチケットをここに貼り付けます
    // 例: let ticket_str = "DOC_TICKET_STRING_FROM_A";
    let ticket_str = "PASTE_YOUR_TICKET_STRING_HERE"; 
    
    // irohノードを初期化
    let node = Node::builder().spawn().await?;
    println!("Irohノードを起動しました。ID: {}", node.node_id());

    // チケットをパースして共有情報を取得
    let ticket = iroh::ticket::Ticket::parse_bytes(ticket_str.as_bytes())?;

    // コンテンツを取得
    // NOTE: この例では単一のデータが共有されることを想定しています。
    // doc.get_content_bytes_with_pathなど、より汎用的なAPIもあります。
    let (content, _path) = node.client().import_ticket(ticket).await?;

    let file_name = "received_file.txt";
    let mut file = tokio::fs::File::create(file_name).await?;
    file.write_all(&content).await?;

    println!("ファイル '{}' を受信し、保存しました！", file_name);

    // Ctrl+Cで終了するまで待機
    tokio::signal::ctrl_c().await?;
    println!("ノードをシャットダウンします。");

    Ok(())
}

レジ「Bさんは、Aさんからもらったチケットの文字列をコードに貼り付けて実行します。すると、Aさんが共有したファイルがBさんのPCにダウンロードされます。これで、ファイル共有完了です！」

あなた「おぉ、すごい！本当にシンプルですね！これなら、複雑な設定なしにP2P通信ができちゃいますね。」

レジ「そうなんです！もちろん、これは一番基本的な例で、irohにはもっとたくさんの機能があります。例えば、ファイルの変更を自動で同期したり、特定のユーザーとだけ共有したり、いろいろなことができますよ。」

レジ「いかがでしたか？ 『iroh』、ソフトウェアエンジニアのあなたにとって、きっと強力な武器になるはずです！」

あなた「いや～、まさかコンビニでこんなに役立つ情報が聞けるとは思いませんでした！ありがとうございます！」

レジ「どういたしまして！P2Pの世界は奥が深いですが、irohはそれを『just works』にしてくれる素晴らしいライブラリです。ぜひ、ご自身のプロジェクトで試してみてくださいね！」

あなた「はい！さっそく試してみます！お会計お願いします！」

レジ「かしこまりました！またのご来店をお待ちしております！」