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: record real-device results for local network mode
baiyuze345fede64335
diff --git a/design/lan-mode.md b/design/lan-mode.mdindex a7d967d..583c461 100644--- a/design/lan-mode.md+++ b/design/lan-mode.md@@ -51,7 +51,13 @@- 后台服务的 Info.plist 加上 `NSLocalNetworkUsageDescription`(中英日本地化)与 `NSBonjourServices`。- LaunchAgent 写上 `AssociatedBundleIdentifiers`,让系统知道后台服务属于 CopySync.app(TN3179 的建议)。-- 后台服务发现发往本机直连网段的包返回 `EHOSTUNREACH` 时,报告「被系统拦截」,界面提示用户去「系统设置 → 隐私与安全性 → 本地网络」打开。+- 后台服务发现发往本机直连网段的包持续返回 `EHOSTUNREACH` 时,报告「被系统拦截」,界面提示用户去「系统设置 → 隐私与安全性 → 本地网络」打开。++后来用正式打包方式(同样的 Info.plist,由 launchd 带着 `AssociatedBundleIdentifiers` 启动)在解锁的屏幕上复测:++- 系统会弹出授权窗,授权记在后台服务自己的 bundle ID 名下,没有因为 `AssociatedBundleIdentifiers` 算到 CopySync.app 头上。用户允许后,mDNS 与单播都正常。+- 换了程序文件(ad-hoc 重新签名)后没有再问,授权仍然有效;但新程序刚启动的十几秒里,发往局域网的包仍会被拦下,之后自动放行。所以「被系统拦截」要持续 30 秒才报告,否则每次升级都会闪一下提示。+- 还没配对任何设备时,后台服务不往局域网发单播,就发现不了自己被拦着。于是在 macOS 上定期往本网段里一个普通地址的丢弃端口发几个字节探测(不用网关:发往网关的包可能不受这项限制)。往本机自己的地址发包也不受限制,不能当作「没被拦」的证据——Parallels 的 NAT 会让虚拟机的包看起来来自本机地址。## 三、方案@@ -94,8 +100,15 @@- 输入码的一方:先在局域网里找,发往所有 `p=1` 的实例和用户输入的地址,每 500 毫秒重发,3 秒为限(输了地址时 5 秒);找不到且连着服务器再去服务器兑换。- 请求和回复都是 `LanPairInfo`,用自带的公钥签名,并校验 ID 由公钥派生;回复回显请求的 nonce,绑定到这次请求。配对码在局域网里明文传输,与服务器模式下服务器能看到配对码等价:防中间人靠的是用户核对指纹。- 配对请求与回复本身证明了对方在哪个地址,收到即标记可达,确认后第一次连接不必再等 hello。+- **敲门**:输入码的一方在 mDNS 里带上 `s=1`;显示码的一方看到后,先往它的每个地址发一个只有魔数的空包。显示码的一方若是没放行防火墙的 Windows,对方主动发来的配对请求本会被挡住;先发过包,有状态防火墙就会放行。只在同一网段有效(靠 mDNS),跨网段时仍需在被连的一方放行。++### 6. 重启++hello 里带一个每次启动随机生成的启动标识。收到已配对设备的 hello、发现启动标识变了,就知道它重启过:立即丢掉旧的 P2P 连接重建,不必等连接超时。用服务器时,这件事由服务器的上下线通知完成;没有服务器时,没有这一步的话,应答方重启后要等发起方自己发现连接失效(实测约 30 秒)。-### 6. 其他改动+另外,mDNS 里出现已配对设备的新实例名或新地址时,即使还当它可达,也马上打招呼:重启的那台若是没放行防火墙的 Windows,它主动发来的包进不来,要靠本机先发。++### 7. 其他改动- 服务器地址默认为空。1.4.0 之前的默认值 `ws://127.0.0.1:8787/signal` 其实没有服务器在跑,升级时清空一次(配置文件记 `config_version`,只迁移一次)。- 没有服务器时不探测公共 STUN:只在局域网里连,探测出口没有用,还会把公网 IP 暴露给公共服务器。@@ -110,7 +123,7 @@| `transport/lan/pairing.go` | 局域网配对 || `transport/lan/discovery.go`、`mdns*.go` | 发现接口、pion/mdns 实现、Windows 的系统 DNS-SD 注册、测试用的内存网络 || `transport/lan/addrs.go` | 本机地址、地址解析、令牌 |-| `transport/lan/permission_*.go` | macOS 打开本地网络设置、Windows 用 UAC 放行防火墙 |+| `transport/lan/permission_*.go` | macOS 打开本地网络设置与探测地址、Windows 用 UAC 放行防火墙 || `transport/signed/` | 签名、校验、防重放、收件人检查 || `peers/manager.go` | 两条通道合并、配对流程 || `store/store.go` | `device_addrs` 表 |@@ -123,7 +136,7 @@| 同一网段 | mDNS 发现,直连 || 不同网段,网段之间互通 | 配对时输入地址,直连;之后靠地址簿 || 同一 tailnet | 配对时输入 100.x 地址,直连 |-| 一台是没放行防火墙的 Windows | 只要它知道对方的地址(或由系统 DNS-SD 被发现后对方打招呼),就能连上 |+| 一台是没放行防火墙的 Windows | 同一网段里能配对(它先「敲门」)、能重连;跨网段时要它知道对方的地址 || 两台都是没放行防火墙的 Windows,跨网段,只有一边知道地址 | 连不上,需要在被连的一方点「放行」 || 两个网段之间被隔离(访客网络等) | 连不上,只能经两边都能访问的服务器中转 || macOS 15 没允许本地网络 | 对方先发来时能连;两台都是这样的 Mac 时连不上,界面提示去允许 |@@ -134,7 +147,7 @@`transport/signed/signed_test.go`:签名与校验;同一条信令从两条通道到达只处理一次;收件人不是本机时拒收;未配对、冒用 ID、时间戳过期都拒收。-`transport/lan/lan_test.go`:两个实例绑在 127.0.0.1 的不同端口上,用内存网络代替 mDNS。已配对设备互相找到并收发信令、补发的那份被去重、地址记进地址簿;只靠记得的地址互相找到;未配对设备的 hello 不算数;局域网配对、按地址配对、码只能用一次、错 10 次后作废;可达状态过期;地址解析与令牌换天。+`transport/lan/lan_test.go`:两个实例绑在 127.0.0.1 的不同端口上,用内存网络代替 mDNS。已配对设备互相找到并收发信令、补发的那份被去重、地址记进地址簿;只靠记得的地址互相找到;未配对设备的 hello 不算数;局域网配对、按地址配对、码只能用一次、错 10 次后作废;可达状态过期;地址解析与令牌换天;显示码的一方向在找人配对的实例敲门、配对期间广播里带 s=1;对方重启后察觉。`permission_darwin_test.go`:探测地址在本网段里且不是本机,本机地址不算直连网段里的对端。`peers/manager_test.go`:两个完整的 `peers.Manager`。没有服务器时配对、P2P 直连、双向收消息,解除配对后断开;不同网段时不输地址找不到、输了地址能配对并直连;关掉局域网只用服务器时原来的配对路径照常工作,错码立即被拒;服务器和局域网同时开着时,同一个码只能用一次。@@ -162,11 +175,22 @@ Mac 与 Windows 11 虚拟机,各跑一个用 `-tags fakeclip` 编译的后台- 局域网配对成功,两边的安全指纹一致。- 文本双向同步;5 MB 文件从 Mac 传到 Windows,SHA-256 一致。-- 两边都重启后约 1 秒重新直连。- 新的一对在确认配对后立即直连;8788 被占用时退回随机端口,地址里自动带上端口。+第二轮把 Mac 一侧换成正式打包的后台服务,由 launchd 启动,用户在授权窗里点了允许:++- Windows 显示配对码、Mac 只输入配对码:2 秒配对成功(Windows 先敲门)。+- 文本双向同步。+- 只重启 Mac、只重启 Windows:都在 4 秒内恢复,以「复制后对方收到」计时,含每轮约 1 至 2 秒的检测开销。+- 新程序刚启动时没有误报「被系统拦截」。++第一轮里「两边重启后约 1 秒重新直连」的结果不可靠:清理测试进程时漏掉了几个,「重启」时旧实例还以同一个身份在运行。第二轮在干净的环境里重测,结果如上。+## 六、踩过的坑+- **重启后要 30 秒才恢复。** 应答方重启后,发起方还以为旧连接活着,要等握手超时。加了启动标识,见「6. 重启」。+- **没放行防火墙的 Windows 显示配对码时,同网段的 Mac 配不上。** 加了「敲门」;一开始按实例限速,2 秒内只敲到了走不通的那个地址,改成按「实例 + 地址」限速。+- **被系统拦截的提示会闪。** 新程序启动初期的拦截、发往本机地址的成功,都会让判断出错,见第二节。- **配对后的第一次连接要等 30 秒。** 确认配对后立即发起连接,但双方还没互发过 hello,局域网通道认为对方不可达,offer 发不出去,连接停在「连接中」直到握手超时。改为配对的请求与回复到达时就标记可达;offer 发不出去时立即复位,不等超时。- **配对前就被发现的实例,配对后认不出来。** 令牌是按已配对设备算的,配对后要把已经发现的实例重新对一遍。- **pion 的浏览每秒报一次同一个实例,还会报出无关的服务。** 只在地址或令牌变化、或超过 30 秒时才行动;校验服务类型与 `v=1`。@@ -177,6 +201,7 @@ Mac 与 Windows 11 虚拟机,各跑一个用 `-tags fakeclip` 编译的后台## 七、局限与后续- 两台都没放行防火墙的 Windows、跨网段、只有一边知道地址时连不上,需要在被连的一方点「放行」。-- macOS 15 的本地网络授权弹窗只在屏幕解锁时出现。ad-hoc 签名的版本每次更新后,系统可能把它当成新程序重新询问;有了 Developer ID 签名后会稳定。+- macOS 15 的本地网络授权弹窗只在屏幕解锁时出现。用户拒绝之后,要在系统设置里手动打开。+- 敲门只在同一网段有效;跨网段时,被连的一方若是没放行防火墙的 Windows,仍需点「放行」。- 不做网段扫描。两边地址都变了要手动输入一次,台式机建议在路由器里固定地址。- 只支持 IPv4。diff --git a/docs/design/lan-mode.html b/docs/design/lan-mode.htmlindex 021bdfa..8f48629 100644--- a/docs/design/lan-mode.html+++ b/docs/design/lan-mode.html@@ -44,7 +44,9 @@<p>从终端运行的程序不受限制,但同一个程序打包成 App、由 launchd 启动(与后台服务一样)时,往局域网地址发包直接返回 <code>sendto: no route to host</code>。对方先发来的包仍然能收到,也能回复。</p><p>这说明 1.3 的后台服务在 macOS 15 上其实也连不到局域网地址。它和 Windows 虚拟机之间显示「直连」,是因为 Parallels 的 NAT 让虚拟机的包看起来来自 Mac 自己的 IP,恰好绕开了限制。两台 Mac 之间如果都没拿到权限,谁也连不上谁。</p><p>处理办法:</p>-<ul><li>后台服务的 Info.plist 加上 <code>NSLocalNetworkUsageDescription</code>(中英日本地化)与 <code>NSBonjourServices</code>。</li><li>LaunchAgent 写上 <code>AssociatedBundleIdentifiers</code>,让系统知道后台服务属于 CopySync.app(TN3179 的建议)。</li><li>后台服务发现发往本机直连网段的包返回 <code>EHOSTUNREACH</code> 时,报告「被系统拦截」,界面提示用户去「系统设置 → 隐私与安全性 → 本地网络」打开。</li></ul>+<ul><li>后台服务的 Info.plist 加上 <code>NSLocalNetworkUsageDescription</code>(中英日本地化)与 <code>NSBonjourServices</code>。</li><li>LaunchAgent 写上 <code>AssociatedBundleIdentifiers</code>,让系统知道后台服务属于 CopySync.app(TN3179 的建议)。</li><li>后台服务发现发往本机直连网段的包持续返回 <code>EHOSTUNREACH</code> 时,报告「被系统拦截」,界面提示用户去「系统设置 → 隐私与安全性 → 本地网络」打开。</li></ul>+<p>后来用正式打包方式(同样的 Info.plist,由 launchd 带着 <code>AssociatedBundleIdentifiers</code> 启动)在解锁的屏幕上复测:</p>+<ul><li>系统会弹出授权窗,授权记在后台服务自己的 bundle ID 名下,没有因为 <code>AssociatedBundleIdentifiers</code> 算到 CopySync.app 头上。用户允许后,mDNS 与单播都正常。</li><li>换了程序文件(ad-hoc 重新签名)后没有再问,授权仍然有效;但新程序刚启动的十几秒里,发往局域网的包仍会被拦下,之后自动放行。所以「被系统拦截」要持续 30 秒才报告,否则每次升级都会闪一下提示。</li><li>还没配对任何设备时,后台服务不往局域网发单播,就发现不了自己被拦着。于是在 macOS 上定期往本网段里一个普通地址的丢弃端口发几个字节探测(不用网关:发往网关的包可能不受这项限制)。往本机自己的地址发包也不受限制,不能当作「没被拦」的证据——Parallels 的 NAT 会让虚拟机的包看起来来自本机地址。</li></ul><h2 id="三-方案">三、方案</h2><h3 id="1-两条通道并存">1. 两条通道并存</h3><p><code>peers.Manager</code> 同时持有信令服务器客户端和局域网通道:</p>@@ -57,17 +59,20 @@<h3 id="4-地址簿与跨网段">4. 地址簿与跨网段</h3><ul><li>新表 <code>device_addrs(device_id, addr, last_seen)</code>,每台设备最多 8 个,随设备一起删除。</li><li>跨网段时 mDNS 过不去,配对时由用户输入对方配对码下面显示的地址。配对双方都记下对方的地址,之后任意一方换了地址,只要另一方没换,就能重新找到。</li><li>两边都换了地址时,在设备菜单里「输入它的地址」。不做网段扫描:在公司网络里会被当成端口扫描。</li><li>Tailscale 不转发 mDNS,但 100.x 地址就是普通的可达地址:配对时输入它,之后同样靠地址簿。</li></ul><h3 id="5-配对">5. 配对</h3>-<ul><li>显示码的一方:码在服务器和局域网两边同时开放(连着服务器时用服务器签发的码,否则本机生成,格式见 <code>proto/pairingcode</code>),一边用掉另一边就失效。错码 10 次作废。</li><li>输入码的一方:先在局域网里找,发往所有 <code>p=1</code> 的实例和用户输入的地址,每 500 毫秒重发,3 秒为限(输了地址时 5 秒);找不到且连着服务器再去服务器兑换。</li><li>请求和回复都是 <code>LanPairInfo</code>,用自带的公钥签名,并校验 ID 由公钥派生;回复回显请求的 nonce,绑定到这次请求。配对码在局域网里明文传输,与服务器模式下服务器能看到配对码等价:防中间人靠的是用户核对指纹。</li><li>配对请求与回复本身证明了对方在哪个地址,收到即标记可达,确认后第一次连接不必再等 hello。</li></ul>-<h3 id="6-其他改动">6. 其他改动</h3>+<ul><li>显示码的一方:码在服务器和局域网两边同时开放(连着服务器时用服务器签发的码,否则本机生成,格式见 <code>proto/pairingcode</code>),一边用掉另一边就失效。错码 10 次作废。</li><li>输入码的一方:先在局域网里找,发往所有 <code>p=1</code> 的实例和用户输入的地址,每 500 毫秒重发,3 秒为限(输了地址时 5 秒);找不到且连着服务器再去服务器兑换。</li><li>请求和回复都是 <code>LanPairInfo</code>,用自带的公钥签名,并校验 ID 由公钥派生;回复回显请求的 nonce,绑定到这次请求。配对码在局域网里明文传输,与服务器模式下服务器能看到配对码等价:防中间人靠的是用户核对指纹。</li><li>配对请求与回复本身证明了对方在哪个地址,收到即标记可达,确认后第一次连接不必再等 hello。</li><li><strong>敲门</strong>:输入码的一方在 mDNS 里带上 <code>s=1</code>;显示码的一方看到后,先往它的每个地址发一个只有魔数的空包。显示码的一方若是没放行防火墙的 Windows,对方主动发来的配对请求本会被挡住;先发过包,有状态防火墙就会放行。只在同一网段有效(靠 mDNS),跨网段时仍需在被连的一方放行。</li></ul>+<h3 id="6-重启">6. 重启</h3>+<p>hello 里带一个每次启动随机生成的启动标识。收到已配对设备的 hello、发现启动标识变了,就知道它重启过:立即丢掉旧的 P2P 连接重建,不必等连接超时。用服务器时,这件事由服务器的上下线通知完成;没有服务器时,没有这一步的话,应答方重启后要等发起方自己发现连接失效(实测约 30 秒)。</p>+<p>另外,mDNS 里出现已配对设备的新实例名或新地址时,即使还当它可达,也马上打招呼:重启的那台若是没放行防火墙的 Windows,它主动发来的包进不来,要靠本机先发。</p>+<h3 id="7-其他改动">7. 其他改动</h3><ul><li>服务器地址默认为空。1.4.0 之前的默认值 <code>ws://127.0.0.1:8787/signal</code> 其实没有服务器在跑,升级时清空一次(配置文件记 <code>config_version</code>,只迁移一次)。</li><li>没有服务器时不探测公共 STUN:只在局域网里连,探测出口没有用,还会把公网 IP 暴露给公共服务器。</li><li>解除配对时断开 P2P 连接(以前不断开)。</li><li><code>copysync-cli</code>:<code>join CODE [ADDRESS]</code>、<code>address DEVICE ADDR</code>,<code>nat</code> 里加了局域网一节。</li></ul><h3 id="代码位置">代码位置</h3>-<div class="table-scroll"><table><thead><tr><th scope="col">位置</th><th scope="col">内容</th></tr></thead><tbody><tr><td><code>transport/lan/lan.go</code></td><td>socket、hello、可达状态、地址簿、诊断</td></tr><tr><td><code>transport/lan/pairing.go</code></td><td>局域网配对</td></tr><tr><td><code>transport/lan/discovery.go</code>、<code>mdns*.go</code></td><td>发现接口、pion/mdns 实现、Windows 的系统 DNS-SD 注册、测试用的内存网络</td></tr><tr><td><code>transport/lan/addrs.go</code></td><td>本机地址、地址解析、令牌</td></tr><tr><td><code>transport/lan/permission_*.go</code></td><td>macOS 打开本地网络设置、Windows 用 UAC 放行防火墙</td></tr><tr><td><code>transport/signed/</code></td><td>签名、校验、防重放、收件人检查</td></tr><tr><td><code>peers/manager.go</code></td><td>两条通道合并、配对流程</td></tr><tr><td><code>store/store.go</code></td><td><code>device_addrs</code> 表</td></tr><tr><td><code>config/config.go</code></td><td>默认不用服务器、<code>lan_disabled</code>、一次性迁移</td></tr></tbody></table></div>+<div class="table-scroll"><table><thead><tr><th scope="col">位置</th><th scope="col">内容</th></tr></thead><tbody><tr><td><code>transport/lan/lan.go</code></td><td>socket、hello、可达状态、地址簿、诊断</td></tr><tr><td><code>transport/lan/pairing.go</code></td><td>局域网配对</td></tr><tr><td><code>transport/lan/discovery.go</code>、<code>mdns*.go</code></td><td>发现接口、pion/mdns 实现、Windows 的系统 DNS-SD 注册、测试用的内存网络</td></tr><tr><td><code>transport/lan/addrs.go</code></td><td>本机地址、地址解析、令牌</td></tr><tr><td><code>transport/lan/permission_*.go</code></td><td>macOS 打开本地网络设置与探测地址、Windows 用 UAC 放行防火墙</td></tr><tr><td><code>transport/signed/</code></td><td>签名、校验、防重放、收件人检查</td></tr><tr><td><code>peers/manager.go</code></td><td>两条通道合并、配对流程</td></tr><tr><td><code>store/store.go</code></td><td><code>device_addrs</code> 表</td></tr><tr><td><code>config/config.go</code></td><td>默认不用服务器、<code>lan_disabled</code>、一次性迁移</td></tr></tbody></table></div><h2 id="四-能覆盖哪些场景">四、能覆盖哪些场景</h2>-<div class="table-scroll"><table><thead><tr><th scope="col">两台电脑</th><th scope="col">结果</th></tr></thead><tbody><tr><td>同一网段</td><td>mDNS 发现,直连</td></tr><tr><td>不同网段,网段之间互通</td><td>配对时输入地址,直连;之后靠地址簿</td></tr><tr><td>同一 tailnet</td><td>配对时输入 100.x 地址,直连</td></tr><tr><td>一台是没放行防火墙的 Windows</td><td>只要它知道对方的地址(或由系统 DNS-SD 被发现后对方打招呼),就能连上</td></tr><tr><td>两台都是没放行防火墙的 Windows,跨网段,只有一边知道地址</td><td>连不上,需要在被连的一方点「放行」</td></tr><tr><td>两个网段之间被隔离(访客网络等)</td><td>连不上,只能经两边都能访问的服务器中转</td></tr><tr><td>macOS 15 没允许本地网络</td><td>对方先发来时能连;两台都是这样的 Mac 时连不上,界面提示去允许</td></tr></tbody></table></div>+<div class="table-scroll"><table><thead><tr><th scope="col">两台电脑</th><th scope="col">结果</th></tr></thead><tbody><tr><td>同一网段</td><td>mDNS 发现,直连</td></tr><tr><td>不同网段,网段之间互通</td><td>配对时输入地址,直连;之后靠地址簿</td></tr><tr><td>同一 tailnet</td><td>配对时输入 100.x 地址,直连</td></tr><tr><td>一台是没放行防火墙的 Windows</td><td>同一网段里能配对(它先「敲门」)、能重连;跨网段时要它知道对方的地址</td></tr><tr><td>两台都是没放行防火墙的 Windows,跨网段,只有一边知道地址</td><td>连不上,需要在被连的一方点「放行」</td></tr><tr><td>两个网段之间被隔离(访客网络等)</td><td>连不上,只能经两边都能访问的服务器中转</td></tr><tr><td>macOS 15 没允许本地网络</td><td>对方先发来时能连;两台都是这样的 Mac 时连不上,界面提示去允许</td></tr></tbody></table></div><h2 id="五-验证">五、验证</h2><h3 id="单元测试与集成测试">单元测试与集成测试</h3><p><code>transport/signed/signed_test.go</code>:签名与校验;同一条信令从两条通道到达只处理一次;收件人不是本机时拒收;未配对、冒用 ID、时间戳过期都拒收。</p>-<p><code>transport/lan/lan_test.go</code>:两个实例绑在 127.0.0.1 的不同端口上,用内存网络代替 mDNS。已配对设备互相找到并收发信令、补发的那份被去重、地址记进地址簿;只靠记得的地址互相找到;未配对设备的 hello 不算数;局域网配对、按地址配对、码只能用一次、错 10 次后作废;可达状态过期;地址解析与令牌换天。</p>+<p><code>transport/lan/lan_test.go</code>:两个实例绑在 127.0.0.1 的不同端口上,用内存网络代替 mDNS。已配对设备互相找到并收发信令、补发的那份被去重、地址记进地址簿;只靠记得的地址互相找到;未配对设备的 hello 不算数;局域网配对、按地址配对、码只能用一次、错 10 次后作废;可达状态过期;地址解析与令牌换天;显示码的一方向在找人配对的实例敲门、配对期间广播里带 s=1;对方重启后察觉。<code>permission_darwin_test.go</code>:探测地址在本网段里且不是本机,本机地址不算直连网段里的对端。</p><p><code>peers/manager_test.go</code>:两个完整的 <code>peers.Manager</code>。没有服务器时配对、P2P 直连、双向收消息,解除配对后断开;不同网段时不输地址找不到、输了地址能配对并直连;关掉局域网只用服务器时原来的配对路径照常工作,错码立即被拒;服务器和局域网同时开着时,同一个码只能用一次。</p><p><code>config/config_test.go</code>:旧默认地址清空、自己的服务器保留、只迁移一次。<code>store/store_test.go</code>:地址簿的排序、上限、随设备删除。</p><p>界面:<code>pairing_flow_test.dart</code> 覆盖显示本机地址、找不到时展开地址框并带地址重试、错码提示、侧栏的局域网状态与 macOS 拦截提示。</p>@@ -77,11 +82,14 @@<p>「两台都挡入站」用每台主机上的 <code>iptables -A INPUT -p udp -m conntrack --ctstate NEW -j DROP</code> 模拟没有放行规则的 Windows 防火墙,证明两边同时发包确实能穿过有状态防火墙。</p><h3 id="实机验收">实机验收</h3><p>Mac 与 Windows 11 虚拟机,各跑一个用 <code>-tags fakeclip</code> 编译的后台服务(独立数据目录,不碰真实剪贴板),不配服务器。Windows 上的程序是新的路径,没有任何防火墙规则。</p>-<ul><li>局域网配对成功,两边的安全指纹一致。</li><li>文本双向同步;5 MB 文件从 Mac 传到 Windows,SHA-256 一致。</li><li>两边都重启后约 1 秒重新直连。</li><li>新的一对在确认配对后立即直连;8788 被占用时退回随机端口,地址里自动带上端口。</li></ul>+<ul><li>局域网配对成功,两边的安全指纹一致。</li><li>文本双向同步;5 MB 文件从 Mac 传到 Windows,SHA-256 一致。</li><li>新的一对在确认配对后立即直连;8788 被占用时退回随机端口,地址里自动带上端口。</li></ul>+<p>第二轮把 Mac 一侧换成正式打包的后台服务,由 launchd 启动,用户在授权窗里点了允许:</p>+<ul><li>Windows 显示配对码、Mac 只输入配对码:2 秒配对成功(Windows 先敲门)。</li><li>文本双向同步。</li><li>只重启 Mac、只重启 Windows:都在 4 秒内恢复,以「复制后对方收到」计时,含每轮约 1 至 2 秒的检测开销。</li><li>新程序刚启动时没有误报「被系统拦截」。</li></ul>+<p>第一轮里「两边重启后约 1 秒重新直连」的结果不可靠:清理测试进程时漏掉了几个,「重启」时旧实例还以同一个身份在运行。第二轮在干净的环境里重测,结果如上。</p><h2 id="六-踩过的坑">六、踩过的坑</h2>-<ul><li><strong>配对后的第一次连接要等 30 秒。</strong> 确认配对后立即发起连接,但双方还没互发过 hello,局域网通道认为对方不可达,offer 发不出去,连接停在「连接中」直到握手超时。改为配对的请求与回复到达时就标记可达;offer 发不出去时立即复位,不等超时。</li><li><strong>配对前就被发现的实例,配对后认不出来。</strong> 令牌是按已配对设备算的,配对后要把已经发现的实例重新对一遍。</li><li><strong>pion 的浏览每秒报一次同一个实例,还会报出无关的服务。</strong> 只在地址或令牌变化、或超过 30 秒时才行动;校验服务类型与 <code>v=1</code>。</li><li><strong>锁的顺序。</strong> 局域网通道持锁时回调上层(取已配对设备、查 P2P 状态),上层持锁时又查局域网的可达状态。可达状态单独放在一把叶子锁里,回调一律在锁外。</li><li><strong>Parallels 的 NAT 掩盖了 macOS 的拦截</strong>,见第二节。</li><li><strong>natlab 里新建 veth 时,第一个名字先在容器自己的命名空间里创建</strong>,起名 <code>eth0</code> 会与容器的网卡冲突;<code>[[ … ]] && …</code> 放在函数末尾、条件不成立时会让函数返回 1,触发 <code>set -e</code>。</li></ul>+<ul><li><strong>重启后要 30 秒才恢复。</strong> 应答方重启后,发起方还以为旧连接活着,要等握手超时。加了启动标识,见「6. 重启」。</li><li><strong>没放行防火墙的 Windows 显示配对码时,同网段的 Mac 配不上。</strong> 加了「敲门」;一开始按实例限速,2 秒内只敲到了走不通的那个地址,改成按「实例 + 地址」限速。</li><li><strong>被系统拦截的提示会闪。</strong> 新程序启动初期的拦截、发往本机地址的成功,都会让判断出错,见第二节。</li><li><strong>配对后的第一次连接要等 30 秒。</strong> 确认配对后立即发起连接,但双方还没互发过 hello,局域网通道认为对方不可达,offer 发不出去,连接停在「连接中」直到握手超时。改为配对的请求与回复到达时就标记可达;offer 发不出去时立即复位,不等超时。</li><li><strong>配对前就被发现的实例,配对后认不出来。</strong> 令牌是按已配对设备算的,配对后要把已经发现的实例重新对一遍。</li><li><strong>pion 的浏览每秒报一次同一个实例,还会报出无关的服务。</strong> 只在地址或令牌变化、或超过 30 秒时才行动;校验服务类型与 <code>v=1</code>。</li><li><strong>锁的顺序。</strong> 局域网通道持锁时回调上层(取已配对设备、查 P2P 状态),上层持锁时又查局域网的可达状态。可达状态单独放在一把叶子锁里,回调一律在锁外。</li><li><strong>Parallels 的 NAT 掩盖了 macOS 的拦截</strong>,见第二节。</li><li><strong>natlab 里新建 veth 时,第一个名字先在容器自己的命名空间里创建</strong>,起名 <code>eth0</code> 会与容器的网卡冲突;<code>[[ … ]] && …</code> 放在函数末尾、条件不成立时会让函数返回 1,触发 <code>set -e</code>。</li></ul><h2 id="七-局限与后续">七、局限与后续</h2>-<ul><li>两台都没放行防火墙的 Windows、跨网段、只有一边知道地址时连不上,需要在被连的一方点「放行」。</li><li>macOS 15 的本地网络授权弹窗只在屏幕解锁时出现。ad-hoc 签名的版本每次更新后,系统可能把它当成新程序重新询问;有了 Developer ID 签名后会稳定。</li><li>不做网段扫描。两边地址都变了要手动输入一次,台式机建议在路由器里固定地址。</li><li>只支持 IPv4。</li></ul>+<ul><li>两台都没放行防火墙的 Windows、跨网段、只有一边知道地址时连不上,需要在被连的一方点「放行」。</li><li>macOS 15 的本地网络授权弹窗只在屏幕解锁时出现。用户拒绝之后,要在系统设置里手动打开。</li><li>敲门只在同一网段有效;跨网段时,被连的一方若是没放行防火墙的 Windows,仍需点「放行」。</li><li>不做网段扫描。两边地址都变了要手动输入一次,台式机建议在路由器里固定地址。</li><li>只支持 IPv4。</li></ul></article></main>diff --git a/guide/troubleshooting.md b/guide/troubleshooting.mdindex 930e177..e576391 100644--- a/guide/troubleshooting.md+++ b/guide/troubleshooting.md@@ -37,4 +37,4 @@ The background service logs to `~/Library/Logs/CopySync/daemon.log` on Mac and `- **Items aren't resent after a long absence.** The server stores nothing. While the other Mac is unreachable, this Mac keeps the latest 20 items (from the last 24 hours) in memory, and they're lost if its background service restarts.- **Relayed transfers are limited by your server's bandwidth.** Direct connections aren't.- **On different subnets, if both computers change addresses**, you enter the address once more in the device menu; CopySync doesn't scan subnets. Two Windows PCs that both block inbound traffic, where only one knows the other's address, can't connect until the one being reached clicks **Allow**.-- **macOS 15 needs the Local Network permission**, or the background service can't reach devices on your network (it still connects when the other side reaches out first). Current builds are ad-hoc signed, so macOS may ask again after an update.+- **macOS 15 needs the Local Network permission**, or the background service can't reach devices on your network (it still connects when the other side reaches out first). Right after an update, the first ten seconds or so of LAN traffic may also be blocked; it clears on its own.diff --git a/guide/troubleshooting.zh-CN.md b/guide/troubleshooting.zh-CN.mdindex 97502ee..5d90269 100644--- a/guide/troubleshooting.zh-CN.md+++ b/guide/troubleshooting.zh-CN.md@@ -37,4 +37,4 @@- **对方离线太久的内容不会补发**。服务器不存数据;对方暂时连不上时,本机只在内存里记下最近 20 条(24 小时内的),本机的后台服务重启后就清空了。- **中转模式的速度取决于服务器带宽**。直连时不受影响。- **不在同一网段、两台都换了地址时**,要在设备菜单里重新输入一次地址;CopySync 不扫描网段。两台都是没放行防火墙的 Windows、又只有一边知道对方地址时连不上,要在被连的一方点「放行」。-- **macOS 15 要允许「本地网络」权限**,否则后台服务连不到局域网里的设备(对方先发来时仍能连上)。目前的版本是 ad-hoc 签名,更新后系统可能会再问一次。+- **macOS 15 要允许「本地网络」权限**,否则后台服务连不到局域网里的设备(对方先发来时仍能连上)。更新到新版本后,最初十几秒的包也可能被系统拦下,之后自动恢复。