LocalSend

它到底怎么工作

LocalSend 不走云端，也不做账号。它靠两件事完成传输：UDP 广播宣告自己存在，HTTP 在局域网上直接传数据。所以同一网段内只要两台设备都开着，它就能互相发现。

这决定了它的能力边界：

设备列表里每台机器都有一个设备 ID，是一段形如 123-456 的短编号，由 MAC 地址推导而来。这不是账号、不上传服务器、换网也不会变，可以当作局域网内的固定标识来认机器。

三种配对模式怎么选

• 快速模式（默认）：两台设备都保持默认设置，看到对方后直接确认接收。最省事，适合临时传文件。
• 已保存设备：确认过一次后互相标记为「Trusted」，之后直接可见，不需要每次确认。家里固定的几台机器建议用这个。
• 热重发现不可用时手动输入 IP：路由器开了 AP 隔离或防火墙拦了 UDP 广播时，用这个。在接收方的「设置 - 快速模式」里把发现方式改成「手动」，然后在对方列表点「添加」直接填 IP:53317。

端口 53317 是 LocalSend 的默认 TCP/UDP 端口。Windows 首次启动会弹防火墙申请，务必允许「专用网络」，否则表现为「一直搜索不到设备」。

排查搜索不到设备

按这个顺序查，八成能定位：

1. 确认两台机器连的是同一个 Wi-Fi，不是手机热点和家宽 Wi-Fi 混用。
2. 确认网络类型是「专用网络」，公司或校园网常被 Windows 归为「公用网络」，防火墙会直接拦掉广播。
3. 关掉手机上的 VPN / 代理类 App，这类工具普遍会劫持 UDP。
4. 实在不行就切手动 IP，见上一节。

大文件与只读模式

传输大视频时建议在接收端打开只读模式（设置里的「只读」开关）：接收端会变成一个只提供下载、不接受上传的临时站点，避免误传覆盖本地文件。

命令行用法适合批量脚本，比如把一份安装包发到同网段的另一台机器：

bash# 发送单个文件（会弹出确认，等待对方接收）
localsend-cli --file ./release.zip --name server-01
# ----
# 指定目标 IP 直接发，跳过 UDP 发现
localsend-cli --file ./release.zip --dest 192.168.1.42

批量发送整个目录用 --directory 参数。CLI 与桌面端协议一致，可以互发。