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.

fix(core): stop restarting LAN discovery when a peer is offline

baiyuze34b6c643ca82
diff --git a/client-core/internal/transport/lan/lan.go b/client-core/internal/transport/lan/lan.go
index 4379ed0..c4446e1 100644
--- a/client-core/internal/transport/lan/lan.go
+++ b/client-core/internal/transport/lan/lan.go
@@ -1042,9 +1042,30 @@ func (t *Transport) send(dst netip.AddrPort, pkt []byte, probe bool) error {
if !running {
return ErrDisabled
}
- _, err := conn.WriteToUDPAddrPort(pkt, dst)
- if onLink(dst.Addr()) {
- t.noteSend(err, probe, time.Now())
+ if !onLink(dst.Addr()) {
+ _, err := conn.WriteToUDPAddrPort(pkt, dst)
+ return err
+ }
+ err := writeOnLink(conn, dst, pkt)
+ t.noteSend(err, probe, time.Now())
+ return err
+}
+
+// udpWriter 是 *net.UDPConn 发包的那部分,测试里换成假的。
+type udpWriter interface {
+ WriteToUDPAddrPort(b []byte, addr netip.AddrPort) (int, error)
+}
+
+// writeOnLink 往直连网段里的地址发一个包。
+//
+// 对方不在线时,ARP 解析失败的那一次发送也返回 EHOSTUNREACH,与被本地网络权限拦下时相同,
+// 但紧接着再发得到的是 EHOSTDOWN:系统把对方标成不在线,20 秒内都这样。被权限拦下的包到不了 ARP
+// 那一步,再发还是 EHOSTUNREACH。所以遇到它就再发一次,以第二次的结果为准。
+// 第一次没有发出去,对方最多收到一份。
+func writeOnLink(w udpWriter, dst netip.AddrPort, pkt []byte) error {
+ _, err := w.WriteToUDPAddrPort(pkt, dst)
+ if deniedByOS(err) {
+ _, err = w.WriteToUDPAddrPort(pkt, dst)
}
return err
}
diff --git a/client-core/internal/transport/lan/permission_darwin.go b/client-core/internal/transport/lan/permission_darwin.go
index 23fca00..19a3f46 100644
--- a/client-core/internal/transport/lan/permission_darwin.go
+++ b/client-core/internal/transport/lan/permission_darwin.go
@@ -19,6 +19,7 @@ func RequestPermission() error {
// deniedByOS 判断一次发送失败是不是被系统的本地网络权限拦下的。
// 只对本机直连网段里的地址下这个结论:真的没有路由时也会是同一个错误。
+// 直连网段里的对方不在线时,ARP 解析失败也会返回一次同样的错误,见 writeOnLink。
func deniedByOS(err error) bool {
return errors.Is(err, syscall.EHOSTUNREACH)
}
diff --git a/client-core/internal/transport/lan/permission_darwin_test.go b/client-core/internal/transport/lan/permission_darwin_test.go
index 08be53b..a4c1e11 100644
--- a/client-core/internal/transport/lan/permission_darwin_test.go
+++ b/client-core/internal/transport/lan/permission_darwin_test.go
@@ -84,3 +84,56 @@ func TestBlockedWithoutProbeTarget(t *testing.T) {
t.Fatal("没有探测地址时,发送成功应当算拦截解除")
}
}
+
+// fakeWriter 依次返回给定的错误,记下发了几次。
+type fakeWriter struct {
+ errs []error
+ n int
+}
+
+func (f *fakeWriter) WriteToUDPAddrPort(b []byte, _ netip.AddrPort) (int, error) {
+ err := f.errs[f.n]
+ f.n++
+ if err != nil {
+ return 0, err
+ }
+ return len(b), nil
+}
+
+// 对方不在线时 ARP 解析失败,那一次也返回 EHOSTUNREACH,紧接着再发就是 EHOSTDOWN:不算被系统拦下。
+// 实测被本地网络权限拦下时,再发还是 EHOSTUNREACH。
+func TestUnresolvedPeerIsNotDenied(t *testing.T) {
+ dst := netip.MustParseAddrPort("192.168.1.77:8788")
+ for _, c := range []struct {
+ name string
+ errs []error
+ writes int
+ denied bool
+ }{
+ {"发出去了", []error{nil}, 1, false},
+ {"对方被标成不在线", []error{syscall.EHOSTDOWN}, 1, false},
+ {"ARP 刚解析失败", []error{syscall.EHOSTUNREACH, syscall.EHOSTDOWN}, 2, false},
+ {"被本地网络权限拦下", []error{syscall.EHOSTUNREACH, syscall.EHOSTUNREACH}, 2, true},
+ } {
+ w := &fakeWriter{errs: c.errs}
+ err := writeOnLink(w, dst, []byte(magic))
+ if w.n != c.writes || deniedByOS(err) != c.denied {
+ t.Errorf("%s:发了 %d 次,结果 %v;应当发 %d 次,被拦=%v", c.name, w.n, err, c.writes, c.denied)
+ }
+ }
+}
+
+// ARP 解析失败不能触发重启 mDNS:之前每一两分钟就因此重启一次。
+func TestUnresolvedPeerKeepsDiscovery(t *testing.T) {
+ tr := idleTransport(t)
+ tr.probeAddr = netip.MustParseAddr("192.168.1.253")
+ now := time.Now()
+ tr.nextProbe = now.Add(probeEvery)
+
+ err := writeOnLink(&fakeWriter{errs: []error{syscall.EHOSTUNREACH, syscall.EHOSTDOWN}}, netip.MustParseAddrPort("192.168.1.77:8788"), []byte(magic))
+ tr.noteSend(err, false, now)
+ tr.noteSend(nil, true, now.Add(time.Second))
+ if tr.rediscover || !tr.deniedSince.IsZero() || tr.nextProbe.Before(now.Add(time.Minute)) {
+ t.Fatal("对方不在线不是被系统拦下,不该提前探测、也不该重启 mDNS")
+ }
+}
diff --git a/design/lan-mode.md b/design/lan-mode.md
index 6f6ecf0..072b196 100644
--- a/design/lan-mode.md
+++ b/design/lan-mode.md
@@ -52,6 +52,7 @@
- 后台服务的 Info.plist 加上 `NSLocalNetworkUsageDescription`(中英日本地化)与 `NSBonjourServices`。
- LaunchAgent 写上 `AssociatedBundleIdentifiers`,让系统知道后台服务属于 CopySync.app(TN3179 的建议)。
- 后台服务发现发往本机直连网段的包持续返回 `EHOSTUNREACH` 时,报告「被系统拦截」,界面提示用户去「系统设置 → 隐私与安全性 → 本地网络」打开。
+- 但对方不在线时也会得到 `EHOSTUNREACH`:ARP 解析失败的那一次发送返回它,之后 20 秒(`net.link.ether.inet.host_down_time`)里返回 `EHOSTDOWN`。被权限拦下的包到不了 ARP 那一步,立即再发还是 `EHOSTUNREACH`。所以遇到 `EHOSTUNREACH` 就立即再发一次,仍是它才算被拦。两种情况都在真机上测过(1.6.0 之后):launchd 启动的新签名程序头 2.5 秒里,在线和不在线的地址都是两次 `EHOSTUNREACH`;之后发往不在线地址的是 `EHOSTUNREACH` 加 `EHOSTDOWN`。
后来用正式打包方式(同样的 Info.plist,由 launchd 带着 `AssociatedBundleIdentifiers` 启动)在解锁的屏幕上复测:
@@ -166,7 +167,7 @@ hello 里带一个每次启动随机生成的启动标识。收到已配对设
`transport/lan/nearby_test.go`:只在窗口打开期间广播设备名、两台都打开才互相看到、关掉即消失;认出已配对的设备;点了对方后交换身份、对方关掉窗口时很快返回找不到;不再收到 ping 的设备消失、收到 ping 又出现;实例被过期丢掉后只靠对方的 ping 也能完整显示;设备名编码与截断。
-`transport/lan/lan_test.go`:两个实例绑在 127.0.0.1 的不同端口上,用内存网络代替 mDNS。已配对设备互相找到并收发信令、补发的那份被去重、地址记进地址簿;只靠记得的地址互相找到;未配对设备的 hello 不算数;局域网配对、按地址配对、码只能用一次、错 10 次后作废;可达状态过期;地址解析与令牌换天;显示码的一方向在找人配对的实例敲门、配对期间广播里带 s=1;对方重启后察觉。`permission_darwin_test.go`:探测地址在本网段里且不是本机,本机地址不算直连网段里的对端。
+`transport/lan/lan_test.go`:两个实例绑在 127.0.0.1 的不同端口上,用内存网络代替 mDNS。已配对设备互相找到并收发信令、补发的那份被去重、地址记进地址簿;只靠记得的地址互相找到;未配对设备的 hello 不算数;局域网配对、按地址配对、码只能用一次、错 10 次后作废;可达状态过期;地址解析与令牌换天;显示码的一方向在找人配对的实例敲门、配对期间广播里带 s=1;对方重启后察觉。`permission_darwin_test.go`:探测地址在本网段里且不是本机,本机地址不算直连网段里的对端;对方不在线(`EHOSTUNREACH` 后接 `EHOSTDOWN`)不算被拦,也不重启 mDNS。
`peers/manager_test.go`:两个完整的 `peers.Manager`。搜索附近设备:互相看到、点了对方后双方核对确认、直连并收发消息,重复的请求只弹一次确认,配对后显示为已配对;对方没打开窗口时看不到、配不上。没有服务器时配对、P2P 直连、双向收消息,解除配对后断开;不同网段时不输地址找不到、输了地址能配对并直连;关掉局域网只用服务器时原来的配对路径照常工作,错码立即被拒;服务器和局域网同时开着时,同一个码只能用一次。
@@ -226,6 +227,7 @@ Mac 与 Windows 11 虚拟机,各跑一个用 `-tags fakeclip` 编译的后台
- **没放行防火墙的 Windows 显示配对码时,同网段的 Mac 配不上。** 加了「敲门」;一开始按实例限速,2 秒内只敲到了走不通的那个地址,改成按「实例 + 地址」限速。
- **被系统拦截的提示会闪。** 新程序启动初期的拦截、发往本机地址的成功,都会让判断出错,见第二节。
- **升级后局域网发现不工作。** mDNS 恰好在新程序被拦的那几秒里启动,Wi-Fi 和虚拟机的网卡都没用上,要等下次登录。改为拦截一解除就重启 mDNS,见第二节。
+- **局域网发现每一两分钟重启一次。** 已配对的设备不在线时,发往它旧地址的打招呼包每隔一阵就碰上一次 ARP 解析失败,返回的 `EHOSTUNREACH` 被当成了「被系统拦截」;紧接着的探测成功,又被当成「拦截解除」,于是重启 mDNS。改为立即再发一次来区分,见第二节。
- **短暂的拦截被报告了 5 分钟。** 启动时的第一次探测先把下次探测排到 10 分钟后,偏偏这次被拦,之后又没有包能证明拦截已解除。改为看到探测结果再排下一次。
- **网络刚变化时 mDNS 启动失败,之后不再重试。** 网卡还没拿到地址时启动会报 no usable interfaces。改为每 5 秒重试,直到成功。
- **配对后的第一次连接要等 30 秒。** 确认配对后立即发起连接,但双方还没互发过 hello,局域网通道认为对方不可达,offer 发不出去,连接停在「连接中」直到握手超时。改为配对的请求与回复到达时就标记可达;offer 发不出去时立即复位,不等超时。
diff --git a/docs/design/lan-mode.html b/docs/design/lan-mode.html
index ea71c50..753ff83 100644
--- a/docs/design/lan-mode.html
+++ b/docs/design/lan-mode.html
@@ -44,7 +44,7 @@
<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><li>但对方不在线时也会得到 <code>EHOSTUNREACH</code>:ARP 解析失败的那一次发送返回它,之后 20 秒(<code>net.link.ether.inet.host_down_time</code>)里返回 <code>EHOSTDOWN</code>。被权限拦下的包到不了 ARP 那一步,立即再发还是 <code>EHOSTUNREACH</code>。所以遇到 <code>EHOSTUNREACH</code> 就立即再发一次,仍是它才算被拦。两种情况都在真机上测过(1.6.0 之后):launchd 启动的新签名程序头 2.5 秒里,在线和不在线的地址都是两次 <code>EHOSTUNREACH</code>;之后发往不在线地址的是 <code>EHOSTUNREACH</code> 加 <code>EHOSTDOWN</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>这段拦截还会让 mDNS 失效:pion/mdns 启动时在哪块网卡上加入组播失败,就再也不用那块网卡。于是启动 mDNS 之前先探测一次,被拦期间每一轮都探测,探测一通过就重启 mDNS。用户后来才在系统设置里允许,也走同一条路恢复。判断拦截解除只认探测包:被拦时,发给先联系过本机的设备照样能成功。</li><li>还没配对任何设备时,后台服务不往局域网发单播,就发现不了自己被拦着。于是在 macOS 上定期往本网段里一个普通地址的丢弃端口发几个字节探测(不用网关:发往网关的包可能不受这项限制)。往本机自己的地址发包也不受限制,不能当作「没被拦」的证据——Parallels 的 NAT 会让虚拟机的包看起来来自本机地址。</li></ul>
<h2 id="三-方案">三、方案</h2>
@@ -76,7 +76,7 @@
<h3 id="单元测试与集成测试">单元测试与集成测试</h3>
<p><code>transport/signed/signed_test.go</code>:签名与校验;同一条信令从两条通道到达只处理一次;收件人不是本机时拒收;未配对、冒用 ID、时间戳过期都拒收。</p>
<p><code>transport/lan/nearby_test.go</code>:只在窗口打开期间广播设备名、两台都打开才互相看到、关掉即消失;认出已配对的设备;点了对方后交换身份、对方关掉窗口时很快返回找不到;不再收到 ping 的设备消失、收到 ping 又出现;实例被过期丢掉后只靠对方的 ping 也能完整显示;设备名编码与截断。</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>transport/lan/lan_test.go</code>:两个实例绑在 127.0.0.1 的不同端口上,用内存网络代替 mDNS。已配对设备互相找到并收发信令、补发的那份被去重、地址记进地址簿;只靠记得的地址互相找到;未配对设备的 hello 不算数;局域网配对、按地址配对、码只能用一次、错 10 次后作废;可达状态过期;地址解析与令牌换天;显示码的一方向在找人配对的实例敲门、配对期间广播里带 s=1;对方重启后察觉。<code>permission_darwin_test.go</code>:探测地址在本网段里且不是本机,本机地址不算直连网段里的对端;对方不在线(<code>EHOSTUNREACH</code> 后接 <code>EHOSTDOWN</code>)不算被拦,也不重启 mDNS。</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>
@@ -95,7 +95,7 @@
<ul><li>Mac 打开后立刻看到 Windows,设备名经 Windows 的系统 DNS-SD 服务转发后完好;点它不到 1 秒收到回应,两边指纹一致,确认后直连。没放行防火墙的 Windows 照样收到了请求(它先发过 ping)。</li><li>两边都只打开、不点:Mac 打开后 1 秒内出现在 Windows 的列表里,并认出是已配对的设备;Mac 关掉后 1 秒内从 Windows 的列表里消失(广播里撤下设备名,pion 报了更新)。</li><li>配对后文本双向同步。</li></ul>
<p>第一轮里「两边重启后约 1 秒重新直连」的结果不可靠:清理测试进程时漏掉了几个,「重启」时旧实例还以同一个身份在运行。第二轮在干净的环境里重测,结果如上。</p>
<h2 id="六-踩过的坑">六、踩过的坑</h2>
-<ul><li><strong>重启后要 30 秒才恢复。</strong> 应答方重启后,发起方还以为旧连接活着,要等握手超时。加了启动标识,见「7. 重启」。</li><li><strong>没放行防火墙的 Windows 显示配对码时,同网段的 Mac 配不上。</strong> 加了「敲门」;一开始按实例限速,2 秒内只敲到了走不通的那个地址,改成按「实例 + 地址」限速。</li><li><strong>被系统拦截的提示会闪。</strong> 新程序启动初期的拦截、发往本机地址的成功,都会让判断出错,见第二节。</li><li><strong>升级后局域网发现不工作。</strong> mDNS 恰好在新程序被拦的那几秒里启动,Wi-Fi 和虚拟机的网卡都没用上,要等下次登录。改为拦截一解除就重启 mDNS,见第二节。</li><li><strong>短暂的拦截被报告了 5 分钟。</strong> 启动时的第一次探测先把下次探测排到 10 分钟后,偏偏这次被拦,之后又没有包能证明拦截已解除。改为看到探测结果再排下一次。</li><li><strong>网络刚变化时 mDNS 启动失败,之后不再重试。</strong> 网卡还没拿到地址时启动会报 no usable interfaces。改为每 5 秒重试,直到成功。</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>[[ … ]] &amp;&amp; …</code> 放在函数末尾、条件不成立时会让函数返回 1,触发 <code>set -e</code>。</li></ul>
+<ul><li><strong>重启后要 30 秒才恢复。</strong> 应答方重启后,发起方还以为旧连接活着,要等握手超时。加了启动标识,见「7. 重启」。</li><li><strong>没放行防火墙的 Windows 显示配对码时,同网段的 Mac 配不上。</strong> 加了「敲门」;一开始按实例限速,2 秒内只敲到了走不通的那个地址,改成按「实例 + 地址」限速。</li><li><strong>被系统拦截的提示会闪。</strong> 新程序启动初期的拦截、发往本机地址的成功,都会让判断出错,见第二节。</li><li><strong>升级后局域网发现不工作。</strong> mDNS 恰好在新程序被拦的那几秒里启动,Wi-Fi 和虚拟机的网卡都没用上,要等下次登录。改为拦截一解除就重启 mDNS,见第二节。</li><li><strong>局域网发现每一两分钟重启一次。</strong> 已配对的设备不在线时,发往它旧地址的打招呼包每隔一阵就碰上一次 ARP 解析失败,返回的 <code>EHOSTUNREACH</code> 被当成了「被系统拦截」;紧接着的探测成功,又被当成「拦截解除」,于是重启 mDNS。改为立即再发一次来区分,见第二节。</li><li><strong>短暂的拦截被报告了 5 分钟。</strong> 启动时的第一次探测先把下次探测排到 10 分钟后,偏偏这次被拦,之后又没有包能证明拦截已解除。改为看到探测结果再排下一次。</li><li><strong>网络刚变化时 mDNS 启动失败,之后不再重试。</strong> 网卡还没拿到地址时启动会报 no usable interfaces。改为每 5 秒重试,直到成功。</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>[[ … ]] &amp;&amp; …</code> 放在函数末尾、条件不成立时会让函数返回 1,触发 <code>set -e</code>。</li></ul>
<h2 id="七-局限与后续">七、局限与后续</h2>
<ul><li>两台都没放行防火墙的 Windows、跨网段、只有一边知道地址时连不上,需要在被连的一方点「放行」。</li><li>macOS 15 的本地网络授权弹窗只在屏幕解锁时出现。用户拒绝之后,要在系统设置里手动打开。</li><li>敲门只在同一网段有效;跨网段时,被连的一方若是没放行防火墙的 Windows,仍需点「放行」。</li><li>不做网段扫描。两边地址都变了要手动输入一次,台式机建议在路由器里固定地址。</li><li>只支持 IPv4。</li><li>本机换 IP 后,旧的 P2P 连接要等 ICE 判定失效(约 30 秒)才重建。</li><li>发送时连接恰好断开,那一条可能丢失:同步层没有送达确认(1.1 起就是这样,与局域网模式无关)。</li></ul>
</article>