LocalSend 入门指南：3 分钟搞定局域网免网文件传输-平芜编程栈

LocalSend 入门指南：3 分钟搞定局域网免网文件传输

【免费下载链接】localsendAn open-source cross-platform alternative to AirDrop项目地址: https://gitcode.com/GitHub_Trending/lo/localsend

把一张照片从手机丢到桌上电脑，传统路径是数据线、网盘或微信文件传输助手，最后还要联网。LocalSend 走的另一条路：同一 Wi-Fi 下两台设备直接点对点传输，全程 HTTPS 加密，不需要互联网和任何账号。

定位：它管什么，不管什么

LocalSend 是跨平台的开源文件传输应用，覆盖 Windows、macOS、Linux、Android、iOS（另有 Fire OS 渠道），底层用 Flutter 写界面、Rust 写协议实现。它只干一件事：同一局域网内把文件和短消息点对点送过去。

它不做什么：不做跨网传输（两端必须在同一 Wi-Fi 或有线网段内），不做云存储和同步，不做设备间文件管理。传输用的 TLS 证书每台设备临时生成（见packages/core/src/crypto/cert.rs），所以不存在"连不上服务器"这种问题。

场景	传统方式	用 LocalSend
手机传照片到电脑	数据线 / 网盘 / 微信	同一 Wi-Fi 下互点一下，全程 HTTPS
要不要联网	网盘和社交软件都要	不需要互联网
账号	网盘、微信各一个	不需要

3 分钟上手

桌面端建议走包管理器，因为应用没有自动更新：Windows 用 winget 或 Scoop，macOS 用 Homebrew 或 App Store，Linux 可用 Flatpak、Snap、Nix 等。移动端从 Play Store、F-Droid 或 App Store 安装。

装完两端都要开：手机和电脑连同一个 Wi-Fi，分别打开 LocalSend，主页顶部应显示本机 IP（如192.168.x.x）。手机点"发送"，发送页的设备列表里出现电脑名字即发现成功；选中电脑、确认接收，第一份文件就走完了整条链路。

想体验终端版，从源码构建 CLI：

git clone https://gitcode.com/GitHub_Trending/lo/localsend cd localsend cargo build --release --package localsend-cli target/release/localsend-cli

跑起来后按D列出已配对的设备、数字键1-9直接发给对应设备。界面里出现对端设备名，说明发现（discovery，即两端通过组播互相打招呼）正常。

按场景走一遍

场景一：手机和电脑互传

场景：iPhone 拍完照，想立刻在 Windows 电脑上修图，不想连数据线也不走网盘。

操作：两端进 LocalSend。手机点发送、选文件、点电脑设备名；电脑端弹出确认，按 Y（或点接受）。

预期效果：电脑端显示接收进度，文件默认存进下载目录。没有中间服务器，速度基本就是你这个 Wi-Fi 的水平。

场景二：浏览器直接收发（CLI 的 link 模式）

场景：同事路过，想在浏览器里临时拿个文件，不打算装应用。

操作：在 CLI 里按W+S切换"share via link"（见cli/src/main.rs的快捷键说明），终端打印一个 HTTP 链接；把链接发给对方，浏览器打开即可下载。要反向收文件则按W+R，对方在浏览器里上传。

预期效果：链接只在本局域网内有效，关掉或再次切换即失效。注意这一模式走的是明文 HTTP，仅用于临时场景，日常收发仍用默认的加密通道。

场景三：终端常驻接收

场景：一台常开的 Linux 主机当文件落脚点，不想每次开图形界面。

操作：直接跑localsend-cli，首次运行会在配置目录生成带注释的config.toml模板（模板见cli/src/storage/config.rs）；要发文件可用localsend-cli --file 路径启动，选完设备即开传。

预期效果：文件落到接收目录（默认系统下载目录），终端里能看到发现、发送、接收三类事件日志。

按需配置：CLI 的 3 个键

CLI 的全部可配项只有三个，优先级是命令行参数 > 环境变量 >config.toml> 默认值：

配置	改它会发生什么
`alias`	设备在别的设备列表里的显示名，默认取主机名
`destination`	接收文件的落盘目录，默认系统下载目录，支持`~/`前缀
`port`	服务端口，默认`53317`；两端不一致或防火墙没放行，对方发现不了你

官方发布包已附带各平台的 CLI 二进制（见 README 的 Download 表格），日常使用不必自己编译。

踩坑记录

现象：同一 Wi-Fi 下设备互相看不到。原因：路由器开了 AP 隔离（客户端之间被禁止互通，访客网络尤其常见）；或 Windows 把网络类型设成了"公用"；或防火墙没放行53317端口的 TCP 和 UDP；macOS/iOS 还可能是"本地网络"隐私权限没开。解法：对照 README 的 Troubleshooting 表逐项排除，防火墙按"入站 TCP/UDP 53317 允许、出站任意允许"放行，路由器里关掉 AP 隔离。

现象：传大文件速度上不去。原因：2.4GHz Wi-Fi 本身带宽有限，HTTPS 加密还占一部分 CPU。解法：README 官方建议是切到 5GHz，或在两端同时关掉加密（仅局域网内、且你信任该网络时）。

现象：Android 端接收特别慢。原因：底层文件流写入的已知问题，官方在 Troubleshooting 表里直接标了 known issue。解法：目前没有一键修法，只能换端或等上游修复。

现象：想从源码跑桌面应用，构建报 Flutter 相关错误。原因：LocalSend 锁定了较旧的 Flutter 版本，系统里的新版不兼容。解法：按 README 的 Getting Started 装 fvm（Flutter 版本管理工具），之后一律用fvm flutter代替flutter。