局域网传文件总被发现不了?LocalSend 常见问题排查与实用配置
两台设备就在同一个 Wi-Fi 下,LocalSend 也装好了,可是设备列表里空空如也——这是用这类局域网互传工具时最常卡住的地方。它不是软件坏了,绝大多数情况是路由器的隔离策略或者系统网络配置在拦。
这篇文章不重复官网的安装说明,重点放在三件事上:设备互相发现不了的排查顺序、几个真正影响日常使用的配置项、以及它做不到哪些事。
文中以 LocalSend 1.18.2(2026-08-21 发布的当前稳定版)为准。
一、先确认它的工作原理
理解这一点能让后面的排查顺畅很多:LocalSend 不经过任何中继服务器,每台设备自己起一个 HTTPS 服务,TLS 证书在本机即时生成,设备之间直接建立连接。
由此推出三个直接结论:
- 文件不落第三方服务器,传输是点对点的。
- 通信端口是固定的 TCP/UDP 53317。按官方协议文档的默认配置,
Multicast (UDP)用于设备发现,HTTP (TCP)用于实际传输——这也决定了防火墙要放行哪些方向。 - 必须处在同一局域网内。跨网段、跨路由器通常发现不了对方。
补一句排查时很有用的细节:协议默认使用 224.0.0.0/24 这个组播组,具体地址是 224.0.0.167。范围之所以取得这么窄,是因为部分 Android 设备会拒绝其他组播组。如果你的网络对组播有额外限制,设备发现就会失败——这正是下面 IP 直连能绕过的问题。
因为是局域网内点对点,接收方必须在线并手动确认,没有发一个链接让对方稍后自取的异步方式。
二、设备发现不了:按这个顺序排查
这是最高频的问题。下面六步是常见的几个方向,建议按顺序排除,因为前面的步骤成本最低。
1. 路由器开了 AP 隔离
AP 隔离(AP Isolation / 客户端隔离)会禁止同一 Wi-Fi 下设备互相访问。它在访客网络里经常默认开启,主网络有时也会被误开。
判断方法:如果两台设备连的是访客 SSID,先换到主 SSID 试。或者登录路由器后台,找无线设置里的"AP 隔离""客户端隔离"选项关掉。
2. Windows 把网络识别成了"公用网络"
Windows 对"公用网络"的入站限制更严格。在设置 → 网络和 Internet → 以太网/Wi-Fi 里把网络配置文件改成**“专用网络”**,再重试。
这一步经常被忽略,因为很多人以为网络类型只影响文件共享。
3. macOS / iOS 的"本地网络"权限被关
在系统设置 → 隐私与安全性 → 本地网络里确认 LocalSend 是打开的。
升级系统或重装应用后,这个权限有时会被重置。表现就是软件能启动,但始终扫不到设备。
4. VPN 拦截了局域网流量
不少 VPN 默认只允许流量走隧道,会顺带拦截局域网通信。临时断开 VPN 测试一下,如果立刻能发现设备,就在 VPN 客户端里放行本地网络。
顺带一提,1.18.2 有一个针对代理的修复:忽略系统代理,解决了开启代理(如 Shadowrocket)时出现的 TLS info not found 报错。如果你之前因为这个报错放弃过,新版本值得再试。
5. 直接用 IP 直连
如果以上都排除了还是发现不了,就在发送界面手动输入接收方的 IP 地址。
这一步同时也是一个诊断手段:IP 直连能通,说明网络本身没问题,问题出在设备发现环节。
另外,协议本身也为组播失败准备了回退方案:当组播不可用时,它会退而向本地网段内的地址逐个发起 HTTP 请求来发现设备。所以组播被拦并不一定意味着只能手填 IP,先给程序一点时间跑完回退流程再判断。定位到问题后,可以把这个设备加为收藏,之后程序会直接探测该设备,不再依赖自动发现。
设备列表正常情况下长这样,每台设备显示随机名称、编号和系统类型:

