Skip to content

sqmw/lan-clipboard

Repository files navigation

LAN Clipboard Logo

lan-clipboard

同一局域网内的 macOS / Windows 共享剪贴板。
Tauri UI · Rust Core · 共享域自动发现

stars release license platform

📖 文档 · 🧰 开发/联调 · 🐛 反馈 · ⭐ Star

🇨🇳 中文 | 🇬🇧 English


🖼️ 界面截图

LAN Clipboard 界面截图

围绕共享域、传输状态与必要配置展开,尽量减少多余操作和视觉噪声。

🎯 设计原则

  • 简洁优先:界面只保留共享域、网络选择、大小限制、传输进度这些真正影响使用的核心信息
  • 高效优先:默认围绕“打开即用、同码入域、复制即同步”设计,而不是让用户理解复杂连接流程
  • 可调试但不打扰:运行日志、进度、成员状态都能看,但默认收纳到合适位置,避免主界面噪声

✨ 特性

  • 共享域模型:同一局域网内填写相同 6 位共享码的设备自动加入同一共享域
  • 共享域防抖:同一内容在共享域内只允许一次有效发送;发送中的重复复制直接丢弃,发送成功后的连续重复复制也会被发送前拦截
  • 自动发现mDNS + UDP 心跳 维护成员缓存;点击“刷新”可立即补充扫描
  • 事件驱动同步:剪贴板变化入队后以 TCP 二进制帧推送到共享域成员
  • 常用类型:文本 / 图片(PNG) / 文件与目录 / 基础富文本(HTML/RTF)
  • 加密传输:可开关,默认使用共享码派生密钥
  • 多网卡支持:可选择本机使用网络,避免虚拟网卡影响发现
  • 调试友好:发送/接收进度、类型与预览展示;日志入口收纳在“高级/日志”

🚀 快速开始(Win + macOS)

  1. 两台设备连接同一局域网并启动应用。
  2. 在两端设置相同的 6 位共享码,点击“保存配置”。
  3. 如遇多网卡/虚拟网卡,先在“使用网络”选择实际局域网 IP,再保存。
  4. 点击“刷新”确认成员列表出现对端设备。
  5. 在任意一端复制文本/图片/文件(目录)或富文本,对端可直接粘贴。

补充说明: 同一个文件或同一份剪贴板内容如果连续复制多次,应用只保证第一次有效同步平稳到达;后续重复复制会被视为共享域内的重复内容并直接丢弃,用来减少回环风险和带宽浪费。

📚 文档入口

  • docs/README.zh-CN.md:文档总入口
  • docs/status.md:当前支持、边界、关键参数(含吞吐说明)
  • docs/dev.md:开发 / 联调 / 排障
  • docs/todo.md:里程碑与待办

⚠️ 当前边界

  • “任何类型”不等于“任意私有剪贴板格式完全等价”;以跨平台支持的格式集合为边界(见 docs/protocol.md
  • 当前版本仍未把局域网传输速度稳定优化到“吃满带宽”;对大文件/大图片高吞吐场景仍需继续优化(见 docs/status.md 的“吞吐说明”)

About

LAN clipboard sync for macOS and Windows with shared-domain discovery, text/image/file transfer, and encrypted local network sync

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors