ClipCascade
ClipCascade 是跨 Windows、macOS、Linux 和 Android 的开源剪贴板同步工具,支持服务端或 P2P 模式、端到端加密、文字、图片和文件同步以及自托管。
适合做什么
ClipCascade 适合在个人受信设备间自动同步文本、图片与文件,可使用中心服务器转发,也可通过服务端完成认证和信令后建立 P2P 数据通道。它提供 Windows、macOS、Linux、Android 客户端,并能以 Java JAR 或 Docker 自托管多用户服务。
当前版本与部署方式
3.2.0 是 2026-05-04 发布的当前稳定版,改善了睡眠恢复后的 P2P 连接、WebSocket 心跳、Wayland 剪贴板监视和多平台打包。自托管服务默认关闭注册,但仍带有公开文档中的初始管理员凭据,首次上线必须更换。
剪贴板、加密与网络边界
剪贴板经常包含密码、验证码和私人图片,自动同步扩大了接触这些内容的设备数量。端到端加密保护传输正文,不保护已解锁端点;P2P 也不提供匿名性。生产服务要配置 HTTPS/WSS、强数据库密钥、受限 CORS、消息上限、备份和日志管理。项目采用 GPL-3.0。
维护记录
本页于 2026-08-06 根据 ClipCascade 3.2.0 发布资产、官方 README、P2S/P2P 架构、端到端加密、客户端权限和服务端默认配置复核。
选择下载方式
下载前请核对资源版本和授权范围。本站不提供破解软件及未经授权的资料。
ClipCascade 3.2.0 客户端同步与安全自托管教程
下面先用非敏感内容验证两台设备,再说明端到端加密、服务端与 P2P 选择,以及自托管时必须修改的默认凭据和网络边界。
安装前准备
- 准备至少两台受信任设备;剪贴板会自动捕获密码、令牌、截图和文件路径,测试阶段不要登录生产账号。
- 自托管准备 Java 21 或容器环境、HTTPS 域名、持久数据库目录、备份与强管理员密码。
- 确定使用集中服务端还是 P2P;跨公网 P2P 还要评估 STUN、信令、防火墙和对端可见地址。
安装步骤
- 01
选择 3.2.0 对应客户端
Windows 可用 MSI 或便携 EXE,macOS 区分 Intel 与 Apple Silicon,Linux 使用 ZIP 或 TAR.XZ,Android 使用 APK。安装前核对包名和架构。
- 02
建立安全服务端
自托管启动后第一时间更改默认管理员账号密码,关闭不需要的自助注册,限制允许来源,并通过 HTTPS/WSS 反向代理访问,不裸露明文端口。
- 03
统一启用加密配置
所有设备使用相同且足够强的端到端加密配置,先同步一个测试短语。密钥或盐值不要和服务器账号一起发在同一聊天消息中。
快速上手
- 01
限制同步内容和大小
在每台客户端设置合理剪贴板上限,只启用确实需要的文字、图片或文件类型。P2P 会忽略服务器消息大小限制,客户端仍需独立限制。
- 02
验证跨设备同步与清除
复制非敏感测试文本,确认只有同一账号的受信设备收到,再清空两端剪贴板与历史。注销一台设备后验证它不再接收更新。
- 03
处理敏感复制场景
输入密码、API 密钥或恢复码前暂停同步,完成后清除系统剪贴板。客户端被盗、远程控制或记录日志时,端到端加密无法保护已解密内容。
使用建议
- 社区服务器方便试用,但账号、可用性和元数据由运营方控制;高敏感场景优先自托管并审查配置。
- Android 自动监控可能要求额外 ADB 授权和日志读取流程,授予前应理解权限;卸载后需要重新授权。
- Windows 与 macOS 的 P2P 模式会请求网络访问权限,只允许需要的网络范围,不应简单放开所有公共网络。
故障排查与卸载方法
一台设备收不到同步内容怎么办?
核对服务地址、账号、版本、加密开关与密钥配置,再检查 WebSocket、反向代理超时和系统剪贴板权限。不要为排错关闭 TLS 或长期开放注册。
大图片或文件导致客户端卡顿怎么办?
降低本地剪贴板大小上限,关闭不需要的图片和文件同步,先测试小文件。P2P 没有服务端上限时尤其要在每个客户端限制资源消耗。
- 注销设备并撤销访问从账号移除不再使用的设备,轮换端到端加密材料和管理员凭据,并确认旧客户端无法重新建立连接。
- 清理客户端与服务器数据清除各设备剪贴板、缓存和日志后卸载;自托管服务器先备份必要账号配置,再停止服务并按保留要求处理数据库和反向代理日志。
常见问题
端到端加密后服务器就完全可信了吗?
端到端加密可减少服务器读取剪贴板正文的能力,但不能保护已经解锁或受感染的客户端,也不能消除账号、连接元数据、配置错误和弱密钥风险。
自托管后可以直接把 8080 端口开放到公网吗?
不应该。应立即更换默认管理员凭据,通过 HTTPS/WSS 反向代理提供服务,限制注册与 CORS 来源,设置消息大小、数据库密码、备份和日志策略。
P2P 模式比服务端模式更私密吗?
数据通道更直接,但设备需要借助信令和 STUN 建立连接,通信双方可能获得彼此网络信息,防火墙也要允许必要连接。它不是匿名网络。
下载时需要提取码吗?
夸克网盘无需提取码;百度网盘所需的四位提取码会直接显示在下载入口旁。
