LocalSend 指南：跨平台局域网文件与消息免流互传工具

是什么

LocalSend 是一款免费、开源的局域网文件与消息传输工具，能让临近设备在无需连接互联网的情况下直接互传数据。作为苹果 AirDrop 这类专有服务的一款跨平台替代方案，它完全脱离外部云端设施和第三方服务器运行。

在设备间通信方面，该应用采用成熟的 REST API 架构来传输网络请求与结构化数据。所有传输均通过 HTTPS 加密完成，且 TLS/SSL 安全证书由各设备在传输时动态实时生成。这种去中心化的设计，保证了数据仅在收发两端之间端到端加密流转，有效守护数据隐私。

据项目官网公布的数据，LocalSend 目前在 GitHub 上已获得超过 9.3 万颗星标（stars），累计下载量突破 3500 万次，并有逾 230 位开发者参与了代码贡献。此外，官网声明该软件完全零广告、无任何追踪脚本，代码在 Apache License 2.0 开源协议下分发。

能做什么

LocalSend 提供了多项实用的局域网传输与沟通功能：

• 广泛的文件格式支持：支持传输照片、视频、纯文本和常规文档。软件内部未设任何带宽限制，能充分利用本地 Wi-Fi 或有线局域网的传输能力。
• 消息与链接分享：除了普通文件外，还能直接向同一局域网内的其他设备发送纯文本消息和网页链接。
• 自定义存储路径：接收到的文件默认保存在操作系统的“下载”（Downloads）文件夹中，也可以在应用设置中指定其他保存目录。
• 传输安全确认：除基础的 HTTPS 加密外，软件还支持开启可选的 PIN 码验证功能，在接收端手动确认后才会开始传输。
• 便携模式：支持免安装便携化运行。如果在可执行文件同目录下放置一个名为 settings.json 的文件（无论内容是否为空），软件便会将配置信息直接保存在该文件中，而不会写入操作系统默认配置路径。
• 最小化静默启动：在桌面端，应用可以直接启动并最小化至系统托盘，无需弹出主窗口。用户可通过以下命令实现静默启动：

localsend_app.exe --hidden

• 命令行客户端：为满足自动化运维、无头环境（headless）或终端爱好者的需求，项目基于 LocalSend Protocol v2 推出了命令行工具 localsend-cli。通过命令行可以发送单个文件、多个文件甚至整个目录树：

localsend-cli send report.pdf photo.jpg ./project-backup

在发送文件夹时，接收端会保留原有的多层目录结构；不过由于传输机制是按具体文件进行追踪的，空文件夹会被自动跳过。用户可以在自动发现的设备列表中交互式选择目标，也可以直接通过设备别名或局域网 IP 地址指定接收端：

localsend-cli send --to "Cute Tomato" report.pdf

localsend-cli send --to 192.168.27.26 report.pdf

终端客户端还可以使用 --text 参数发送纯文本消息：

localsend-cli send --to "Cute Tomato" --text "https://localsend.org"

也可以通过管道传入标准输入（stdin），只需在末尾传入 - 即可：

echo "Hello" | localsend-cli send --to "Cute Tomato" --text -

通过管道输入文本时，末尾多余的一个换行符会被自动去除。标准输入的内容必须为 UTF-8 编码且大小不能超过 16 MB。当文本内容超过 64 KB 时，系统会自动将其转为 .txt 文件进行发送。若要查看完整的命令行参数与快捷键，可以运行：

localsend-cli --help

怎么开始

开始使用 LocalSend 前，只需在需要互传的各台设备上安装该软件。由于应用本身没有内置自动更新机制，项目 README 建议通过正规应用商店或包管理器进行安装，以便后续无缝获取版本更新。

该应用适配了多种主流操作系统：

• Windows 用户可通过 Winget、Scoop、Chocolatey、独立 EXE 安装包、便携式 ZIP 压缩包或 Windows Store 安装。
• macOS 用户可通过 Mac App Store、Homebrew 或独立 DMG 镜像文件进行安装。
• Linux 发行版用户可通过 Flathub、Snapcraft、Nixpkgs、AUR、DEB 安装包、TAR 归档文件或 AppImage 格式获取。
• 移动端方面，Android 支持 Google Play Store、F-Droid 及独立 APK 安装包；iOS 可在 Apple App Store 下载；Fire OS 则可通过 Amazon Appstore 获取。

