
crosspaste-desktop
局域网内多设备剪贴板秒同步,端到端加密不走云
Crosspaste Desktop 是一款跨平台剪贴板同步工具,支持 macOS、Windows 和 Linux,用 Kotlin 与 Compose Desktop 构建。它解决多设备间复制粘贴内容无法互通的问题:在同一局域网内自动发现设备并同步剪贴板历史,全程端到端加密,不经过任何云端服务器,数据不出本地网络。核心能力包括剪贴板历史记录管理、跨设备实时同步、内置 OCR 识别图片文字、命令行工具以及 MCP 服务器,方便接入 AI 助手工作流。相比依赖云端的同步方案,它更注重隐私与低延迟,适合对数据安全敏感、又有多台电脑协同需求的用户。
项目数据
使用教程
环境要求
- 能够访问 GitHub 与 Gradle 依赖仓库的网络环境
- 已安装 Git
- 首次运行需下载 JBR(JetBrains Runtime)与 Gradle 依赖,耗时较长、需要稳定网络
- 若网络受限,需要 VPN 或为 Gradle 配置代理
安装与启动步骤
-
1下载安装包
普通用户无需编译源码,可直接从官网下载对应平台的安装包使用。
-
2克隆仓库
源码方式部署的第一步,把 crosspaste-desktop 仓库克隆到本地。
git clone https://github.com/CrossPaste/crosspaste-desktop.git -
3进入项目目录
切换到刚克隆下来的仓库目录,后续命令都在这里执行。
cd crosspaste-desktop -
4编译并运行
使用 Gradle Wrapper 启动桌面应用,首次启动会自动下载 JBR 与依赖,请耐心等待。
./gradlew app:run -
5配置 Gradle 代理
若构建报 Connection reset,可在 gradle.properties 中按 README 示例添加代理参数。
systemProp.https.proxyHost=localhost systemProp.https.proxyPort=8080 systemProp.https.proxyUser=userid systemProp.https.proxyPassword=password systemProp.http.nonProxyHosts=*.nonproxyrepos.com|localhost
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
systemProp.https.proxyHost | 否 | HTTPS 代理主机地址,网络受限时使用 | localhost |
systemProp.https.proxyPort | 否 | HTTPS 代理端口 | 8080 |
systemProp.https.proxyUser | 否 | 代理认证用户名(如代理需要认证) | userid |
systemProp.https.proxyPassword | 否 | 代理认证密码(如代理需要认证) | password |
systemProp.http.nonProxyHosts | 否 | 不走代理的主机列表 | *.nonproxyrepos.com|localhost |
如何确认成功
执行 ./gradlew app:run 后构建无报错、应用窗口正常弹出并可使用剪贴板功能即成功。
常见问题
Q:构建时报 java.net.SocketException: Connection reset 怎么办?
A:这是依赖下载被中断导致的,README 说明可能需要使用 VPN,或在 gradle.properties 中按示例配置 Gradle 代理后再重试。
Q:首次运行为什么特别慢?
A:首次启动会下载 JBR(JetBrains Runtime)和 Gradle 依赖,属于正常现象,保持网络稳定等待完成即可。
Q:普通用户必须自己编译吗?
A:不必。README 提供了官网下载入口,可到 https://crosspaste.com/en/download 下载对应平台安装包直接使用。
Q:同步的剪贴板数据会经过云端吗?
A:不会。项目在同一局域网内自动发现设备并同步,全程端到端加密,数据不经过任何云端服务器。
注意事项
- README 节选只包含从源码开发运行的说明,未给出 Docker、命令行工具或 MCP 服务器的具体安装命令。
- 多设备同步需处于同一局域网,且各设备均安装并运行 CrossPaste。
- 代理示例中的 host、port、userid、password 需替换为你自己的代理配置。
- 如需了解架构细节,可阅读官网博客系列文章。
核心亮点
- 局域网直连同步,端到端加密,剪贴板内容不经过任何云服务器
- 内置 OCR 与 CLI、MCP 服务器,可被 AI 助手和脚本直接调用
- 基于 Compose Desktop 实现三平台统一 UI,剪贴板历史可检索管理
不足之处
- 仅限局域网内使用,跨网络或远程办公场景无法同步
- 项目较新,长期稳定性与多设备兼容性仍需更多验证
适用场景
- 办公室多台电脑之间复制粘贴文本、链接和代码片段
- 把手机或平板截图发到电脑后,用 OCR 提取文字继续编辑
- 通过 MCP 让 AI 助手直接读取剪贴板内容并处理
替代项目
KDE Connect、LocalSend、Clipboard Sync
项目介绍
同类项目推荐
sunshine-control-panel
开源
一站式管理游戏库、监控内存,AI 助手加持,让大屏启动更高效。
Sunshine Foundation 大屏桌面管理器 | Tauri + Vue 3,游戏库管理、米塔AI助手、内存监控···
Stirling PDF
开源
本地部署 PDF 工具箱
#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere
obsidian-md2wechat
开源
一键将 Obsidian 笔记排版成公众号文章,告别手动调格式
Obsidian → WeChat | Obsidian 插件一键排版发布到微信公众号,键排版发布到微信公众号:···
pdf2md
开源
浏览器里直接把 PDF 变成 Markdown,不用上传,隐私安全。
Browser based tool to convert PDFs to Markdown