做 Linux 桌面的这些年我在统信 UOS 上折腾过不少局域网工具从最原始的文件共享、FTP到后来各类跨端 App兜兜转转最后留在日常环境里的反而是 LocalSend 这个看着不起眼的小东西。一开始我也只当它是个“传文件更省事”的替代品——毕竟 UOS 生态里的跨端协作确实不算丰富。真正让我改变看法的是某天在编码时想把手机构图里的一段文案贴到 UOS 的终端里结果发现 LocalSend 的文本模式直接把这件事做掉了而且比任何聊天软件都干净。后来我又顺手试了剪贴板互传、多设备同时在线接力、甚至用脚本调用它的接口越用越觉得这玩意儿被低估了。这篇就把我在统信 UOS 上关于 LocalSend 的这套“非常规用法”完整捋一遍从安装、配置到文本/剪贴板/多设备联动的实操细节包括踩过的坑和端口、防火墙、mDNS 这些容易被忽略的地方都摊开讲清楚适合刚上手 UOS 想打通多设备的普通用户也适合喜欢折腾自动化、想把它嵌进工作流的技术用户。1. LocalSend 到底是什么为什么它在 UOS 上格外值得装1.1 先把它和网盘、聊天软件彻底区分开很多人第一次听到 LocalSend会下意识把它归类成“又一个传文件的工具”。但只要用过一次就会发现它的定位和网盘、IM 完全不在一个维度。网盘的数据要经过服务商的服务器中转你先上传别人才能下载链路长、依赖外网、还受容量和限速约束聊天软件虽然能发文件发文本但它本质是个社交产品你要在会话框里操作还要处理对方是否在线、消息是否推送这些问题。LocalSend 走的是完全不同的路子——它只做一件事让同一局域网里的设备互相发现然后点对点直连传输。也就是说数据从 A 设备的网卡出去经过你家的路由器或者办公室的交换机直接到达 B 设备中间不经过任何第三方服务器。传输过程走 HTTPS端口默认是 53317文件内容在链路上是加密的。这个设计带来的直接好处是速度上限基本等于你内网带宽千兆局域网跑满百兆每秒很正常外网断了照样能用传输内容不会被任何一方留存。理解这一点后面讲的所有“隐藏玩法”才站得住脚——因为它是点对点的所以才有资格当成剪贴板通道和多设备协作枢纽来用。1.2 它在统信 UOS 上的真实处境统信 UOS 基于 Debian 体系桌面是自研的 DDE整体体验已经比较完整但在跨端协作这一块官方自带的工具链偏保守主要围绕文件管理器、云文档、打印共享这些方向真正意义上的“设备间实时互传”并没有一个特别顺手的原生方案。你可能想同步一段文本、一张截图、一个临时文件往往要绕道微信、钉钉这类第三方软件登录、加好友、发消息、再另存流程相当冗长。LocalSend 恰好补上了这个缺口。它本身是跨平台的开源项目用 Flutter 写的支持 Windows、macOS、Linux、Android、iOS 全套Linux 侧既提供 AppImage 也提供 deb还能通过 Flatpak 安装。UOS 属于 Debian 系装上对应的 deb 包或 AppImage 都能正常跑起来桌面环境识别也没有明显问题。更关键的是它不需要账号、不需要注册、不需要联网验证装完打开就能用这一点对于很多内网办公环境来说几乎是刚需——你甚至可以把整个使用场景放在完全不接外网的隔离局域网里。1.3 三个我最常用的场景先摆出来为了让后面的实操有条理我先把最有价值的三个场景列出来你可以对照自己的需求判断要不要往下看。第一个是临时文本和链接的搬运。手机上刷到的一段代码、一个网址、一段地址不用再发给自己或者复制到备忘录直接用 LocalSend 的文本模式丢给 UOS落手就能粘贴使用。第二个是剪贴板级别的互传。这个比传文本更进一步——接收端拿到内容后直接进剪贴板在 UOS 上按 CtrlV 就能用。实际用下来这个场景对经常在手机和电脑之间倒腾素材的人效率提升非常明显。第三个是多设备联动。LocalSend 不限制同时连接的设备数多台手机、平板、笔记本、台式机在同一个局域网里可以互相看到你可以把它当成一个迷你的传输总线在这条总线上做设备间的接力、广播和分发具体怎么组合后面会展开讲。2. 在统信 UOS 上把 LocalSend 装稳、配好、放行2.1 安装方式的取舍deb、AppImage 还是 Flatpak在 UOS 上安装 LocalSend现实中主要有三条路我都试过各有适用场景。deb 包是最省心的方式。你从项目发布页下载对应架构的 debUOS 大多数机器是 amd64少数国产平台是 arm64然后双击或者用dpkg安装。优点是集成到系统包管理里菜单项、图标、卸载流程都完整符合 UOS 的使用习惯。缺点是 UOS 对未签名或非商店来源的 deb 有时会弹安全提示需要在系统设置里允许“安装任意来源的软件包”或者进入开发者模式这个要在动手之前先确认清楚。AppImage更灵活下载后加执行权限直接运行不污染系统目录适合你只是想试用一下、或者没有 sudo 权限的办公机器。缺点是每次启动要从文件管理器里双击或者你自己建一个 .desktop 文件丢到~/.local/share/applications下才能进应用菜单。第一次运行的时候 AppImage 需要 FUSE 支持UOS 默认通常是带了的如果报错大概率是缺libfuse2。Flatpak在 UOS 上需要先装 flatpak 运行时和 flathub 源流程比前两种长但好处是沙箱隔离、后续升级方便。如果你本来就习惯 Flatpak 生态可以走这条路如果只是为了传文件我建议还是 deb 或者 AppImage少一层变量少一层坑。2.2 首次启动必须盯紧的几个设置装完之后第一次打开界面很简单但有几个设置项值得当场调好不然后面用起来会别扭。设备别名默认一般是主机名建议改成你能一眼认出来的名字比如“UOS-工位机”“客厅台式”。多设备环境下识别名字比识别一长串指纹要快得多。这个改动在设置里改一次就生效之后所有设备看到你都是这个名字。下载目录默认是系统下载文件夹如果你有固定的“接收区”习惯比如~/Transfer或~/Downloads/LocalSend就在设置里定死省得接收文件之后到处找。保存到相册这个是移动端的选项桌面端没有但你如果同时用手机可以在手机上打开接收的图片直接进相册省一步手动保存。HTTPS 加密默认是开着的别关。它的原理是用自签名证书建立 TLS 通道第一次和某个新设备通信时会交换指纹这个指纹就是设备身份。保持开启的好处是连进来的每台设备都会被验证避免局域网内有人乱发东西。2.3 端口、防火墙与 mDNS三个最容易被忽略的配置真正让 LocalSend“找不到设备”或者“看得到传不动”的问题90% 出在这三件事上。端口 53317是 LocalSend 的默认通信端口TCP 和 UDP 都用它。TCP 负责实际的 HTTPS 传输UDP 负责 mDNS 广播发现。你要确认 UOS 上的防火墙放行这个端口。UOS 默认用的是 ufw 或者系统自带的安全中心命令行方式可以这样放行sudo ufw allow 53317/tcp sudo ufw allow 53317/udp如果你用的是 iptables 或者 firewalld规则写法不同但思路一样TCP 和 UDP 都要放。mDNS 发现是它能在设备列表里显示出对方的关键。mDNS 本质是局域网内的多播 DNS服务类型一般注册成_localsend._tcp.local。如果路由器开启了 AP 隔离很多公共 WiFi 和企业网络默认开多播包就传不过去设备之间互相看不到。家庭路由器一般没事办公室网络要留意必要时让网络管理员临时关掉隔离或者用下面要讲的手动 IP 方式绕过。子网一致性也是个坑。两台设备必须在同一个网段里比如都在 192.168.1.x 下才能通过 mDNS 互相发现。如果一台连的是 2.4G 的访客网络另一台连的是主网络看起来都在家里实际上是两个隔离的子网怎么都发现不了。排查时先看两边的 IP 地址前三段是否一致这是最快的判断方式。3. 隐藏玩法一把文本模式当成剪贴板直通车3.1 文本模式到底怎么用和传文件有什么不同很多人装了 LocalSend 之后只用来传文件完全没注意界面顶部还有一个“文本”的切换项。默认它是文件模式切到文本模式之后输入框里敲进去的任何内容都会被当成一段文本发出去接收端收到后会展示在文本查看器里。内容可以是网址、命令、地址、一段代码、一个 JSON长度上没有明显限制日常用的几百字到几千字都没问题。操作路径非常直接UOS 上打开 LocalSend顶部切换到“文本”粘贴或输入内容点发送选择目标设备接收端确认接收内容立刻出现。整个过程几秒钟比登录任何 IM 都快。这里有个细节值得注意文本模式下内容是以text/plain的形式走的和传文件共用同一套传输通道所以你传一长段文字和传一个 txt 文件在底层没有本质差别只是在接收端的呈现方式不一样。3.2 手机到 UOS 的剪贴板场景实操真正让我留下来的是移动端到 UOS 的这一段。具体场景是这样的我在手机浏览器里看到一个技术问题的解决方案或者对着一段地址、验证码、订单号要填到 UOS 上的网页或者终端里。以前的做法是发到自己的微信文件传输助手然后 UOS 上登录微信再复制。现在直接在手机上打开 LocalSend切文本模式粘贴选 UOS 设备发送。UOS 上收到之后文本内容直接显示在窗口里同时——在移动端设备上接收时——内容会进剪贴板在 UOS 桌面端接收时是显示在窗口里按全选复制一下就能用。反过来也一样。UOS 上复制了一段命令、一个 URL、一段配置切文本模式发到手机上手机上接收后直接粘贴到需要的地方。整个链路只在局域网里跑不经过任何服务器敏感一点的内容比如一段临时代码、一次性的 token用这个方式倒腾心里也踏实。3.3 几条让文本模式更好用的小经验第一先切换再输入。LocalSend 的输入框在切换模式后不会保留之前的内容如果你是先在文件模式里点了什么再切到文本之前的操作会被清掉。养成先切文本再粘贴的习惯。第二长文本优先走文件模式。文本模式适合几百字以内的短内容如果你要传几千字的文档、带格式的内容、或者包含大量特殊字符的文本直接用文件模式发一个.txt反而更稳接收端不会出现排版错乱。第三接收后立刻用。桌面端接收的文本是显示在窗口里的窗口一关内容就没了。手机上接收的文本会进剪贴板但如果你之后又复制了别的东西前面的就被覆盖了。所以收到就赶紧粘贴到目标位置别当成临时仓库攒着。第四不要把文本模式当备忘录用。它没有历史记录关了窗口就找不回来也不支持多设备同步。要做长期存储还是老老实实用笔记或者文件。4. 隐藏玩法二多设备联动把它变成内网传输总线4.1 多设备同时在线的实际效果LocalSend 的一个被严重低估的特性是它不限制在线设备数量。同一个局域网里只要你打开 LocalSend所有开启的设备都会出现在设备列表里一台手机、两个平板、三台电脑可以同时在列。你发文件的时候是点对点选择目标可以单选也可以多选多选模式下会依次向每个目标设备发起传输请求每个目标端独立确认。我实测过的一个典型组合是客厅台式UOS、卧室笔记本UOS、我的主力手机、一台旧安卓平板四台设备同时在线。手机上拍下的照片可以一次发给台式和平板两边的编辑工作不用来回拷贝 U 盘。这个场景在家庭里非常实用尤其是家里有老人小孩的时候你不会希望他们为了传一张照片去装什么软件、注册什么账号。4.2 UOS 作为传输枢纽的几种组合因为 UOS 桌面端处理文件的能力比移动端强我习惯把 UOS 当成整个内网的“中转站”几种常见的组合手机 → UOS → 打印机。手机上收到一份要打印的 PDF先发到 UOS在 UOS 上用系统打印对话框选择网络打印机比手机直连打印稳定得多尤其是格式复杂一点的文档。平板 → UOS → 移动硬盘。平板上剪完的视频先发到 UOS接入移动硬盘或者 U 盘之后归档。UOS 的文件管理器和外设挂载体验比移动端成熟处理大文件更省心。UOS → 多台手机广播。给全家人的手机同时推送一份通知文档、一个安装包、一张行程表一次选中所有目标设备发送每台手机各自确认接收。这个场景在组织小型活动、家庭出游的时候特别顺手。4.3 设备指纹、可信设备与安全边界多设备场景下安全这件事必须提一下。每台 LocalSend 设备都有一个指纹fingerprint第一次和某个新设备通信时两边会交换指纹。如果你把某台设备标记为“可信”之后的传输就不需要每次手动确认。在只有自家设备的内网里这个设置能大幅减少点击次数但如果你的环境里有访客设备建议保持默认的每次确认避免误收或被人主动推送。还有一点容易被忽略接收是必须由接收方确认的发送方无法强制把东西塞进对方。这个设计是它和某些“推送式”工具的关键区别也决定了它不能被用来做骚扰或者骚扰性传播。如果你在办公室环境里同事的设备出现在列表里你不会收到他们未经过你确认的任何东西这一点可以放心。5. 隐藏玩法三把 LocalSend 接进自动化脚本里5.1 先摸清它的通信方式前面讲的都是图形界面的玩法对技术用户来说LocalSend 还有一层玩法是直接调它的 HTTP 接口。因为它走的是标准的 HTTPS 协议端口 53317路径前缀是/api/localsend/v2/你可以用 curl、Python 或者任何 HTTP 客户端跟它对话。这个特性让它具备了被脚本化的可能——你可以写一个定时任务把某个目录里新生成的文件自动推给指定设备或者把 UOS 上剪贴板的内容通过命令行直接发出去。需要先说明这一层玩法依赖的是项目公开的协议行为不同版本之间接口可能有细微差异动手之前建议先在自己的设备上小范围验证一次确认路径和字段都能对上再写进正式脚本。下面的示例都是我在本地验证过能跑通的思路整理。5.2 一个最小可用的发送脚本最基础的流程分两步先向目标设备发起一次“准备上传”的请求拿到会话 ID 和文件令牌再用这个令牌把实际内容 POST 过去。第一步的请求体大概长这样curl -sk -X POST https://192.168.1.20:53317/api/localsend/v2/prepare-upload \ -H Content-Type: application/json \ -d { info: { alias: UOS-Workstation, version: 2.1, deviceModel: PC, deviceType: desktop, fingerprint: your-device-fingerprint, port: 53317, protocol: https, download: false }, files: { clip: { id: clip, fileName: clip.txt, size: 24, fileType: text/plain } } }-k是为了跳过自签名证书的校验本地局域网里用可以接受如果在意安全性可以把 LocalSend 的证书导出之后用--cacert指定。响应里会返回一个sessionId和一个针对clip这个文件的token把它们留好进入第二步curl -sk -X POST https://192.168.1.20:53317/api/localsend/v2/send?sessionIdSESSION_IDfileIdcliptokenFILE_TOKEN \ -H Content-Type: application/octet-stream \ --data-binary clip.txt实际运行时接收端会弹出一个接收确认除非该设备已被标记为可信确认之后文件就落在对方的下载目录里。理解了这个流程你就等于拿到了 LocalSend 的命令行入口。5.3 几个能立刻落地的自动化场景场景一剪贴板快发。在 UOS 上写一个 shell 函数把xclip -o拿到的剪贴板内容写进临时文件然后调上面的脚本发到手机。绑定一个快捷键以后选中一段内容按下快捷键就发到手机比切窗口点按钮快得多。场景二目录监控。用inotifywait监控某个目录一旦有新文件落进来就自动推送到指定设备。适合做扫描仪、截图目录、下载目录的自动分发。场景三定时备份推送。写一个 cron 任务每天固定时间把 UOS 上某个工作目录打包压缩后通过 LocalSend 推送到家里的另一台设备或者手机上做成一套不依赖外网、不依赖云服务的本地备份链路。场景四批量配置分发。在有多台 UOS 设备的办公环境里把一份统一的配置文件、一个内部工具包通过脚本一次性推给所有在线的目标设备省去人工逐台拷贝。6. 常见问题与排查技巧实录6.1 设备列表里看不到对方怎么办这是最高频的问题我把排查顺序整理成一张表按这个顺序走基本能定位到位。现象可能原因排查动作完全看不到任何设备不在同一网段对比两台设备的 IP 前三段是否一致部分设备互相看不到AP 隔离/多播被拦检查路由器是否开启客户端隔离或关掉隔离重试UOS 上看不到手机手机能看到 UOS防火墙挡了 UDPsudo ufw allow 53317/udp后重启应用之前能看到突然看不到了网络切换或缓存重启 LocalSend或手动输入对方 IP 添加所有设备都看不到应用未启动或端口被占ss -tulnp手动添加设备的方式是点设备列表旁边的“手动输入地址”填ip:53317就能直连绕开 mDNS。这个技巧在 mDNS 不可靠的企业网络里几乎是救命稻草。6.2 传了一半断掉或者速度上不去速度问题的核心就一句它跑的是内网速度慢说明内网本身慢或者走了错误路径。先确认两台设备是不是连在同一个路由器下如果一台走 WiFi 一台走网线速度会被 WiFi 那一侧拖慢。5G WiFi 实际跑到几十兆每秒是正常的2.4G 会更低千兆有线之间跑满百兆每秒以上也很常见。如果传输中途断开常见原因有三个一是接收端切到了后台被系统限制手机端尤其明显要在设置里允许后台运行二是大文件传输时路由器或者某些安全软件做了流量整形三是传输目录所在磁盘空间不足或者权限有问题。逐个排除即可。6.3 UOS 上遇到的几个具体坑AppImage 启动报 FUSE 错误。这是缺依赖装上libfuse2就好命令是sudo apt install libfuse2。deb 安装时提示来源不受信任。UOS 的安全策略比较严需要在系统设置的“通用”里打开“开发者模式”或者允许未知来源装完可以再关回去。桌面图标不显示或者启动无反应。多半是 .desktop 文件里的路径写错了检查Exec那一行指向的可执行文件是否存在、是否有执行权限。AppImage 方式安装的记得先chmod x。接收目录权限异常。如果目标目录是外挂的 NTFS 或者 exFAT 分区写入时可能因为权限或者挂载选项出问题换成用户目录下的普通路径先验证一下。6.4 常见问题速查提示所有排查都建议先做一件事——把两台设备的 LocalSend 都重启一次。很多“找不到设备”的问题在重启后就没了因为 mDNS 缓存在某些网络环境下会失效重启会强制重新广播。设备名重复导致认错设备去设置里把别名改成有辨识度的名字。收到文件找不到在哪检查设置里的下载目录默认在系统下载文件夹。手机端收不到后台通知在系统设置里把 LocalSend 加入“允许后台活动”和“允许自启动”名单。传输速度忽高忽低关掉路由器上的 QoS 或者智能限速功能再试。多设备同时发送时某台始终失败检查那台设备是否处于休眠状态或者它的防火墙规则是不是最严。三个我踩过的坑值得单独说。第一个是宽带路由器在开了“访客网络”之后主机和访客网络之间会被完全隔离看起来都连着同一个 WiFi实际是两个独立子网这种情况只能把设备都连到主网络。第二个是某些企业安全软件会拦截未知的 HTTPS 服务端口53317 这种非标准端口首当其冲遇到这种情况需要把 LocalSend 加入白名单或者找 IT 协调放行。第三个是手机的省电策略安卓阵营各家的后台管理越来越激进LocalSend 被冻结之后即使前台显示在线接收也会失败这个要在手机的电池设置里针对性放行。这套东西用熟了之后我在 UOS 上的日常流程基本就固定下来了手机上复制的东西直接 LocalSend 推过来临时文件在几台设备间随手转发需要批量分发的场景写个小脚本让它自己跑。它没有华丽的界面也没有云同步那种“什么都能做”的野心但正因为只做局域网直连这一件事用起来反而比那些大而全的工具轻松。后续我还在琢磨把它和 UOS 的文件管理器右键菜单集成一下选中文件就能一键发出去等时机成熟了再整理出来。 
长河君 · 2026/9/18 23:05:01 · 阅读 1.2k 统信UOS上LocalSend隐藏玩法：剪贴板互传与多设备联动
做 Linux 桌面的这些年我在统信 UOS 上折腾过不少局域网工具从最原始的文件共享、FTP到后来各类跨端 App兜兜转转最后留在日常环境里的反而是 LocalSend 这个看着不起眼的小东西。一开始我也只当它是个“传文件更省事”的替代品——毕竟 UOS 生态里的跨端协作确实不算丰富。真正让我改变看法的是某天在编码时想把手机构图里的一段文案贴到 UOS 的终端里结果发现 LocalSend 的文本模式直接把这件事做掉了而且比任何聊天软件都干净。后来我又顺手试了剪贴板互传、多设备同时在线接力、甚至用脚本调用它的接口越用越觉得这玩意儿被低估了。这篇就把我在统信 UOS 上关于 LocalSend 的这套“非常规用法”完整捋一遍从安装、配置到文本/剪贴板/多设备联动的实操细节包括踩过的坑和端口、防火墙、mDNS 这些容易被忽略的地方都摊开讲清楚适合刚上手 UOS 想打通多设备的普通用户也适合喜欢折腾自动化、想把它嵌进工作流的技术用户。1. LocalSend 到底是什么为什么它在 UOS 上格外值得装1.1 先把它和网盘、聊天软件彻底区分开很多人第一次听到 LocalSend会下意识把它归类成“又一个传文件的工具”。但只要用过一次就会发现它的定位和网盘、IM 完全不在一个维度。网盘的数据要经过服务商的服务器中转你先上传别人才能下载链路长、依赖外网、还受容量和限速约束聊天软件虽然能发文件发文本但它本质是个社交产品你要在会话框里操作还要处理对方是否在线、消息是否推送这些问题。LocalSend 走的是完全不同的路子——它只做一件事让同一局域网里的设备互相发现然后点对点直连传输。也就是说数据从 A 设备的网卡出去经过你家的路由器或者办公室的交换机直接到达 B 设备中间不经过任何第三方服务器。传输过程走 HTTPS端口默认是 53317文件内容在链路上是加密的。这个设计带来的直接好处是速度上限基本等于你内网带宽千兆局域网跑满百兆每秒很正常外网断了照样能用传输内容不会被任何一方留存。理解这一点后面讲的所有“隐藏玩法”才站得住脚——因为它是点对点的所以才有资格当成剪贴板通道和多设备协作枢纽来用。1.2 它在统信 UOS 上的真实处境统信 UOS 基于 Debian 体系桌面是自研的 DDE整体体验已经比较完整但在跨端协作这一块官方自带的工具链偏保守主要围绕文件管理器、云文档、打印共享这些方向真正意义上的“设备间实时互传”并没有一个特别顺手的原生方案。你可能想同步一段文本、一张截图、一个临时文件往往要绕道微信、钉钉这类第三方软件登录、加好友、发消息、再另存流程相当冗长。LocalSend 恰好补上了这个缺口。它本身是跨平台的开源项目用 Flutter 写的支持 Windows、macOS、Linux、Android、iOS 全套Linux 侧既提供 AppImage 也提供 deb还能通过 Flatpak 安装。UOS 属于 Debian 系装上对应的 deb 包或 AppImage 都能正常跑起来桌面环境识别也没有明显问题。更关键的是它不需要账号、不需要注册、不需要联网验证装完打开就能用这一点对于很多内网办公环境来说几乎是刚需——你甚至可以把整个使用场景放在完全不接外网的隔离局域网里。1.3 三个我最常用的场景先摆出来为了让后面的实操有条理我先把最有价值的三个场景列出来你可以对照自己的需求判断要不要往下看。第一个是临时文本和链接的搬运。手机上刷到的一段代码、一个网址、一段地址不用再发给自己或者复制到备忘录直接用 LocalSend 的文本模式丢给 UOS落手就能粘贴使用。第二个是剪贴板级别的互传。这个比传文本更进一步——接收端拿到内容后直接进剪贴板在 UOS 上按 CtrlV 就能用。实际用下来这个场景对经常在手机和电脑之间倒腾素材的人效率提升非常明显。第三个是多设备联动。LocalSend 不限制同时连接的设备数多台手机、平板、笔记本、台式机在同一个局域网里可以互相看到你可以把它当成一个迷你的传输总线在这条总线上做设备间的接力、广播和分发具体怎么组合后面会展开讲。2. 在统信 UOS 上把 LocalSend 装稳、配好、放行2.1 安装方式的取舍deb、AppImage 还是 Flatpak在 UOS 上安装 LocalSend现实中主要有三条路我都试过各有适用场景。deb 包是最省心的方式。你从项目发布页下载对应架构的 debUOS 大多数机器是 amd64少数国产平台是 arm64然后双击或者用dpkg安装。优点是集成到系统包管理里菜单项、图标、卸载流程都完整符合 UOS 的使用习惯。缺点是 UOS 对未签名或非商店来源的 deb 有时会弹安全提示需要在系统设置里允许“安装任意来源的软件包”或者进入开发者模式这个要在动手之前先确认清楚。AppImage更灵活下载后加执行权限直接运行不污染系统目录适合你只是想试用一下、或者没有 sudo 权限的办公机器。缺点是每次启动要从文件管理器里双击或者你自己建一个 .desktop 文件丢到~/.local/share/applications下才能进应用菜单。第一次运行的时候 AppImage 需要 FUSE 支持UOS 默认通常是带了的如果报错大概率是缺libfuse2。Flatpak在 UOS 上需要先装 flatpak 运行时和 flathub 源流程比前两种长但好处是沙箱隔离、后续升级方便。如果你本来就习惯 Flatpak 生态可以走这条路如果只是为了传文件我建议还是 deb 或者 AppImage少一层变量少一层坑。2.2 首次启动必须盯紧的几个设置装完之后第一次打开界面很简单但有几个设置项值得当场调好不然后面用起来会别扭。设备别名默认一般是主机名建议改成你能一眼认出来的名字比如“UOS-工位机”“客厅台式”。多设备环境下识别名字比识别一长串指纹要快得多。这个改动在设置里改一次就生效之后所有设备看到你都是这个名字。下载目录默认是系统下载文件夹如果你有固定的“接收区”习惯比如~/Transfer或~/Downloads/LocalSend就在设置里定死省得接收文件之后到处找。保存到相册这个是移动端的选项桌面端没有但你如果同时用手机可以在手机上打开接收的图片直接进相册省一步手动保存。HTTPS 加密默认是开着的别关。它的原理是用自签名证书建立 TLS 通道第一次和某个新设备通信时会交换指纹这个指纹就是设备身份。保持开启的好处是连进来的每台设备都会被验证避免局域网内有人乱发东西。2.3 端口、防火墙与 mDNS三个最容易被忽略的配置真正让 LocalSend“找不到设备”或者“看得到传不动”的问题90% 出在这三件事上。端口 53317是 LocalSend 的默认通信端口TCP 和 UDP 都用它。TCP 负责实际的 HTTPS 传输UDP 负责 mDNS 广播发现。你要确认 UOS 上的防火墙放行这个端口。UOS 默认用的是 ufw 或者系统自带的安全中心命令行方式可以这样放行sudo ufw allow 53317/tcp sudo ufw allow 53317/udp如果你用的是 iptables 或者 firewalld规则写法不同但思路一样TCP 和 UDP 都要放。mDNS 发现是它能在设备列表里显示出对方的关键。mDNS 本质是局域网内的多播 DNS服务类型一般注册成_localsend._tcp.local。如果路由器开启了 AP 隔离很多公共 WiFi 和企业网络默认开多播包就传不过去设备之间互相看不到。家庭路由器一般没事办公室网络要留意必要时让网络管理员临时关掉隔离或者用下面要讲的手动 IP 方式绕过。子网一致性也是个坑。两台设备必须在同一个网段里比如都在 192.168.1.x 下才能通过 mDNS 互相发现。如果一台连的是 2.4G 的访客网络另一台连的是主网络看起来都在家里实际上是两个隔离的子网怎么都发现不了。排查时先看两边的 IP 地址前三段是否一致这是最快的判断方式。3. 隐藏玩法一把文本模式当成剪贴板直通车3.1 文本模式到底怎么用和传文件有什么不同很多人装了 LocalSend 之后只用来传文件完全没注意界面顶部还有一个“文本”的切换项。默认它是文件模式切到文本模式之后输入框里敲进去的任何内容都会被当成一段文本发出去接收端收到后会展示在文本查看器里。内容可以是网址、命令、地址、一段代码、一个 JSON长度上没有明显限制日常用的几百字到几千字都没问题。操作路径非常直接UOS 上打开 LocalSend顶部切换到“文本”粘贴或输入内容点发送选择目标设备接收端确认接收内容立刻出现。整个过程几秒钟比登录任何 IM 都快。这里有个细节值得注意文本模式下内容是以text/plain的形式走的和传文件共用同一套传输通道所以你传一长段文字和传一个 txt 文件在底层没有本质差别只是在接收端的呈现方式不一样。3.2 手机到 UOS 的剪贴板场景实操真正让我留下来的是移动端到 UOS 的这一段。具体场景是这样的我在手机浏览器里看到一个技术问题的解决方案或者对着一段地址、验证码、订单号要填到 UOS 上的网页或者终端里。以前的做法是发到自己的微信文件传输助手然后 UOS 上登录微信再复制。现在直接在手机上打开 LocalSend切文本模式粘贴选 UOS 设备发送。UOS 上收到之后文本内容直接显示在窗口里同时——在移动端设备上接收时——内容会进剪贴板在 UOS 桌面端接收时是显示在窗口里按全选复制一下就能用。反过来也一样。UOS 上复制了一段命令、一个 URL、一段配置切文本模式发到手机上手机上接收后直接粘贴到需要的地方。整个链路只在局域网里跑不经过任何服务器敏感一点的内容比如一段临时代码、一次性的 token用这个方式倒腾心里也踏实。3.3 几条让文本模式更好用的小经验第一先切换再输入。LocalSend 的输入框在切换模式后不会保留之前的内容如果你是先在文件模式里点了什么再切到文本之前的操作会被清掉。养成先切文本再粘贴的习惯。第二长文本优先走文件模式。文本模式适合几百字以内的短内容如果你要传几千字的文档、带格式的内容、或者包含大量特殊字符的文本直接用文件模式发一个.txt反而更稳接收端不会出现排版错乱。第三接收后立刻用。桌面端接收的文本是显示在窗口里的窗口一关内容就没了。手机上接收的文本会进剪贴板但如果你之后又复制了别的东西前面的就被覆盖了。所以收到就赶紧粘贴到目标位置别当成临时仓库攒着。第四不要把文本模式当备忘录用。它没有历史记录关了窗口就找不回来也不支持多设备同步。要做长期存储还是老老实实用笔记或者文件。4. 隐藏玩法二多设备联动把它变成内网传输总线4.1 多设备同时在线的实际效果LocalSend 的一个被严重低估的特性是它不限制在线设备数量。同一个局域网里只要你打开 LocalSend所有开启的设备都会出现在设备列表里一台手机、两个平板、三台电脑可以同时在列。你发文件的时候是点对点选择目标可以单选也可以多选多选模式下会依次向每个目标设备发起传输请求每个目标端独立确认。我实测过的一个典型组合是客厅台式UOS、卧室笔记本UOS、我的主力手机、一台旧安卓平板四台设备同时在线。手机上拍下的照片可以一次发给台式和平板两边的编辑工作不用来回拷贝 U 盘。这个场景在家庭里非常实用尤其是家里有老人小孩的时候你不会希望他们为了传一张照片去装什么软件、注册什么账号。4.2 UOS 作为传输枢纽的几种组合因为 UOS 桌面端处理文件的能力比移动端强我习惯把 UOS 当成整个内网的“中转站”几种常见的组合手机 → UOS → 打印机。手机上收到一份要打印的 PDF先发到 UOS在 UOS 上用系统打印对话框选择网络打印机比手机直连打印稳定得多尤其是格式复杂一点的文档。平板 → UOS → 移动硬盘。平板上剪完的视频先发到 UOS接入移动硬盘或者 U 盘之后归档。UOS 的文件管理器和外设挂载体验比移动端成熟处理大文件更省心。UOS → 多台手机广播。给全家人的手机同时推送一份通知文档、一个安装包、一张行程表一次选中所有目标设备发送每台手机各自确认接收。这个场景在组织小型活动、家庭出游的时候特别顺手。4.3 设备指纹、可信设备与安全边界多设备场景下安全这件事必须提一下。每台 LocalSend 设备都有一个指纹fingerprint第一次和某个新设备通信时两边会交换指纹。如果你把某台设备标记为“可信”之后的传输就不需要每次手动确认。在只有自家设备的内网里这个设置能大幅减少点击次数但如果你的环境里有访客设备建议保持默认的每次确认避免误收或被人主动推送。还有一点容易被忽略接收是必须由接收方确认的发送方无法强制把东西塞进对方。这个设计是它和某些“推送式”工具的关键区别也决定了它不能被用来做骚扰或者骚扰性传播。如果你在办公室环境里同事的设备出现在列表里你不会收到他们未经过你确认的任何东西这一点可以放心。5. 隐藏玩法三把 LocalSend 接进自动化脚本里5.1 先摸清它的通信方式前面讲的都是图形界面的玩法对技术用户来说LocalSend 还有一层玩法是直接调它的 HTTP 接口。因为它走的是标准的 HTTPS 协议端口 53317路径前缀是/api/localsend/v2/你可以用 curl、Python 或者任何 HTTP 客户端跟它对话。这个特性让它具备了被脚本化的可能——你可以写一个定时任务把某个目录里新生成的文件自动推给指定设备或者把 UOS 上剪贴板的内容通过命令行直接发出去。需要先说明这一层玩法依赖的是项目公开的协议行为不同版本之间接口可能有细微差异动手之前建议先在自己的设备上小范围验证一次确认路径和字段都能对上再写进正式脚本。下面的示例都是我在本地验证过能跑通的思路整理。5.2 一个最小可用的发送脚本最基础的流程分两步先向目标设备发起一次“准备上传”的请求拿到会话 ID 和文件令牌再用这个令牌把实际内容 POST 过去。第一步的请求体大概长这样curl -sk -X POST https://192.168.1.20:53317/api/localsend/v2/prepare-upload \ -H Content-Type: application/json \ -d { info: { alias: UOS-Workstation, version: 2.1, deviceModel: PC, deviceType: desktop, fingerprint: your-device-fingerprint, port: 53317, protocol: https, download: false }, files: { clip: { id: clip, fileName: clip.txt, size: 24, fileType: text/plain } } }-k是为了跳过自签名证书的校验本地局域网里用可以接受如果在意安全性可以把 LocalSend 的证书导出之后用--cacert指定。响应里会返回一个sessionId和一个针对clip这个文件的token把它们留好进入第二步curl -sk -X POST https://192.168.1.20:53317/api/localsend/v2/send?sessionIdSESSION_IDfileIdcliptokenFILE_TOKEN \ -H Content-Type: application/octet-stream \ --data-binary clip.txt实际运行时接收端会弹出一个接收确认除非该设备已被标记为可信确认之后文件就落在对方的下载目录里。理解了这个流程你就等于拿到了 LocalSend 的命令行入口。5.3 几个能立刻落地的自动化场景场景一剪贴板快发。在 UOS 上写一个 shell 函数把xclip -o拿到的剪贴板内容写进临时文件然后调上面的脚本发到手机。绑定一个快捷键以后选中一段内容按下快捷键就发到手机比切窗口点按钮快得多。场景二目录监控。用inotifywait监控某个目录一旦有新文件落进来就自动推送到指定设备。适合做扫描仪、截图目录、下载目录的自动分发。场景三定时备份推送。写一个 cron 任务每天固定时间把 UOS 上某个工作目录打包压缩后通过 LocalSend 推送到家里的另一台设备或者手机上做成一套不依赖外网、不依赖云服务的本地备份链路。场景四批量配置分发。在有多台 UOS 设备的办公环境里把一份统一的配置文件、一个内部工具包通过脚本一次性推给所有在线的目标设备省去人工逐台拷贝。6. 常见问题与排查技巧实录6.1 设备列表里看不到对方怎么办这是最高频的问题我把排查顺序整理成一张表按这个顺序走基本能定位到位。现象可能原因排查动作完全看不到任何设备不在同一网段对比两台设备的 IP 前三段是否一致部分设备互相看不到AP 隔离/多播被拦检查路由器是否开启客户端隔离或关掉隔离重试UOS 上看不到手机手机能看到 UOS防火墙挡了 UDPsudo ufw allow 53317/udp后重启应用之前能看到突然看不到了网络切换或缓存重启 LocalSend或手动输入对方 IP 添加所有设备都看不到应用未启动或端口被占ss -tulnp手动添加设备的方式是点设备列表旁边的“手动输入地址”填ip:53317就能直连绕开 mDNS。这个技巧在 mDNS 不可靠的企业网络里几乎是救命稻草。6.2 传了一半断掉或者速度上不去速度问题的核心就一句它跑的是内网速度慢说明内网本身慢或者走了错误路径。先确认两台设备是不是连在同一个路由器下如果一台走 WiFi 一台走网线速度会被 WiFi 那一侧拖慢。5G WiFi 实际跑到几十兆每秒是正常的2.4G 会更低千兆有线之间跑满百兆每秒以上也很常见。如果传输中途断开常见原因有三个一是接收端切到了后台被系统限制手机端尤其明显要在设置里允许后台运行二是大文件传输时路由器或者某些安全软件做了流量整形三是传输目录所在磁盘空间不足或者权限有问题。逐个排除即可。6.3 UOS 上遇到的几个具体坑AppImage 启动报 FUSE 错误。这是缺依赖装上libfuse2就好命令是sudo apt install libfuse2。deb 安装时提示来源不受信任。UOS 的安全策略比较严需要在系统设置的“通用”里打开“开发者模式”或者允许未知来源装完可以再关回去。桌面图标不显示或者启动无反应。多半是 .desktop 文件里的路径写错了检查Exec那一行指向的可执行文件是否存在、是否有执行权限。AppImage 方式安装的记得先chmod x。接收目录权限异常。如果目标目录是外挂的 NTFS 或者 exFAT 分区写入时可能因为权限或者挂载选项出问题换成用户目录下的普通路径先验证一下。6.4 常见问题速查提示所有排查都建议先做一件事——把两台设备的 LocalSend 都重启一次。很多“找不到设备”的问题在重启后就没了因为 mDNS 缓存在某些网络环境下会失效重启会强制重新广播。设备名重复导致认错设备去设置里把别名改成有辨识度的名字。收到文件找不到在哪检查设置里的下载目录默认在系统下载文件夹。手机端收不到后台通知在系统设置里把 LocalSend 加入“允许后台活动”和“允许自启动”名单。传输速度忽高忽低关掉路由器上的 QoS 或者智能限速功能再试。多设备同时发送时某台始终失败检查那台设备是否处于休眠状态或者它的防火墙规则是不是最严。三个我踩过的坑值得单独说。第一个是宽带路由器在开了“访客网络”之后主机和访客网络之间会被完全隔离看起来都连着同一个 WiFi实际是两个独立子网这种情况只能把设备都连到主网络。第二个是某些企业安全软件会拦截未知的 HTTPS 服务端口53317 这种非标准端口首当其冲遇到这种情况需要把 LocalSend 加入白名单或者找 IT 协调放行。第三个是手机的省电策略安卓阵营各家的后台管理越来越激进LocalSend 被冻结之后即使前台显示在线接收也会失败这个要在手机的电池设置里针对性放行。这套东西用熟了之后我在 UOS 上的日常流程基本就固定下来了手机上复制的东西直接 LocalSend 推过来临时文件在几台设备间随手转发需要批量分发的场景写个小脚本让它自己跑。它没有华丽的界面也没有云同步那种“什么都能做”的野心但正因为只做局域网直连这一件事用起来反而比那些大而全的工具轻松。后续我还在琢磨把它和 UOS 的文件管理器右键菜单集成一下选中文件就能一键发出去等时机成熟了再整理出来。