当同一局域网内的至少两台设备均完成安装后，无需注册账号、无需输入任何凭据，也无需搭建服务器。打开应用后，选定需要传输的文档、多媒体或文本，在发现页面点击目标设备，即可发起传输。

网络配置与故障排查

LocalSend 通常开箱即用，但在部分网络环境下可能会因局域网限制导致无法发现设备。该软件在接收传入连接时使用 53317 端口（同时占用 TCP 与 UDP 协议），外发流量则可以使用任意端口。

在配置了 ufw 防火墙的 Linux 系统中，可运行以下命令开放所需端口：

sudo ufw allow 53317

在采用 firewalld 的 Linux 系统中，可执行：

sudo firewall-cmd --permanent --add-port=53317/tcp
sudo firewall-cmd --permanent --add-port=53317/udp
sudo firewall-cmd --reload

项目代码仓库中还记录了其他常见故障排查方法：

• 路由器 AP 隔离：接入点隔离（AP Isolation）会阻止无线设备间互相通信。请确保路由器已关闭 AP 隔离功能。
• 网络配置文件类型：Windows 设备应将当前网络连接设为“专用网络”（Private），因为“公共网络”模式会启用严格的本地防火墙限制。
• 隐私权限设置：在 iOS 和 macOS 上，需检查并开启系统隐私设置中的“本地网络”权限。
• VPN 设置：部分虚拟专用网络（VPN）会拦截局域网流量。可在 VPN 客户端中开启允许局域网流量访问，或暂时断开 VPN 连接。
• 手动输入 IP 地址：若自动搜索不到设备，可手动输入对方的 IP 地址，并将其添加到常用列表以便直接探测通信。
• 提升传输速率：据项目排错指南说明，若遇到传输缓慢的情况，可以尝试连接 5 GHz Wi-Fi 频段，或在两端设备上同时关闭传输加密功能。

源码编译

若开发者希望从源码编译构建该应用，需准备 Flutter（推荐通过 fvm 管理）与 Rust 环境。进入项目目录后执行：

cd app
flutter pub get
flutter run

价格与门槛

LocalSend 遵循 Apache License 2.0 开源协议，是一款完全免费的开源软件，内部无任何广告、第三方追踪器或隐性收费。有关项目定价与方案的详细说明，均以官方页面为准。

项目文档给出了以下平台兼容性要求：

• Android：需要 Android 7.0 及以上版本。据项目 README 说明，1.17.0 是最后一个支持 Android 5 和 Android 6 的版本。
• iOS：需要 iOS 13.0 及以上版本。1.17.0 是支持 iOS 12 的最终版本；若需直接从其他已安装应用中调用分享功能，则需要 iOS 14 或更高版本。
• macOS：需要 macOS 11 Big Sur 及以上版本。旧款硬件机型可参考项目文档，通过 OpenCore Legacy Patcher 2.0.2 进行适配。
• Windows：需要 Windows 10 及以上版本。1.15.4 是最后一个支持 Windows 7 的版本。
• Linux：支持绝大多数主流发行版。桌面环境需配合桌面门户组件运行：GNOME 桌面需要 xdg-desktop-portal 与 xdg-desktop-portal-gtk；KDE 桌面需要 xdg-desktop-portal 与 xdg-desktop-portal-kde。
• Fire OS：兼容 Amazon Appstore 提供的受支持版本。

适合谁

LocalSend 适合经常在 Windows、macOS、Linux、Android、iOS 以及 Fire OS 等不同系统之间跨平台传输文件、图片及文本内容的用户。对于重视隐私安全与本地数据保护的人群尤为实用，因为所有文件绝不会经过第三方云服务器或外部网络。该工具也非常适合在网络受限甚至完全离线的环境中使用，仅凭普通路由器或离线 Wi-Fi 即可顺畅完成传输。此外，开发者和系统管理员还可以利用其专属的命令行界面，将局域网文件及文本传输无缝接入各类终端工作流与脚本中。

替代品

KDE Connect 提供跨多个平台的设备互联与文件共享功能。

Syncthing 是一款支持多种操作系统的开源去中心化文件同步工具。

来源

• https://github.com/localsend/localsend
• https://localsend.org/
• https://kdeconnect.kde.org/
• https://github.com/syncthing/syncthing