夜雨聆风学习资料网

ARTICLE · 1360312

不写手机 App,我让别人的 App 直接给我的软件传文件

不写手机 App,我让别人的 App 直接给我的软件传文件

上篇解决了手机扫码免装接入,但还有个更刁钻的场景:手机上已经装了 LocalSend 的人,凭什么再扫一次码?这篇讲我们怎么让 LocalSend 直接认 dt-chat 当同类设备。

先交个底。

手机接入内网 IM,上篇的答案是内嵌网页——完整聊天没问题,但浏览器有个先天短板:做不出原生的分享体验。手机相册选张照片、点分享、选目标 App,这条路浏览器走不进来。

而现实是:内网用户手机里装 LocalSend 的比例相当高——开源、免费、跨平台,早就是内网传文件的事实标准之一。

让这批人再装一个新 App、再扫一次码?是在跟推广率过不去。

于是思路倒转:不是再造一个手机端,是让 LocalSend 把我们的软件认作同类设备。

LocalSend 有开放协议。照着实现一遍,手机上什么都不用装、什么都不用改——用户看到的就是"我的 LocalSend 里多了一台叫 dt-chat 的设备"。

互通一个开放协议,等于免费继承它的全部装机量。

协议长什么样:出乎意料地朴素

三件套:

发现靠 UDP 组播。固定组播地址,每 25 秒广播一次身份(名字、指纹、设备类型、端口)。听到别人的宣告就记进通讯录,再反向注册一次——两边就都认识对方了。

传输是两步走。发送方先发一份文件清单(名字、大小、哈希),接收方建会话、给每个文件发一张一次性令牌;发送方再拿着令牌逐个推文件。

身份是自签证书。这是整个协议最有意思的部分,单独说。

"不校验证书"?先想通再动手

LocalSend 的加密用自签证书,而且客户端不校验证书链。

第一次实现时我本能地想"加强"一下——至少做个指纹锁定吧?马上意识到行不通:互通协议里,单方面的安全加强,等于互通失败。对面是千千万万个真正的 LocalSend App,它们不会陪我校验任何额外的东西。

想明白对方的威胁模型后就释然了:证书指纹在这里不是安全凭证,是设备标识——它回答"你还是上次那台设备吗",不回答"你是好人吗"。

真正防坏人的闸门在自己这边的接收侧:

令牌三元组校验,发文件必须拿着之前签发的一次性令牌;会话绑定来源地址,别人抢不走你的会话;文件名永远不当路径用,防目录穿越;边收边算哈希,收完对不上直接拒收删除。

把安全做在内容校验上,而不是身份校验上。传输被篡改会当场暴露;伪造身份最多等于"一个陌生设备发来文件",而文件本身过不了哈希校验就不算数。对局域网传文件,这个账是够算的。

还有个细节花了心思:指纹必须跨重启稳定。证书第一次运行时生成,之后存盘复用——否则软件每次重启都变成"新设备",别人手机上的记录全部作废。

一次性令牌:验过即焚,错了不吭声

接收方的会话管理有三个小心思:

令牌用过一次就作废。重放第二次就是无效令牌,直接拒。

报错统一口径。"会话不存在"和"令牌错误"都返回同一个错误码——探测的人拿不到任何信息。

过期不跑定时器。会话十分钟有效,清理动作挂在下一次请求的入口顺手做,不养后台线程。

发送方向:尊重对方手机上的那个确认键

我们往手机发文件,走的是对方 App 的标准流程:清单先发过去,对方手机上弹出确认,点了"接受"才开传。

这里有个反直觉的参数:这个确认请求的超时给了 120 秒。

为什么这么长?因为最慢的环节是人。机器对机器的请求超时习惯是十秒八秒,但"等人在手机上点一下"这个动作,十秒钟根本不够。我们早年就吃过这个亏:文件传输等对方确认,超时设了 15 秒,人工点击经常超时——后来才明白,超时参数要按流程里最慢的那个环节来定,而人永远比机器慢。

两个"认怂"的设计

文件夹不支持,界面明说。协议的传输是单文件粒度,硬造文件夹语义等于发明私有扩展——对面真正的 App 不认识。宁缺毋滥。

和真 LocalSend 共存。桌面版 LocalSend 用户是真实群体,它也占着那个组播端口。我们的策略:端口被占就降级为只广播不监听——手机照样能发现我们、给我们发文件,只是我们不去听别人的宣告。两套软件一台机器各干各的,谁也不用卸载谁。

最重要的决定:互通不许倒灌主协议

比协议实现本身更重要的,是圈地:

LocalSend 设备在侧栏住在独立分区,地址带专属前缀;不进在线表、不参与消息扩散、不走中继——我们主协议的任何消息,它们一概收不到;发送入口按前缀分流到独立函数。

好处是单向的:互通层再怎么改、再怎么升级,主协议一行不动;主协议的路由和在线判定,也永远不会被"一类不说话的设备"干扰。

互通是加法,不是乘法。接一个新生态的复杂度,必须被圈死在它自己的模块里。

复盘

  1. 移动端最短路径,有时是别人的生态。 互通一个开放协议,约等于免费继承它的装机量和用户习惯。自己写 App 是在跟全公司手机的惰性作战,寄生生态是借力打力。
  2. 互通必须尊重对方的信任模型。 单方面加强安全等于互通失败;安全的正确落点在自己的接收侧——内容校验比身份校验在这个场景更对症。
  3. 超时参数按最慢的环节定。 跨人机交互的请求,120 秒不荒谬,10 秒才是 bug。
  4. 旁路设计是互通的护栏。 复杂度圈死在自己的前缀和通讯录里,主协议永远不知道"外面又接了谁"。

项目开源在 Gitee:Rust 写的局域网 IM,单二进制免安装,支持飞鸽协议互通、跨子网自动发现、微信式文件传输、手机扫码免装接入。

项目地址(复制到浏览器打开):

https://gitee.com/zhongyifeng-git-reporter/local-network-chat-tool

做过多端互通的同学应该深有体会,点个在看。下一篇回到协议本身:给运行中的 IM 加新字段,怎么让旧版本对端零感知。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料