LocalSend：跨平台离线文件传输的技术指南——从防火墙配置、桌面高级用法到发现协议与源码构建

LocalSend跨平台离线文件传输的技术指南——从防火墙配置、桌面高级用法到发现协议与源码构建【免费下载链接】localsendAn open-source cross-platform alternative to AirDrop项目地址: https://gitcode.com/GitHub_Trending/lo/localsendLocalSend 是一款不依赖互联网、仅通过局域网在邻近设备之间安全共享文件与消息的免费开源应用。本篇以项目官方土耳其语 READMEsupport/readme/README_TR.md为主体完整覆盖其安装渠道与平台兼容性、防火墙规则、便携模式与--hidden隐藏启动等桌面高级用法、协议工作原理以及从源码构建的完整步骤并结合仓库源码补充了默认端口、自签名证书、设备发现等底层实现证据帮助读者既能按文档上手使用也能理解其技术构成并参与贡献。一、关于 LocalSendLocalSend 是一款多平台应用设备间通过 REST API 通信并全程使用 HTTPS 加密。与其他依赖外部中转服务器的即时通讯/共享应用不同LocalSend 不需要互联网连接也不接触任何第三方服务器——数据只在你自己的局域网内流动。这使它成为一个快速且可信的本地通信方案典型场景包括手机与电脑之间互传照片、文档无需云盘或数据线在无外网环境如机房、内网、飞行模式下传输文件替代系统自带的 AirDrop 等封闭传输方案实现 Android、iOS、Windows、macOS、Linux 全平台互通。关于协议的更完整定义可参考 LocalSend Protocol 官方文档项目以独立的 protocol 仓库维护协议规范。二、平台支持与分发渠道由于应用本身没有内置自动更新能力官方建议从应用商店或包管理器安装以便获得持续更新。各平台可用的官方分发渠道如下以 support/readme/README_TR.md 与 CONTRIBUTING.md 中 Distribution 一节为准WindowsmacOSLinuxAndroidiOSFire OSWingetApp StoreFlathubPlay StoreApp StoreAmazon AppstoreScoopHomebrewNixpkgsF-DroidChocolateyDMG 安装包SnapAPKreleasesEXE 安装包AUR便携 ZIPTARreleasesDEB / AppImagereleases兼容性最低系统版本平台最低版本备注Android5.0-iOS12.0-macOS11 Big Sur旧机型可通过 OpenCore Legacy Patcher 2.0.2 支持参见项目 issue #1005Windows10支持 Windows 7 的最后版本为 v1.15.4之后版本可能出现针对 Win7 的 backportLinuxN.A.-三、安装后的网络配置防火墙与 AP 隔离大多数情况下 LocalSend 开箱即用但如果收/发文件失败通常是本地网络拦截了流量。需要放行以下规则流量方向协议端口操作入站IncomingTCP, UDP53317允许出站OutgoingTCP, UDP任意允许从源码结构看53317 是项目的硬编码默认端口Rust 核心与 CLI 的 默认端口常量const DEFAULT_PORT: u16 53317均指向它CLI 的 main.rs 也注明 HTTP 服务端口“默认取 config.toml否则为 53317”。因此防火墙规则只需针对 53317 即可覆盖收发两端。另一个常见坑是路由器开启了AP 隔离AP-Isolation / 客户端隔离该特性会阻断同一网段内客户端之间的通信。它默认通常关闭但部分路由器尤其是访客网络会默认开启发现设备互相“看不见”时建议首先检查。四、桌面端高级用法便携模式与隐藏启动4.1 便携模式v1.13.0 引入在可执行文件所在目录创建一个名为settings.json的文件内容可以为空应用便会把设置保存到这个文件而不是系统默认位置。这使得整个目录可以整体拷贝到 U 盘随身携带。这一行为的实现位于 shared_preferences_portable.dartSharedPreferencesPortable是一个自定义的SharedPreferences存储实现其配置路径由 buildSettingsPath 计算——优先取Platform.resolvedExecutable所在目录无法解析时回退到当前工作目录最终固定命名为settings.json。值得注意的是 _resolveExecutable 对虚拟磁盘如 ImDisk RAM 盘读取可执行路径会抛TypeError的情况做了容错处理说明该模式在真实 Windows 环境中有过踩坑与加固。4.2 隐藏启动v1.15.0 更新希望应用仅驻留系统托盘而不弹出主窗口时使用--hidden参数启动localsend_app.exe --hidden在 v1.14.0 及更早版本中隐藏启动的判定条件是“设置了autostart且开启了隐藏设置”v1.15.0 起改为直接监听--hidden命令行参数行为更直观。源码侧可以看到完整的三平台落地参数常量定义在 autostart_helper.dartconst startHiddenFlag --hiddenWindows 自启动项写入注册表Software\Microsoft\Windows\CurrentVersion\Run值中按需拼接--hidden见 autostart_helper.dartLinux 写入~/.config/autostart/app.desktop的Exec行autostart_helper.dart启动入口 my_application.cc 会遍历 Dart 入口参数确认--hidden并决定是否初始隐藏窗口macOS 通过 launch-at-login API 的“最小化启动”开关实现autostart_helper.dart。五、工作原理HTTPS、自签名证书与设备发现官方文档对“如何工作”的表述是LocalSend 使用一套安全通信协议让设备互联交互通过 REST API 完成所有数据经 HTTPS 传输每台设备会即时生成自己的 TLS/SSL 证书以保证最大安全性。仓库源码印证了这些表述的具体形态设备身份即证书指纹。核心库的 cert.rs 生成 RSA-2048 自签名证书CNLocalSend User不设 SAN并计算证书 DER 的 SHA-256 指纹作为设备标识——对端之间完全靠指纹互相识别所以证书里的主机名不携带任何信息。验证逻辑verify_cert_from_cert会检查签名、时间有效性与可选公钥匹配。发现阶段走多播 子网扫描。discovery/mod.rs 定义了发现参数注册请求默认 500ms 超时局域网对等体要么秒回要么不回应保持短超时可避免无响应主机拖慢扫描子网扫描并发度 50与 Flutter 端的历史 HTTP 发现行为保持一致。发现确认成功后设备会以Discovered/Updated事件DiscoveryEvent对外广播状态变化。注册即双向证书校验。HTTPS 模式下客户端证书是强制的每台设备把自己的 TLS 身份证书 私钥见 DeviceIdentity随注册请求发送对端据此完成身份确认。这些机制共同解释了前文的网络配置要求53317 端口承载 HTTPS 数据传输而发现阶段则依赖多播/广播流量两者都可能被防火墙或 AP 隔离阻断。六、从源码构建Başlarken官方给出的构建步骤如下适用于想跑最新代码或贡献补丁的开发者安装 Flutter。注意 LocalSend 目前要求特定较旧/固定的 Flutter 版本所需版本见 .fvmrc建议直接通过 fvm 管理版本安装 Rust当前仓库 rust-toolchain.toml 锁定工具链为1.97.1并附带 clippy 组件克隆 LocalSend 仓库cd app进入应用目录运行flutter pub get下载依赖运行flutter run启动应用。官方提示重要LocalSend 目前要求较旧的 Flutter 版本如果系统全局安装的 Flutter 与项目所需版本不一致可能导致构建问题。为使开发环境一致项目使用 fvm 管理 Flutter 版本——当前 .fvmrc 中固定为flutter: 3.41.9。安装 fvm 后请一律用fvm flutter替代flutter命令执行后续步骤。技术栈上应用 UI 层是 Flutterapp/网络/协议核心是 Rust 工作区packages/core 与 packages/localsend_isolates通过 flutter_rust_bridge 在 isolate 中调用原生能力另有独立的 Rust CLI 与 server 组件。七、参与贡献翻译与问题反馈7.1 翻译LocalSend 支持数十种语言。推荐的参与方式是通过 Weblate 平台管理翻译也可以 fork 仓库后手动提交翻译文件。翻译资源位于 app/assets/i18n 目录各语言的主翻译文件如 tr.json当前仓库中以locale.json命名缺失词条清单_missing_translations_locale.json例如 _missing_translations_tr.json其头部info说明补全后可运行dart run slang apply --localetr快速应用新增翻译对应的生成产物在 app/lib/genstrings_locale.g.dart由 slang 生成。注意以开头的字段不是待翻译内容它们是仅供文件说明或给译者提供上下文的信息性文本应用运行时不会使用。7.2 缺陷修复与改进缺陷修复发现问题后请提交附带清晰问题描述与修复方式的 PR改进建议请先开 issue 讨论该改进的必要性再动手实现。完整的贡献流程、分发渠道打包方式见 CONTRIBUTING.md。八、故障排除速查表官方文档给出的排障矩阵如下建议按“发送端/接收端平台”定位对应行问题平台发送方平台接收方解决方案设备不可见任意平台任意平台确认路由器上已关闭 AP 隔离开启时设备间通信会被阻断设备不可见任意平台Windows把网络类型设置为“专用”Private“公用”网络下 Windows 限制更多设备不可见macOS / iOS任意平台到系统设置“隐私”中的“本地网络”权限尝试关闭再打开该开关速度太慢任意平台任意平台改用 5GHz 频段两台设备都临时关闭加密以排除瓶颈速度太慢任意平台Android已知问题Flutter 侧 SAF 流读取限制所致属上游已知项实践建议排障时先用“设备不可见”三行确认发现链路防火墙 53317 入站放行 → AP 隔离关闭 → 接收端系统级网络权限确认能互见后再用“速度太慢”两行判断是无线频段/加密开销还是平台 I/O 瓶颈必要时可利用应用内 调试页 与 发现调试页 查看实时发现日志与 HTTP 日志来进一步定位。【免费下载链接】localsendAn open-source cross-platform alternative to AirDrop项目地址: https://gitcode.com/GitHub_Trending/lo/localsend创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考