开源一个基于网页的共享剪切板 ( PHP )

爱意满满的作品展示区。

This topic created in 929 days ago, the information mentioned may be changed or developed.

个人使用了两年左右, 最近心血来潮进行了一波优化, 顺便进行开源. 说是共享剪切板, 实际上更像是一个共享文本框, 因为没有设备的剪切板访问权限.

https://github.com/lslqtz/UniversalClipboard

这一剪切板具有如下特性:

基于网页, 采用轮询机制, PHP 单文件部署;
在键入完毕后的半秒内被同步到各设备;
网页会产生二维码便于共享 (推荐由移动设备访问桌面设备产生的二维码);
支持简单的深色模式 (二维码在深色模式下会变暗);
支持简单的多账号认证和匿名. 匿名模式下使用一个不需要登录的"特殊账号". 以账号为门槛, 在 Session 模式下剪切板关联 Session ID (即根据不同的 Session ID 可支持单账号多剪切板, 但此时剪切板可跨账号访问), 在 JSON 模式下剪切板关联账号 (即意味着在匿名模式下完全共享剪切板).
可设置的过期时间;
通过修改 VersionKey, 可以废弃所有用户的之前剪切板;

注: 这一剪切板的设计目的是个人及小规模使用. 该工具的密码存储及传输使用未加盐 SHA1, 不建议使用重要密码. SessionName 如为 null, 则以 JSON 模式存储用户数据, 否则其字符串决定其字面意思. 过期及废弃剪切板并不意味着丢弃, 由于没有计划任务的实现, Session 模式下 PHP 本身会触发基于概率的回收, JSON 模式下只有在访问用户数据时才会检查是否过期.

这是一个目前可用的测试服务, 使用 Session 模式, 账号为 user1, 密码为空. 测试链接

Supplement 1 · Nov 13, 2023

关于本程序的接口:
POST /clipboard.php 或 POST /clipboard.php?{SessionName}={SessionID}
Content-Type: application/json

首次访问/初始化
{"version": -1, "version_hash": null, "clipboard": null}

再次访问须使用已获得的 version 及 version_hash, 并传递客户端当前剪切板内容, 如无变化 clipboard 将为 null, 有变化即获得下一版本, 应当储存它.

Supplement 2 · Nov 13, 2023

另: 接口若只返回 version 且为 -2, 即意味着未登录, 不应继续请求.
客户端登录可直接构造 Cookie: {AuthCookieName}={Username}:{Password (SHA1)}

Supplement 3 · Nov 13, 2023

测试服务目前无法达成: 2. 在键入完毕后的半秒内被同步到各设备; ,这是因为默认间隔 Interval 配置为 1000ms (1s), 修改间隔会加快速度, 但是也会导致大量 HTTP(S) 请求的压力.

Supplement 4 · Nov 13, 2023

为上一条附言补充一条视频:

Preview

剪切

Session

账号

JSON

11 replies • 2023-12-18 10:03:40 +08:00

Puteulanus

Nov 13, 2023

我之前也想做这个，基于网页或者 PWA 的剪贴板共享工具
但是浏览器的剪贴板 API 卡得太死了，要权限都可以接受，焦点还必须一直在网页上，自动同步基本上就不要想了

lslqtz

Nov 13, 2023

@Puteulanus
说到剪切板 API, 这个程序目前还没有使用, 也许有优化空间? 我一般是使用 Command (Control)+C/V 快捷键来取出.
不过如果使用的话, 在两个设备都已有剪切板内容时确定先后顺序可能是一个难题.

Puteulanus

Nov 13, 2023

@lslqtz 可以做一个一键复制的按钮，或者把变动历史做成一个列表（剪贴板历史），每个 item 单击或者双击直接复制，感觉体验会好一些，纯鼠标就能操作。

两个设备的先后确实是个问题，特别是浏览器 API 禁止了非焦点情况下的剪贴板访问，没办法像剪贴板同步的客户端程序一样在变动的当下及时反应，当一个设备重新回网页的时候是不可能知道它是想读还是想写的。

我的想法是网页上再做个读剪贴板的按钮，都手动操作，让它俩自己决定哪边读哪边写，自动同步这事在网页上真做不出来。。

lemonTreeTop

Nov 13, 2023

可以看看我的项目柠檬 Push ，把电脑剪切板转为 http 服务，提供获取和写入的 api

柠檬 Push ，同一 WiFi 环境下手机高效推送文本到电脑剪切板的工具，移动端支持 Android 、iOS ，电脑端支持 Windows 、Mac 、Linux 平台

https://github.com/ishare20/lemonPush

brader

Nov 13, 2023

我是自己做了一个 https://9iqu.cn/clip/

justfindu

Nov 13, 2023

我一直在用 Edge 提供的 Drop

dasenlin

Nov 13, 2023

每秒一次的轮询是否可以使用主动推送到客户端来代替，当前剪切板内容变化时才改变状态然后推送到各客户端，我想这样会增加难度，比如不得不增加 Websocket 之类的功能，这样就影响了轻便的初衷了。

lslqtz

Nov 13, 2023

@dasenlin 可以, 除了 CDN 和虚拟主机等兼容性外应该还好.

lslqtz

Nov 13, 2023

目前没有计划, 高频轮询足够个人需求了.

Eanson

Dec 17, 2023

@brader 开源吗我正好需要这个

brader

Dec 18, 2023

@Eanson 之前有放了一份到 gitee ，你要可以自己上去拿
https://gitee.com/shunbiao/clip