6. 补一步防火墙
确认放行 TCP 和 UDP 的 53317 端口。Linux 上用 ufw 是:
sudo ufw allow 53317
firewalld 的话:
sudo firewall-cmd --permanent --add-port=53317/tcp
sudo firewall-cmd --permanent --add-port=53317/udp
sudo firewall-cmd --reload
三、几个影响日常使用的配置
便携模式:把配置放进程序目录
这是我觉得设计得比较实用的一点,从 1.13.0 开始支持。
在可执行文件同目录下新建一个名为 settings.json 的文件(内容可以为空),程序就会把配置写在这个文件里,而不是系统的用户目录。
效果是整个文件夹可以拷进 U 盘带走,插到别的电脑上打开,设置、收藏的设备都还在。对于经常在几台机器之间切换、又不想每台都重新配一遍的场景,这个模式省事很多。
静默启动
想开机后只驻留在托盘、不弹窗口:
localsend_app.exe --hidden
1.15.0 起支持这个参数。适合把发送端常驻在后台、需要时再打开的情况。
传文件夹会保留目录结构
把整个文件夹拖进去,接收端拿到的是完整的目录结构和顶层文件夹名,不是一堆散文件。省掉了在目标机器上重建目录的步骤。
有一个边界要注意:空目录不会被传输。协议传输的是文件条目而不是目录条目,所以空文件夹在接收端不会出现。
命令行版本
官方还提供 CLI 客户端,适合脚本化调用或者没有桌面环境的机器:
localsend-cli send report.pdf photo.jpg ./project-backup
不带参数时会列出发现的设备,交互选择一个回车开始传输。也可以跳过交互直接指定接收方:
# 按设备别名
localsend-cli send --to "Cute Tomato" report.pdf
# 按 IP 直连
localsend-cli send --to 192.168.27.26 report.pdf
传目录时会递归收集文件,保留顶层文件夹名和嵌套路径。用 IP 指定时直接走 HTTPS 探测 53317 端口,跳过设备发现环节——在组播被拦的环境里,这个方式更可靠。
四、结果验证
配置完成后,可以用两步快速确认是否生效:
- 两台设备都打开 LocalSend,确认设备列表里能互相看到对方(设备名是程序随机生成的,形如 “Cute Avocado”,后面跟着编号和系统类型)。
- 传一个小文件做端到端验证,观察接收端是否弹出确认、进度条是否推进。
传输过程中可以看到单个文件的进度和总进度:

电脑端接收时的界面,会列出正在接收的文件和总进度条:

如果设备能发现但传输出错,优先检查 53317 端口是否双向放行:UDP 用于设备发现,TCP 用于实际传输,只放行其中一个会出现"能看到设备但传不过去"或"完全看不到设备"的现象。
五、性能与已知限制
传输偏慢时,可以尝试:
- 换到 5GHz 频段,通常有明显改善。
- 在两端关闭加密。这会提升速度,代价是流量不再加密,只在可信网络里考虑。
Android 接收大量小文件偏慢是已知问题,源于系统存储访问框架(SAF)的写入限制,与网络速度无关,换设备或换网络都不会改善。
没有自动更新机制。官方建议通过应用商店或包管理器安装,以便跟随系统更新。直接使用安装包的话,需要自己关注新版本。这是目前使用上最不方便的一点。
跨网段一般用不了。设备通常需要在同一局域网内,跨路由器、跨网段一般发现不了对方。如果需要跨网络传输,得借助其他方案中转,这不是 LocalSend 的设计目标。
六、各平台安装包选择
| 平台 | 选择建议 | 系统要求 |
|---|---|---|
| Windows | 安装版选 .exe;便携版选 .zip,解压即用 | Windows 10 及以上 |
| macOS | .dmg(通用版,覆盖 Intel 与 Apple 芯片) | macOS 11 Big Sur 及以上 |
| Linux | AppImage / deb / tar.gz;ARM64 设备选带 arm-64 的包 | 需 xdg-desktop-portal |
| Android | 多数手机选 arm64v8,老设备选 arm32v7,模拟器选 x64 | Android 5.0 及以上 |
| iOS | App Store 安装 | iOS 12.0 及以上 |
两点容易踩的坑:
- Windows 7 无法运行 1.18.2,最后一个支持 Win7 的版本是 v1.15.4。
- Linux 需要额外的 portal 依赖:GNOME 需
xdg-desktop-portal和xdg-desktop-portal-gtk,KDE 需xdg-desktop-portal和xdg-desktop-portal-kde。缺了会导致文件选择对话框无法正常弹出。
七、项目来源
GitHub 项目页:https://github.com/localsend/localsend
官方网站:https://localsend.org
本次版本发布页:https://github.com/localsend/localsend/releases/tag/v1.18.2
协议文档(端口与组播细节可在此查阅):https://github.com/localsend/protocol
八、下载链接
百度网盘:https://pan.baidu.com/s/1vk9-8xp2667BOKriFFSXWg?pwd=3cv5
提取码:3cv5
夸克网盘:https://pan.quark.cn/s/8789d113a0ee
(夸克盘无提取码)
排查这类问题的通用思路是一样的:先确认通信路径没被策略拦掉,再去看应用层配置。LocalSend 的 53317 端口和"IP 直连"这两个点,基本能覆盖大部分连不上的情况。
374



被折叠的 条评论
为什么被折叠?



