LocalSend 意大利语文档技术解读：局域网安全文件传输的部署、排障与从源码构建指南

LocalSend 意大利语文档技术解读局域网安全文件传输的部署、排障与从源码构建指南【免费下载链接】localsendAn open-source cross-platform alternative to AirDrop项目地址: https://gitcode.com/GitHub_Trending/lo/localsend本文以 LocalSend 仓库中的意大利语版官方 READMEsupport/readme/README_IT.md为主体完整覆盖其介绍的所有实战要素——多平台下载与兼容性、首次运行的防火墙配置、便携模式与最小化启动、协议工作原理、从源码编译的完整步骤、故障排查对照表以及翻译贡献流程——并结合当前仓库的 Rust 核心源码与构建配置端口常量、自签名证书生成、Flutter/Rust 工具链版本等逐项验证与扩充帮助读者既能在各操作系统上正确部署 LocalSend也能深入理解其无互联网依赖的本地安全传输机制。项目定位免费、开源、不依赖互联网的本地传输意大利语版 README 对 LocalSend 的核心定义是一款免费且开源的应用允许用户在本地网络上通过安全方式与邻近设备共享文件和消息无需任何互联网连接。原文support/readme/README_IT.md在 Panoramica概览一节进一步说明LocalSend 是一个跨平台应用设备之间通过REST API 与 HTTPS 加密通信与依赖外部服务器的即时通讯类应用不同它不需要互联网连接也不依赖任何第三方服务器是一种快速、可靠的本地通信方案。这一纯局域网定位在仓库结构中得到了直接印证核心传输逻辑位于 packages/core 这个 Rust 包中包含discovery设备发现、multicast组播广播、http客户端/服务端等模块均面向局域网内的直连通信设计。工作原理REST API 每设备动态生成的自签名证书文档 Come funziona工作原理一节指出LocalSend 使用一种安全的通信协议使设备之间能通过 REST API 互相通信所有数据都通过 HTTPS 传输且 TLS/SSL 证书是在每台设备上即时生成的以确保安全。这一描述在当前仓库源码中可以找到精确对应自签名证书的生成实现位于 packages/core/src/crypto/cert.rs。其中generate_self_signed()函数负责在本地生成密钥对并签发自签名证书源码注释明确说明该证书的 SHA-256 指纹用于标识设备self-signed certificate whose SHA-256 fingerprint identifies the device即每台设备都拥有独立的加密身份。默认通信端口为53317在 packages/core/src/http/client/url.rs 的测试用例中可以直接看到完整的目标地址形态例如https://192.168.1.1:53317/api/localsend/v2/register——HTTPS 路径前缀/api/localsend/v2/对应文档所说的 REST API 端点。由于每台设备的证书是本地即时生成而非由统一 CA 签发设备间在首次连接时需要交换并校验证书信息这在 App 界面中体现为安全校验页这正是无需外部服务器却依然保持加密传输的实现基础。下载渠道与各平台兼容性文档 Download 一节建议优先通过应用商店或包管理器下载因为应用本身没有自动更新机制。文档给出的渠道矩阵如下WindowsmacOSLinuxAndroidiOSFire OSWingetApp StoreFlathubPlay StoreApp StoreAmazonScoopHomebrewNixpkgsF-DroidChocolateyDMG 安装包SnapEXE 安装器AURZIP 便携版TAR / DEB / AppImage各分发渠道的维护仓库列表在 CONTRIBUTING.md 的 Distribution 一节中有更详细的说明含各渠道的维护者与仓库来源。文档同时给出了最低版本兼容性表这是部署前必须核对的硬性前提平台最低版本备注Android5.0—iOS12.0—macOS11 Big Sur旧机型需借助 OpenCore Legacy Patcher 2.0.2参见文档引用的 issue #1005Windows10最后一个支持 Windows 7 的版本是 v1.15.4后续可能视情况 backportLinuxN.A.—兼容性声明与仓库中的构建配置相互印证macOS 的MACOSX_DEPLOYMENT_TARGET在 app/macos/Podfile 中被显式设置为11.0与文档表格中的 macOS 11 Big Sur 完全一致Android 侧 app/android/app/build.gradle 使用minSdkVersion flutter.minSdkVersion即 Flutter SDK 默认的 API 21对应 Android 5.0targetSdkVersion 37同样与文档声明吻合。首次运行配置防火墙规则与路由器 AP 隔离文档 Installazione安装一节的结论是大多数情况下 LocalSend 装完即用但如果发送或接收文件失败通常需要配置防火墙放行本地流量。文档给出的防火墙规则表为流量方向协议端口动作入站TCP, UDP53317允许出站TCP, UDP任意允许这里的端口号 53317 并非文档凭空规定——它在 Rust 核心代码的测试与常量中反复出现如 packages/core/src/http/client/url.rs 与 packages/core/src/model/discovery.rs是设备发现与文件传输共用的固定端口因此防火墙必须对TCP 和 UDP同时放行UDP 用于组播发现TCP 承载 HTTPS 数据传输。文档还特别提醒务必确认路由器上禁用了 AP 隔离AP Isolation。它默认通常是关闭的但部分路由器尤其是访客网络会将其打开开启后同一网段内的设备之间会被禁止直接通信LocalSend 将完全无法发现彼此。桌面端高级用法便携模式与最小化启动意大利语版 README 记录了两项仅对桌面端Windows 为主有意义的实用配置1. 便携模式Modalità portatilev1.13.0 引入在可执行文件所在目录创建一个名为settings.json的文件内容可以为空。创建后应用会把设置写入该文件而不是默认的系统配置位置从而实现整个程序连同配置一起拷贝到 U 盘即可用的便携形态。2. 最小化启动Avvio minimizzatov1.15.0 更新通过命令行参数--hidden让应用直接以最小化形式启动仅驻留系统托盘/任务栏例如localsend_app.exe --hidden文档同时说明在 v1.14.0 及更早版本中行为由autostart标志配合隐藏启动设置项控制二者同时满足时应用才会最小化启动而 v1.15.0 起改由显式的--hidden参数控制行为更直接。从源码构建完整的 Primi passi起步步骤文档 Primi passi 一节给出了从源码编译 LocalSend 的六步流程。结合当前仓库的实际工具链配置可以将其补充为更精确的版本安装 Flutter。仓库通过 .fvmrc 锁定版本当前要求为Flutter 3.41.9。文档特别注明引用块 NOTELocalSend 目前要求的是较旧版本的 Flutter如果系统安装的 Flutter 版本与项目要求不匹配很可能就是编译报错的原因项目统一使用 fvm 管理项目级 Flutter 版本该说明在文档中出现外部服务名 fvm 为文档原文引用安装fvm后应改用fvm flutter代替flutter执行所有命令以保证开发环境一致。安装 Rust。当前仓库通过 rust-toolchain.toml 将工具链固定在Rust 1.97.1并附带clippy组件用于代码检查。克隆 LocalSend 仓库。进入应用目录cd app。执行flutter pub get拉取 Dart 侧依赖。执行flutter run启动应用。仓库根目录的 pubspec.yaml 声明 Dart SDK 约束为^3.11.0与 Flutter 3.41.x 配套Rust 工作区则由根 Cargo.toml 管理涵盖packages/core、packages/localsend_isolates、cli、server等 crate。此外文档目录意大利语版 README 的 TOC列出了 Android、iOS、macOS、Windows、Linux 五套平台级的编译流程当前仓库在 support/scripts/ 目录下确实保留了与各平台一一对应的官方构建脚本例如 compile_android_apk.sh、compile_ios.sh、compile_linux_appimage.sh、compile_windows_exe.ps1、compile_mac_dmg.sh 等需要产出对应平台安装包时可以直接对照这些脚本了解各平台的打包方式。故障排查对照表文档 Risoluzione dei problemi故障排查一节给出了一张按现象 × 平台组织的排查矩阵是排查连接问题的第一手依据现象发送方平台接收方平台解决方案设备不可见任意任意确认已禁用路由器的 AP 隔离若开启设备间通信会被禁止设备不可见任意Windows确认网络配置为专用网络PrivateWindows 对公用网络Public的限制更严格设备不可见macOS / iOS任意可尝试在系统设置的隐私中关闭本地网络Local Network授权项速度过慢任意任意改用 5 GHz 频段在两台设备上同时关闭加密速度过慢任意Android已知问题文档指向 flutter-cavalry/saf_stream 的 issue #4这张表与本文前面两节是一体的AP 隔离与 Windows 网络配置文件影响的是设备发现组播/广播能否到达对方5 GHz 与关闭加密影响的是传输吞吐。若设备能互相发现但传输失败则应回到防火墙一节核对 53317 端口的 TCP/UDP 放行。贡献指南翻译与代码改进文档 Come contribuire如何贡献一节将贡献途径分为两类翻译Traduzione推荐方式通过 Weblate 平台协作翻译文档以 Weblate 的 localsend/app 项目为入口README 顶部的 Translations 徽章即指向该平台的翻译进度统计替代方式fork 仓库后手动添加翻译文件。翻译文件位于 app/assets/i18n/ 目录当前包含 ar、de、fr、ja、pt-BR、zh-CN、zh-TW 等 60 余种语言的strings_locale.i18n.json文件文档说明应修改_missing_translations_locale.json或strings_locale.i18n.json来新增或更新译文本仓库快照中保留了 app/assets/i18n/_missing_translations_it.json 等缺失译文清单文件即用于标记尚未翻译的词条。文档特别警示以开头的字段不要翻译——它们不用于 App 运行只是给译者提供的上下文注释。仓库中生成的 app/lib/gen/strings_it.g.dart 等*.g.dart文件则是由翻译 JSON 自动生成的 Dart 代码无需手工维护。Bug 修复与功能改进修复 Bug提交 Pull Request 时需清晰描述问题及修复方式功能改进先提交 issue 讨论改进的必要性再着手实现。完整的规范包括分发渠道维护、安全漏洞上报方式——安全类问题应直接发邮件给 supportlocalsend.org 而非公开 issue见 CONTRIBUTING.md。小结从意大利语 README 到可验证的工程细节这篇意大利语版 README 虽然篇幅不长却完整覆盖了 LocalSend 使用者需要的全部关键路径它说明了项目REST API 每设备即时生成的 HTTPS 自签名证书这一无外网依赖的安全模型对应 packages/core/src/crypto/cert.rs给出了 53317 端口 TCP/UDP 的防火墙放行规则与 packages/core/src/http/client/url.rs 中的端口常量一致、AP 隔离与 Windows 网络配置这两个最常见的发现失败原因、macOS 11.0 / Android 5.0 等与构建配置严格对应的兼容性边界见 app/macos/Podfile、app/android/app/build.gradle以及Flutter 3.41.9 Rust 1.97.1的从源码构建组合见 .fvmrc、rust-toolchain.toml。将文档声明与仓库源码、构建配置逐项对照后可以看出该 README 提供的每一条运维建议都有明确的代码依据可直接作为本地网络部署 LocalSend 的操作手册使用。【免费下载链接】localsendAn open-source cross-platform alternative to AirDrop项目地址: https://gitcode.com/GitHub_Trending/lo/localsend创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考