Nas部署跨端剪贴板同步工具:ClipCascade - 实现在电脑上Ctrl+C,在手机上Ctrl+V


- • 项目简介:
ClipCascade
我们经常需要在手机、电脑甚至平板之间快速共享剪贴板内容,比如复制一段文字、图片或链接
正好ClipCascade就是这么一款轻量级、跨平台的剪贴板同步工具,支持自托管和端到端加密,让你轻松实现设备间无缝同步,同时守护数据隐私
多端支持:win、android、MacOS、Linux;(iOS正在开发中)
- • 项目源码:
https://github.com/Sathvik-Rao/ClipCascade

一、ClipCascade是什么?基本介绍
ClipCascade 是一个轻量级、开源的跨设备剪贴板同步工具,由开发者Sathvik Rao(GitHub:@Sathvik-Rao)基于Python和TypeScript开发,采用MIT许可证。它通过WebSocket(ws/wss)实现实时剪贴板广播,支持Windows、macOS、Linux和Android平台,最新版本(v3.0.0,2025年2月)还引入了多用户支持和P2P同步模式。ClipCascade主打无需手动触发的自动同步,用户复制内容后,其他设备立即同步,操作流畅。截至2025年4月,项目已获超600个GitHub星标,在r/selfhosted社区广受好评。
ClipCascade推荐通过Docker部署服务器(docker pull sathvikrao/clipcascade),客户端则提供多种安装方式,包括Windows的MSI/EXE、macOS的ZIP、Linux的TAR.XZ和Android的APK。用户需配置服务器地址(IP或域名)和凭据,默认用户名为user,密码为pass123(建议立即更改)。项目支持端到端加密,所有数据在客户端加密后传输,服务器仅负责中转或信令,保障隐私。
二、ClipCascade的核心特点与优势
1. 跨平台无缝同步
ClipCascade支持Windows、macOS、Linux和Android,覆盖主流设备。用户复制文字、图片或文件后,内容通过WebSocket实时广播到其他设备,无需按键触发。最新版本(v1.3.0起)支持图像和文件传输,Android客户端优化了非Root设备的自动监控,桌面端支持大容量剪贴板(可通过“Extra Config”设置上限)。
2. 自托管与端到端加密
ClipCascade提供自托管选项,通过Docker Compose部署:
services:
clipcascade:
## 这时我已经替换了镜像加速地址
image:docker.1ms.run/sathvikrao/clipcascade
container_name:clipcascade
ports:
-"8080:8080"
environment:
-CC_MAX_MESSAGE_SIZE_IN_MiB=1
volumes:
- ./data:/database所有数据通过端到端加密保护,服务器无法访问明文内容。v2.0.0新增增强加密标准(更新哈希函数)和自定义加密盐,安全性更高。用户可通过29个环境变量(如CC_ALLOWED_ORIGINS)配置CORS策略或消息大小,灵活性强。
3. 双模同步:P2S与P2P
ClipCascade支持两种同步模式:
-
• Peer-to-Server(P2S) :默认模式,客户端通过服务器中转数据,适合稳定网络环境。
-
• Peer-to-Peer(P2P) :通过CC_P2P_ENABLED=true启用,客户端直接通信,服务器仅用于信令,提升速度并降低服务器负载。P2P模式需用户允许网络访问(Windows会提示)。 P2P模式尤其适合局域网内同步,减少延迟。
4. 多用户支持与健康检查
v2.0.0引入多用户功能,服务器支持多个账户(通过CC_ALLOW_USER_REGISTRATION=true启用注册),适合团队或家庭共享。新增健康检查端点(Health Check Endpoint)便于监控服务器状态。用户可通过Web界面(http://localhost:8080)查看剪贴板历史,实时管理同步内容。
5. 轻量与易用
ClipCascade服务器基于轻量级Node:22-alpine镜像,资源占用低,适合Raspberry Pi或VPS部署。客户端安装简单,内置更新检查功能(v1.0.0起),无需卸载旧版即可覆盖升级,保留登录信息。v1.0.0优化了macOS集成(通知、剪贴板访问),v1.1.0为Wayland/Hyperland Linux添加了轮询模式,确保兼容性。
6. 社区驱动与活跃开发
ClipCascade的开发者积极响应社区反馈,GitHub Discussions活跃,近期讨论包括iOS支持(#25)和OIDC/OAuth集成(计划中)。v3.0.0新增29个环境变量和预定义YAML文件,优化配置体验。开源代码(Python/TypeScript)透明,欢迎贡献者提交功能请求或PR。
三、总结与展望
ClipCascade以其轻量、隐私优先和跨平台特性,成为剪贴板同步领域的优秀开源项目。它的自托管选项、端到端加密和双模同步满足了从普通用户到技术极客的多样需求。Docker部署和直观的客户端让上手毫无门槛,而多用户支持和P2P模式为团队协作和低延迟场景增添了亮点。
快部署ClipCascade吧!让剪贴板同步更高效,隐私更有保障!
最后
-
• 目前项目为起步阶段(已经支持那么多端、确实不容易),更新很频繁,可以持续关注
-
• 体验上和之前介绍过的SyncClipboard大同小异
兴趣推荐
免翻上TG、X、WhatsApp、非死不可等10数个老外社交平台 - Beeper
docker新玩具:极客风的docker管理工具 - 大预言家Isaiah
docker部署一款开源的【价值百万】的人财务管理系统 - maybe
Nas搭建一个纯静态、支持SEO、内置收录多达 800+ 优质网站的强大导航系统 - Nav
又可以用Nas来摸鱼了 - docker部署一套文字修仙游戏,这位道友,我授你绝世功法。