LocalSend CLI 找不到设备?Windows 发现排查
LocalSend CLI Windows 设备发现排查指南,介绍 v1.18.2 命令行启动、查看发现列表和检查多播错误,适合同一局域网内未看到对端的用户;文中区分同机双进程观察与两台设备互传,并按官方 README 提示检查网络隔离和 Windows 网络配置,不建议停用整机防火墙,改动前应核实网络类型。
Ressources et versions compatibles
LocalSend CLI Windows 设备发现排查指南,介绍 v1.18.2 命令行启动、查看发现列表和检查多播错误,适合同一局域网内未看到对端的用户;文中区分同机双进程观察与两台设备互传,并按官方 README 提示检查网络隔离和 Windows 网络配置,不建议停用整机防火墙,改动前应核实网络类型。
目标
排查 Windows 上 LocalSend CLI v1.18.2 的设备发现问题。本教程只覆盖命令行启动和发现检查,不指导 GUI 文件传输;本次验证没有发现对端,也没有传输文件。
关联软件:LocalSend 软件详情。
适用环境与版本
Windows x86_64,LocalSend CLI v1.18.2。官方 Release 提供对应 Windows CLI 资产;现存实测记录未保存 Windows 版本/构建号,因此不声明具体 Windows 兼容范围。验证在同一主机运行两个 CLI 进程,不能代表两台实体设备或 GUI 行为。
准备工作
- 从 LocalSend v1.18.2 官方 Release 下载 Windows x86_64 CLI,并放入已知目录。
- 打开 PowerShell,在可执行文件所在目录运行
--version核对命令,预期为localsend-cli 1.18.2;例如& '.\LocalSend-CLI-1.18.2-windows-x86-64.exe' --version。按实际文件名和路径调整。准备两个不同的接收目录;只使用无敏感信息的测试文件。 - 测试网络应允许设备互通。不要在公共网络关闭防火墙或路由器隔离。
操作步骤:启动并查看发现列表
配图待补:需有与该主题对应的 LocalSend CLI 1.18.2 Windows 真实授权图片;条目现有 GUI 截图不能作为 CLI 操作证据。
以下命令假设可执行文件位于 C:\Tools\LocalSend\LocalSend-CLI-1.18.2-windows-x86-64.exe;请按实际下载位置修改第一行。测试同一台主机时使用两个不同端口及接收目录:
$exe = 'C:\Tools\LocalSend\LocalSend-CLI-1.18.2-windows-x86-64.exe'
New-Item -ItemType Directory -Force C:\Temp\ls-a, C:\Temp\ls-b | Out-Null
& $exe --alias Peer-A --port 53318 --destination C:\Temp\ls-a
在第二个 PowerShell 窗口运行:
$exe = 'C:\Tools\LocalSend\LocalSend-CLI-1.18.2-windows-x86-64.exe'
& $exe --alias Peer-B --port 53319 --destination C:\Temp\ls-b
等待 CLI 就绪后,在第一个窗口按 D 查看 Paired / Discovered 列表。若对端出现,说明本次网络的发现步骤成功;这仍不等于已完成文件传输。按 Ctrl+C 退出进程。两台真实设备测试时,各自启动 CLI 并查看发现列表;不要在第二台设备上照搬本机目录。
LocalSend CLI 找不到设备时
配图待补:需有与该主题对应的 LocalSend CLI 1.18.2 Windows 真实授权图片;条目现有 GUI 截图不能作为 CLI 操作证据。
- 确认两端 CLI 进程都仍在运行,且加入同一可互通局域网;查看输出中的 multicast、网络接口或端口错误。
- LocalSend v1.18.2 CLI 帮助说明默认 HTTP 端口为 53317,支持通过
--port改端口;发现过程使用的多播端口仍可能涉及 53317。确认网络与防火墙策略允许应用通信。只在可信网络添加经管理员批准的必要规则,不要关闭整个防火墙。 - 按固定版本 v1.18.2 README Troubleshooting 检查路由器 AP isolation;接收端为 Windows 时,README 建议检查网络是否设为 Private。代理相关变化另见该版本 Release 说明,不能归因给 README。是否适用由网络管理员/设备策略决定。
- 若当前环境没有可用多播接口,换到允许设备互通的网络后再测。改动 VPN、防火墙或路由器设置前记下原值,排查后恢复。
官方 v1.18.2 README 对“Device not visible”的建议是检查路由器是否启用 AP isolation;当接收端为 Windows 时,检查网络是否配置为 Private,因为 Public 网络配置可能更严格。按组织设备策略核实网络类型;不要为排查关闭整机防火墙或修改公共网络。
LocalSend CLI 发现结果、恢复与限制
配图待补:需有与该主题对应的 LocalSend CLI 1.18.2 Windows 真实授权图片;条目现有 GUI 截图不能作为 CLI 操作证据。
发现成功时,CLI 的 Discovered 列表应出现对端。发现列表为空时记录版本、网络环境和错误信息,不要把“进程已启动”当作发现成功。退出进程即可结束本次监听;若为排障修改了网络设置,恢复原设置。
LocalSend v1.18.2 Windows 版本说明
官方 v1.18.2 Release 于 2026-08-21T14:02:01Z 发布,提供 Windows x86-64 CLI 资产,并说明 Windows binaries 已加入签名。该版修复 1.17.0 及更早版本在缺少多播网络时的兼容性问题,并修复系统代理导致 TLS 信息缺失的问题;这些变化不保证每种网络环境都能发现设备。
配图待补:需有与该主题对应的 LocalSend CLI 1.18.2 Windows 真实授权图片;条目现有 GUI 截图不能作为 CLI 操作证据。
实际验证记录
配图待补:需有与该主题对应的 LocalSend CLI 1.18.2 Windows 真实授权图片;条目现有 GUI 截图不能作为 CLI 操作证据。
2026-10-13 UTC:Windows x86_64 LocalSend CLI v1.18.2 的 --help 和 --version 均退出码 0。同机启动 Peer-A / Peer-B,分别监听 53318 / 53319,均进入等待状态;两边均报告 Multicast unavailable: No network interface available for multicast on port 53317。在 Peer-A 按 D 后 Paired 和 Discovered 均为 none。未发现 peer,未尝试传输,接收目录为空。这是本次主机/网络的结果,不能推断多播可用 LAN 上的发现结果。
常见问题(FAQ)
同一台电脑启动两个 CLI 进程,能证明两台设备可互传吗? 不能;这只能观察该主机当时的进程与多播状态,不能代替两台实体设备互传测试。
Windows 上首先检查什么? 按固定版本 README 检查接收端网络类型和路由器 AP isolation;遵循组织管理策略,不要为排查关闭整机防火墙。
CLI 没显示设备是否说明软件安装失败? 不能据此判断。记录 CLI 错误、多播接口、端口与网络情况,再按可信网络条件排查。
发现设备后是否已验证文件传输? 没有。现有记录没有发现对端,也没有尝试传输。
来源(CLI 记录日期:2026-10-13 UTC;官方资料复核:2026-10-15 Asia/Shanghai)
- v1.18.2 官方 Release / Windows CLI 资产与版本变更:https://api.github.com/repos/localsend/localsend/releases/tags/v1.18.2
- v1.18.2 固定版本 README / Troubleshooting:https://raw.githubusercontent.com/localsend/localsend/v1.18.2/README.md
- 固定版本 README(Setup / Troubleshooting):https://github.com/localsend/localsend/blob/v1.18.2/README.md
- CLI 参数来自该 Release 中 Windows x86_64 CLI 的
--help输出;本次命令及观察记录保存在关联任务审计记录中。
本文是 LocalSend CLI v1.18.2 Windows 设备发现排查教程;两设备实际传输、GUI、手动 IP 入口、接收确认及默认保存路径未验证。
Sources et vérification
Première publication : 15 oct. 2026· Révision éditoriale : 15 oct. 2026