- 项目简介:
Cloud Clipboard 是一款基于开源技术的跨平台云剪贴板解决方案,核心功能在于消除多设备间复制粘贴操作中的中断体验。通过实时同步剪贴板内容到各个终端,用户可以在智能手机、计算机和平板等多种设备上流畅地共享文字、图像及各类文件。
- 项目源码:
https://github.com/TransparentLC/cloud-clipboard - 快捷体验:
https://try-clipboard.akarin.dev/
手机端体验截图:

电脑端体验截图:

项目概述
该项目旨在提供一个高效的跨设备内容共享工具,避免用户因简单文件传输任务而依赖复杂第三方应用。其设计理念聚焦于提升多平台协作的便捷性。
- 支持纯文本传输并允许一键复制操作
- 具备文件传输能力,用户可通过文件选择、拖拽或Ctrl+V粘贴截图等方式上传,图像文件还会自动生成缩略图预览
- 采用 WebSocket 协议确保实时通知功能
- 前端架构基于 Vue 2 和 Vuetify 组件库开发
工具的基本参数与限制说明:
- 历史记录最多保存 50 条内容
- 文本内容长度限制为 4096 个字符
- 文件上传大小上限为 256 MB,且文件有效期设定为一小时
- 默认情况下,发送内容在局域网内公开可见;如需隐私保护,可启用右上角“房间”功能实现个人隔离
安装指南
虽然官方未直接提供Docker镜像,但社区用户已分享多个预构建版本。不熟悉自编译的用户可选用以下docker-compose配置快速部署:
services:
cloud-clipboard:
# image: cloud-clipboard:latest # 若使用自建镜像,则启用此选项
# image: docker.1ms.run/chenqiyux/lan-clip # 社区镜像版本一,仅兼容x86架构
# image: docker.1ms.run/shuaigekda123/myclip # 社区镜像版本二,支持x86与arm64架构
image: docker.1ms.run/jonnyan404/cloud-clipboard # 社区镜像版本三,兼容x86、arm32及arm64架构
container_name: cloud-clipboard
restart: unless-stopped
ports:
- 9501:9501
偏好自定义构建的用户可参照源码编译方法:
## 获取项目源代码:
git clone https://github.com/TransparentLC/cloud-clipboard.git
## 若网络访问困难,可使用加速命令替代
### git clone https://kkgithub.com/TransparentLC/cloud-clipboard.git
## 构建Docker镜像
cd cloud-clipboard
### 若未配置Docker镜像加速,需修改Dockerfile中的基础镜像行,添加加速地址示例如下:
#### FROM docker.1ms.run/library/node:22.12-alpine3.21 AS builder
#### FROM docker.1ms.run/library/node:22.12-alpine3.21
docker build -t cloud-clipboard:latest .
## 完成后使用前述docker-compose文件启动服务
针对常见镜像拉取问题,已在compose配置中集成加速地址docker.1ms.run以提升下载效率,该地址来源于公开网络资源,可用性无法长期保证。
使用教程
在计算机或移动设备浏览器中访问http://<nas-ip>:9501,当界面右上角网络状态显示“已连接”时,即可开始发送文本、文件与图像内容。
工具界面设计直观简洁,符合国内用户操作习惯,无需复杂学习即可快速上手。
应用场景与扩展功能
- 适用用户群体:
- 数字办公人群:在iPad或手机端收集灵感文案后,直接同步到电脑进行编辑,替代传统微信或QQ文件传输
- 跨平台开发者:在不同操作系统间共享代码片段,优化多环境开发流程
- 教育行业从业者:教师端复制题目解析后,学生设备自动接收内容,助力构建高效数字化课堂
- 家庭共享环境:实现照片、文档在家庭多设备间的便捷流转
- 安全敏感领域:通过自建服务器确保数据内部流通,政府或金融单位可建立专用剪贴板协作网络
- 潜在进阶应用(当前版本暂未支持):
- 集成IFTTT服务,将剪贴板内容自动归档到Notion等知识管理平台
- 基于API开发自动化脚本,例如实现社交媒体内容跨平台同步
- 若具备VPS或公网IP资源,可进一步扩展工具使用范围,实现随时随地访问。