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.

docs(site): describe searching nearby devices

baiyuzecaf54672b0df
diff --git a/design/lan-mode.md b/design/lan-mode.md
index b407258..7d5dc8d 100644
--- a/design/lan-mode.md
+++ b/design/lan-mode.md
@@ -1,7 +1,7 @@
# 局域网直连:不用服务器也能配对和同步
-> 状态:已实现,随 1.4.0 发布
-> 代码:`client-core/internal/transport/lan/`(发现、信令、配对、地址簿)、`transport/signed/`(签名与校验)、`peers/manager.go`(两条通道合并)
+> 状态:已实现,随 1.4.0 发布;「搜索附近设备」随 1.5.0 发布
+> 代码:`client-core/internal/transport/lan/`(发现、信令、配对、搜索附近设备、地址簿)、`transport/signed/`(签名与校验)、`peers/manager.go`(两条通道合并)
> 验证:`transport/lan/lan_test.go`、`peers/manager_test.go`、`tools/natlab/`(局域网场景)、Mac 与 Windows 虚拟机实机测试
> 相关:[多出口网络的 NAT 打洞](nat-traversal.md)
@@ -103,18 +103,32 @@
- 配对请求与回复本身证明了对方在哪个地址,收到即标记可达,确认后第一次连接不必再等 hello。
- **敲门**:输入码的一方在 mDNS 里带上 `s=1`;显示码的一方看到后,先往它的每个地址发一个只有魔数的空包。显示码的一方若是没放行防火墙的 Windows,对方主动发来的配对请求本会被挡住;先发过包,有状态防火墙就会放行。只在同一网段有效(靠 mDNS),跨网段时仍需在被连的一方放行。
-### 6. 重启
+### 6. 搜索附近设备
+
+配对码之外的另一种配对方式,1.5.0 加入:两台都在「设备」页打开「搜索附近设备」,互相出现在雷达上,点一下对方就发起配对。原来的「添加设备」(配对码)不变,雷达是单独的入口。
+
+- **只在窗口打开期间公开设备名。** 平时广播里只有匿名令牌;窗口打开时加上 `n`(设备名,UTF-8 再 base64url 编码,最多 60 字节)和 `o`(系统)。编码是为了经 Windows 的系统 DNS-SD 服务转一道也不走样。窗口关掉、界面退出时,后台服务的 `WatchNearby` 调用随之结束,广播里的设备名随即撤下。
+- **只有两台都打开时才互相看得到**:没打开窗口的一方不广播设备名,也不接受这种请求。
+- **靠 ping 判断对方还在。** pion/mdns 只在实例出现或变化时上报,不报下线,对方退出或睡眠后会一直留在列表里。所以打开窗口的设备每 2 秒(每轮 tick)向附近每个也打开了窗口的实例发一个 `LanNearbyPing`(带自己的实例名),收到的一方刷新那个实例的时间;7 秒没有消息就从列表里拿掉。ping 的来源地址也记下来,作为发配对请求的首选地址(多网卡时 mDNS 报的不一定是走得通的那个)。
+- **ping 同时是敲门。** 两台都在互相发,没放行防火墙的 Windows 发过 ping 之后,对方随后的配对请求就进得来,不需要「放行」。
+- **配对请求**是 `LanPacket.nearby_request`:与 `pair_request` 相同的签名 `LanPairInfo`,只是不带配对码。对方窗口开着时,上层弹出核对指纹(同一台设备的重复请求只弹一次),并立即回复 `pair_response`;窗口已关时回 `pair_reject`(`closed`),发起方立即报「对方没有回应」,不必等到超时。之后两边核对指纹、各自确认,与配对码完全相同。
+- **安全性。** 配对码挡的是「任何人都能发起」:这里由对方的用户在弹窗里决定接不接受,而且只在对方开着窗口时才会弹。防中间人仍然靠两边核对安全指纹,这一点与配对码相同。
+- **兼容。** 旧版本不广播 `n`,不会出现在雷达上;收到新的包类型时直接忽略。
+- 已配对的设备也显示在雷达上(按令牌认出),标为「已配对」,不能点。
+- 只在同一网段有效(靠 mDNS)。跨网段仍用配对码加地址。
+
+### 7. 重启
hello 里带一个每次启动随机生成的启动标识。收到已配对设备的 hello、发现启动标识变了,就知道它重启过:立即丢掉旧的 P2P 连接重建,不必等连接超时。用服务器时,这件事由服务器的上下线通知完成;没有服务器时,没有这一步的话,应答方重启后要等发起方自己发现连接失效(实测约 30 秒)。
另外,mDNS 里出现已配对设备的新实例名或新地址时,即使还当它可达,也马上打招呼:重启的那台若是没放行防火墙的 Windows,它主动发来的包进不来,要靠本机先发。
-### 7. 其他改动
+### 8. 其他改动
- 服务器地址默认为空。1.4.0 之前的默认值 `ws://127.0.0.1:8787/signal` 其实没有服务器在跑,升级时清空一次(配置文件记 `config_version`,只迁移一次)。
- 没有服务器时不探测公共 STUN:只在局域网里连,探测出口没有用,还会把公网 IP 暴露给公共服务器。
- 解除配对时断开 P2P 连接(以前不断开)。
-- `copysync-cli`:`join CODE [ADDRESS]`、`address DEVICE ADDR`,`nat` 里加了局域网一节。
+- `copysync-cli`:`join CODE [ADDRESS]`、`address DEVICE ADDR`,`nat` 里加了局域网一节;1.5.0 加了 `nearby [NAME]`(搜索附近设备,给了 NAME 就在它出现时发起配对)。
### 代码位置
@@ -122,6 +136,7 @@ hello 里带一个每次启动随机生成的启动标识。收到已配对设
|---|---|
| `transport/lan/lan.go` | socket、hello、可达状态、地址簿、诊断 |
| `transport/lan/pairing.go` | 局域网配对 |
+| `transport/lan/nearby.go` | 搜索附近设备:广播设备名、ping、不带配对码的配对请求 |
| `transport/lan/discovery.go`、`mdns*.go` | 发现接口、pion/mdns 实现、Windows 的系统 DNS-SD 注册、测试用的内存网络 |
| `transport/lan/addrs.go` | 本机地址、地址解析、令牌 |
| `transport/lan/permission_*.go` | macOS 打开本地网络设置与探测地址、Windows 用 UAC 放行防火墙 |
@@ -148,13 +163,15 @@ hello 里带一个每次启动随机生成的启动标识。收到已配对设
`transport/signed/signed_test.go`:签名与校验;同一条信令从两条通道到达只处理一次;收件人不是本机时拒收;未配对、冒用 ID、时间戳过期都拒收。
+`transport/lan/nearby_test.go`:只在窗口打开期间广播设备名、两台都打开才互相看到、关掉即消失;认出已配对的设备;点了对方后交换身份、对方关掉窗口时很快返回找不到;不再收到 ping 的设备消失、收到 ping 又出现;设备名编码与截断。
+
`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 直连、双向收消息,解除配对后断开;不同网段时不输地址找不到、输了地址能配对并直连;关掉局域网只用服务器时原来的配对路径照常工作,错码立即被拒;服务器和局域网同时开着时,同一个码只能用一次。
+`peers/manager_test.go`:两个完整的 `peers.Manager`。搜索附近设备:互相看到、点了对方后双方核对确认、直连并收发消息,重复的请求只弹一次确认,配对后显示为已配对;对方没打开窗口时看不到、配不上。没有服务器时配对、P2P 直连、双向收消息,解除配对后断开;不同网段时不输地址找不到、输了地址能配对并直连;关掉局域网只用服务器时原来的配对路径照常工作,错码立即被拒;服务器和局域网同时开着时,同一个码只能用一次。
`config/config_test.go`:旧默认地址清空、自己的服务器保留、只迁移一次。`store/store_test.go`:地址簿的排序、上限、随设备删除。
-界面:`pairing_flow_test.dart` 覆盖显示本机地址、找不到时展开地址框并带地址重试、错码提示、侧栏的局域网状态与 macOS 拦截提示。
+界面:`pairing_flow_test.dart` 覆盖原来的添加设备不变、雷达是单独入口;雷达显示附近的设备、点了之后弹出核对指纹并关掉雷达(随之撤下本机)、对方没回应时的提示、局域网发现关闭时的说明;显示本机地址、找不到时展开地址框并带地址重试、错码提示、侧栏的局域网状态与 macOS 拦截提示。
### NAT 打洞实验室
@@ -194,11 +211,17 @@ Mac 与 Windows 11 虚拟机,各跑一个用 `-tags fakeclip` 编译的后台
- Mac 装上新版后,局域网发现正常工作,没有误报「被系统拦截」(修复前见「六、踩过的坑」)。
- 没测:睡眠唤醒、Mac 上开关 Wi-Fi、两台 Windows 之间、真实的跨网段与 Tailscale(只在 NAT 打洞实验室里测过)。
+第四轮(1.5.0,搜索附近设备):Mac 与 Windows 11 虚拟机各跑一个 `-tags fakeclip` 的后台服务(独立数据目录,与两边正式安装的 1.4.0 同时运行,局域网端口因此都退回随机端口),Windows 上的程序是新的路径,没有任何防火墙规则,用 `copysync-cli nearby` 代替界面:
+
+- Mac 打开后立刻看到 Windows,设备名经 Windows 的系统 DNS-SD 服务转发后完好;点它不到 1 秒收到回应,两边指纹一致,确认后直连。没放行防火墙的 Windows 照样收到了请求(它先发过 ping)。
+- 两边都只打开、不点:Mac 打开后 1 秒内出现在 Windows 的列表里,并认出是已配对的设备;Mac 关掉后 1 秒内从 Windows 的列表里消失(广播里撤下设备名,pion 报了更新)。
+- 配对后文本双向同步。
+
第一轮里「两边重启后约 1 秒重新直连」的结果不可靠:清理测试进程时漏掉了几个,「重启」时旧实例还以同一个身份在运行。第二轮在干净的环境里重测,结果如上。
## 六、踩过的坑
-- **重启后要 30 秒才恢复。** 应答方重启后,发起方还以为旧连接活着,要等握手超时。加了启动标识,见「6. 重启」。
+- **重启后要 30 秒才恢复。** 应答方重启后,发起方还以为旧连接活着,要等握手超时。加了启动标识,见「7. 重启」。
- **没放行防火墙的 Windows 显示配对码时,同网段的 Mac 配不上。** 加了「敲门」;一开始按实例限速,2 秒内只敲到了走不通的那个地址,改成按「实例 + 地址」限速。
- **被系统拦截的提示会闪。** 新程序启动初期的拦截、发往本机地址的成功,都会让判断出错,见第二节。
- **升级后局域网发现不工作。** mDNS 恰好在新程序被拦的那几秒里启动,Wi-Fi 和虚拟机的网卡都没用上,要等下次登录。改为拦截一解除就重启 mDNS,见第二节。
diff --git a/docs/design/lan-mode.html b/docs/design/lan-mode.html
index ab45314..4765936 100644
--- a/docs/design/lan-mode.html
+++ b/docs/design/lan-mode.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>局域网直连:不用服务器也能配对和同步:CopySync 技术方案</title>
- <meta name="description" content="状态:已实现,随 1.4.0 发布">
+ <meta name="description" content="状态:已实现,随 1.4.0 发布;「搜索附近设备」随 1.5.0 发布">
<link rel="canonical" href="https://baiyuze.github.io/copysync/design/lan-mode.html">
<meta name="theme-color" content="#141416">
<link rel="icon" href="../assets/favicon.svg" type="image/svg+xml">
@@ -27,7 +27,7 @@
<article class="article">
<p class="crumb"><a href="../">CopySync</a> 的技术方案</p>
<h1>局域网直连:不用服务器也能配对和同步</h1>
-<blockquote><p>状态:已实现,随 1.4.0 发布</p><p>代码:<code>client-core/internal/transport/lan/</code>(发现、信令、配对、地址簿)、<code>transport/signed/</code>(签名与校验)、<code>peers/manager.go</code>(两条通道合并)</p><p>验证:<code>transport/lan/lan_test.go</code>、<code>peers/manager_test.go</code>、<code>tools/natlab/</code>(局域网场景)、Mac 与 Windows 虚拟机实机测试</p><p>相关:<a href="nat-traversal.html">多出口网络的 NAT 打洞</a></p></blockquote>
+<blockquote><p>状态:已实现,随 1.4.0 发布;「搜索附近设备」随 1.5.0 发布</p><p>代码:<code>client-core/internal/transport/lan/</code>(发现、信令、配对、搜索附近设备、地址簿)、<code>transport/signed/</code>(签名与校验)、<code>peers/manager.go</code>(两条通道合并)</p><p>验证:<code>transport/lan/lan_test.go</code>、<code>peers/manager_test.go</code>、<code>tools/natlab/</code>(局域网场景)、Mac 与 Windows 虚拟机实机测试</p><p>相关:<a href="nat-traversal.html">多出口网络的 NAT 打洞</a></p></blockquote>
<nav class="toc" aria-label="目录"><strong>目录</strong><ul><li><a href="#一-问题">一、问题</a></li><li><a href="#二-原型实测">二、原型实测</a></li><li><a href="#三-方案">三、方案</a></li><li><a href="#四-能覆盖哪些场景">四、能覆盖哪些场景</a></li><li><a href="#五-验证">五、验证</a></li><li><a href="#六-踩过的坑">六、踩过的坑</a></li><li><a href="#七-局限与后续">七、局限与后续</a></li></ul></nav>
<h2 id="一-问题">一、问题</h2>
<p>1.3 之前,两台电脑必须先连上同一台信令服务器,才能配对、知道对方在线、交换连接信息。即使两台就在同一个路由器下面,用户也得先找一台常开的电脑部署服务器。</p>
@@ -60,22 +60,26 @@
<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><li><strong>敲门</strong>:输入码的一方在 mDNS 里带上 <code>s=1</code>;显示码的一方看到后,先往它的每个地址发一个只有魔数的空包。显示码的一方若是没放行防火墙的 Windows,对方主动发来的配对请求本会被挡住;先发过包,有状态防火墙就会放行。只在同一网段有效(靠 mDNS),跨网段时仍需在被连的一方放行。</li></ul>
-<h3 id="6-重启">6. 重启</h3>
+<h3 id="6-搜索附近设备">6. 搜索附近设备</h3>
+<p>配对码之外的另一种配对方式,1.5.0 加入:两台都在「设备」页打开「搜索附近设备」,互相出现在雷达上,点一下对方就发起配对。原来的「添加设备」(配对码)不变,雷达是单独的入口。</p>
+<ul><li><strong>只在窗口打开期间公开设备名。</strong> 平时广播里只有匿名令牌;窗口打开时加上 <code>n</code>(设备名,UTF-8 再 base64url 编码,最多 60 字节)和 <code>o</code>(系统)。编码是为了经 Windows 的系统 DNS-SD 服务转一道也不走样。窗口关掉、界面退出时,后台服务的 <code>WatchNearby</code> 调用随之结束,广播里的设备名随即撤下。</li><li><strong>只有两台都打开时才互相看得到</strong>:没打开窗口的一方不广播设备名,也不接受这种请求。</li><li><strong>靠 ping 判断对方还在。</strong> pion/mdns 只在实例出现或变化时上报,不报下线,对方退出或睡眠后会一直留在列表里。所以打开窗口的设备每 2 秒(每轮 tick)向附近每个也打开了窗口的实例发一个 <code>LanNearbyPing</code>(带自己的实例名),收到的一方刷新那个实例的时间;7 秒没有消息就从列表里拿掉。ping 的来源地址也记下来,作为发配对请求的首选地址(多网卡时 mDNS 报的不一定是走得通的那个)。</li><li><strong>ping 同时是敲门。</strong> 两台都在互相发,没放行防火墙的 Windows 发过 ping 之后,对方随后的配对请求就进得来,不需要「放行」。</li><li><strong>配对请求</strong>是 <code>LanPacket.nearby_request</code>:与 <code>pair_request</code> 相同的签名 <code>LanPairInfo</code>,只是不带配对码。对方窗口开着时,上层弹出核对指纹(同一台设备的重复请求只弹一次),并立即回复 <code>pair_response</code>;窗口已关时回 <code>pair_reject</code>(<code>closed</code>),发起方立即报「对方没有回应」,不必等到超时。之后两边核对指纹、各自确认,与配对码完全相同。</li><li><strong>安全性。</strong> 配对码挡的是「任何人都能发起」:这里由对方的用户在弹窗里决定接不接受,而且只在对方开着窗口时才会弹。防中间人仍然靠两边核对安全指纹,这一点与配对码相同。</li><li><strong>兼容。</strong> 旧版本不广播 <code>n</code>,不会出现在雷达上;收到新的包类型时直接忽略。</li><li>已配对的设备也显示在雷达上(按令牌认出),标为「已配对」,不能点。</li><li>只在同一网段有效(靠 mDNS)。跨网段仍用配对码加地址。</li></ul>
+<h3 id="7-重启">7. 重启</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="8-其他改动">8. 其他改动</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> 里加了局域网一节;1.5.0 加了 <code>nearby [NAME]</code>(搜索附近设备,给了 NAME 就在它出现时发起配对)。</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/nearby.go</code></td><td>搜索附近设备:广播设备名、ping、不带配对码的配对请求</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>同一网段里能配对(它先「敲门」)、能重连;跨网段时要它知道对方的地址</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/nearby_test.go</code>:只在窗口打开期间广播设备名、两台都打开才互相看到、关掉即消失;认出已配对的设备;点了对方后交换身份、对方关掉窗口时很快返回找不到;不再收到 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>peers/manager_test.go</code>:两个完整的 <code>peers.Manager</code>。没有服务器时配对、P2P 直连、双向收消息,解除配对后断开;不同网段时不输地址找不到、输了地址能配对并直连;关掉局域网只用服务器时原来的配对路径照常工作,错码立即被拒;服务器和局域网同时开着时,同一个码只能用一次。</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>
+<p>界面:<code>pairing_flow_test.dart</code> 覆盖原来的添加设备不变、雷达是单独入口;雷达显示附近的设备、点了之后弹出核对指纹并关掉雷达(随之撤下本机)、对方没回应时的提示、局域网发现关闭时的说明;显示本机地址、找不到时展开地址框并带地址重试、错码提示、侧栏的局域网状态与 macOS 拦截提示。</p>
<h3 id="nat-打洞实验室">NAT 打洞实验室</h3>
<p>新增 <code>natlab lanpeer</code>:不起任何服务器,用真实的局域网通道连接,两端身份由种子派生,相当于已经配对。新增两种拓扑:同一网段(网桥)与两个网段(路由器,不做 NAT)。</p>
<div class="table-scroll"><table><thead><tr><th scope="col">场景</th><th scope="col">预期</th><th scope="col">结果</th></tr></thead><tbody><tr><td>同一网段,靠 mDNS 发现</td><td>直连</td><td>通过</td></tr><tr><td>两个网段,一边记得对方地址</td><td>直连</td><td>通过</td></tr><tr><td>两个网段,两台都挡入站新连接,都记得地址</td><td>直连</td><td>通过</td></tr><tr><td>两个网段,两台都挡入站新连接,只有一边记得</td><td>连不上</td><td>通过</td></tr><tr><td>两个网段之间被隔离</td><td>连不上</td><td>通过</td></tr></tbody></table></div>
@@ -87,9 +91,11 @@
<ul><li>Windows 显示配对码、Mac 只输入配对码:2 秒配对成功(Windows 先敲门)。</li><li>文本双向同步。</li><li>只重启 Mac、只重启 Windows:都在 4 秒内恢复,以「复制后对方收到」计时,含每轮约 1 至 2 秒的检测开销。</li><li>新程序刚启动时没有误报「被系统拦截」。</li></ul>
<p>第三轮用正式安装的 App:Mac 装进 /Applications,Windows 用 CI 构建的安装包覆盖安装,两边都配着服务器,Windows 没放行防火墙:</p>
<ul><li>Mac 换成新版、Windows 还是旧版(1.1.2 开发版)时,经服务器文本双向同步。</li><li>图片(Mac 上的 PNG 数据、Windows 上的位图)和文件夹(带子目录与中文文件名)双向同步,SHA-256 一致。</li><li>在 Windows 防火墙里挡住到服务器的连接、重启 Windows 的后台服务:只靠局域网,12 秒内重新直连,同步正常;Mac 1.6 秒后就从启动标识察觉对方重启。</li><li>Windows 换 IP:约 32 秒后旧连接被判定失效,4 秒后重连。网卡禁用 15 秒再启用:启用后 8 秒恢复直连。</li><li>Mac 装上新版后,局域网发现正常工作,没有误报「被系统拦截」(修复前见「六、踩过的坑」)。</li><li>没测:睡眠唤醒、Mac 上开关 Wi-Fi、两台 Windows 之间、真实的跨网段与 Tailscale(只在 NAT 打洞实验室里测过)。</li></ul>
+<p>第四轮(1.5.0,搜索附近设备):Mac 与 Windows 11 虚拟机各跑一个 <code>-tags fakeclip</code> 的后台服务(独立数据目录,与两边正式安装的 1.4.0 同时运行,局域网端口因此都退回随机端口),Windows 上的程序是新的路径,没有任何防火墙规则,用 <code>copysync-cli nearby</code> 代替界面:</p>
+<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> 应答方重启后,发起方还以为旧连接活着,要等握手超时。加了启动标识,见「6. 重启」。</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>短暂的拦截被报告了 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>
diff --git a/docs/en/index.html b/docs/en/index.html
index 9a8ba69..a41953d 100644
--- a/docs/en/index.html
+++ b/docs/en/index.html
@@ -395,7 +395,7 @@
<li><strong>You compare fingerprints when pairing.</strong> Both screens show the same two lines: the fingerprint of each device's key. The server could swap keys in transit, but then the two screens would no longer match. That check is what stops a man in the middle.</li>
<li><strong>Every message after that is signed,</strong> so the server can't impersonate your device. The direct channel's certificate is checked again after the handshake; a mismatch drops the connection.</li>
<li><strong>The relay only forwards ciphertext.</strong> TURN carries encrypted packets, and relay credentials are issued per device and expire after 12 hours.</li>
- <li><strong>Same on the local network.</strong> What a device broadcasts on the LAN is an anonymous token that changes daily, not its name. Pairing still means comparing fingerprints, and every message is still signed.</li>
+ <li><strong>Same on the local network.</strong> What a device broadcasts on the LAN is an anonymous token that changes daily, not its name; the name is added only while Search nearby is open. Pairing still means comparing fingerprints, and every message is still signed.</li>
</ul>
<figure class="figure-card">
<img src="../assets/screenshots/en/card-verify-dark.png" width="1120" height="800" loading="lazy" alt="The fingerprint check during pairing shows R8NF-2WTC-QL5J and asks you to confirm it matches the other computer exactly">
diff --git a/docs/en/lan/index.html b/docs/en/lan/index.html
index 6b48e46..ac678e9 100644
--- a/docs/en/lan/index.html
+++ b/docs/en/lan/index.html
@@ -82,7 +82,7 @@
</svg>
</figure>
<ul class="points ports">
- <li><strong>Found automatically.</strong> Each computer announces itself on the LAN over mDNS, with only an anonymous token that changes daily, so nobody can tell whose computer it is.</li>
+ <li><strong>Found automatically.</strong> Each computer announces itself on the LAN over mDNS, with only an anonymous token that changes daily, so nobody can tell whose computer it is. Its name is added only while Search nearby is open.</li>
<li><strong>Direct.</strong> Content goes straight between the two computers, at the speed of your network.</li>
<li><strong>Same security.</strong> You compare two fingerprint lines when pairing, and every message after that is signed, so others on the network can't pose as your device.</li>
</ul>
@@ -121,6 +121,19 @@
<img src="../../assets/screenshots/en/pairing-dark.png" width="2112" height="1472" loading="lazy" alt="Add device: the pairing code K7MP2X, with this computer&#x27;s address 192.168.1.20 below it">
</figure>
</div>
+ <div class="os-grid qs-grid">
+ <div class="qs-app">
+ <h3>Without a code: Search nearby</h3>
+ <ol class="steps">
+ <li>On both computers, open Devices and click Search nearby. Only while this window is open can devices on the network see this computer's name.</li>
+ <li>When the other one shows up on the radar, click it. Both screens show the same two fingerprint lines; check them, then confirm on each.</li>
+ <li>This works within one subnet only. If the other computer doesn't show up, use a pairing code as above.</li>
+ </ol>
+ </div>
+ <figure class="shot">
+ <img src="../../assets/screenshots/en/nearby-dark.png" width="2112" height="1472" loading="lazy" alt="Nearby devices: this computer in the middle, with Design PC and Meeting room iMac around it, plus the already paired MacBook Air">
+ </figure>
+ </div>
</div>
</section>
@@ -163,7 +176,7 @@
</details>
<details>
<summary>Can others on the network see my computer?</summary>
- <div class="answer"><p>They can see that a CopySync device is there, but not whose: the broadcast carries an anonymous token that changes daily, with no device name or ID. Messages from devices you haven't paired with are dropped, and pairing requires comparing fingerprints on both screens.</p></div>
+ <div class="answer"><p>They can see that a CopySync device is there, but not whose: the broadcast carries an anonymous token that changes daily, with no device name or ID. The name is added only while you have Search nearby open, and removed when you close it. Messages from devices you haven't paired with are dropped, and pairing requires comparing fingerprints on both screens.</p></div>
</details>
<details>
<summary>Which ports does it use?</summary>
diff --git a/docs/index.html b/docs/index.html
index f2858ea..9245b3f 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -415,7 +415,7 @@
<li><strong>配对时由你核对安全指纹。</strong>两块屏幕会显示同样的两行:双方各自公钥的指纹。服务器有能力替换转发中的公钥,但替换之后两块屏幕就对不上了,这一步就是防中间人的闸门。</li>
<li><strong>之后的每条消息都带签名,</strong>服务器无法冒充你的设备。直连通道的证书在握手后还会再核对一次,不一致立即断开。</li>
<li><strong>中转也只是转发密文。</strong>TURN 转发的是加密后的数据包,中转凭证按设备单独签发,12 小时后过期。</li>
- <li><strong>局域网里也一样。</strong>设备在局域网里广播的只是一个每天都变的匿名标识,看不出是谁的电脑;配对同样要核对指纹,之后的消息同样带签名。</li>
+ <li><strong>局域网里也一样。</strong>设备在局域网里广播的只是一个每天都变的匿名标识,看不出是谁的电脑,只有打开「搜索附近设备」时才带上设备名;配对同样要核对指纹,之后的消息同样带签名。</li>
</ul>
<figure class="figure-card">
<img src="assets/screenshots/card-verify-dark.png" width="1120" height="800" loading="lazy" alt="配对时的「核对安全指纹」对话框,显示 R8NF-2WTC-QL5J,要求与另一台电脑上显示的完全一致">
diff --git a/docs/ja/index.html b/docs/ja/index.html
index a395858..1974c86 100644
--- a/docs/ja/index.html
+++ b/docs/ja/index.html
@@ -395,7 +395,7 @@
<li><strong>ペアリングでは指紋をあなたが照合する。</strong>両方の画面に同じ 2 行、つまりお互いの公開鍵の指紋が表示されます。サーバーは転送中の公開鍵をすり替えられますが、すり替えれば 2 つの画面が一致しなくなります。この照合が中間者攻撃を防ぐ関門です。</li>
<li><strong>その後のメッセージはすべて署名付き。</strong>サーバーがあなたのデバイスになりすますことはできません。直接接続の証明書もハンドシェイク後にもう一度照合し、食い違えばすぐ切断します。</li>
<li><strong>中継も暗号文を転送するだけ。</strong>TURN が運ぶのは暗号化済みのパケットです。中継用の認証情報はデバイスごとに発行され、12 時間で失効します。</li>
- <li><strong>ローカルネットワークでも同じ。</strong>デバイスが LAN に流すのは毎日変わる匿名の識別子だけで、誰のコンピューターかはわかりません。ペアリングでは同じく指紋を照合し、その後のメッセージも署名付きです。</li>
+ <li><strong>ローカルネットワークでも同じ。</strong>デバイスが LAN に流すのは毎日変わる匿名の識別子だけで、誰のコンピューターかはわかりません。デバイス名を流すのは「近くを検索」を開いている間だけです。ペアリングでは同じく指紋を照合し、その後のメッセージも署名付きです。</li>
</ul>
<figure class="figure-card">
<img src="../assets/screenshots/ja/card-verify-dark.png" width="1120" height="800" loading="lazy" alt="ペアリング時の「セキュリティ指紋を確認」ダイアログ。R8NF-2WTC-QL5J が表示され、もう一台の表示と完全に一致するか確かめるよう求めている">
diff --git a/docs/ja/lan/index.html b/docs/ja/lan/index.html
index 865eb86..d4a2ed1 100644
--- a/docs/ja/lan/index.html
+++ b/docs/ja/lan/index.html
@@ -82,7 +82,7 @@
</svg>
</figure>
<ul class="points ports">
- <li><strong>自動で見つける。</strong>各コンピューターは mDNS で LAN に自分を知らせます。流すのは毎日変わる匿名の識別子だけで、誰のコンピューターかはわかりません。</li>
+ <li><strong>自動で見つける。</strong>各コンピューターは mDNS で LAN に自分を知らせます。流すのは毎日変わる匿名の識別子だけで、誰のコンピューターかはわかりません。デバイス名を加えるのは「近くを検索」を開いている間だけです。</li>
<li><strong>直接接続。</strong>コピーした内容は 2 台のあいだを直接流れ、速さは LAN の速さそのままです。</li>
<li><strong>安全性はそのまま。</strong>ペアリングで 2 行の指紋を照合し、その後のメッセージはすべて署名付き。同じネットワークの他人があなたのデバイスになりすますことはできません。</li>
</ul>
@@ -121,6 +121,19 @@
<img src="../../assets/screenshots/ja/pairing-dark.png" width="2112" height="1472" loading="lazy" alt="デバイスを追加:ペアリングコード K7MP2X と、その下にこのコンピューターのアドレス 192.168.1.20">
</figure>
</div>
+ <div class="os-grid qs-grid">
+ <div class="qs-app">
+ <h3>コードなしで:近くを検索</h3>
+ <ol class="steps">
+ <li>両方のコンピューターで「デバイス」を開き、「近くを検索」をクリックします。このウィンドウを開いている間だけ、同じネットワークのデバイスからこのコンピューターの名前が見えます。</li>
+ <li>相手がレーダーに表示されたらクリックします。両方の画面に同じ 2 行の指紋が表示されるので、照合してそれぞれで確定します。</li>
+ <li>同じサブネットの中でだけ使えます。相手が表示されないときは、上のペアリングコードを使ってください。</li>
+ </ol>
+ </div>
+ <figure class="shot">
+ <img src="../../assets/screenshots/ja/nearby-dark.png" width="2112" height="1472" loading="lazy" alt="近くのデバイス:中央にこのコンピューター、まわりに同じウィンドウを開いたデザイン部の PC と会議室の iMac、ペアリング済みの MacBook Air">
+ </figure>
+ </div>
</div>
</section>
@@ -163,7 +176,7 @@
</details>
<details>
<summary>同じネットワークの他の人に、自分のコンピューターが見えますか?</summary>
- <div class="answer"><p>CopySync のデバイスがあることはわかりますが、誰のものかはわかりません。流しているのは毎日変わる匿名の識別子だけで、デバイス名もデバイス ID も含みません。ペアリングしていないデバイスからのメッセージはすべて捨てられ、ペアリングには両方の画面で指紋の照合が必要です。</p></div>
+ <div class="answer"><p>CopySync のデバイスがあることはわかりますが、誰のものかはわかりません。流しているのは毎日変わる匿名の識別子だけで、デバイス名もデバイス ID も含みません。デバイス名を流すのは「近くを検索」を開いている間だけで、閉じると取り下げます。ペアリングしていないデバイスからのメッセージはすべて捨てられ、ペアリングには両方の画面で指紋の照合が必要です。</p></div>
</details>
<details>
<summary>どのポートを使いますか?</summary>
diff --git a/docs/lan/index.html b/docs/lan/index.html
index bf860ea..8c5f26b 100644
--- a/docs/lan/index.html
+++ b/docs/lan/index.html
@@ -82,7 +82,7 @@
</svg>
</figure>
<ul class="points ports">
- <li><strong>自动发现。</strong>每台电脑用 mDNS 在局域网里广播自己,广播里只有一个每天都变的匿名标识,看不出是谁的电脑。</li>
+ <li><strong>自动发现。</strong>每台电脑用 mDNS 在局域网里广播自己,广播里只有一个每天都变的匿名标识,看不出是谁的电脑。打开「搜索附近设备」时才带上设备名,关掉就撤下。</li>
<li><strong>直连。</strong>复制的内容在两台电脑之间直接传输,速度就是局域网的速度。</li>
<li><strong>安全照旧。</strong>配对时核对两行安全指纹,之后的每条消息都带签名,同一网络里的其他人冒充不了你的设备。</li>
</ul>
@@ -121,6 +121,19 @@
<img src="../assets/screenshots/pairing-dark.png" width="2112" height="1472" loading="lazy" alt="添加设备:显示配对码 K7MP2X,下面是本机地址 192.168.1.20">
</figure>
</div>
+ <div class="os-grid qs-grid">
+ <div class="qs-app">
+ <h3>不用配对码:搜索附近设备</h3>
+ <ol class="steps">
+ <li>两台电脑都打开「设备」,点「搜索附近设备」。窗口打开期间,同一网络里的设备才看得到这台电脑的名字。</li>
+ <li>对方出现在雷达上之后点它。两块屏幕会显示同样的两行安全指纹,核对一致后各自确认。</li>
+ <li>只在同一网段里有效。找不到对方时,改用上面的配对码。</li>
+ </ol>
+ </div>
+ <figure class="shot">
+ <img src="../assets/screenshots/nearby-dark.png" width="2112" height="1472" loading="lazy" alt="附近的设备:本机在中间,周围是同样打开了这个窗口的设计部的 PC、会议室的 iMac,以及已经配对过的 MacBook Air">
+ </figure>
+ </div>
</div>
</section>
@@ -163,7 +176,7 @@
</details>
<details>
<summary>同一网络里的其他人会看到我的电脑吗?</summary>
- <div class="answer"><p>能看到网络里有一台 CopySync,但看不出是谁的:广播里只有一个每天都变的匿名标识,没有设备名,也没有设备 ID。没有和你配对过的设备,发来的消息一律丢弃;配对还要两边核对安全指纹。</p></div>
+ <div class="answer"><p>能看到网络里有一台 CopySync,但看不出是谁的:广播里只有一个每天都变的匿名标识,没有设备名,也没有设备 ID。只有你打开「搜索附近设备」的那段时间,广播里才带上设备名,关掉窗口就撤下。没有和你配对过的设备,发来的消息一律丢弃;配对还要两边核对安全指纹。</p></div>
</details>
<details>
<summary>用了哪些端口?</summary>
diff --git a/tools/site/build.py b/tools/site/build.py
index 38ed9f0..a5bfcfa 100644
--- a/tools/site/build.py
+++ b/tools/site/build.py
@@ -1447,6 +1447,17 @@ def lan_page(code: str) -> str:
<img src="{shots}pairing-dark.png" width="2112" height="1472" loading="lazy" alt="{esc(ln["pair_alt"])}">
</figure>
</div>
+ <div class="os-grid qs-grid">
+ <div class="qs-app">
+ <h3>{ln["nearby_h3"]}</h3>
+ <ol class="steps">
+{items(ln["nearby_steps"], " ")}
+ </ol>
+ </div>
+ <figure class="shot">
+ <img src="{shots}nearby-dark.png" width="2112" height="1472" loading="lazy" alt="{esc(ln["nearby_alt"])}">
+ </figure>
+ </div>
</div>
</section>
diff --git a/tools/site/content/en.py b/tools/site/content/en.py
index c305334..d5840cf 100644
--- a/tools/site/content/en.py
+++ b/tools/site/content/en.py
@@ -204,7 +204,7 @@ C = {
("You compare fingerprints when pairing.", " Both screens show the same two lines: the fingerprint of each device's key. The server could swap keys in transit, but then the two screens would no longer match. That check is what stops a man in the middle."),
("Every message after that is signed,", " so the server can't impersonate your device. The direct channel's certificate is checked again after the handshake; a mismatch drops the connection."),
("The relay only forwards ciphertext.", " TURN carries encrypted packets, and relay credentials are issued per device and expire after 12 hours."),
- ("Same on the local network.", " What a device broadcasts on the LAN is an anonymous token that changes daily, not its name. Pairing still means comparing fingerprints, and every message is still signed."),
+ ("Same on the local network.", " What a device broadcasts on the LAN is an anonymous token that changes daily, not its name; the name is added only while Search nearby is open. Pairing still means comparing fingerprints, and every message is still signed."),
],
"verify_alt": "The fingerprint check during pairing shows R8NF-2WTC-QL5J and asks you to confirm it matches the other computer exactly",
@@ -721,7 +721,7 @@ C = {
},
"overview_points": [
"<strong>Found automatically.</strong> Each computer announces itself on the LAN over mDNS, with only an anonymous "
- "token that changes daily, so nobody can tell whose computer it is.",
+ "token that changes daily, so nobody can tell whose computer it is. Its name is added only while Search nearby is open.",
"<strong>Direct.</strong> Content goes straight between the two computers, at the speed of your network.",
"<strong>Same security.</strong> You compare two fingerprint lines when pairing, and every message after that is "
"signed, so others on the network can't pose as your device.",
@@ -748,6 +748,13 @@ C = {
"Both screens show the same two fingerprint lines. Check them character by character, then confirm. Copying syncs from now on.",
],
"pair_alt": "Add device: the pairing code K7MP2X, with this computer's address 192.168.1.20 below it",
+ "nearby_h3": "Without a code: Search nearby",
+ "nearby_steps": [
+ "On both computers, open Devices and click Search nearby. Only while this window is open can devices on the network see this computer's name.",
+ "When the other one shows up on the radar, click it. Both screens show the same two fingerprint lines; check them, then confirm on each.",
+ "This works within one subnet only. If the other computer doesn't show up, use a pairing code as above.",
+ ],
+ "nearby_alt": "Nearby devices: this computer in the middle, with Design PC and Meeting room iMac around it, plus the already paired MacBook Air",
"subnet_h2": "Different subnets",
"subnet_intro": "Local discovery only reaches one subnet. When your computers are on different subnets that can still "
@@ -782,7 +789,8 @@ C = {
]),
("Can others on the network see my computer?", [
"They can see that a CopySync device is there, but not whose: the broadcast carries an anonymous token that changes "
- "daily, with no device name or ID. Messages from devices you haven't paired with are dropped, and pairing requires "
+ "daily, with no device name or ID. The name is added only while you have Search nearby open, and removed when you close it. "
+ "Messages from devices you haven't paired with are dropped, and pairing requires "
"comparing fingerprints on both screens.",
]),
("Which ports does it use?", [
diff --git a/tools/site/content/ja.py b/tools/site/content/ja.py
index 9b98a27..8cb9724 100644
--- a/tools/site/content/ja.py
+++ b/tools/site/content/ja.py
@@ -192,7 +192,7 @@ C = {
("ペアリングでは指紋をあなたが照合する。", "両方の画面に同じ 2 行、つまりお互いの公開鍵の指紋が表示されます。サーバーは転送中の公開鍵をすり替えられますが、すり替えれば 2 つの画面が一致しなくなります。この照合が中間者攻撃を防ぐ関門です。"),
("その後のメッセージはすべて署名付き。", "サーバーがあなたのデバイスになりすますことはできません。直接接続の証明書もハンドシェイク後にもう一度照合し、食い違えばすぐ切断します。"),
("中継も暗号文を転送するだけ。", "TURN が運ぶのは暗号化済みのパケットです。中継用の認証情報はデバイスごとに発行され、12 時間で失効します。"),
- ("ローカルネットワークでも同じ。", "デバイスが LAN に流すのは毎日変わる匿名の識別子だけで、誰のコンピューターかはわかりません。ペアリングでは同じく指紋を照合し、その後のメッセージも署名付きです。"),
+ ("ローカルネットワークでも同じ。", "デバイスが LAN に流すのは毎日変わる匿名の識別子だけで、誰のコンピューターかはわかりません。デバイス名を流すのは「近くを検索」を開いている間だけです。ペアリングでは同じく指紋を照合し、その後のメッセージも署名付きです。"),
],
"verify_alt": "ペアリング時の「セキュリティ指紋を確認」ダイアログ。R8NF-2WTC-QL5J が表示され、もう一台の表示と完全に一致するか確かめるよう求めている",
@@ -669,7 +669,8 @@ C = {
"direct_note": "コピーした内容は 2 台のあいだだけを流れる",
},
"overview_points": [
- "<strong>自動で見つける。</strong>各コンピューターは mDNS で LAN に自分を知らせます。流すのは毎日変わる匿名の識別子だけで、誰のコンピューターかはわかりません。",
+ "<strong>自動で見つける。</strong>各コンピューターは mDNS で LAN に自分を知らせます。流すのは毎日変わる匿名の識別子だけで、誰のコンピューターかはわかりません。"
+ "デバイス名を加えるのは「近くを検索」を開いている間だけです。",
"<strong>直接接続。</strong>コピーした内容は 2 台のあいだを直接流れ、速さは LAN の速さそのままです。",
"<strong>安全性はそのまま。</strong>ペアリングで 2 行の指紋を照合し、その後のメッセージはすべて署名付き。同じネットワークの他人があなたのデバイスになりすますことはできません。",
],
@@ -691,6 +692,13 @@ C = {
"両方の画面に同じ 2 行の指紋が表示されます。1 文字ずつ照合して一致していれば確定します。これでコピーが同期されます。",
],
"pair_alt": "デバイスを追加:ペアリングコード K7MP2X と、その下にこのコンピューターのアドレス 192.168.1.20",
+ "nearby_h3": "コードなしで:近くを検索",
+ "nearby_steps": [
+ "両方のコンピューターで「デバイス」を開き、「近くを検索」をクリックします。このウィンドウを開いている間だけ、同じネットワークのデバイスからこのコンピューターの名前が見えます。",
+ "相手がレーダーに表示されたらクリックします。両方の画面に同じ 2 行の指紋が表示されるので、照合してそれぞれで確定します。",
+ "同じサブネットの中でだけ使えます。相手が表示されないときは、上のペアリングコードを使ってください。",
+ ],
+ "nearby_alt": "近くのデバイス:中央にこのコンピューター、まわりに同じウィンドウを開いたデザイン部の PC と会議室の iMac、ペアリング済みの MacBook Air",
"subnet_h2": "別のサブネットにある場合",
"subnet_intro": "LAN 内の検出が届くのはひとつのサブネットの中だけです。2 台が別のサブネットにあっても互いに通信できるなら(会社でよくあります)、"
@@ -723,6 +731,7 @@ C = {
]),
("同じネットワークの他の人に、自分のコンピューターが見えますか?", [
"CopySync のデバイスがあることはわかりますが、誰のものかはわかりません。流しているのは毎日変わる匿名の識別子だけで、デバイス名もデバイス ID も含みません。"
+ "デバイス名を流すのは「近くを検索」を開いている間だけで、閉じると取り下げます。"
"ペアリングしていないデバイスからのメッセージはすべて捨てられ、ペアリングには両方の画面で指紋の照合が必要です。",
]),
("どのポートを使いますか?", [
diff --git a/tools/site/content/zh.py b/tools/site/content/zh.py
index e863a03..9c22746 100644
--- a/tools/site/content/zh.py
+++ b/tools/site/content/zh.py
@@ -187,7 +187,7 @@ C = {
("配对时由你核对安全指纹。", "两块屏幕会显示同样的两行:双方各自公钥的指纹。服务器有能力替换转发中的公钥,但替换之后两块屏幕就对不上了,这一步就是防中间人的闸门。"),
("之后的每条消息都带签名,", "服务器无法冒充你的设备。直连通道的证书在握手后还会再核对一次,不一致立即断开。"),
("中转也只是转发密文。", "TURN 转发的是加密后的数据包,中转凭证按设备单独签发,12 小时后过期。"),
- ("局域网里也一样。", "设备在局域网里广播的只是一个每天都变的匿名标识,看不出是谁的电脑;配对同样要核对指纹,之后的消息同样带签名。"),
+ ("局域网里也一样。", "设备在局域网里广播的只是一个每天都变的匿名标识,看不出是谁的电脑,只有打开「搜索附近设备」时才带上设备名;配对同样要核对指纹,之后的消息同样带签名。"),
],
"verify_alt": "配对时的「核对安全指纹」对话框,显示 R8NF-2WTC-QL5J,要求与另一台电脑上显示的完全一致",
@@ -659,7 +659,8 @@ C = {
"direct_note": "复制的内容只在两台电脑之间传输",
},
"overview_points": [
- "<strong>自动发现。</strong>每台电脑用 mDNS 在局域网里广播自己,广播里只有一个每天都变的匿名标识,看不出是谁的电脑。",
+ "<strong>自动发现。</strong>每台电脑用 mDNS 在局域网里广播自己,广播里只有一个每天都变的匿名标识,看不出是谁的电脑。"
+ "打开「搜索附近设备」时才带上设备名,关掉就撤下。",
"<strong>直连。</strong>复制的内容在两台电脑之间直接传输,速度就是局域网的速度。",
"<strong>安全照旧。</strong>配对时核对两行安全指纹,之后的每条消息都带签名,同一网络里的其他人冒充不了你的设备。",
],
@@ -681,6 +682,13 @@ C = {
"两块屏幕会显示同样的两行安全指纹。逐字核对一致后,再点确认。之后复制就会同步。",
],
"pair_alt": "添加设备:显示配对码 K7MP2X,下面是本机地址 192.168.1.20",
+ "nearby_h3": "不用配对码:搜索附近设备",
+ "nearby_steps": [
+ "两台电脑都打开「设备」,点「搜索附近设备」。窗口打开期间,同一网络里的设备才看得到这台电脑的名字。",
+ "对方出现在雷达上之后点它。两块屏幕会显示同样的两行安全指纹,核对一致后各自确认。",
+ "只在同一网段里有效。找不到对方时,改用上面的配对码。",
+ ],
+ "nearby_alt": "附近的设备:本机在中间,周围是同样打开了这个窗口的设计部的 PC、会议室的 iMac,以及已经配对过的 MacBook Air",
"subnet_h2": "不在同一网段",
"subnet_intro": "局域网发现只在一个网段里有效。两台电脑在不同网段、但网段之间互通时(公司里常见),配对时多输入一个地址就行。",
@@ -712,6 +720,7 @@ C = {
]),
("同一网络里的其他人会看到我的电脑吗?", [
"能看到网络里有一台 CopySync,但看不出是谁的:广播里只有一个每天都变的匿名标识,没有设备名,也没有设备 ID。"
+ "只有你打开「搜索附近设备」的那段时间,广播里才带上设备名,关掉窗口就撤下。"
"没有和你配对过的设备,发来的消息一律丢弃;配对还要两边核对安全指纹。",
]),
("用了哪些端口?", [