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.
Dart airdrop-alternativeclipboardclipboard-sharingclipboard-synccopy-pastecross-platformend-to-end-encryptionfile-syncfile-transferfluttergolanglinuxmacosnat-traversalp2pself-hostedtailscaleuniversal-clipboardwebrtcwindows
docs(site): align relay explanations with official access
baiyuzecb838dc72a99
diff --git a/docs/en/index.html b/docs/en/index.htmlindex cd64f64..91e2e2a 100644--- a/docs/en/index.html+++ b/docs/en/index.html@@ -331,7 +331,7 @@<tr><th scope="row">Paste right away, nothing to accept</th><td class="yes ours">Yes</td><td class="yes">Yes</td><td class="no">No</td><td class="no">No</td></tr><tr><th scope="row">Files and whole folders</th><td class="yes ours">Yes</td><td class="partial">Unreliable</td><td class="yes">Yes</td><td class="partial">Zip first</td></tr><tr><th scope="row">Find something you copied earlier</th><td class="yes ours">Yes</td><td class="no">No</td><td class="no">No</td><td class="partial">Scroll back</td></tr>- <tr><th scope="row">Only your devices can decrypt content</th><td class="yes ours">Yes</td><td class="yes">Yes</td><td class="yes">Yes</td><td class="no">No</td></tr>+ <tr><th scope="row">Only your devices can decrypt content</th><td class="yes ours">Yes</td><td class="yes">Yes</td><td class="yes">Yes</td><td class="some">Varies by app</td></tr></tbody></table></div>@@ -341,13 +341,13 @@<section class="section" id="how" aria-labelledby="how-title"><div class="wrap"><h2 id="how-title">How it works</h2>- <p class="intro">Your two computers open an encrypted connection to each other. On the same network they find each other on their own; across networks your server introduces them, and relays traffic when a direct path can't be made. The diagram shows the cross-network case.</p>+ <p class="intro">On the same network, devices find each other without a server. Across networks, official access or your own server exchanges connection information. Direct NAT traversal comes first; encrypted relay is used after direct failure. The diagram shows this general signaling and relay structure.</p><figure class="diagram"><svg viewBox="0 0 960 400" role="img" aria-labelledby="diagram-title diagram-desc"><title id="diagram-title">How PasteFerry connects</title><desc id="diagram-desc">Computer A and computer B (Mac or Windows) connect directly over WebRTC. Both connect to your server for signaling. If the direct connection fails, data is relayed through the server's TURN service.</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">Your server</text>+ <text class="d-title" x="480" y="64" text-anchor="middle">Signaling and relay service</text><text class="d-sub" x="480" y="92" text-anchor="middle">Signaling, STUN, TURN relay</text><path class="d-sig" d="M140 210V58H360"/><path class="d-sig" d="M820 210V58H600"/>@@ -372,7 +372,7 @@</svg><ul class="points diagram-text"><li><strong>Direct WebRTC, DTLS encrypted</strong> Data moves only between your computers</li>- <li><strong>Your server</strong> Signaling, STUN, TURN relay</li>+ <li><strong>Signaling and relay service</strong> Signaling, STUN, TURN relay</li><li>Relay: only if direct fails</li></ul></figure>@@ -392,7 +392,7 @@<li><strong>All of them sent to the peer.</strong> The peer tries each address; the one matching the real uplink gets through.</li><li><strong>Uplinks remembered.</strong> If a round misses an uplink that keeps ports unchanged, its address is filled in as uplink IP plus local port.</li><li><strong>A rule for who sends first.</strong> Some routers lock a port when the other side's packet arrives first. One side announces its addresses first; the other sends to them before announcing its own. Retries alternate the order.</li>- <li><strong>Relay first, direct later.</strong> If the first handshake lands on the relay, PasteFerry punches again while idle and switches to direct when that works.</li>+ <li><strong>Retry direct while idle.</strong>If direct traversal fails and relay is available, sync can use relay. When the connection is idle, the client can retry direct access and release the relay after success.</li></ul></div><div>@@ -453,9 +453,9 @@<dl class="fallbacks"><div><dt>Can't find the other computer on the network</dt><dd>Different subnets, guest networks and Wi‑Fi with client isolation block local discovery. Enter the address shown under the other computer's code when pairing; it's remembered afterwards, and if both computers change addresses you enter it once more in the device list.</dd></div><div><dt>The system blocks the local network</dt><dd>From macOS 15, the background service needs your permission to reach devices on the local network; Windows asks about the firewall on first run. If either isn't allowed, the app says so and links straight to the fix.</dd></div>- <div><dt>No direct path between the computers</dt><dd>Common behind symmetric NAT and corporate firewalls. Traffic switches to the TURN relay on your server, still encrypted, and the device list shows "Relay".</dd></div>+ <div><dt>No direct path between the computers</dt><dd>Official access requests relay only after direct failure and within its current allowance. A custom server uses its own TURN relay instead. Content remains end-to-end encrypted in either case.</dd></div><div><dt>Public STUN servers unreachable</dt><dd>Public STUN is unreliable in some regions, including mainland China. Your server runs its own STUN, and clients prefer it.</dd></div>- <div><dt>Connected through the relay first</dt><dd>The relay handshake is fast and sometimes beats the direct path. Once connected, the side that started the connection punches again while idle and switches to direct when that works, never in the middle of a transfer.</dd></div>+ <div><dt>Switching back to direct</dt><dd>If direct traversal fails and relay is available, sync can use relay. When the connection is idle, the client can retry direct access and release the relay after success.</dd></div><div><dt>The other computer sleeps, drops off or restarts</dt><dd>A connection that dies silently is noticed, closed and reconnected. Anything you copy meanwhile is kept and added to the other computer's history once it's back, without overwriting what's on its clipboard now.</dd></div><div><dt>Server connection drops</dt><dd>Reconnects automatically: the delay starts at 1 second and doubles up to 30, with jitter so devices don't all reconnect at once. Devices on the same network keep syncing.</dd></div><div><dt>File too large</dt><dd>Above the limit only a record is synced, pulled when you need it. If the source file is gone by then, you get a clear message instead of a vague failure.</dd></div>@@ -512,9 +512,9 @@<li><a href="cloud/">Self-hosted server</a><span>Control your own capacity</span></li><li><a href="tailscale/">Tailscale</a><span>Across networks, no server</span></li></ul>- <a class="button quiet" href="start/#server">Compare the three</a>+ <a class="button quiet" href="start/#server">Compare connection options</a></div>- <p class="pairing"><strong>Pairing:</strong> on one computer, choose Devices → Add device to show a 6-character code; enter it on the other, and confirm once both screens show the same two fingerprints. On a different subnet, also enter the address shown under the code. Any mix of Mac, Windows and Linux works the same way.</p>+ <p class="pairing">Show a pairing code on one computer, enter it on the other, and compare both fingerprint lines before confirming. Existing pairings are kept. Official access needs no peer IP. Enter an address only for LAN subnets or Tailscale.</p></div></section>@@ -528,7 +528,7 @@<tr><th scope="row">Mac app</th><td>macOS 13 Ventura or later; separate downloads for Apple silicon and Intel, about 25 MB each, no Rosetta; a universal version for both is about 47 MB</td></tr><tr><th scope="row">Windows app</th><td>Windows 10 and Windows 11, x64; installs per user, no administrator rights; about 23 MB download</td></tr><tr><th scope="row">Linux app</th><td>x64 and ARM64; .deb (Debian, Ubuntu and similar) or tar.gz (other distributions), about 22 MB; needs an X11 desktop, or a Wayland desktop with XWayland (GNOME, KDE and others include it by default); GTK 3</td></tr>- <tr><th scope="row">Server</th><td>Optional, only for syncing across networks. Linux on x86_64 or ARM64 (systemd or Docker), macOS (Intel and Apple silicon), Windows 10 and 11 x64 (as a service); about 15 MB of RAM</td></tr>+ <tr><th scope="row">Server</th><td>Deployment is needed only for self-hosting; official access needs no server of your own. Self-hosting supports Linux x86_64/ARM64, macOS and Windows 10/11 x64.</td></tr><tr><th scope="row">Languages</th><td>English, Simplified Chinese, Traditional Chinese (Taiwan and Hong Kong) and Japanese; follows the system by default, switchable in Settings</td></tr><tr><th scope="row">Content</th><td>Plain text, rich text, images and screenshots, files, folders; each type can be turned off</td></tr><tr><th scope="row">Transport</th><td>WebRTC data channels, direct first with TURN relay fallback; on the same network, mDNS discovery and connection details over UDP 8788; every uplink probed on multi-uplink networks; files streamed as tar + zstd</td></tr>diff --git a/docs/index.html b/docs/index.htmlindex e5dbd26..b1480e4 100644--- a/docs/index.html+++ b/docs/index.html@@ -324,7 +324,7 @@<h2 id="history-title">所有设备上复制过的,都在这里</h2><p class="intro">复制记录保留最近 3 天的内容,随时可以放回剪贴板,图片点开就能预览。50 MB 以内的文件在你复制的时候就已经传好了,更大的文件需要时点一下再拉取。想找以前复制过的,按文字内容或文件名搜一下就有。</p><figure class="shot">- <img src="assets/screenshots/history-dark.png" width="2112" height="1472" alt="隔空贴的复制记录:来自 MacBook Air 和 Mac mini 的文件、图片、文字,大文件显示「拉取到本机」按钮">+ <img src="assets/screenshots/history-dark.png" width="2112" height="1472" alt="隔空贴的复制记录:来自 MacBook Air 和 Mac mini 的文件、图片、文字,大文件显示「接收」按钮"></figure></div></section>@@ -356,7 +356,7 @@<tr><th scope="row">复制后直接粘贴,不用点接收</th><td class="yes ours">可以</td><td class="yes">可以</td><td class="no">不行</td><td class="no">不行</td></tr><tr><th scope="row">文件与整个文件夹</th><td class="yes ours">可以</td><td class="partial">不稳定</td><td class="yes">可以</td><td class="partial">要先打包</td></tr><tr><th scope="row">找回之前复制过的内容</th><td class="yes ours">可以</td><td class="no">不行</td><td class="no">不行</td><td class="partial">翻聊天记录</td></tr>- <tr><th scope="row">仅自己的设备可解密内容</th><td class="yes ours">不经过</td><td class="yes">不经过</td><td class="yes">不经过</td><td class="no">经过</td></tr>+ <tr><th scope="row">仅自己的设备可解密内容</th><td class="yes ours">可以</td><td class="yes">可以</td><td class="yes">可以</td><td class="some">视软件而定</td></tr></tbody></table></div>@@ -366,13 +366,13 @@<section class="section" id="how" aria-labelledby="how-title"><div class="wrap"><h2 id="how-title">工作原理</h2>- <p class="intro">两台电脑之间直接建立加密连接。同一个网络里,它们自己就能找到彼此;跨网络时,你的服务器负责牵线,打不通直连的时候再帮忙转发。下图是跨网络的情形。</p>+ <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">隔空贴的连接方式</title>- <desc id="diagram-desc">电脑 A 与电脑 B(Mac 或 Windows)之间是 WebRTC 直连;两台电脑都通过信令连接到你的服务器;直连失败时,数据经服务器的 TURN 中转。</desc>+ <desc id="diagram-desc">电脑 A 与电脑 B(Mac 或 Windows)之间是 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-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"/>@@ -397,7 +397,7 @@</svg><ul class="points diagram-text"><li><strong>WebRTC 直连,DTLS 加密</strong> 数据只在两台电脑之间传输</li>- <li><strong>你的服务器</strong> 信令、STUN、TURN 中转</li>+ <li><strong>信令与中转服务</strong> 信令、STUN、TURN 中转</li><li>中转:仅在打不通直连时</li></ul></figure>@@ -417,7 +417,7 @@<li><strong>全部告诉对端。</strong>对端逐个尝试,与实际出口吻合的那一个能打通。</li><li><strong>记住见过的出口。</strong>某次漏掉的出口如果不改端口,就用「出口 IP + 本地端口」推算补上。</li><li><strong>定好谁先发包。</strong>有的路由器收到对方先到的包会占住端口。一方先公布出口地址,另一方先往那边发包再公布自己的;重试时两种顺序轮流用。</li>- <li><strong>先中转,再换直连。</strong>第一次握手落到了中转时,空闲时再打一次洞,打通就换成直连。</li>+ <li><strong>空闲时重试直连。</strong>直连失败且中转可用时,先通过中转保持同步。连接空闲时可重试打洞,成功后切回直连并释放中转。</li></ul></div><div>@@ -478,9 +478,9 @@<dl class="fallbacks"><div><dt>同一网络里找不到对方</dt><dd>不同网段、访客网络、开了 AP 隔离的 Wi‑Fi 会挡住局域网发现。配对时输入对方配对码下面显示的地址就行;之后地址会被记住,两边都换了地址时,在设备列表里给它重新输入一次。</dd></div><div><dt>系统拦着局域网</dt><dd>macOS 15 起,后台服务连接局域网里的设备要你允许;Windows 第一次运行时会问防火墙。没放行时 App 会提示,并给出直达的按钮。</dd></div>- <div><dt>两台电脑打不通直连</dt><dd>常见于对称 NAT 和公司防火墙。自动改走你服务器上的 TURN 中转,内容依然加密,设备列表里显示「中转」。</dd></div>+ <div><dt>两台电脑打不通直连</dt><dd>官方模式在直连失败后,按当前额度申请中转;自建模式使用自己的 TURN 中转。两种方式的内容均保持端到端加密。</dd></div><div><dt>公共 STUN 服务器连不上</dt><dd>国内访问公共 STUN 时通时断。服务器自带 STUN,客户端优先用它。</dd></div>- <div><dt>先连上了中转</dt><dd>中转握手快,有时会抢在直连之前。连上之后,发起连接的一方会在空闲时再打一次洞,打通就换成直连;正在传文件时不打扰。</dd></div>+ <div><dt>从中转切回直连</dt><dd>直连失败且中转可用时,先通过中转保持同步。连接空闲时可重试打洞,成功后切回直连并释放中转。</dd></div><div><dt>对方睡眠、断网或重启</dt><dd>连接悄悄断了也能发现,立即关闭重连。这期间复制的内容会记下来,连上后补发到对方的复制记录里,但不会覆盖对方此刻剪贴板里的内容。</dd></div><div><dt>服务器断开</dt><dd>自动重连,间隔从 1 秒开始翻倍、最长 30 秒,并带随机抖动,避免一群设备同时重连。同一网络里的设备不受影响,照常同步。</dd></div><div><dt>文件太大</dt><dd>超过上限的只同步一条记录,需要时再拉取。拉取时源文件已经被删,会明确告诉你,而不是不明不白地失败。</dd></div>@@ -537,9 +537,9 @@<li><a href="cloud/">自建公网服务器</a><span>自己管理容量与部署</span></li><li><a href="tailscale/">Tailscale</a><span>跨网络,不用服务器</span></li></ul>- <a class="button quiet" href="start/#server">对比三种方式</a>+ <a class="button quiet" href="start/#server">对比连接方式</a></div>- <p class="pairing"><strong>配对:</strong>一台点「设备 → 添加设备」生成 6 位配对码,另一台输入它;两块屏幕上的两行安全指纹完全一致后确认。不在同一网段时,输入配对码的同时输入它下面显示的地址。Mac、Windows、Linux 之间怎么组合都一样。</p>+ <p class="pairing">一台生成配对码,另一台输入;核对两边的安全指纹后确认。已有配对关系可以继续使用。 官方服务无需填写对端 IP;仅局域网跨网段或 Tailscale 配对时填写对端地址。</p></div></section>@@ -553,7 +553,7 @@<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(systemd 或 Docker)、macOS(Intel 与 Apple 芯片)、Windows 10 与 11 x64(系统服务);约 15 MB 内存</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>简体中文、繁體中文(台灣、香港)、English、日本語,默认跟随系统,可在设置里切换</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>diff --git a/docs/ja/index.html b/docs/ja/index.htmlindex a41e401..6b56f4e 100644--- a/docs/ja/index.html+++ b/docs/ja/index.html@@ -331,7 +331,7 @@<tr><th scope="row">コピーしてすぐ貼り付け、受け取り操作なし</th><td class="yes ours">できる</td><td class="yes">できる</td><td class="no">できない</td><td class="no">できない</td></tr><tr><th scope="row">ファイルとフォルダまるごと</th><td class="yes ours">できる</td><td class="partial">不安定</td><td class="yes">できる</td><td class="partial">先に圧縮</td></tr><tr><th scope="row">前にコピーしたものを探す</th><td class="yes ours">できる</td><td class="no">できない</td><td class="no">できない</td><td class="partial">履歴をさかのぼる</td></tr>- <tr><th scope="row">内容を復号できるのは自分の端末のみ</th><td class="yes ours">通らない</td><td class="yes">通らない</td><td class="yes">通らない</td><td class="no">通る</td></tr>+ <tr><th scope="row">内容を復号できるのは自分の端末のみ</th><td class="yes ours">可能</td><td class="yes">可能</td><td class="yes">可能</td><td class="some">アプリによる</td></tr></tbody></table></div>@@ -341,13 +341,13 @@<section class="section" id="how" aria-labelledby="how-title"><div class="wrap"><h2 id="how-title">しくみ</h2>- <p class="intro">2 台のコンピューターは、暗号化された接続で直接つながります。同じネットワークなら自分たちでお互いを見つけます。ネットワークをまたぐときはサーバーが引き合わせ、直接つながらないときだけ中継します。下の図はネットワークをまたぐ場合です。</p>+ <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(Mac または Windows)は WebRTC で直接つながります。どちらもシグナリングのためにあなたのサーバーへ接続し、直接接続に失敗したときはサーバーの TURN でデータを中継します。</desc>+ <desc id="diagram-desc">コンピューター A と B(Mac または Windows)は 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-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"/>@@ -372,7 +372,7 @@</svg><ul class="points diagram-text"><li><strong>WebRTC 直接接続、DTLS 暗号化</strong> データは 2 台のあいだだけを流れる</li>- <li><strong>あなたのサーバー</strong> シグナリング、STUN、TURN 中継</li>+ <li><strong>シグナリング・中継サービス</strong> シグナリング、STUN、TURN 中継</li><li>中継:直接つながらないときだけ</li></ul></figure>@@ -392,7 +392,7 @@<li><strong>すべて相手に伝える。</strong>相手はひとつずつ試し、実際の出口と合うものがつながります。</li><li><strong>見た出口を覚えておく。</strong>ポートを書き換えない出口を取りこぼしたときは、「出口の IP +ローカルポート」で補います。</li><li><strong>どちらが先に送るかを決める。</strong>相手のパケットが先に届くとポートをふさいでしまうルーターがあります。片方が先にアドレスを公開し、もう片方はそこへ送ってから自分のアドレスを公開します。再試行では順番を入れ替えます。</li>- <li><strong>まず中継、あとで直接。</strong>最初のハンドシェイクが中継になったら、アイドル時にもう一度穴あけを試み、成功すれば直接接続に切り替えます。</li>+ <li><strong>待機中に直接接続を再試行。</strong>直接接続に失敗して中継が利用可能なら、中継で同期を続けます。待機中に直接接続を再試行し、成功したら中継を解放します。</li></ul></div><div>@@ -453,9 +453,9 @@<dl class="fallbacks"><div><dt>同じネットワークなのに相手が見つからない</dt><dd>サブネットが違う、ゲストネットワーク、クライアント分離(AP アイソレーション)が有効な Wi‑Fi では、LAN 内の検出が届きません。ペアリング時に相手のコードの下に表示されたアドレスを入力してください。アドレスはその後も記憶され、両方のアドレスが変わったときはデバイス一覧からもう一度入力します。</dd></div><div><dt>システムがローカルネットワークを止めている</dt><dd>macOS 15 以降、バックグラウンドサービスが LAN 上のデバイスに接続するにはあなたの許可が要ります。Windows は初回起動時にファイアウォールについて聞いてきます。許可されていないときはアプリが知らせ、設定へ直接飛べるボタンを出します。</dd></div>- <div><dt>2 台が直接つながらない</dt><dd>対称型 NAT や会社のファイアウォールでよく起きます。自動であなたのサーバーの TURN 中継に切り替わり、内容は暗号化されたまま。デバイス一覧には「中継」と表示されます。</dd></div>+ <div><dt>2 台が直接つながらない</dt><dd>公式モードでは直接接続に失敗した後、残量の範囲内で中継を申請します。独自サーバーではその TURN 中継を使います。どちらも内容はエンドツーエンド暗号化されます。</dd></div><div><dt>公開 STUN サーバーにつながらない</dt><dd>中国本土などでは公開 STUN が不安定です。サーバーは STUN を内蔵していて、クライアントはそちらを優先します。</dd></div>- <div><dt>先に中継でつながった</dt><dd>中継のハンドシェイクは速く、直接接続より先に決まることがあります。接続後、接続を始めた側がアイドル時にもう一度穴あけを試み、成功すれば直接接続に切り替えます。転送中は邪魔しません。</dd></div>+ <div><dt>直接接続へ切り替える</dt><dd>直接接続に失敗して中継が利用可能なら、中継で同期を続けます。待機中に直接接続を再試行し、成功したら中継を解放します。</dd></div><div><dt>相手がスリープ、切断、再起動した</dt><dd>黙って切れた接続にも気づき、すぐに閉じて再接続します。そのあいだにコピーしたものは記録しておき、つながったら相手の履歴に追加します。相手のいまのクリップボードは上書きしません。</dd></div><div><dt>サーバーとの接続が切れた</dt><dd>自動で再接続します。間隔は 1 秒から倍々で最大 30 秒、ランダムな揺らぎ付きで、たくさんのデバイスが一斉に再接続しないようにしています。同じネットワークのデバイスは影響を受けず、そのまま同期します。</dd></div><div><dt>ファイルが大きすぎる</dt><dd>上限を超えるものは記録だけを同期し、必要なときに取り込みます。そのとき元のファイルが消えていれば、あいまいな失敗ではなく、はっきりそう伝えます。</dd></div>@@ -512,9 +512,9 @@<li><a href="cloud/">独自の公開サーバー</a><span>容量と運用を自分で管理</span></li><li><a href="tailscale/">Tailscale</a><span>ネットワークをまたぐ、サーバーなし</span></li></ul>- <a class="button quiet" href="start/#server">3 通りを比べる</a>+ <a class="button quiet" href="start/#server">接続方法を比較</a></div>- <p class="pairing"><strong>ペアリング:</strong>一台で「デバイス → デバイスを追加」を開いて 6 桁のコードを表示し、もう一台で入力します。両方の画面に同じ 2 行の指紋が表示されたら確定します。別のサブネットにある場合は、コードの下に表示されたアドレスも入力します。Mac、Windows、Linux のどの組み合わせでも同じ手順です。</p>+ <p class="pairing">一方でコードを表示し、もう一方で入力。両画面の指紋を照合して確認します。既存のペアリングはそのまま使えます。 公式サービスでは相手の IP は不要です。LAN の別サブネットや Tailscale の場合のみ相手のアドレスを入力します。</p></div></section>@@ -528,7 +528,7 @@<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、systemd または Docker)、macOS(Intel と Apple シリコン)、Windows 10・11 x64(サービスとして動作)。メモリは約 15 MB</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>diff --git a/docs/zh-hk/index.html b/docs/zh-hk/index.htmlindex 0038928..90f478c 100644--- a/docs/zh-hk/index.html+++ b/docs/zh-hk/index.html@@ -299,7 +299,7 @@<h2 id="history-title">所有裝置上複製過的內容,都在這裏</h2><p class="intro">複製記錄保留最近 3 天的內容,隨時可以放回剪貼簿,圖片按一下就能預覽。50 MB 以內的檔案在你複製的時候已經傳送好了,更大的檔案需要時按一下再拉取。想找以前複製過的,用文字內容或檔案名稱搜尋一下就找到。</p><figure class="shot">- <img src="../assets/screenshots/zh-hk/history-dark.png" width="2112" height="1472" alt="隔空貼的複製記錄:來自 MacBook Air 和 Mac mini 的檔案、圖片、文字,大檔案顯示「拉取到本機」按鈕">+ <img src="../assets/screenshots/zh-hk/history-dark.png" width="2112" height="1472" alt="隔空貼的複製記錄:來自 MacBook Air 和 Mac mini 的檔案、圖片、文字,大檔案顯示「接收」按鈕"></figure></div></section>@@ -331,7 +331,7 @@<tr><th scope="row">複製後直接貼上,不用按接受</th><td class="yes ours">可以</td><td class="yes">可以</td><td class="no">不行</td><td class="no">不行</td></tr><tr><th scope="row">檔案與整個資料夾</th><td class="yes ours">可以</td><td class="partial">不穩定</td><td class="yes">可以</td><td class="partial">要先壓縮</td></tr><tr><th scope="row">找回之前複製過的內容</th><td class="yes ours">可以</td><td class="no">不行</td><td class="no">不行</td><td class="partial">翻查聊天記錄</td></tr>- <tr><th scope="row">只有自己的裝置可解密內容</th><td class="yes ours">不經過</td><td class="yes">不經過</td><td class="yes">不經過</td><td class="no">經過</td></tr>+ <tr><th scope="row">只有自己的裝置可解密內容</th><td class="yes ours">可以</td><td class="yes">可以</td><td class="yes">可以</td><td class="some">視軟件而定</td></tr></tbody></table></div>@@ -341,13 +341,13 @@<section class="section" id="how" aria-labelledby="how-title"><div class="wrap"><h2 id="how-title">運作原理</h2>- <p class="intro">兩部電腦之間直接建立加密連線。在同一個網絡裏,它們自己就能找到對方;跨網絡時,由你的伺服器負責牽線,打不通直連的時候再幫忙轉發。下圖是跨網絡的情況。</p>+ <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">隔空貼的連線方式</title>- <desc id="diagram-desc">電腦 A 與電腦 B(Mac 或 Windows)之間是 WebRTC 直連;兩部電腦都透過信令連接到你的伺服器;直連失敗時,資料經伺服器的 TURN 中轉。</desc>+ <desc id="diagram-desc">電腦 A 與電腦 B(Mac 或 Windows)之間是 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-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"/>@@ -372,7 +372,7 @@</svg><ul class="points diagram-text"><li><strong>WebRTC 直連,DTLS 加密</strong> 資料只在兩部電腦之間傳輸</li>- <li><strong>你的伺服器</strong> 信令、STUN、TURN 中轉</li>+ <li><strong>信令與中轉服務</strong> 信令、STUN、TURN 中轉</li><li>中轉:僅在打不通直連時</li></ul></figure>@@ -392,7 +392,7 @@<li><strong>全部告訴對方。</strong>對方逐個嘗試,與實際出口吻合的那一個就能打通。</li><li><strong>記住見過的出口。</strong>某次漏掉的出口如果沒有改變端口,就用「出口 IP + 本機端口」推算補上。</li><li><strong>定好誰先發封包。</strong>有些路由器收到對方先到的封包,會佔用該端口。一方先公佈出口地址,另一方先向那邊發封包,再公佈自己的;重試時兩種次序輪流使用。</li>- <li><strong>先中轉,再換直連。</strong>第一次握手落到中轉時,閒置時會再打一次洞,打通就換成直連。</li>+ <li><strong>閒置時重試直連。</strong>直連失敗且中轉可用時,先透過中轉保持同步。連線閒置時可重試打洞,成功後切回直連並釋放中轉。</li></ul></div><div>@@ -453,9 +453,9 @@<dl class="fallbacks"><div><dt>在同一網絡裏找不到對方</dt><dd>不同網段、訪客網絡、開啟了 AP 隔離的 Wi‑Fi 會阻礙區域網絡發現。配對時輸入對方配對碼下面顯示的地址就可以;之後地址會被記住,兩邊都換了地址時,在裝置列表裏為它重新輸入一次。</dd></div><div><dt>系統阻擋區域網絡</dt><dd>由 macOS 15 起,背景服務連接區域網絡裏的裝置需要你允許;Windows 第一次執行時會詢問防火牆設定。未允許時 App 會提示,並提供直達設定的按鈕。</dd></div>- <div><dt>兩部電腦打不通直連</dt><dd>常見於對稱型 NAT 和公司防火牆。會自動改經你伺服器上的 TURN 中轉,內容依然加密,裝置列表裏顯示「中轉」。</dd></div>+ <div><dt>兩部電腦打不通直連</dt><dd>官方模式在直連失敗後,按目前額度申請中轉;自建模式使用自己的 TURN 中轉。兩種方式的內容均保持端到端加密。</dd></div><div><dt>公共 STUN 伺服器連不上</dt><dd>在內地連公共 STUN 時通時斷。伺服器自帶 STUN,用戶端會優先使用它。</dd></div>- <div><dt>先連上了中轉</dt><dd>中轉握手較快,有時會搶在直連之前。連上之後,發起連線的一方會在閒置時再打一次洞,打通就換成直連;正在傳送檔案時不會打擾。</dd></div>+ <div><dt>從中轉切回直連</dt><dd>直連失敗且中轉可用時,先透過中轉保持同步。連線閒置時可重試打洞,成功後切回直連並釋放中轉。</dd></div><div><dt>對方進入睡眠、斷網或重新啟動</dt><dd>連線悄悄斷了也能察覺,會立即關閉並重新連線。這期間複製的內容會記下來,連上後補發到對方的複製記錄裏,但不會覆蓋對方此刻剪貼簿裏的內容。</dd></div><div><dt>伺服器斷線</dt><dd>自動重新連線,間隔由 1 秒開始倍增、最長 30 秒,並加入隨機抖動,避免大量裝置同時重新連線。同一網絡裏的裝置不受影響,照常同步。</dd></div><div><dt>檔案太大</dt><dd>超過上限的只同步一條記錄,需要時再拉取。拉取時如果來源檔案已被刪除,會清楚告訴你,而不是莫名其妙地失敗。</dd></div>@@ -512,9 +512,9 @@<li><a href="cloud/">自建公網伺服器</a><span>自行管理容量與部署</span></li><li><a href="tailscale/">Tailscale</a><span>跨網絡,不用伺服器</span></li></ul>- <a class="button quiet" href="start/#server">比較三種方式</a>+ <a class="button quiet" href="start/#server">比較連線方式</a></div>- <p class="pairing"><strong>配對:</strong>一部電腦按「裝置 → 新增裝置」產生 6 位配對碼,另一部輸入它;兩邊螢幕上的兩行安全指紋完全一致後確認。不在同一網段時,輸入配對碼的同時,也要輸入它下面顯示的地址。Mac、Windows、Linux 之間怎樣組合都一樣。</p>+ <p class="pairing">一部產生配對碼,另一部輸入;核對兩邊的安全指紋後確認。原有配對關係可以繼續使用。 官方服務無需填寫對方 IP;只在區域網絡跨網段或 Tailscale 配對時填寫對方地址。</p></div></section>@@ -528,7 +528,7 @@<tr><th scope="row">Mac 用戶端</th><td>macOS 13 Ventura 或以上;Apple 晶片與 Intel 處理器的 Mac 各有一個安裝檔,約 25 MB,不需要 Rosetta;另有兩種 Mac 通用的版本,約 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(systemd 或 Docker)、macOS(Intel 與 Apple 晶片)、Windows 10 與 11 x64(系統服務);約佔 15 MB 記憶體</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>簡體中文、繁體中文(台灣、香港)、English、日本語,預設跟隨系統,可在設定裏切換</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>diff --git a/docs/zh-tw/index.html b/docs/zh-tw/index.htmlindex 76c48b7..1d00dff 100644--- a/docs/zh-tw/index.html+++ b/docs/zh-tw/index.html@@ -299,7 +299,7 @@<h2 id="history-title">所有裝置上複製過的,都在這裡</h2><p class="intro">複製記錄保留最近 3 天的內容,隨時可以放回剪貼簿,圖片點一下就能預覽。50 MB 以內的檔案在你複製的時候就已經傳好了,更大的檔案等需要時再點一下拉取。想找以前複製過的,用文字內容或檔名搜尋一下就有。</p><figure class="shot">- <img src="../assets/screenshots/zh-tw/history-dark.png" width="2112" height="1472" alt="隔空貼的複製記錄:來自 MacBook Air 和 Mac mini 的檔案、圖片、文字,大檔案顯示「拉取到本機」按鈕">+ <img src="../assets/screenshots/zh-tw/history-dark.png" width="2112" height="1472" alt="隔空貼的複製記錄:來自 MacBook Air 和 Mac mini 的檔案、圖片、文字,大檔案顯示「接收」按鈕"></figure></div></section>@@ -331,7 +331,7 @@<tr><th scope="row">複製後直接貼上,不用點接受</th><td class="yes ours">可以</td><td class="yes">可以</td><td class="no">不行</td><td class="no">不行</td></tr><tr><th scope="row">檔案與整個資料夾</th><td class="yes ours">可以</td><td class="partial">不穩定</td><td class="yes">可以</td><td class="partial">要先壓縮</td></tr><tr><th scope="row">找回之前複製過的內容</th><td class="yes ours">可以</td><td class="no">不行</td><td class="no">不行</td><td class="partial">翻聊天記錄</td></tr>- <tr><th scope="row">僅自己的裝置可解密內容</th><td class="yes ours">不經過</td><td class="yes">不經過</td><td class="yes">不經過</td><td class="no">經過</td></tr>+ <tr><th scope="row">僅自己的裝置可解密內容</th><td class="yes ours">可以</td><td class="yes">可以</td><td class="yes">可以</td><td class="some">依軟體而定</td></tr></tbody></table></div>@@ -341,13 +341,13 @@<section class="section" id="how" aria-labelledby="how-title"><div class="wrap"><h2 id="how-title">運作原理</h2>- <p class="intro">兩台電腦之間直接建立加密連線。在同一個網路裡,它們自己就能找到彼此;跨網路時,由你的伺服器負責牽線,直連打不通時再幫忙轉送。下圖是跨網路的情況。</p>+ <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">隔空貼的連線方式</title>- <desc id="diagram-desc">電腦 A 與電腦 B(Mac 或 Windows)之間是 WebRTC 直連;兩台電腦都透過信令連線到你的伺服器;直連失敗時,資料經伺服器的 TURN 中繼。</desc>+ <desc id="diagram-desc">電腦 A 與電腦 B(Mac 或 Windows)之間是 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-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"/>@@ -372,7 +372,7 @@</svg><ul class="points diagram-text"><li><strong>WebRTC 直連,DTLS 加密</strong> 資料只在兩台電腦之間傳輸</li>- <li><strong>你的伺服器</strong> 信令、STUN、TURN 中繼</li>+ <li><strong>信令與中繼服務</strong> 信令、STUN、TURN 中繼</li><li>中繼:只在直連打不通時</li></ul></figure>@@ -392,7 +392,7 @@<li><strong>全部告訴對方。</strong>對方逐一嘗試,與實際出口相符的那一個就能打通。</li><li><strong>記住見過的出口。</strong>某次漏掉的出口,如果它不會改變連接埠,就用「出口 IP + 本機連接埠」推算補上。</li><li><strong>講好誰先送封包。</strong>有些路由器收到對方先到的封包,會把連接埠佔住。一方先公布出口位址,另一方先往那邊送封包,再公布自己的;重試時兩種順序輪流使用。</li>- <li><strong>先中繼,再換直連。</strong>第一次交握落到中繼時,會在閒置時再打一次洞,打通就換成直連。</li>+ <li><strong>閒置時重試直連。</strong>直連失敗且中繼可用時,先透過中繼保持同步。連線閒置時可重試打洞,成功後切回直連並釋放中繼。</li></ul></div><div>@@ -453,9 +453,9 @@<dl class="fallbacks"><div><dt>在同一個網路裡找不到對方</dt><dd>不同網段、訪客網路、開了 AP 隔離的 Wi‑Fi,都會擋住區域網路探索。配對時輸入對方配對碼下方顯示的位址就行;之後位址會被記住,兩邊都換了位址時,在裝置清單裡幫它重新輸入一次。</dd></div><div><dt>系統擋住區域網路連線</dt><dd>從 macOS 15 起,背景服務要連線區域網路裡的裝置,需要你允許;Windows 第一次執行時,防火牆會跳出詢問。沒有允許時,App 會提示,並提供直達設定的按鈕。</dd></div>- <div><dt>兩台電腦打不通直連</dt><dd>常見於對稱型 NAT 和公司防火牆。會自動改走你伺服器上的 TURN 中繼,內容依然加密,裝置清單裡顯示「中繼」。</dd></div>+ <div><dt>兩台電腦打不通直連</dt><dd>官方模式在直連失敗後,依目前額度申請中繼;自建模式使用自己的 TURN 中繼。兩種方式的內容均保持端到端加密。</dd></div><div><dt>連不上公共 STUN 伺服器</dt><dd>在中國大陸連公共 STUN 時通時斷。伺服器內建 STUN,用戶端會優先使用它。</dd></div>- <div><dt>先連上了中繼</dt><dd>中繼的交握比較快,有時會搶在直連之前。連上之後,發起連線的一方會在閒置時再打一次洞,打通就換成直連;正在傳檔案時不會打擾。</dd></div>+ <div><dt>從中繼切回直連</dt><dd>直連失敗且中繼可用時,先透過中繼保持同步。連線閒置時可重試打洞,成功後切回直連並釋放中繼。</dd></div><div><dt>對方睡眠、斷線或重新開機</dt><dd>連線悄悄斷了也能察覺,會立即關閉並重新連線。這段期間複製的內容會先記下來,連上後補送到對方的複製記錄裡,但不會覆蓋對方當下剪貼簿裡的內容。</dd></div><div><dt>伺服器斷線</dt><dd>自動重新連線,間隔從 1 秒開始加倍、最長 30 秒,並加上隨機抖動,避免一大群裝置同時重連。同一個網路裡的裝置不受影響,照常同步。</dd></div><div><dt>檔案太大</dt><dd>超過上限的只同步一筆記錄,需要時再拉取。拉取時如果原始檔案已經被刪除,會明確告訴你,而不是莫名其妙地失敗。</dd></div>@@ -512,9 +512,9 @@<li><a href="cloud/">自建公網伺服器</a><span>自行管理容量與部署</span></li><li><a href="tailscale/">Tailscale</a><span>跨網路,不用伺服器</span></li></ul>- <a class="button quiet" href="start/#server">比較三種方式</a>+ <a class="button quiet" href="start/#server">比較連線方式</a></div>- <p class="pairing"><strong>配對:</strong>一台點「裝置 → 新增裝置」產生一組 6 碼的配對碼,另一台輸入它;兩邊螢幕上的兩行安全指紋完全一致後再確認。不在同一個網段時,輸入配對碼的同時,也要輸入它下方顯示的位址。Mac、Windows、Linux 之間怎麼搭配都一樣。</p>+ <p class="pairing">一台產生配對碼,另一台輸入;核對兩邊的安全指紋後確認。原有配對關係可繼續使用。 官方服務無需填寫對方 IP;僅區域網路跨網段或 Tailscale 配對時填寫對方位址。</p></div></section>@@ -528,7 +528,7 @@<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(systemd 或 Docker)、macOS(Intel 與 Apple 晶片)、Windows 10 與 11 x64(系統服務);約佔 15 MB 記憶體</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>簡體中文、繁體中文(台灣、香港)、English、日本語,預設跟隨系統,可在設定裡切換</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>diff --git a/tools/site/content/en.py b/tools/site/content/en.pyindex 8446496..083b8c5 100644--- a/tools/site/content/en.py+++ b/tools/site/content/en.py@@ -135,30 +135,12 @@ C = {("Paste right away, nothing to accept", [("yes", "Yes"), ("yes", "Yes"), ("no", "No"), ("no", "No")]),("Files and whole folders", [("yes", "Yes"), ("partial", "Unreliable"), ("yes", "Yes"), ("partial", "Zip first")]),("Find something you copied earlier", [("yes", "Yes"), ("no", "No"), ("no", "No"), ("partial", "Scroll back")]),- ('Only your devices can decrypt content', [("yes", "Yes"), ("yes", "Yes"), ("yes", "Yes"), ("no", "No")]),+ ('Only your devices can decrypt content', [('yes', 'Yes'), ('yes', 'Yes'), ('yes', 'Yes'), ('some', 'Varies by app')]),],"how_h2": "How it works",- "how_intro": "Your two computers open an encrypted connection to each other. On the same network they find each other "- "on their own; across networks your server introduces them, and relays traffic when a direct path can't be "- "made. The diagram shows the cross-network case.",- "diagram": {- "title": "How PasteFerry connects",- "desc": "Computer A and computer B (Mac or Windows) connect directly over WebRTC. Both connect to your server for "- "signaling. If the direct connection fails, data is relayed through the server's TURN service.",- "server": "Your server",- "server_sub": "Signaling, STUN, TURN relay",- "sig_note": "Signaling: connection details",- "relay_note": "Relay: only if direct fails",- "copy_here": "You copy here",- "other": "Mac or Windows",- "paste_here": "You paste here",- "direct": "Direct WebRTC, DTLS encrypted",- "direct_note": "Data moves only between your computers",- "legend_direct": "Data (direct)",- "legend_relay": "Data (relay, fallback)",- "legend_sig": "Signaling",- },+ "how_intro": 'On the same network, devices find each other without a server. Across networks, official access or your own server exchanges connection information. Direct NAT traversal comes first; encrypted relay is used after direct failure. The diagram shows this general signaling and relay structure.',+ "diagram": {'title': 'How PasteFerry connects', 'desc': "Computer A and computer B (Mac or Windows) connect directly over WebRTC. Both connect to your server for signaling. If the direct connection fails, data is relayed through the server's TURN service.", 'server': 'Signaling and relay service', 'server_sub': 'Signaling, STUN, TURN relay', 'sig_note': 'Signaling: connection details', 'relay_note': 'Relay: only if direct fails', 'copy_here': 'You copy here', 'other': 'Mac or Windows', 'paste_here': 'You paste here', 'direct': 'Direct WebRTC, DTLS encrypted', 'direct_note': 'Data moves only between your computers', 'legend_direct': 'Data (direct)', 'legend_relay': 'Data (relay, fallback)', 'legend_sig': 'Signaling'},"uplink_h2": "Direct on office networks too","uplink_intro": "Office networks with two ISPs, or carriers with a pool of NAT addresses, have several uplinks and pick one "@@ -171,7 +153,7 @@ C = {("All of them sent to the peer.", " The peer tries each address; the one matching the real uplink gets through."),("Uplinks remembered.", " If a round misses an uplink that keeps ports unchanged, its address is filled in as uplink IP plus local port."),("A rule for who sends first.", " Some routers lock a port when the other side's packet arrives first. One side announces its addresses first; the other sends to them before announcing its own. Retries alternate the order."),- ("Relay first, direct later.", " If the first handshake lands on the relay, PasteFerry punches again while idle and switches to direct when that works."),+ ('Retry direct while idle.', 'If direct traversal fails and relay is available, sync can use relay. When the connection is idle, the client can retry direct access and release the relay after success.'),],"lab_h3": "Checked against real network topologies","lab_intro": "The NAT lab builds these topologies with Linux network namespaces and iptables and runs PasteFerry's actual "@@ -214,9 +196,9 @@ C = {"fallbacks": [("Can't find the other computer on the network", "Different subnets, guest networks and Wi‑Fi with client isolation block local discovery. Enter the address shown under the other computer's code when pairing; it's remembered afterwards, and if both computers change addresses you enter it once more in the device list."),("The system blocks the local network", "From macOS 15, the background service needs your permission to reach devices on the local network; Windows asks about the firewall on first run. If either isn't allowed, the app says so and links straight to the fix."),- ("No direct path between the computers", "Common behind symmetric NAT and corporate firewalls. Traffic switches to the TURN relay on your server, still encrypted, and the device list shows \"Relay\"."),+ ("No direct path between the computers", 'Official access requests relay only after direct failure and within its current allowance. A custom server uses its own TURN relay instead. Content remains end-to-end encrypted in either case.'),("Public STUN servers unreachable", "Public STUN is unreliable in some regions, including mainland China. Your server runs its own STUN, and clients prefer it."),- ("Connected through the relay first", "The relay handshake is fast and sometimes beats the direct path. Once connected, the side that started the connection punches again while idle and switches to direct when that works, never in the middle of a transfer."),+ ('Switching back to direct', 'If direct traversal fails and relay is available, sync can use relay. When the connection is idle, the client can retry direct access and release the relay after success.'),("The other computer sleeps, drops off or restarts", "A connection that dies silently is noticed, closed and reconnected. Anything you copy meanwhile is kept and added to the other computer's history once it's back, without overwriting what's on its clipboard now."),("Server connection drops", "Reconnects automatically: the delay starts at 1 second and doubles up to 30, with jitter so devices don't all reconnect at once. Devices on the same network keep syncing."),("File too large", "Above the limit only a record is synced, pulled when you need it. If the source file is gone by then, you get a clear message instead of a vague failure."),@@ -257,12 +239,10 @@ C = {],"server_h3": "Ways to connect","server_intro": 'Same network? Install and pair. Different networks? Enable official access without hosting a server. Custom servers and Tailscale remain available when you prefer to manage the connection yourself.',- "server_compare": "Compare the three",+ "server_compare": 'Compare connection options',"copy": "Copy","copied": "Copied",- "pairing": "<strong>Pairing:</strong> on one computer, choose Devices → Add device to show a 6-character code; enter it on "- "the other, and confirm once both screens show the same two fingerprints. On a different subnet, also enter the "- "address shown under the code. Any mix of Mac, Windows and Linux works the same way.",+ "pairing": 'Show a pairing code on one computer, enter it on the other, and compare both fingerprint lines before confirming. Existing pairings are kept. Official access needs no peer IP. Enter an address only for LAN subnets or Tailscale.',"specs_h2": "Specifications","specs": [@@ -272,7 +252,7 @@ C = {("Windows app", "Windows 10 and Windows 11, x64; installs per user, no administrator rights; about 23 MB download"),("Linux app", "x64 and ARM64; .deb (Debian, Ubuntu and similar) or tar.gz (other distributions), about 22 MB; ""needs an X11 desktop, or a Wayland desktop with XWayland (GNOME, KDE and others include it by default); GTK 3"),- ("Server", "Optional, only for syncing across networks. Linux on x86_64 or ARM64 (systemd or Docker), macOS (Intel and Apple silicon), Windows 10 and 11 x64 (as a service); about 15 MB of RAM"),+ ("Server", 'Deployment is needed only for self-hosting; official access needs no server of your own. Self-hosting supports Linux x86_64/ARM64, macOS and Windows 10/11 x64.'),("Languages", "English, Simplified Chinese, Traditional Chinese (Taiwan and Hong Kong) and Japanese; follows the system by default, switchable in Settings"),("Content", "Plain text, rich text, images and screenshots, files, folders; each type can be turned off"),("Transport", "WebRTC data channels, direct first with TURN relay fallback; on the same network, mDNS discovery and connection details over UDP 8788; every uplink probed on multi-uplink networks; files streamed as tar + zstd"),diff --git a/tools/site/content/ja.py b/tools/site/content/ja.pyindex 2ffb9b3..e9279eb 100644--- a/tools/site/content/ja.py+++ b/tools/site/content/ja.py@@ -125,29 +125,12 @@ C = {("コピーしてすぐ貼り付け、受け取り操作なし", [("yes", "できる"), ("yes", "できる"), ("no", "できない"), ("no", "できない")]),("ファイルとフォルダまるごと", [("yes", "できる"), ("partial", "不安定"), ("yes", "できる"), ("partial", "先に圧縮")]),("前にコピーしたものを探す", [("yes", "できる"), ("no", "できない"), ("no", "できない"), ("partial", "履歴をさかのぼる")]),- ('内容を復号できるのは自分の端末のみ', [("yes", "通らない"), ("yes", "通らない"), ("yes", "通らない"), ("no", "通る")]),+ ('内容を復号できるのは自分の端末のみ', [('yes', '可能'), ('yes', '可能'), ('yes', '可能'), ('some', 'アプリによる')]),],"how_h2": "しくみ",- "how_intro": "2 台のコンピューターは、暗号化された接続で直接つながります。同じネットワークなら自分たちでお互いを見つけます。"- "ネットワークをまたぐときはサーバーが引き合わせ、直接つながらないときだけ中継します。下の図はネットワークをまたぐ場合です。",- "diagram": {- "title": "PasteFerry の接続のしかた",- "desc": "コンピューター A と B(Mac または Windows)は WebRTC で直接つながります。どちらもシグナリングのためにあなたのサーバーへ接続し、"- "直接接続に失敗したときはサーバーの TURN でデータを中継します。",- "server": "あなたのサーバー",- "server_sub": "シグナリング、STUN、TURN 中継",- "sig_note": "シグナリング:接続情報の交換",- "relay_note": "中継:直接つながらないときだけ",- "copy_here": "ここでコピー",- "other": "Mac または Windows",- "paste_here": "ここで貼り付け",- "direct": "WebRTC 直接接続、DTLS 暗号化",- "direct_note": "データは 2 台のあいだだけを流れる",- "legend_direct": "データ(直接)",- "legend_relay": "データ(中継、予備)",- "legend_sig": "シグナリング",- },+ "how_intro": '同じネットワークではサーバーなしで端末を検出します。別ネットワークでは公式サービスまたは独自サーバーが接続情報を交換。直接接続を優先し、失敗時に暗号化中継を使います。図は共通のシグナリングと中継構成です。',+ "diagram": {'title': 'PasteFerry の接続のしかた', 'desc': 'コンピューター A と B(Mac または Windows)は WebRTC で直接つながります。どちらもシグナリングのためにシグナリング・中継サービスへ接続し、直接接続に失敗したときはサーバーの TURN でデータを中継します。', 'server': 'シグナリング・中継サービス', 'server_sub': 'シグナリング、STUN、TURN 中継', 'sig_note': 'シグナリング:接続情報の交換', 'relay_note': '中継:直接つながらないときだけ', 'copy_here': 'ここでコピー', 'other': 'Mac または Windows', 'paste_here': 'ここで貼り付け', 'direct': 'WebRTC 直接接続、DTLS 暗号化', 'direct_note': 'データは 2 台のあいだだけを流れる', 'legend_direct': 'データ(直接)', 'legend_relay': 'データ(中継、予備)', 'legend_sig': 'シグナリング'},"uplink_h2": "会社のネットワークでも直接つながる","uplink_intro": "2 つの回線を持つ会社や、キャリアの NAT アドレスプールのようなネットワークには出口が複数あり、宛先ごとに出口が変わります。"@@ -159,7 +142,7 @@ C = {("すべて相手に伝える。", "相手はひとつずつ試し、実際の出口と合うものがつながります。"),("見た出口を覚えておく。", "ポートを書き換えない出口を取りこぼしたときは、「出口の IP +ローカルポート」で補います。"),("どちらが先に送るかを決める。", "相手のパケットが先に届くとポートをふさいでしまうルーターがあります。片方が先にアドレスを公開し、もう片方はそこへ送ってから自分のアドレスを公開します。再試行では順番を入れ替えます。"),- ("まず中継、あとで直接。", "最初のハンドシェイクが中継になったら、アイドル時にもう一度穴あけを試み、成功すれば直接接続に切り替えます。"),+ ('待機中に直接接続を再試行。', '直接接続に失敗して中継が利用可能なら、中継で同期を続けます。待機中に直接接続を再試行し、成功したら中継を解放します。'),],"lab_h3": "実際のネットワーク構成で検証","lab_intro": "NAT 穴あけ実験室では、Linux のネットワーク名前空間と iptables でこれらの構成を組み、PasteFerry の本物の接続コードをそれぞれで動かします。コミットのたびに自動で実行されます。",@@ -201,9 +184,9 @@ C = {"fallbacks": [("同じネットワークなのに相手が見つからない", "サブネットが違う、ゲストネットワーク、クライアント分離(AP アイソレーション)が有効な Wi‑Fi では、LAN 内の検出が届きません。ペアリング時に相手のコードの下に表示されたアドレスを入力してください。アドレスはその後も記憶され、両方のアドレスが変わったときはデバイス一覧からもう一度入力します。"),("システムがローカルネットワークを止めている", "macOS 15 以降、バックグラウンドサービスが LAN 上のデバイスに接続するにはあなたの許可が要ります。Windows は初回起動時にファイアウォールについて聞いてきます。許可されていないときはアプリが知らせ、設定へ直接飛べるボタンを出します。"),- ("2 台が直接つながらない", "対称型 NAT や会社のファイアウォールでよく起きます。自動であなたのサーバーの TURN 中継に切り替わり、内容は暗号化されたまま。デバイス一覧には「中継」と表示されます。"),+ ("2 台が直接つながらない", '公式モードでは直接接続に失敗した後、残量の範囲内で中継を申請します。独自サーバーではその TURN 中継を使います。どちらも内容はエンドツーエンド暗号化されます。'),("公開 STUN サーバーにつながらない", "中国本土などでは公開 STUN が不安定です。サーバーは STUN を内蔵していて、クライアントはそちらを優先します。"),- ("先に中継でつながった", "中継のハンドシェイクは速く、直接接続より先に決まることがあります。接続後、接続を始めた側がアイドル時にもう一度穴あけを試み、成功すれば直接接続に切り替えます。転送中は邪魔しません。"),+ ('直接接続へ切り替える', '直接接続に失敗して中継が利用可能なら、中継で同期を続けます。待機中に直接接続を再試行し、成功したら中継を解放します。'),("相手がスリープ、切断、再起動した", "黙って切れた接続にも気づき、すぐに閉じて再接続します。そのあいだにコピーしたものは記録しておき、つながったら相手の履歴に追加します。相手のいまのクリップボードは上書きしません。"),("サーバーとの接続が切れた", "自動で再接続します。間隔は 1 秒から倍々で最大 30 秒、ランダムな揺らぎ付きで、たくさんのデバイスが一斉に再接続しないようにしています。同じネットワークのデバイスは影響を受けず、そのまま同期します。"),("ファイルが大きすぎる", "上限を超えるものは記録だけを同期し、必要なときに取り込みます。そのとき元のファイルが消えていれば、あいまいな失敗ではなく、はっきりそう伝えます。"),@@ -240,12 +223,10 @@ C = {],"server_h3": "接続方法","server_intro": '同じネットワークならインストールしてペアリング。別ネットワークなら公式サービスをオンにするだけで、サーバーの準備は不要です。独自サーバーと Tailscale も選べます。',- "server_compare": "3 通りを比べる",+ "server_compare": '接続方法を比較',"copy": "コピー","copied": "コピーしました",- "pairing": "<strong>ペアリング:</strong>一台で「デバイス → デバイスを追加」を開いて 6 桁のコードを表示し、もう一台で入力します。"- "両方の画面に同じ 2 行の指紋が表示されたら確定します。別のサブネットにある場合は、コードの下に表示されたアドレスも入力します。"- "Mac、Windows、Linux のどの組み合わせでも同じ手順です。",+ "pairing": '一方でコードを表示し、もう一方で入力。両画面の指紋を照合して確認します。既存のペアリングはそのまま使えます。 公式サービスでは相手の IP は不要です。LAN の別サブネットや Tailscale の場合のみ相手のアドレスを入力します。',"specs_h2": "仕様","specs": [@@ -255,7 +236,7 @@ C = {("Windows アプリ", "Windows 10 と Windows 11、x64。ユーザーごとのインストールで管理者権限不要。ダウンロードは約 23 MB"),("Linux アプリ", "x64 と ARM64。.deb(Debian、Ubuntu など)または tar.gz(ほかのディストリビューション)、約 22 MB。""X11 のデスクトップ、または XWayland 付きの Wayland デスクトップ(GNOME、KDE などは標準で搭載)が必要。GTK 3"),- ("サーバー", "任意。ネットワークをまたぐときだけ必要。Linux(x86_64 または ARM64、systemd または Docker)、macOS(Intel と Apple シリコン)、Windows 10・11 x64(サービスとして動作)。メモリは約 15 MB"),+ ("サーバー", '構築が必要なのは独自運用の場合のみ。公式サービスなら自分のサーバーは不要です。独自運用は Linux x86_64/ARM64、macOS、Windows 10/11 x64 に対応。'),("表示言語", "日本語、英語、簡体字中国語、繁体字中国語(台湾・香港)。初期設定はシステムに合わせ、「設定」で切り替え可能"),("同期する内容", "プレーンテキスト、書式付きテキスト、画像とスクリーンショット、ファイル、フォルダ。種類ごとにオフにできる"),("転送", "WebRTC データチャネル。直接接続を優先し、つながらなければ TURN で中継。同じネットワークでは mDNS で発見し、UDP 8788 で接続情報を交換。複数の出口があるネットワークでは出口ごとに調査。ファイルは tar + zstd でストリーム転送"),diff --git a/tools/site/content/zh-hk.py b/tools/site/content/zh-hk.pyindex c1d25d8..7db839b 100644--- a/tools/site/content/zh-hk.py+++ b/tools/site/content/zh-hk.py@@ -100,7 +100,7 @@ C = {"history_intro": "複製記錄保留最近 3 天的內容,隨時可以放回剪貼簿,圖片按一下就能預覽。""50 MB 以內的檔案在你複製的時候已經傳送好了,更大的檔案需要時按一下再拉取。""想找以前複製過的,用文字內容或檔案名稱搜尋一下就找到。",- "history_alt": "隔空貼的複製記錄:來自 MacBook Air 和 Mac mini 的檔案、圖片、文字,大檔案顯示「拉取到本機」按鈕",+ "history_alt": '隔空貼的複製記錄:來自 MacBook Air 和 Mac mini 的檔案、圖片、文字,大檔案顯示「接收」按鈕',"flow_h2": "按下複製之後","flow_intro": "文字、圖片、檔案、整個資料夾,都走同一條路。",@@ -123,28 +123,12 @@ C = {("複製後直接貼上,不用按接受", [("yes", "可以"), ("yes", "可以"), ("no", "不行"), ("no", "不行")]),("檔案與整個資料夾", [("yes", "可以"), ("partial", "不穩定"), ("yes", "可以"), ("partial", "要先壓縮")]),("找回之前複製過的內容", [("yes", "可以"), ("no", "不行"), ("no", "不行"), ("partial", "翻查聊天記錄")]),- ('只有自己的裝置可解密內容', [("yes", "不經過"), ("yes", "不經過"), ("yes", "不經過"), ("no", "經過")]),+ ('只有自己的裝置可解密內容', [('yes', '可以'), ('yes', '可以'), ('yes', '可以'), ('some', '視軟件而定')]),],"how_h2": "運作原理",- "how_intro": "兩部電腦之間直接建立加密連線。在同一個網絡裏,它們自己就能找到對方;跨網絡時,由你的伺服器負責牽線,"- "打不通直連的時候再幫忙轉發。下圖是跨網絡的情況。",- "diagram": {- "title": "隔空貼的連線方式",- "desc": "電腦 A 與電腦 B(Mac 或 Windows)之間是 WebRTC 直連;兩部電腦都透過信令連接到你的伺服器;直連失敗時,資料經伺服器的 TURN 中轉。",- "server": "你的伺服器",- "server_sub": "信令、STUN、TURN 中轉",- "sig_note": "信令:交換連線資訊",- "relay_note": "中轉:僅在打不通直連時",- "copy_here": "在這裏複製",- "other": "Mac 或 Windows",- "paste_here": "在這裏貼上",- "direct": "WebRTC 直連,DTLS 加密",- "direct_note": "資料只在兩部電腦之間傳輸",- "legend_direct": "資料(直連)",- "legend_relay": "資料(中轉,後備)",- "legend_sig": "信令",- },+ "how_intro": '同一網絡裏,裝置無需伺服器就能找到彼此;跨網絡時,官方服務或自建伺服器協助交換連線資料。優先打洞直連,失敗後才使用加密中轉。下圖展示通用的信令與中轉結構。',+ "diagram": {'title': '隔空貼的連線方式', 'desc': '電腦 A 與電腦 B(Mac 或 Windows)之間是 WebRTC 直連;兩部電腦都透過信令連接到信令與中轉服務;直連失敗時,資料經伺服器的 TURN 中轉。', 'server': '信令與中轉服務', 'server_sub': '信令、STUN、TURN 中轉', 'sig_note': '信令:交換連線資訊', 'relay_note': '中轉:僅在打不通直連時', 'copy_here': '在這裏複製', 'other': 'Mac 或 Windows', 'paste_here': '在這裏貼上', 'direct': 'WebRTC 直連,DTLS 加密', 'direct_note': '資料只在兩部電腦之間傳輸', 'legend_direct': '資料(直連)', 'legend_relay': '資料(中轉,後備)', 'legend_sig': '信令'},"uplink_h2": "公司網絡也能直連","uplink_intro": "公司雙線、電訊商地址池這類網絡有多個出口,會按目標地址選擇走哪一個。只探測一次只會知道其中一個出口,"@@ -156,7 +140,7 @@ C = {("全部告訴對方。", "對方逐個嘗試,與實際出口吻合的那一個就能打通。"),("記住見過的出口。", "某次漏掉的出口如果沒有改變端口,就用「出口 IP + 本機端口」推算補上。"),("定好誰先發封包。", "有些路由器收到對方先到的封包,會佔用該端口。一方先公佈出口地址,另一方先向那邊發封包,再公佈自己的;重試時兩種次序輪流使用。"),- ("先中轉,再換直連。", "第一次握手落到中轉時,閒置時會再打一次洞,打通就換成直連。"),+ ('閒置時重試直連。', '直連失敗且中轉可用時,先透過中轉保持同步。連線閒置時可重試打洞,成功後切回直連並釋放中轉。'),],"lab_h3": "用真實的網絡拓撲驗證","lab_intro": "NAT 打洞實驗室用 Linux 網絡命名空間與 iptables 搭建這些拓撲,用隔空貼真實的連線程式碼逐一執行,每次提交程式碼都會自動執行。",@@ -200,9 +184,9 @@ C = {"之後地址會被記住,兩邊都換了地址時,在裝置列表裏為它重新輸入一次。"),("系統阻擋區域網絡", "由 macOS 15 起,背景服務連接區域網絡裏的裝置需要你允許;Windows 第一次執行時會詢問防火牆設定。""未允許時 App 會提示,並提供直達設定的按鈕。"),- ("兩部電腦打不通直連", "常見於對稱型 NAT 和公司防火牆。會自動改經你伺服器上的 TURN 中轉,內容依然加密,裝置列表裏顯示「中轉」。"),+ ("兩部電腦打不通直連", '官方模式在直連失敗後,按目前額度申請中轉;自建模式使用自己的 TURN 中轉。兩種方式的內容均保持端到端加密。'),("公共 STUN 伺服器連不上", "在內地連公共 STUN 時通時斷。伺服器自帶 STUN,用戶端會優先使用它。"),- ("先連上了中轉", "中轉握手較快,有時會搶在直連之前。連上之後,發起連線的一方會在閒置時再打一次洞,打通就換成直連;正在傳送檔案時不會打擾。"),+ ('從中轉切回直連', '直連失敗且中轉可用時,先透過中轉保持同步。連線閒置時可重試打洞,成功後切回直連並釋放中轉。'),("對方進入睡眠、斷網或重新啟動", "連線悄悄斷了也能察覺,會立即關閉並重新連線。這期間複製的內容會記下來,連上後補發到對方的複製記錄裏,但不會覆蓋對方此刻剪貼簿裏的內容。"),("伺服器斷線", "自動重新連線,間隔由 1 秒開始倍增、最長 30 秒,並加入隨機抖動,避免大量裝置同時重新連線。同一網絡裏的裝置不受影響,照常同步。"),("檔案太大", "超過上限的只同步一條記錄,需要時再拉取。拉取時如果來源檔案已被刪除,會清楚告訴你,而不是莫名其妙地失敗。"),@@ -239,11 +223,10 @@ C = {],"server_h3": "連線方式","server_intro": '同一網絡裏裝好就能配對;不同網絡裏,啟用官方服務即可,無需自建。也保留自建伺服器與 Tailscale,按需要選擇。',- "server_compare": "比較三種方式",+ "server_compare": '比較連線方式',"copy": "複製","copied": "已複製",- "pairing": "<strong>配對:</strong>一部電腦按「裝置 → 新增裝置」產生 6 位配對碼,另一部輸入它;兩邊螢幕上的兩行安全指紋完全一致後確認。"- "不在同一網段時,輸入配對碼的同時,也要輸入它下面顯示的地址。Mac、Windows、Linux 之間怎樣組合都一樣。",+ "pairing": '一部產生配對碼,另一部輸入;核對兩邊的安全指紋後確認。原有配對關係可以繼續使用。 官方服務無需填寫對方 IP;只在區域網絡跨網段或 Tailscale 配對時填寫對方地址。',"specs_h2": "技術規格","specs": [@@ -252,7 +235,7 @@ C = {("Windows 用戶端", "Windows 10 與 Windows 11,x64;為目前用戶安裝,不需要管理員權限;安裝檔約 23 MB"),("Linux 用戶端", "x64 與 ARM64;.deb(Debian、Ubuntu 等)或 tar.gz(其他發行版),約 22 MB;""需要 X11 桌面,或帶 XWayland 的 Wayland 桌面(GNOME、KDE 等預設都已包含);GTK 3"),- ("伺服器", "可選,只在跨網絡時需要。Linux x86_64 或 ARM64(systemd 或 Docker)、macOS(Intel 與 Apple 晶片)、Windows 10 與 11 x64(系統服務);約佔 15 MB 記憶體"),+ ("伺服器", '只在自建時需要部署;使用官方服務無需自備伺服器。自建支援 Linux x86_64/ARM64、macOS 與 Windows 10/11 x64。'),("介面語言", "簡體中文、繁體中文(台灣、香港)、English、日本語,預設跟隨系統,可在設定裏切換"),("同步的內容", "純文字、帶格式的文字、圖片與截圖、檔案、資料夾,可以按類型關閉"),("傳輸", "WebRTC 數據通道,直連優先,打不通時經 TURN 中轉;同一網絡裏經 mDNS 發現、UDP 8788 交換連線資訊;多出口網絡會逐一探測每個出口;檔案以 tar + zstd 串流方式打包"),diff --git a/tools/site/content/zh-tw.py b/tools/site/content/zh-tw.pyindex 8d3221e..b0ccd68 100644--- a/tools/site/content/zh-tw.py+++ b/tools/site/content/zh-tw.py@@ -100,7 +100,7 @@ C = {"history_intro": "複製記錄保留最近 3 天的內容,隨時可以放回剪貼簿,圖片點一下就能預覽。""50 MB 以內的檔案在你複製的時候就已經傳好了,更大的檔案等需要時再點一下拉取。""想找以前複製過的,用文字內容或檔名搜尋一下就有。",- "history_alt": "隔空貼的複製記錄:來自 MacBook Air 和 Mac mini 的檔案、圖片、文字,大檔案顯示「拉取到本機」按鈕",+ "history_alt": '隔空貼的複製記錄:來自 MacBook Air 和 Mac mini 的檔案、圖片、文字,大檔案顯示「接收」按鈕',"flow_h2": "按下複製之後","flow_intro": "文字、圖片、檔案、整個資料夾,都走同一條路。",@@ -123,28 +123,12 @@ C = {("複製後直接貼上,不用點接受", [("yes", "可以"), ("yes", "可以"), ("no", "不行"), ("no", "不行")]),("檔案與整個資料夾", [("yes", "可以"), ("partial", "不穩定"), ("yes", "可以"), ("partial", "要先壓縮")]),("找回之前複製過的內容", [("yes", "可以"), ("no", "不行"), ("no", "不行"), ("partial", "翻聊天記錄")]),- ('僅自己的裝置可解密內容', [("yes", "不經過"), ("yes", "不經過"), ("yes", "不經過"), ("no", "經過")]),+ ('僅自己的裝置可解密內容', [('yes', '可以'), ('yes', '可以'), ('yes', '可以'), ('some', '依軟體而定')]),],"how_h2": "運作原理",- "how_intro": "兩台電腦之間直接建立加密連線。在同一個網路裡,它們自己就能找到彼此;跨網路時,由你的伺服器負責牽線,"- "直連打不通時再幫忙轉送。下圖是跨網路的情況。",- "diagram": {- "title": "隔空貼的連線方式",- "desc": "電腦 A 與電腦 B(Mac 或 Windows)之間是 WebRTC 直連;兩台電腦都透過信令連線到你的伺服器;直連失敗時,資料經伺服器的 TURN 中繼。",- "server": "你的伺服器",- "server_sub": "信令、STUN、TURN 中繼",- "sig_note": "信令:交換連線資訊",- "relay_note": "中繼:只在直連打不通時",- "copy_here": "在這裡複製",- "other": "Mac 或 Windows",- "paste_here": "在這裡貼上",- "direct": "WebRTC 直連,DTLS 加密",- "direct_note": "資料只在兩台電腦之間傳輸",- "legend_direct": "資料(直連)",- "legend_relay": "資料(中繼,備用)",- "legend_sig": "信令",- },+ "how_intro": '同一網路裡,裝置不需伺服器就能找到彼此;跨網路時,官方服務或自建伺服器協助交換連線資訊。優先打洞直連,失敗後才使用加密中繼。下圖展示通用的信令與中繼結構。',+ "diagram": {'title': '隔空貼的連線方式', 'desc': '電腦 A 與電腦 B(Mac 或 Windows)之間是 WebRTC 直連;兩台電腦都透過信令連線到信令與中繼服務;直連失敗時,資料經伺服器的 TURN 中繼。', 'server': '信令與中繼服務', 'server_sub': '信令、STUN、TURN 中繼', 'sig_note': '信令:交換連線資訊', 'relay_note': '中繼:只在直連打不通時', 'copy_here': '在這裡複製', 'other': 'Mac 或 Windows', 'paste_here': '在這裡貼上', 'direct': 'WebRTC 直連,DTLS 加密', 'direct_note': '資料只在兩台電腦之間傳輸', 'legend_direct': '資料(直連)', 'legend_relay': '資料(中繼,備用)', 'legend_sig': '信令'},"uplink_h2": "公司網路也能直連","uplink_intro": "公司雙線路、電信業者位址池這類網路有多個出口,會依目的位址決定走哪一個。只偵測一次,只會知道其中一個出口,"@@ -156,7 +140,7 @@ C = {("全部告訴對方。", "對方逐一嘗試,與實際出口相符的那一個就能打通。"),("記住見過的出口。", "某次漏掉的出口,如果它不會改變連接埠,就用「出口 IP + 本機連接埠」推算補上。"),("講好誰先送封包。", "有些路由器收到對方先到的封包,會把連接埠佔住。一方先公布出口位址,另一方先往那邊送封包,再公布自己的;重試時兩種順序輪流使用。"),- ("先中繼,再換直連。", "第一次交握落到中繼時,會在閒置時再打一次洞,打通就換成直連。"),+ ('閒置時重試直連。', '直連失敗且中繼可用時,先透過中繼保持同步。連線閒置時可重試打洞,成功後切回直連並釋放中繼。'),],"lab_h3": "用真實的網路拓撲驗證","lab_intro": "NAT 打洞實驗室用 Linux 網路命名空間與 iptables 搭出這些拓撲,用隔空貼真正的連線程式碼各跑一遍,每次提交程式碼都會自動執行。",@@ -200,9 +184,9 @@ C = {"之後位址會被記住,兩邊都換了位址時,在裝置清單裡幫它重新輸入一次。"),("系統擋住區域網路連線", "從 macOS 15 起,背景服務要連線區域網路裡的裝置,需要你允許;Windows 第一次執行時,防火牆會跳出詢問。""沒有允許時,App 會提示,並提供直達設定的按鈕。"),- ("兩台電腦打不通直連", "常見於對稱型 NAT 和公司防火牆。會自動改走你伺服器上的 TURN 中繼,內容依然加密,裝置清單裡顯示「中繼」。"),+ ("兩台電腦打不通直連", '官方模式在直連失敗後,依目前額度申請中繼;自建模式使用自己的 TURN 中繼。兩種方式的內容均保持端到端加密。'),("連不上公共 STUN 伺服器", "在中國大陸連公共 STUN 時通時斷。伺服器內建 STUN,用戶端會優先使用它。"),- ("先連上了中繼", "中繼的交握比較快,有時會搶在直連之前。連上之後,發起連線的一方會在閒置時再打一次洞,打通就換成直連;正在傳檔案時不會打擾。"),+ ('從中繼切回直連', '直連失敗且中繼可用時,先透過中繼保持同步。連線閒置時可重試打洞,成功後切回直連並釋放中繼。'),("對方睡眠、斷線或重新開機", "連線悄悄斷了也能察覺,會立即關閉並重新連線。這段期間複製的內容會先記下來,連上後補送到對方的複製記錄裡,但不會覆蓋對方當下剪貼簿裡的內容。"),("伺服器斷線", "自動重新連線,間隔從 1 秒開始加倍、最長 30 秒,並加上隨機抖動,避免一大群裝置同時重連。同一個網路裡的裝置不受影響,照常同步。"),("檔案太大", "超過上限的只同步一筆記錄,需要時再拉取。拉取時如果原始檔案已經被刪除,會明確告訴你,而不是莫名其妙地失敗。"),@@ -239,11 +223,10 @@ C = {],"server_h3": "連線方式","server_intro": '同一網路裡裝好就能配對;不同網路裡,啟用官方服務即可,無需自建。也保留自建伺服器與 Tailscale,依需求選擇。',- "server_compare": "比較三種方式",+ "server_compare": '比較連線方式',"copy": "複製","copied": "已複製",- "pairing": "<strong>配對:</strong>一台點「裝置 → 新增裝置」產生一組 6 碼的配對碼,另一台輸入它;兩邊螢幕上的兩行安全指紋完全一致後再確認。"- "不在同一個網段時,輸入配對碼的同時,也要輸入它下方顯示的位址。Mac、Windows、Linux 之間怎麼搭配都一樣。",+ "pairing": '一台產生配對碼,另一台輸入;核對兩邊的安全指紋後確認。原有配對關係可繼續使用。 官方服務無需填寫對方 IP;僅區域網路跨網段或 Tailscale 配對時填寫對方位址。',"specs_h2": "技術規格","specs": [@@ -252,7 +235,7 @@ C = {("Windows 用戶端", "Windows 10 與 Windows 11,x64;只為目前使用者安裝,不需要系統管理員權限;安裝檔約 23 MB"),("Linux 用戶端", "x64 與 ARM64;.deb(Debian、Ubuntu 等)或 tar.gz(其他發行版),約 22 MB;""需要 X11 桌面,或附有 XWayland 的 Wayland 桌面(GNOME、KDE 等預設都有);GTK 3"),- ("伺服器", "選用,只在跨網路時需要。Linux x86_64 或 ARM64(systemd 或 Docker)、macOS(Intel 與 Apple 晶片)、Windows 10 與 11 x64(系統服務);約佔 15 MB 記憶體"),+ ("伺服器", '僅自建時需要部署;使用官方服務不需自備伺服器。自建支援 Linux x86_64/ARM64、macOS 與 Windows 10/11 x64。'),("介面語言", "簡體中文、繁體中文(台灣、香港)、English、日本語,預設跟隨系統,可在設定裡切換"),("同步的內容", "純文字、帶格式的文字、圖片與螢幕截圖、檔案、資料夾,可依類型個別關閉"),("傳輸", "WebRTC 資料通道,優先直連,打不通時經 TURN 中繼;同一個網路裡透過 mDNS 探索、UDP 8788 交換連線資訊;多出口網路逐一偵測每個出口;檔案以 tar + zstd 串流打包"),diff --git a/tools/site/content/zh.py b/tools/site/content/zh.pyindex e1feaef..837615a 100644--- a/tools/site/content/zh.py+++ b/tools/site/content/zh.py@@ -100,7 +100,7 @@ C = {"history_intro": "复制记录保留最近 3 天的内容,随时可以放回剪贴板,图片点开就能预览。""50 MB 以内的文件在你复制的时候就已经传好了,更大的文件需要时点一下再拉取。""想找以前复制过的,按文字内容或文件名搜一下就有。",- "history_alt": "隔空贴的复制记录:来自 MacBook Air 和 Mac mini 的文件、图片、文字,大文件显示「拉取到本机」按钮",+ "history_alt": '隔空贴的复制记录:来自 MacBook Air 和 Mac mini 的文件、图片、文字,大文件显示「接收」按钮',"flow_h2": "按下复制之后","flow_intro": "文字、图片、文件、整个文件夹,都走同一条路。",@@ -123,28 +123,12 @@ C = {("复制后直接粘贴,不用点接收", [("yes", "可以"), ("yes", "可以"), ("no", "不行"), ("no", "不行")]),("文件与整个文件夹", [("yes", "可以"), ("partial", "不稳定"), ("yes", "可以"), ("partial", "要先打包")]),("找回之前复制过的内容", [("yes", "可以"), ("no", "不行"), ("no", "不行"), ("partial", "翻聊天记录")]),- ('仅自己的设备可解密内容', [("yes", "不经过"), ("yes", "不经过"), ("yes", "不经过"), ("no", "经过")]),+ ('仅自己的设备可解密内容', [('yes', '可以'), ('yes', '可以'), ('yes', '可以'), ('some', '视软件而定')]),],"how_h2": "工作原理",- "how_intro": "两台电脑之间直接建立加密连接。同一个网络里,它们自己就能找到彼此;跨网络时,你的服务器负责牵线,"- "打不通直连的时候再帮忙转发。下图是跨网络的情形。",- "diagram": {- "title": "隔空贴的连接方式",- "desc": "电脑 A 与电脑 B(Mac 或 Windows)之间是 WebRTC 直连;两台电脑都通过信令连接到你的服务器;直连失败时,数据经服务器的 TURN 中转。",- "server": "你的服务器",- "server_sub": "信令、STUN、TURN 中转",- "sig_note": "信令:交换连接信息",- "relay_note": "中转:仅在打不通直连时",- "copy_here": "在这里复制",- "other": "Mac 或 Windows",- "paste_here": "在这里粘贴",- "direct": "WebRTC 直连,DTLS 加密",- "direct_note": "数据只在两台电脑之间传输",- "legend_direct": "数据(直连)",- "legend_relay": "数据(中转,备用)",- "legend_sig": "信令",- },+ "how_intro": '同一网络里,设备无需服务器就能找到彼此;跨网络时,官方服务或自建服务器帮助交换连接信息。优先打洞直连,失败后才使用加密中转。下图展示通用的信令与中转结构。',+ "diagram": {'title': '隔空贴的连接方式', 'desc': '电脑 A 与电脑 B(Mac 或 Windows)之间是 WebRTC 直连;两台电脑都通过信令连接到信令与中转服务;直连失败时,数据经服务器的 TURN 中转。', 'server': '信令与中转服务', 'server_sub': '信令、STUN、TURN 中转', 'sig_note': '信令:交换连接信息', 'relay_note': '中转:仅在打不通直连时', 'copy_here': '在这里复制', 'other': 'Mac 或 Windows', 'paste_here': '在这里粘贴', 'direct': 'WebRTC 直连,DTLS 加密', 'direct_note': '数据只在两台电脑之间传输', 'legend_direct': '数据(直连)', 'legend_relay': '数据(中转,备用)', 'legend_sig': '信令'},"uplink_h2": "公司网络也能直连","uplink_intro": "公司双线、运营商地址池这类网络有多个出口,按目标地址选走哪一个。只探测一次只会知道其中一个出口,"@@ -156,7 +140,7 @@ C = {("全部告诉对端。", "对端逐个尝试,与实际出口吻合的那一个能打通。"),("记住见过的出口。", "某次漏掉的出口如果不改端口,就用「出口 IP + 本地端口」推算补上。"),("定好谁先发包。", "有的路由器收到对方先到的包会占住端口。一方先公布出口地址,另一方先往那边发包再公布自己的;重试时两种顺序轮流用。"),- ("先中转,再换直连。", "第一次握手落到了中转时,空闲时再打一次洞,打通就换成直连。"),+ ('空闲时重试直连。', '直连失败且中转可用时,先通过中转保持同步。连接空闲时可重试打洞,成功后切回直连并释放中转。'),],"lab_h3": "用真实的网络拓扑验证","lab_intro": "NAT 打洞实验室用 Linux 网络命名空间与 iptables 搭出这些拓扑,用隔空贴真实的连接代码各跑一遍,每次提交代码都自动运行。",@@ -200,9 +184,9 @@ C = {"之后地址会被记住,两边都换了地址时,在设备列表里给它重新输入一次。"),("系统拦着局域网", "macOS 15 起,后台服务连接局域网里的设备要你允许;Windows 第一次运行时会问防火墙。""没放行时 App 会提示,并给出直达的按钮。"),- ("两台电脑打不通直连", "常见于对称 NAT 和公司防火墙。自动改走你服务器上的 TURN 中转,内容依然加密,设备列表里显示「中转」。"),+ ("两台电脑打不通直连", '官方模式在直连失败后,按当前额度申请中转;自建模式使用自己的 TURN 中转。两种方式的内容均保持端到端加密。'),("公共 STUN 服务器连不上", "国内访问公共 STUN 时通时断。服务器自带 STUN,客户端优先用它。"),- ("先连上了中转", "中转握手快,有时会抢在直连之前。连上之后,发起连接的一方会在空闲时再打一次洞,打通就换成直连;正在传文件时不打扰。"),+ ('从中转切回直连', '直连失败且中转可用时,先通过中转保持同步。连接空闲时可重试打洞,成功后切回直连并释放中转。'),("对方睡眠、断网或重启", "连接悄悄断了也能发现,立即关闭重连。这期间复制的内容会记下来,连上后补发到对方的复制记录里,但不会覆盖对方此刻剪贴板里的内容。"),("服务器断开", "自动重连,间隔从 1 秒开始翻倍、最长 30 秒,并带随机抖动,避免一群设备同时重连。同一网络里的设备不受影响,照常同步。"),("文件太大", "超过上限的只同步一条记录,需要时再拉取。拉取时源文件已经被删,会明确告诉你,而不是不明不白地失败。"),@@ -239,11 +223,10 @@ C = {],"server_h3": "连接方式","server_intro": '同一网络里装好就能配对;不同网络里,开启官方服务即可,无需自建。也保留自建服务器与 Tailscale,按你的需要选择。',- "server_compare": "对比三种方式",+ "server_compare": '对比连接方式',"copy": "复制","copied": "已复制",- "pairing": "<strong>配对:</strong>一台点「设备 → 添加设备」生成 6 位配对码,另一台输入它;两块屏幕上的两行安全指纹完全一致后确认。"- "不在同一网段时,输入配对码的同时输入它下面显示的地址。Mac、Windows、Linux 之间怎么组合都一样。",+ "pairing": '一台生成配对码,另一台输入;核对两边的安全指纹后确认。已有配对关系可以继续使用。 官方服务无需填写对端 IP;仅局域网跨网段或 Tailscale 配对时填写对端地址。',"specs_h2": "技术规格","specs": [@@ -252,7 +235,7 @@ C = {("Windows 客户端", "Windows 10 与 Windows 11,x64;按用户安装,不需要管理员权限;安装包约 23 MB"),("Linux 客户端", "x64 与 ARM64;.deb(Debian、Ubuntu 等)或 tar.gz(其他发行版),约 22 MB;""需要 X11 桌面,或者带 XWayland 的 Wayland 桌面(GNOME、KDE 等默认都带);GTK 3"),- ("服务器", "可选,只在跨网络时需要。Linux x86_64 或 ARM64(systemd 或 Docker)、macOS(Intel 与 Apple 芯片)、Windows 10 与 11 x64(系统服务);约 15 MB 内存"),+ ("服务器", '仅自建时需要部署;使用官方服务无需自备服务器。自建支持 Linux x86_64/ARM64、macOS 与 Windows 10/11 x64。'),("界面语言", "简体中文、繁體中文(台灣、香港)、English、日本語,默认跟随系统,可在设置里切换"),("同步的内容", "纯文本、带格式的文本、图片与截图、文件、文件夹,可以按类型关闭"),("传输", "WebRTC 数据通道,直连优先,打不通时经 TURN 中转;同一网络里经 mDNS 发现、UDP 8788 交换连接信息;多出口网络逐个探测每个出口;文件以 tar + zstd 流式打包"),