Skip to content

PasteFerry (隔空贴): clipboard and file sync across macOS, Windows and Linux. Direct-first, end-to-end encrypted. Optional official access: no server to host. Independent self-hosting remains available.

21.1 KB
Raw Blame
<!doctype html>
<html lang="ja">
<head>
  <meta charset="utf-8">
  <script>
    (function () {
      if (location.hostname !== "baiyuze.github.io") return;
      var prefix = /^\/(?:pasteferry|copysync)(?=\/|$)/.exec(location.pathname);
      if (!prefix) return;
      var path = location.pathname.slice(prefix[0].length) || "/";
      location.replace("https://pasteferry.cc" + path + location.search + location.hash);
    })();
  </script>
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>PasteFerry のしくみ:直接接続、複数回線の探索、障害時の動作</title>
  <meta name="description" content="コピーしたあとに何が起きるか、どうつながるか、つながらないときはどうなるか。">
  <link rel="canonical" href="https://pasteferry.cc/ja/how/">
  <link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/how/">
  <link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/how/">
  <link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/how/">
  <link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/how/">
  <link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/how/">
  <meta name="theme-color" content="#141416">
  <meta property="og:type" content="article">
  <meta property="og:site_name" content="PasteFerry">
  <meta property="og:title" content="PasteFerry のしくみ:直接接続、複数回線の探索、障害時の動作">
  <meta property="og:description" content="コピーしたあとに何が起きるか、どうつながるか、つながらないときはどうなるか。">
  <meta property="og:url" content="https://pasteferry.cc/ja/how/">
  <meta property="og:image" content="https://pasteferry.cc/assets/og-en.png">
  <meta property="og:locale" content="ja_JP">
  <meta name="twitter:card" content="summary_large_image">
  <link rel="icon" href="../../assets/favicon.svg?v=df696024d8" type="image/svg+xml">
  <link rel="icon" href="../../assets/favicon-32.png?v=8e9afa506d" sizes="32x32" type="image/png">
  <link rel="apple-touch-icon" href="../../assets/apple-touch-icon.png?v=bcbf406cb8">
  <link rel="stylesheet" href="../../assets/site.css?v=dbae55d27c">
  <script>document.documentElement.classList.add("js");if (!/Mac|iPhone|iPad/.test(navigator.platform || navigator.userAgent)) document.documentElement.classList.add("pc");</script>
