LocalSend 安装渠道怎么选:README 为什么建议优先用包管理器而不是官网二进制
【免费下载链接】localsendAn open-source cross-platform alternative to AirDrop项目地址: https://gitcode.com/GitHub_Trending/lo/localsend
第一次安装 LocalSend 时,你会在 README.md 的 Download 一栏看到一堆选项:App Store、Winget、Scoop、Flathub、Homebrew、AUR……以及 EXE Installer、Portable ZIP、DMG、APK 这些直接指向发布页的二进制包。README 对此给出一条明确建议:
It is recommended to download the app either from an app store or from a package manager because the app does not have an auto-update.
也就是说:LocalSend 本体没有自动更新能力,所以官方推荐走应用商店或包管理器这类自带更新机制的渠道,而不是手动下载二进制后自行盯版本。本文按这条建议,说明各平台该怎么选渠道、选完之后如何确认应用能正常工作,以及选择二进制渠道时需要了解的签名和边界信息。
README 建议背后的依据
直接原因:应用没有自动更新
README 给出的理由就是上面那句:应用不具备 auto-update。包管理器和商店负责分发的同时承担版本跟进,而从发布页手动拿到的二进制装完后,README 没有描述任何帮它升级的机制。如果你装的是 Windows Portable ZIP 或 Linux AppImage,版本停留在你下载的那一天。
三类分发渠道的维护结构不同
CONTRIBUTING.md 的 Distribution 一节把渠道分成三类,维护方式差别明显:
- Git-based distribution:Winget、Scoop、Chocolatey、Homebrew、Flathub、AUR、Nixpkgs、F-Droid、Snap。每一项都有独立的仓库和明确的维护者,多数由社区维护者加 GitHub Actions / CI 共同维护,例如 Flathub 由维护者加 F-Droid CI 之外的 GitHub Actions 更新,Winget、Scoop、Homebrew、Flathub、F-Droid 均标注了 CI 参与。
- Manual distribution:App Store(iOS)、Play Store(Android)、Amazon(Fire OS),由项目维护者手动发布。
- Binary distribution:Windows ZIP、MSIX、EXE、APK、TAR、DEB、AppImage、DMG,即 README 下载表中链接到发布页的那些文件,由单一维护者手工产出。
二进制渠道有一个信任信号:Windows 签名
README 在 Download 一节说明 "Windows binaries are signed",细节见 CODE_SIGNING.md:
- 官方 Windows 发布产物(portable ZIP、EXE installer、MSIX helper)由 GitHub Actions 从源码构建,经 SignPath 签名,每个签名请求由人工审批;
- 只签 LocalSend 自己构建的二进制,随应用打包的第三方二进制保持上游原样、不参与签名;
- 签名后的 Windows 文件显示SignPath Foundation为发布者,因为证书属于 SignPath Foundation 而非 LocalSend 项目。
核对安装来源时记住一点:如果 Windows 文件属性里发布者不是 SignPath Foundation,就说明它不是官方签名产物。
一个必须知道的例外:非官方 MSIX 预览版
README 用 CAUTION 标注了一个非官方渠道:localsend.ob-buff.dev 提供基于最新提交的 MSIX 预览构建,稳定性不保证,且该站点列出的所有自定义代码改动都需自行确认。这条不属于正常安装路径,本文后续讨论均指 README 下载表中的官方渠道。
按平台选渠道
README 下载表列出的官方渠道如下(表中第一、二行是商店/包管理器,其余为发布页二进制;具体安装方式以各渠道站点为准):
| Windows | macOS | Linux | Android | iOS | Fire OS |
|---|---|---|---|---|---|
| Winget | App Store | Flathub | Play Store | App Store | Amazon |
| Scoop | Homebrew | Nixpkgs | F-Droid | ||
| Chocolatey | DMG Installer | Snap | APK | ||
| EXE Installer | AUR | ||||
| Portable ZIP | TAR / DEB / AppImage |
选择时结合 README 的 Compatibility 表核对系统版本:
| 平台 | 最低版本 | 备注 |
|---|---|---|
| Android | 5.0 | - |
| iOS | 12.0 | - |
| macOS | 11 Big Sur | 旧机器可用 OpenCore Legacy Patcher 2.0.2 |
| Windows | 10 | 最后一个支持 Windows 7 的版本是 v1.15.4 |
| Linux | N.A. | 依赖:GNOME 需xdg-desktop-portal与xdg-desktop-portal-gtk;KDE 需xdg-desktop-portal与xdg-desktop-portal-kde |
几个直接影响选型的限制:
- 还在用 Windows 7 的话,包管理器渠道拿到的当前版本装不上,只能退回 v1.15.4 二进制;
- Linux 上无论走 Flathub、Nixpkgs 还是裸二进制,主机发行版本身若没有
xdg-desktop-portal相关依赖,文件选择/接收功能会受影响; - 传统 Linux 发行版(Debian、Fedora 等)的官方原生包在 CONTRIBUTING.md 的 TODO 清单中仍未完成,这类系统上 Flathub/Nixpkgs/Snap/AUR 或发布页的 DEB/TAR/AppImage 就是可用的全部路径。
中文用户可参考仓库内的 support/readme/README_ZH.md,其内容与英文 README 对应(该文档注明更新可能滞后,以英文文档为准)。
安装后验证是否可用
README 的 Setup 一节给出的判断基准是:大多数情况下 LocalSend 开箱即用;只有当发送或接收文件失败时,才需要动网络配置。验证方法:
- 同一局域网内两台设备各装好 LocalSend,确认对方出现在设备列表中;
- 能互相发现并完成一次文件收发,即验证通过。
如果发现不了设备或传不动文件,README 给出的网络要求和故障对照如下。
防火墙规则(README Setup 一节):
| 流量类型 | 协议 | 端口 | 操作 |
|---|---|---|---|
| 传入 | TCP, UDP | 53317 | 允许 |
| 传出 | TCP, UDP | Any | 允许 |
路由器:确认关闭 AP 隔离(AP isolation)。它通常默认关闭,但部分路由器(尤其访客网络)会开启。
现象对照表(README Troubleshooting 一节):
| 现象 | 相关平台 | 文档给出的处理方式 |
|---|---|---|
| 设备不可见 | 任意 | 关闭路由器 AP 隔离;开启时设备间连接被禁止 |
| 设备不可见 | 接收端为 Windows | 将网络类型设置为 "private";public 网络下 Windows 限制更严 |
| 设备不可见 | 发送端为 macOS / iOS | 在系统设置的 "Privacy" 中切换 "Local Network" 权限 |
| 速度过慢 | 任意 | 使用 5 GHz 频段;两台设备都关闭加密 |
| 速度过慢 | 接收端为 Android | 已知问题,README 指向 flutter-cavalry/saf_stream 的 issue |
选了二进制渠道的桌面用户:两个可选配置
如果你最终选了 Windows EXE 或 Portable ZIP(比如 Windows 7 场景),README 在 Setup 一节给了两项桌面专属配置,与包管理器安装无直接关系,属于可选分支:
隐藏启动(v1.15.0 起):用--hidden标志启动,应用只出现在托盘:
localsend_app.exe --hidden注意 v1.14.0 及更早版本行为不同:当时是设置了autostart标志且隐藏选项开启时应用才隐藏启动。
便携模式(v1.13.0 引入):在与可执行文件相同目录创建一个名为settings.json的文件(内容可以为空)。之后应用会把设置写入这个文件,而不是默认位置。这对使用 Portable ZIP 的场景有意义:设置随目录走。
限制与边界
- 应用无自动更新,这是 README 推荐包管理器的唯一明确理由;README 未描述二进制渠道的任何更新机制,装完后是否需要升级要自己留意。
- 非官方 MSIX 预览版(localsend.ob-buff.dev)稳定性不保证且含自定义代码改动,不应作为常规安装来源。
- 传统 Linux 发行版的原生官方包尚未发布(CONTRIBUTING.md TODO),对应系统的选择范围以本文渠道表为限。
- macOS 11 Big Sur 以下的旧系统需要 OpenCore Legacy Patcher 2.0.2 这一前置条件,属于 README Compatibility 表明确标注的例外。
装好并验证收发正常后,README 的下一个延伸入口是它的 Troubleshooting 表:设备不可见、速度慢这两类现象的处理方式都列在其中,可按现象对照执行。
【免费下载链接】localsendAn open-source cross-platform alternative to AirDrop项目地址: https://gitcode.com/GitHub_Trending/lo/localsend
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考