ClipVault 一个开源局域网剪贴板同步工具 支持 Windows 和 Android 复制即同步

0 阅读3分钟

大家好最近我做了一个开源项目 ClipVault,解决了不同设备间粘贴板不通用的问题。

项目目前支持

windows -> windows

windows -> android

android -> android

苹果端正在努力开发中......

项目地址:

github.com/13131633633…

Release 下载:

github.com/13131633633…

如果你喜欢这个项目就请给我点个star吧

求求了ヾ(≧▽≦*)o

ps:新人作者有些地方做的不好谅解一下

它是做什么的?

ClipVault 是一个局域网剪贴板同步工具。

核心目标很简单:

在同一个 Wi-Fi / 局域网下,Windows 和 Android 之间复制文本、图片后,自动同步到对方的系统剪贴板。

不走公网,不需要服务器,不需要端口映射,也不需要把剪贴内容传到第三方云端。

目前支持什么?

当前版本已经实现:

  • Windows 桌面端
  • Android 客户端
  • 局域网二维码配对
  • 6 位配对码连接
  • 文本同步
  • PNG 图片同步
  • 本地历史记录
  • 设备管理
  • Windows 托盘常驻
  • Android 高级后台同步
  • Android 无线调试 / USB ADB 辅助后台读取剪贴板

为什么想做这个?

我自己平时经常遇到这种场景:

  • 电脑上复制一段文字,想立刻发到手机
  • 手机上复制验证码、链接、地址,想直接到电脑用
  • 不想每次都打开微信、QQ、文件传输助手
  • 不想把剪贴板内容传到公网服务
  • 不想用“应用内剪贴板”,而是希望直接写入系统剪贴板

所以 ClipVault 的设计目标不是再做一个单独的粘贴板列表,而是尽量做到:

复制以后,对方设备可以直接粘贴。

配对方式

目前有两种连接方式:

1. 二维码配对

电脑端或手机端生成二维码,另一台设备扫码后自动建立局域网连接。

二维码里包含设备 IP、端口、设备标识和校验信息,适合手机和电脑之间快速连接。

2. 6 位配对码

适合电脑和电脑之间,或者不方便扫码的时候使用。

配对码不是纯随机数,而是结合局域网 IP 最后一段和会话校验码生成,方便在同一网段内快速定位设备。

Android 后台同步

Android 10 以后,系统限制了后台读取剪贴板。

所以 ClipVault 做了一个高级后台同步方案:

  • 前台服务保持同步进程
  • 首次通过无线调试或 USB ADB 授权
  • 授权后通过 ADB 辅助读取系统剪贴板
  • 后续启动时会自动尝试回连

如果手机 ROM 杀后台比较严重,也建议手动打开:

  • 通知权限
  • 自启动
  • 电池优化白名单
  • 后台运行权限
  • 精确闹钟
  • 悬浮窗权限

技术栈

项目不是单一平台的原生项目,而是一个跨端工程:

  • Windows / Linux 桌面端:Electron + Node.js + React
  • Android:Capacitor + React UI + Kotlin
  • iOS:Capacitor + React UI + Swift

目前主要完善的是 Windows 和 Android。

下载体验

GitHub Release:

github.com/13131633633…

里面已经放了:

  • Windows 安装包
  • Windows 免安装版
  • Android APK

项目地址

github.com/13131633633…

项目刚开源,肯定还有很多地方可以继续优化,比如:

  • 更多 Android ROM 的后台稳定性适配
  • Linux / iOS 端完善
  • 更漂亮的演示图和文档
  • 自动化 Release 打包
  • 更多剪贴板格式支持

如果你也有类似需求,欢迎试试。

也欢迎提 issue、PR 或建议。