</head>
<body>
  <a class="skip" href="#main">本文へ移動</a>

  <header class="bar">
    <div class="wrap">
      <a class="brand" href="../../ja/" aria-label="PasteFerry ホーム"><img src="../../assets/icon.svg?v=65a69999e0" alt="" width="26" height="26">PasteFerry</a>
      <nav aria-label="ページ内の移動">
        <a href="../../ja/features/">機能</a>
        <a class="mid" href="../../ja/start/">はじめかた</a>
        <a class="wide" href="../../ja/start/#server">接続方法</a>
        <a href="../../ja/download/">ダウンロード</a>
        <details class="menu">
          <summary aria-label="その他のページ" class="current"><span>その他</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
          <ul>
            <li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
            <li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
            <li><a href="../../ja/themes/">テーマガイド</a></li>
            <li><a href="./" aria-current="page">しくみ</a></li>
            <li><a href="../../ja/security/">セキュリティ</a></li>
            <li><a href="../../ja/faq/">よくある質問</a></li>
            <li><a href="../../ja/feedback/">ディスカッションとフィードバック</a></li>
            <li class="sep" role="separator"></li>
            <li><a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">更新履歴</a></li>
            <li class="narrow-gh"><a href="https://github.com/baiyuze/pasteferry">GitHub</a></li>
          </ul>
        </details>
        <a class="gh" href="https://github.com/baiyuze/pasteferry" data-gh-stars aria-label="GitHub で PasteFerry にスターを付ける"><svg class="gh-mark" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg><span class="gh-label">Star</span><span class="gh-count" hidden><svg class="gh-star" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 .25a.75.75 0 01.673.418l1.882 3.815 4.21.612a.75.75 0 01.416 1.279l-3.046 2.97.719 4.192a.751.751 0 01-1.088.791L8 12.347l-3.766 1.98a.75.75 0 01-1.088-.79l.72-4.194L.818 6.374a.75.75 0 01.416-1.28l4.21-.611L7.327.668A.75.75 0 018 .25z"/></svg><b></b></span></a>
        <details class="lang">
          <summary aria-label="言語:日本語"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.4" aria-hidden="true"><circle cx="10" cy="10" r="7.25"/><path d="M2.75 10h14.5M10 2.75c-2.1 2-3.1 4.4-3.1 7.25s1 5.25 3.1 7.25M10 2.75c2.1 2 3.1 4.4 3.1 7.25s-1 5.25-3.1 7.25"/></svg><span>日本語</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
          <ul>
            <li><a href="../../how/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a></li>
            <li><a href="../../zh-tw/how/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a></li>
            <li><a href="../../zh-hk/how/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a></li>
            <li><a href="../../en/how/" hreflang="en" lang="en" data-lang="en">English</a></li>
            <li><a href="../../ja/how/" hreflang="ja" lang="ja" data-lang="ja" aria-current="page">日本語</a></li>
          </ul>
        </details>
      </nav>
    </div>
  </header>

  <main id="main">
    <section class="hero guide-hero">
      <div class="wrap">
        <p class="crumb"><a href="../../ja/">PasteFerry</a></p>
        <h1 class="display">しくみ</h1>
        <p class="lede">コピーしたあとに何が起きるか、どうつながるか、つながらないときはどうなるか。</p>
      </div>
    </section>

    <section class="section" aria-labelledby="flow-title">
      <div class="wrap">
        <h2 id="flow-title">コピーしたあと、何が起きるか</h2>
        <p class="intro">テキストも画像もファイルも、同じ道を通ります。</p>
        <ol class="flow">
          <li><h3>気づく</h3><p>バックグラウンドサービスがクリップボードの変化に気づきます。</p></li>
          <li><h3>送る</h3><p>テキストと 50 MB までのファイルはすぐに送り、それより大きいものは先に記録だけを送ります。</p></li>
          <li><h3>貼り付ける</h3><p>受け取った側はローカルに保存してからクリップボードに入れるので、貼り付けると本物のファイルになります。</p></li>
        </ol>
      </div>
    </section>

    <section class="section" id="diagram" aria-labelledby="how-title">
      <div class="wrap">
        <h2 id="how-title">PasteFerry の接続のしかた</h2>
        <p class="intro">同じネットワークなら直接相手を見つけます。別のネットワークではサーバーが橋渡しをしてできるだけ直接つなぎ、無理なときだけ中継します。内容は常に暗号化されます。</p>
        <figure class="diagram">
          <svg viewBox="0 0 960 400" role="img" aria-labelledby="diagram-title diagram-desc">
            <title id="diagram-title">PasteFerry の接続のしかた</title>
            <desc id="diagram-desc">コンピューター A と B は WebRTC で直接つながります。どちらもシグナリングでサーバーに接続し、直接接続に失敗したときはサーバーの TURN でデータを中継します。</desc>
            <rect class="d-box" x="360" y="24" width="240" height="96" rx="14"/>
            <text class="d-title" x="480" y="64" text-anchor="middle">シグナリング・中継サービス</text>
            <text class="d-sub" x="480" y="92" text-anchor="middle">シグナリング、STUN、TURN 中継</text>
            <path class="d-sig" d="M140 210V58H360"/>
            <path class="d-sig" d="M820 210V58H600"/>
            <path class="d-relay" d="M196 210V100H360"/>
            <path class="d-relay" d="M764 210V100H600"/>
            <text class="d-note" x="210" y="50">シグナリング:接続情報の交換</text>
            <text class="d-note" x="210" y="128">中継:直接つながらないときだけ</text>
            <rect class="d-box" x="40" y="210" width="240" height="120" rx="14"/>
            <text class="d-title" x="160" y="262" text-anchor="middle">Mac</text>
            <text class="d-sub" x="160" y="290" text-anchor="middle">ここでコピー</text>
            <rect class="d-box" x="680" y="210" width="240" height="120" rx="14"/>
            <text class="d-title" x="800" y="262" text-anchor="middle">Mac、Windows または Linux</text>
            <text class="d-sub" x="800" y="290" text-anchor="middle">ここで貼り付け</text>
            <path class="d-direct" d="M280 270H680"/>
            <text class="d-label" x="480" y="256" text-anchor="middle">WebRTC 直接接続、DTLS 暗号化</text>
            <text class="d-note" x="480" y="298" text-anchor="middle">データは 2 台のあいだだけを流れる</text>
            <g class="d-legend" transform="translate(40 372)">
              <path class="d-direct" d="M0 0H28"/><text x="38" y="5">データ(直接)</text>
              <path class="d-relay" d="M210 0H238"/><text x="248" y="5">データ(中継、予備)</text>
              <path class="d-sig" d="M470 0H498"/><text x="508" y="5">シグナリング</text>
            </g>
          </svg>
          <ul class="points diagram-text">
            <li><strong>WebRTC 直接接続、DTLS 暗号化</strong> データは 2 台のあいだだけを流れる</li>
            <li><strong>シグナリング・中継サービス</strong> シグナリング、STUN、TURN 中継</li>
            <li>中継:直接つながらないときだけ</li>
          </ul>
        </figure>
      </div>
    </section>

    <section class="section" id="multi-uplink" aria-labelledby="multi-title">
      <div class="wrap">
        <h2 id="multi-title">会社のネットワークでも直接つながる</h2>
        <p class="intro">出口が複数ある会社のネットワークは、以前は中継しかできませんでした。PasteFerry はすべての出口を調べ、相手に順に試してもらいます。</p>
        <div class="cols">
          <div>
            <h3>やっていること</h3>
            <ul class="points">
              <li><strong>ポートはひとつ。</strong>すべての接続でひとつの UDP ポートを使います。</li>
              <li><strong>出口をすべて調べる。</strong>7 台のサーバーに同時に問い合わせ、出口の数だけアドレスを得ます。</li>
              <li><strong>すべて相手に伝える。</strong>相手がひとつずつ試し、合ったものでつながります。</li>
              <li><strong>空いているときに直接接続を再試行。</strong>まず中継で使えるようにし、空いているときに直接接続へ切り替えます。</li>
            </ul>
          </div>
          <div>
            <h3>実際のネットワーク構成でテスト</h3>
            <p class="small">コミットのたびに、模擬ネットワークで自動テストしています。</p>
            <div class="table-scroll">
              <table>
                <thead><tr><th scope="col">構成</th><th scope="col">結果</th></tr></thead>
                <tbody>
                <tr><td>出口ひとつ ↔ 家庭用ルーター</td><td>直接</td></tr>
                <tr><td>出口ふたつ、旧バージョン(対照)</td><td>中継</td></tr>
                <tr><td>出口よっつ ↔ 家庭用ルーター</td><td>直接</td></tr>
                <tr><td>出口ふたつ ↔ 出口ふたつ</td><td>直接</td></tr>
                <tr><td>出口ふたつ ↔ ポートをランダムに割り当てる NAT</td><td>中継</td></tr>
                <tr><td>最初はつながらず、あとでネットワークが回復</td><td>中継のあと直接</td></tr>
                <tr><td>サーバーなし、同じサブネット</td><td>直接</td></tr>
                <tr><td>サーバーなし、サブネット同士が遮断されている</td><td>つながらない</td></tr>
                </tbody>
              </table>
            </div>
            <p class="small">実測:出口が 4 つある会社の Mac と自宅の Mac は、以前は中継で 0.6 MB/s、いまは直接つながります。</p>
            <p class="small">詳しくは<a href="../../design/nat-traversal.html">技術資料</a>(中国語)をご覧ください。</p>
          </div>
        </div>
      </div>
    </section>

    <section class="section" id="fallbacks" aria-labelledby="fallback-title">
      <div class="wrap">
        <h2 id="fallback-title">うまくいかないとき</h2>
        <p class="intro">よくあるケースには、どれも対処しています。</p>
        <dl class="fallbacks">
          <div><dt>同じネットワークなのに相手が見つからない</dt><dd>ペアリング時に相手のアドレスを入力すれば、その後は記憶されます。</dd></div>
          <div><dt>直接つながらない</dt><dd>サーバーが中継します。内容は同じく暗号化されます。</dd></div>
          <div><dt>相手がスリープした、切断された</dt><dd>復帰すると自動で再接続します。</dd></div>
          <div><dt>ファイル送信中に切断された</dt><dd>つながったら続きから送ります。</dd></div>
          <div><dt>Windows では使えないファイル名</dt><dd>全角文字に置き換えるので、名前はそのまま読めます。</dd></div>
          <div><dt>パスワードをコピーした</dt><dd>Windows ではパスワードマネージャーからコピーした内容を飛ばします。</dd></div>
        </dl>
      </div>
    </section>

    <section class="section" id="specs" aria-labelledby="specs-title">
      <div class="wrap">
        <h2 id="specs-title">仕様</h2>
        <div class="table-scroll">
          <table class="specs">
            <tbody>
            <tr><th scope="row">バージョン</th><td>2.10.1(<time datetime="2026-11-07">2026 年 11 月 7 日</time>公開)</td></tr>
            <tr><th scope="row">Mac アプリ</th><td>macOS 13 Ventura 以降。Apple シリコン版と Intel 版に分かれ、ダウンロードはそれぞれ約 25 MB で Rosetta 不要。両方で動くユニバーサル版は約 47 MB</td></tr>
            <tr><th scope="row">Windows アプリ</th><td>Windows 10 と Windows 11、x64。ユーザーごとのインストールで管理者権限不要。ダウンロードは約 23 MB</td></tr>
            <tr><th scope="row">Linux アプリ</th><td>x64 と ARM64。.deb(Debian、Ubuntu など)または tar.gz(ほかのディストリビューション)、約 22 MB。X11 のデスクトップ、または XWayland 付きの Wayland デスクトップ(GNOME、KDE などは標準で搭載)が必要。GTK 3</td></tr>
            <tr><th scope="row">サーバー</th><td>「サービス」を使う場合や同じネットワークでは不要。自分で立てる場合は Linux x86_64/ARM64、macOS、Windows 10/11 x64 に対応。</td></tr>
            <tr><th scope="row">表示言語</th><td>日本語、英語、簡体字中国語、繁体字中国語(台湾・香港)。初期設定はシステムに合わせ、「設定」で切り替え可能</td></tr>
            <tr><th scope="row">同期する内容</th><td>プレーンテキスト、書式付きテキスト、画像とスクリーンショット、ファイル、フォルダ。種類ごとにオフにできる</td></tr>
            <tr><th scope="row">転送</th><td>WebRTC データチャネル。直接接続を優先し、つながらなければ TURN で中継。同じネットワークでは mDNS で発見し、UDP 8788 で接続情報を交換。複数の出口があるネットワークでは出口ごとに調査。ファイルは tar + zstd でストリーム転送</td></tr>
            <tr><th scope="row">暗号化と身元</th><td>DTLS によるエンドツーエンド暗号化。デバイスの身元は Ed25519 の鍵。シグナリングのメッセージはすべて署名付き</td></tr>
            <tr><th scope="row">ペアリング</th><td>5 分間有効な 6 桁のコード。0/O や 1/I のような紛らわしい文字は使わない。指紋は人が照合</td></tr>
            <tr><th scope="row">自動同期の上限</th><td>初期値 50 MB、1 MB〜1 GB で調整可能</td></tr>
            <tr><th scope="row">ファイル送信</th><td>1 台のデバイスへ、サイズ無制限。ファイルもフォルダまるごとも送れる。同じネットワークでは暗号化した TCP 接続(両方に 2.5.1 が必要)、使えないときは WebRTC に切り替え。インターネット経由と中継は WebRTC。切れても続きから送り、各ファイルを SHA-256 で検証。Mac から Linux 仮想マシンへ 1 GB を送る実測で 144.3 MB/s。実際の速度はネットワークとディスクしだい</td></tr>
            <tr><th scope="row">連絡先</th><td>F で始まる 7 文字の連絡先コードで追加。ローカルネットワークか「サービス」で交換し、安全コードも照合できる。連絡先とはファイルと画像だけを送り合え、200 文字までのメモを添えられ、毎回相手の受け入れが必要。連絡先にはクリップボード、履歴、デバイスは見えない。受信したファイルは実行権限を外し、Mac では検疫属性を付ける。双方に 2.6 以降が必要</td></tr>
            <tr><th scope="row">履歴の保存期間</th><td>初期値 3 日、1 時間〜30 日で調整可能。期限が来たら自動で削除</td></tr>
            <tr><th scope="row">実測の速度</th><td>LAN の直接接続で 20 MB のファイルを約 330 ミリ秒で転送、チェックサム一致</td></tr>
            <tr><th scope="row">技術スタック</th><td>バックグラウンドサービスとサーバーは Go(Windows では Go から Win32 を直接呼び出し、Linux では Go で X11 プロトコルを直接扱う)、アプリは Flutter(3 つの OS で同じコード)、メッセージ定義は Protocol Buffers</td></tr>
            <tr><th scope="row">ライセンス</th><td><a href="https://github.com/baiyuze/pasteferry/blob/main/LICENSING.md">GNU AGPL-3.0</a></td></tr>
            </tbody>
          </table>
        </div>
      </div>
    </section>
  </main>

  <footer class="footer">
    <div class="wrap">
      <p>PasteFerry は GNU AGPL-3.0 のオープンソースです。</p>
      <nav aria-label="フッターのリンク">
        <a href="https://github.com/baiyuze/pasteferry/releases">すべてのリリース</a>
        <a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">更新履歴</a>
        <a href="https://pasteferry.cc/design/nat-traversal.html">技術資料(中国語)</a>
        <a href="https://github.com/baiyuze/pasteferry/blob/main/LICENSING.md">ライセンス</a>
        <a href="https://github.com/baiyuze/pasteferry/issues">問題を報告</a>
        <a href="../../ja/privacy/">プライバシー</a>
        <a href="../../ja/feedback/">ディスカッションとフィードバック</a>
      </nav>
      <nav aria-label="言語">
        <a href="../../how/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a>
        <a href="../../zh-tw/how/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a>
        <a href="../../zh-hk/how/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a>
        <a href="../../en/how/" hreflang="en" lang="en" data-lang="en">English</a>
        <a href="../../ja/how/" hreflang="ja" lang="ja" data-lang="ja" aria-current="page">日本語</a>
      </nav>
    </div>
  </footer>

  <script src="../../assets/site.js?v=fb60f6e5ce" defer></script>
  <script src="/assets/analytics.js?v=e2777f714d" defer></script>
  <script type="module" src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "7ee226baf4a949a397c4bfd69a9e7461"}'></script>
</body>
</html>