在日常开发中，很多人都会同时使用两台设备。
比如：
- Mac 用来写代码
- Windows 用来测试软件
- 台式机负责主力开发
- 笔记本负责资料整理
- 一台电脑复制链接，另一台电脑需要立即使用
这时最常见的麻烦不是大文件传输，而是一些很小但频繁的内容流转。
例如：
复制一段代码 复制一个接口地址 复制一条 SQL 复制一个验证码 复制一张截图 复制一段临时笔记如果每次都通过微信、文件助手、网盘、邮件或者聊天软件转发，会显得很重。
lanclip 这个开源项目解决的就是这个问题：在局域网内，让 macOS 和 Windows 之间快速同步剪切板内容。
项目地址：
https://github.com/MageGojo/lanclip/tree/main
一、项目背景
lanclip 是一个免费开源的局域网剪切板管理器，面向 macOS 和 Windows 用户。
它的核心目标是：
让可信设备之间通过局域网同步剪切板内容和云同步剪切板工具不同，lanclip 更强调：
- 本地优先
- 局域网优先
- 不依赖云端账号
- 可信设备配对
- 轻量常驻
- 支持文本和图片
- 适合开发者多设备办公
对于经常在 Mac 和 Windows 之间切换的用户来说，这类工具可以明显减少复制、粘贴、转发、找回内容的成本。
二、项目核心功能
根据项目说明，lanclip 主要提供以下能力。
1. 剪切板历史
工具会监听本机剪切板变化，把文本、链接、图片和文件引用等内容写入本地历史。
用户可以通过菜单栏或托盘面板快速搜索历史内容。
常见使用场景：
刚复制过的接口地址找不到了 刚才复制的验证码被覆盖了 复制过的 SQL 想重新使用 临时保存的链接需要再次打开这类场景用剪切板历史会非常方便。
2. 局域网文本同步
lanclip 支持在同一局域网内同步文本剪切板。
比如：
Mac 复制一段代码 ↓ Windows 上可以直接粘贴或者：
Windows 复制接口地址 ↓ Mac 上可以直接使用这对开发者非常实用，尤其是跨系统测试、接口调试、资料整理等场景。
3. 图片同步与预览
项目支持 PNG 图片历史和 hover 预览。
这意味着用户不仅可以同步文本，还能处理截图、临时图片等内容。
例如：
Windows 截图 ↓ Mac 查看并再次复制对于写文档、做测试反馈、整理素材的用户来说，图片剪切板同步比手动保存文件再发送要轻很多。
4. 可信设备配对
lanclip 不是发现设备后就直接同步。
它采用可信设备配对机制：
发现设备 ↓ 设备列表展示 ↓ 用户确认配对 ↓ 写入 trusted peers ↓ 开始同步剪切板这个设计很重要。
因为剪切板里可能包含：
- 账号
- 验证码
- 临时密码
- 接口 token
- 内部链接
- 代码片段
- 图片资料
如果局域网内任意设备都能自动同步，风险会非常高。通过手动配对，可以让同步只发生在可信设备之间。
5. 全局快捷键
项目支持全局快捷键打开剪切板历史面板。
项目说明中提到默认快捷键包括：
macOS：Command + V Windows：Ctrl + Shift + V全局快捷键能让剪切板历史工具更接近日常操作习惯。
对于高频使用场景来说，鼠标点托盘不如快捷键快。
6. GPUI 原生控制台
lanclip 提供 GPUI 原生控制台，用于管理：
- 设备配对
- 同步开关
- 历史摘要
- 开机自启
- 快捷键
- 传输状态
- 中英文切换
这说明项目不只是一个后台同步服务，还提供了完整的桌面端管理界面。
三、适合哪些用户
lanclip 的适用人群比较明确。
| 用户类型 | 使用价值 |
|---|---|
| Mac + Windows 双设备用户 | 在两台电脑之间快速同步文本和图片 |
| 开发者 | 快速流转代码片段、命令、接口地址、JSON |
| 测试人员 | 跨设备复制测试数据、验证码、截图 |
| 写作者 | 在不同设备间同步临时文案和素材 |
| 运维人员 | 复制命令、IP、配置片段更方便 |
| Rust 学习者 | 学习桌面应用、网络同步和模块化设计 |
| 隐私敏感用户 | 不想把剪切板内容上传到云端 |
如果你只用一台电脑，lanclip 可以作为剪切板历史工具。
如果你同时使用 Mac 和 Windows，它的局域网同步能力会更有价值。
四、技术栈分析
lanclip 使用 Rust 构建，项目技术栈比较完整。
根据仓库说明，核心技术包括：
| 技术 | 作用 |
|---|---|
| Rust | 核心开发语言 |
| GPUI / gpui-component | 原生控制台界面 |
| tao / wry | 菜单栏面板与桌面 UI 支撑 |
| tokio | 异步运行时 |
| tokio-tungstenite | WebSocket 网络通信 |
| mdns-sd | 局域网设备发现 |
| clipboard-rs | 剪切板监听与读写 |
| serde / serde_json | 数据序列化 |
| tracing | 日志记录 |
| GitHub Actions | 自动构建发布 |
这个技术组合比较适合桌面端网络工具：
Rust 负责性能和稳定性 tokio 负责异步任务 mDNS 负责局域网发现 WebSocket 负责设备通信 clipboard-rs 负责剪切板操作 GPUI 负责控制台界面从技术学习角度看，lanclip 适合用来研究 Rust 桌面应用、局域网发现、剪切板监听和跨设备同步。
五、项目模块结构
项目采用 Rust workspace 组织，模块划分比较清晰。
仓库中的 crates 目录包含多个子模块：
crates/ ├── lanclip-domain ├── lanclip-proto ├── lanclip-discovery ├── lanclip-network ├── lanclip-clipboard ├── lanclip-transfer ├── lanclip-app └── lanclip-ui可以按职责理解：
| 模块 | 作用 |
|---|---|
| lanclip-domain | 核心模型与剪切板 payload |
| lanclip-proto | 消息枚举与 JSON 编解码 |
| lanclip-discovery | mDNS 设备发现 |
| lanclip-network | WebSocket 与连接池 |
| lanclip-clipboard | 剪切板监听与防回环 |
| lanclip-transfer | 文件传输相关能力 |
| lanclip-app | 服务编排、配置、历史 |
| lanclip-ui | 菜单栏应用、WebPanel、GPUI 控制台 |
这种拆分方式适合中大型 Rust 桌面应用。
好处是：
- 业务模型和 UI 解耦
- 网络层和剪切板层解耦
- 协议层单独维护
- 方便单独测试核心模块
- 后续扩展文件传输更清晰
六、工作原理
lanclip 的整体工作流程可以拆成几个阶段。
1. 监听本机剪切板
应用启动后，会常驻系统菜单栏或托盘，并监听剪切板变化。
当用户复制文本、图片或文件引用时，系统会捕获变更，并写入本地历史记录。
流程如下：
用户复制内容 ↓ 剪切板监听模块捕获变化 ↓ 生成剪切板 payload ↓ 写入本地历史 ↓ 刷新历史面板2. 发现局域网设备
局域网同步开启后，应用会通过 mDNS 发现附近设备。
mDNS 的好处是适合局域网自动发现，不需要用户手动输入 IP。
流程如下：
设备 A 启动 lanclip 设备 B 启动 lanclip ↓ mDNS 广播和发现 ↓ 双方在设备列表中出现3. 建立可信配对
发现设备不等于立即同步。
用户需要在控制台中确认配对。
配对成功后，设备会写入 trusted peers。
流程如下：
发现新设备 ↓ 显示确认信息 ↓ 用户手动确认 ↓ 写入可信设备列表4. 通过 WebSocket 同步内容
可信设备之间建立连接后，会通过 WebSocket 传输剪切板 payload。
流程如下：
本机剪切板变化 ↓ 生成同步消息 ↓ 发送给可信设备 ↓ 远端接收消息 ↓ 写入远端剪切板或历史这里需要处理一个关键问题：防回环。
如果 A 同步给 B，B 写入剪切板后又触发监听，再同步回 A，就会形成循环。
因此剪切板模块通常需要识别“本地用户复制”和“同步写入”的差异，避免重复同步。
七、安装和使用
项目提供 macOS 和 Windows 安装包。
根据项目说明，支持的安装包包括：
macOS Apple Silicon：lanclip-macos-apple-silicon.dmg macOS Intel：lanclip-macos-intel.dmg Windows x64：lanclip-windows-x64-installer.exe使用流程大致如下：
下载对应平台安装包 ↓ 安装并启动 lanclip ↓ 应用常驻菜单栏或系统托盘 ↓ 点击图标或使用快捷键打开剪切板历史 ↓ 在控制台中管理设备配对和同步设置macOS 首次运行未签名构建时，可能需要在系统设置中允许打开，或通过右键打开。
八、开发环境运行
如果想从源码运行，可以使用 Cargo。
开发运行命令：
cargorun-planclip-ui--binlanclip代码格式检查：
cargofmt--all--check编译检查：
cargocheck-planclip-ui--bins测试命令：
cargotest-planclip-app-planclip-uiRelease 构建：
cargobuild--release-planclip-ui--binsmacOS 本地打包 DMG：
packaging/macos/create_dmg.sh aarch64-apple-darwin dist/lanclip-macos-apple-silicon.dmg这些命令比较适合想学习 Rust 桌面应用打包流程的开发者。
九、和常见剪切板工具的区别
常见剪切板工具有 Maccy、Ditto、CopyQ 等。
这些工具都很优秀，但侧重点不同。
| 工具 | 常见重点 | lanclip 的侧重点 |
|---|---|---|
| Maccy | macOS 剪切板历史 | 同时关注 macOS / Windows 和局域网同步 |
| Ditto | Windows 剪切板管理 | 提供 Mac 与 Windows 跨设备同步场景 |
| CopyQ | 高级剪切板管理、规则和脚本 | 更强调轻量、本地优先和可信设备同步 |
| 云剪切板工具 | 跨网络同步和账号体系 | 不依赖云端剪切板服务 |
lanclip 的定位可以概括为：
轻量剪切板历史 + 局域网同步 + Mac/Windows 跨设备 + 可信配对它不是要替代所有高级剪切板工具，而是聚焦在多设备局域网办公这个场景。
十、项目安全设计
剪切板工具一定要重视安全。
因为剪切板内容经常包含敏感信息。
例如：
验证码 登录链接 临时密码 API Key JWT Token 数据库连接片段 内部接口地址 截图内容lanclip 在设计上有几个安全点值得关注。
1. 本地优先
项目强调局域网同步，不依赖云端剪切板服务。
这意味着临时剪切板内容不需要上传到第三方云端。
2. 可信设备配对
设备发现后不会自动同步，必须经过确认配对。
这可以降低局域网内陌生设备误同步的风险。
3. 同步范围可控
用户可以在控制台管理设备、同步开关和历史摘要。
对于剪切板工具来说，可见、可控、可关闭非常重要。
4. 仍需注意使用边界
即使是局域网同步，也不能完全忽略风险。
建议使用时注意：
- 不要在不可信 Wi-Fi 环境下开启同步
- 敏感信息复制后及时清理
- 定期检查 trusted peers
- 办公环境中谨慎同步密码、token 等内容
- 不使用时可以关闭同步功能
十一、适合学习的技术点
lanclip 不只是一个工具，也适合作为 Rust 项目学习案例。
可以重点学习这些方向。
1. Rust workspace 组织方式
项目把 domain、proto、discovery、network、clipboard、app、ui 分成多个 crate。
这种结构适合学习 Rust 多模块工程拆分。
2. mDNS 局域网发现
通过 mDNS 自动发现局域网设备，不需要手动输入 IP。
这类能力适合很多局域网工具：
- 局域网文件传输
- 局域网投屏
- 本地协作工具
- 内网设备发现
- 开发调试工具
3. WebSocket 长连接同步
WebSocket 适合做设备之间的实时消息传输。
剪切板变化、设备状态、同步结果都可以通过消息协议传递。
4. 剪切板监听与防回环
剪切板同步不是简单地读写内容，还要处理重复触发和循环同步。
这是桌面应用中非常实用的一个技术点。
5. 桌面端打包发布
项目提供 macOS DMG 和 Windows EXE 安装器，并通过 GitHub Actions 自动构建发布。
这对学习跨平台桌面应用发布很有参考价值。
十二、可以如何二次开发
如果想基于 lanclip 学习或扩展，可以考虑以下方向。
1. 增加更多剪切板类型
除了文本和图片，可以继续完善：
- 文件真实传输
- 富文本
- HTML 片段
- Markdown 片段
- 代码片段分类
2. 增加分组和标签
剪切板历史可以增加：
- 收藏
- 标签
- 置顶
- 分组
- 搜索过滤
适合高频复制代码片段的开发者。
3. 增加加密传输
局域网环境下也可以考虑端到端加密。
可信设备配对后，后续 payload 使用密钥加密传输，会更安全。
4. 增加同步规则
比如：
不同步包含 password 的文本 不同步超过指定长度的内容 不同步图片 只同步收藏内容 只同步特定设备这样更适合企业或团队内部使用。
5. 增加移动端支持
后续如果支持移动端，可以扩展为：
- Mac ↔ iPhone
- Windows ↔ Android
- 局域网手机传文本
- 手机扫码配对
不过移动端剪切板权限限制更多，需要单独设计。
十三、实际使用建议
如果你准备用 lanclip 做日常工具，可以这样配置。
1. 先只开启历史功能
先把它当作剪切板历史工具使用，确认稳定后再开启局域网同步。
2. 只配对自己的设备
不要在公共网络环境中随便配对未知设备。
3. 给设备起清晰名称
比如：
MacBook-Pro Windows-PC Office-Desktop方便在控制台中识别。
4. 对敏感内容保持谨慎
复制密码、token、密钥后，建议及时清理历史。
5. 开发者可以关注源码结构
如果你是 Rust 开发者，可以重点看 crates 目录下各模块的职责划分。
十四、适合写进简历或项目经验吗
如果你参与了类似项目，或者基于 lanclip 做了二次开发，这类项目是适合写进简历的。
可以提炼成：
基于 Rust 实现跨平台剪切板管理工具，支持 macOS / Windows，使用 mDNS 进行局域网设备发现，通过 WebSocket 在可信设备之间同步剪切板内容，提供剪切板历史搜索、图片预览、设备配对和自动打包发布能力。技术关键词包括：
- Rust 桌面应用
- 跨平台开发
- mDNS 设备发现
- WebSocket 实时同步
- 剪切板监听
- GPUI 原生界面
- GitHub Actions 自动构建
- macOS / Windows 打包
这些关键词比普通 CRUD 项目更有辨识度。
十五、总结
lanclip 是一个很适合开发者使用和学习的开源项目。
从使用角度看，它解决的是多设备办公中的高频小痛点：
剪切板历史找回 Mac 和 Windows 之间复制粘贴 局域网内同步文本和图片 避免依赖云端剪切板账号从技术角度看，它覆盖了 Rust 桌面应用中很多有价值的模块：
workspace 工程拆分 剪切板监听 mDNS 局域网发现 WebSocket 同步 可信设备配对 GPUI 控制台 跨平台安装包构建如果你同时使用 Mac 和 Windows，lanclip 可以作为一个轻量的局域网剪切板同步工具。
如果你正在学习 Rust 桌面开发，它也很适合作为源码阅读和二次开发参考。
项目地址：
https://github.com/MageGojo/lanclip/tree/main
