LocalSend 上手：局域网跨设备传文件，不经过云端

LocalSend 是一个在局域网内传文件的工具。两台设备连同一个网络，打开它就互相可见，选中文件点发送即可。数据走 HTTPS 直连，不经过第三方服务器。本文按 1.18.2 讲清安装渠道、收发流程和排查顺序。

它解决什么问题

用聊天软件传文件，常见问题是压缩画质、有大小上限、还得两边都装同一个 App。用数据线要驱动，接口还不一定对得上。用云盘要先上传再下载，速度受宽带限制，大文件还要等。

这些方案都绕不开一个前提：文件得先经过别人的服务器。在同一个屋檐下传一张照片，数据却要出省再回来，这是很多人介意的点。

LocalSend 走的是另一条路。它只用本地网络，不需要账号，也不需要外网。手机传电脑、电脑传平板、安卓传 iPhone，装同一个应用就能互通。

协议本身不复杂。官方说明是 REST API 加 HTTPS 加密，TLS 证书在每台设备上即时生成。设备发现靠组播，传输走 53317 端口。协议文档单独开源，想自己写客户端也有依据，官网还列了各平台的包管理器入口。

典型的用法有三种。家里把手机拍的视频倒进电脑，办公室给同事传一份设计稿，出门前把电脑里的离线剧集塞进平板。这三种场景的共同点是设备就在旁边，网络也是同一个。

它和同步工具不是一类。Syncthing 那类工具维护的是持续同步的目录，改一个文件两边都变。LocalSend 只管一次性把文件递过去，发完就结束。站内Syncthing 2.1 上手那篇讲过端口放行和服务化，思路可以对照着看。

装哪个版本：各平台渠道与门槛

官方支持六个平台。GitHub 仓库当前显示 97,355 Star、5,527 Fork，许可证 Apache-2.0，用 Dart 与 Flutter 写成。

安卓用户有两个来源可选。Google Play 版更新省心，F-Droid 版更干净，二者包名相同，别同时装。想直接拿 APK，就去发布页下载。iPhone 与 iPad 在 App Store 搜名字即可。

官方提醒应用没有自动更新。所以装的方式决定了以后怎么升级。走应用商店或包管理器，升级是一条命令；手动装 APK 就要自己盯版本。站内Obtainium 使用指南讲的就是这类场景，可以拿它跟踪发布页。

旧系统要注意版本分界。安卓 5 与 6 停在 1.17.0，iOS 12 也是。Windows 7 停在 1.15.4。Linux 上还需要 xdg-desktop-portal，GNOME 与 KDE 各装对应的后端包。

收发一次文件：三步与端口

第一步确认网络。两台设备要连同一个 Wi-Fi，且不能是开了隔离的访客网络。手机开热点给电脑连，也算同一个网络。

第二步打开应用。首页会列出同一网段里在线的设备，图标旁有设备名和系统标识。找不到就下拉刷新一次。

第三步选文件发送。发送端挑文件或文件夹，点发送；接收端会弹出请求，确认后开始传。传输页显示速度和剩余时间，可以随时取消。

接收端能改保存位置。安卓第一次会走系统文件选择器授权目录，之后沿用这个目录。iOS 存进应用沙盒，再从「文件」App 里挪走。

传文件夹会保留结构。发送端选整个目录，接收端拿到的还是同样的层级，空目录不会跟着过去。要传整份照片库，这个特性比逐个勾选省事。

端口只有两个要记。53317 的 TCP 与 UDP 都要放行。Windows 首次启动会弹防火墙提示，选允许即可。Linux 用 ufw 的话，执行 sudo ufw allow 53317。

还有两个省事的用法。一是手动发送，直接填对方 IP，成功后加进收藏，下次不用等发现。二是发文本，短内容直接传给对方剪贴板，超过 64 KB 会转成 txt 文件。

速度受两件事影响。一是频段，5 GHz 明显快于 2.4 GHz。二是加密，官方排查表里提到关闭加密能提速，代价是局域网内明文传输，公共网络别这么干。

搜不到设备时的排查顺序

按下面顺序查，命中率从高到低：

1. 关掉路由器的 AP 隔离。访客网络通常默认开启，开了设备之间就互相看不见。
2. 把 Windows 的网络配置改成「专用」。公用网络模式下系统会更严格地拦入站连接。
3. 检查 macOS 与 iOS 的「本地网络」权限，在隐私设置里关掉再打开一次。
4. 临时断开 VPN。部分 VPN 默认屏蔽局域网流量，或把流量导进隧道。
5. 手动填对方 IP 试试。能连上说明只是发现环节的问题，收藏后即可绕过。

查网段能省下不少时间。手机在 Wi-Fi 详情里能看到 IP，电脑用 ipconfig 或 ifconfig 查。前三段数字不一致，说明两台设备根本不在同一个网络，前面五步都不用试。

这五步之外还有一层。如果设备在不同网段，或者中间隔着路由器做 NAT，组播包过不去，发现就会失败。这种情况手动 IP 也未必通，需要把两台设备放到同一个二层网络里。

权限、隐私与已知问题

它不要账号，也不上传通讯录，这一点和多数网盘类工具不同。必要的权限有两类：本地网络，用于发现与连接；存储或相册，用于读写你要传的文件。授权范围由系统的文件选择器控制，应用拿不到整个磁盘。

接收默认要确认。每次有设备发来文件，接收端都要点同意。这个设计避免了同一网段里被人硬塞文件，但也意味着无人值守时传不进去，批量传要有人在旁边点。

已知问题里有一条值得提前知道。安卓端接收大文件时速度可能偏慢，官方排查表把它归到 SAF 流式读写的已知问题。传几百 MB 的视频时，耐心一点，或者换到电脑端接收。

1.18.2 修了几件事。它恢复了与 1.17.0 及更早版本的兼容，也修了系统代理导致「TLS info not found」的问题。安全上有一处改动：不再跟随对端发来的 HTTP 重定向。

不适合的场景也要说清楚。跨公网传文件它不做，需要自己搭穿透。要做双向目录同步，用它也不合适。站内Deskflow 键鼠共享那类工具解决的是另一件事，别混着比。

能不能跨网段或远程传

不能直接传。它依赖同一网段内的组播发现和直连。远程场景要先组一个虚拟局域网，让两台设备在逻辑上同网段，再按普通流程发。

为什么比 AirDrop 慢

多数时候是频段和加密设置的问题，先换 5 GHz 再比较。AirDrop 走的是苹果私有协议与硬件配合，跨平台工具很难在同等条件下对齐，接受这个差距更实际。

有没有命令行版本

有。macOS 与 Linux 可以用 Homebrew 装 localsend-cli，支持按别名或 IP 指定目标，也能发文本。适合写进脚本做定时备份的分发端。