Charles-Hello / cloud-clipboard

在局域网内自用的在线剪贴板，支持传输纯文本和文件

cloud-clipboard

因为不想为了手机和电脑互传文件这种小事就扫🐴登录某个辣鸡 APP，而自己折腾出来的一个在线剪贴板。

• 支持传输纯文本和一键复制
• 支持传输文件，对于图像可以显示缩略图
• 使用 WebSocket 实现实时通知
• 前端使用 Vue 2 和 Vuetify 构建
• 后端使用 Swoole 或 Node.js (Koa) 构建 （两种服务端实现任选一种即可）

由于这个项目是针对个人在连接到同一局域网（比如家里的路由器）的设备之间使用而设计的，因此并没有额外考虑在公开的服务器上使用时可能面对的技术和安全问题。

截图

桌面端

移动端

使用方法

Node.js 版服务端

安装和运行

据说 pkg 可以把 Node.js 应用打包成可执行文件，但是目前的 5.x 版还不支持 ES Modules，所以先🕊️了（

从源代码运行

需要安装 Vue CLI 和 Node.js。另外同样需要在 server-node 目录下准备好 config.json 配置文件。

cd client
npm install
npm run build
cd ../server-node
npm install

# 从源代码直接运行
node main.js

服务端会监听本机的所有网卡，并在终端中显示前端界面所在的网址，使用浏览器打开即可使用。

如果你使用的是 Node.js 17 或以上的版本，构建前端资源时可能会遇到 Error: error:0308010C:digital envelope routines::unsupported 的错误，在终端里设置环境变量 NODE_OPTIONS=--openssl-legacy-provider 可以解决这个问题。

Swoole 版服务端

已不再维护，以下内容仅作为存档。

准备环境

需要安装了 Swoole 扩展的 PHP 运行环境。

• Linux：参见 Swoole 文档的安装说明
• Windows：使用官方在百毒网盘上提供的 Cygwin 整合包（或者从这里下载我自己搬运的 4.5.0 RC1 版本），也可以在 WSL(Windows Subsystem for Linux) 中安装运行环境

可能是由于 WSL 的缺陷，在 WSL 下多次刷新页面后开始有概率出现错误导致服务端挂掉：

WARNING swReactorEpoll_set(:178): reactor#0->set(fd=15|type=0|events=5) failed, Error: No such file or directory
段错误 (核心已转储)

Cygwin 整合包下暂未发现类似的问题。

在命令行中输入 php --ri swoole，可以输出配置信息就代表准备完成了～

安装和运行

实际上也不能叫安装，毕竟下载之后就可以直接用了

1. 前往 Release 下载最新的 cloud-clipboard.phar。
2. 在同一目录新建配置文件 config.json（可以参见下面的说明），一定要根据实际修改 IP 地址！
3. php cloud-clipboard.phar
4. 打开 http://192.168.1.136:9501（需要替换为在配置文件中实际设定的地址和端口）即可使用～

从源代码运行

需要安装 Vue CLI 和 Composer。

cd client
npm install
npm run build
cd ../server
composer install --no-dev

# 从源代码直接运行
php main.php

# 生成 Phar
cd ..
php build-phar.php

配置文件说明

// 开头的部分是注释，并不需要写入配置文件中，否则会导致读取失败。

{
    "server": {
        "port": 9501, // 端口号
        "history": 10, // 消息历史记录的数量
        "auth": false  // 是否在连接时要求使用密码认证，falsy 值表示不使用
    },
    "text": {
        "limit": 4096 // 文本的长度限制
    },
    "file": {
        "expire": 3600, // 上传文件的有效期，超过有效期后自动删除，单位为秒
        "chunk": 1048576, // 上传文件的分片大小，不能超过 5 MB，单位为 byte
        "limit": 104857600 // 上传文件的大小限制，单位为 byte
    }
}

“密码认证”的说明：

如果启用“密码认证”，只有输入正确的密码才能连接到服务端并查看剪贴板内容。 可以将 auth 字段设为 true（随机生成六位密码）或字符串（自定义密码）来启用这个功能，启动服务端后终端会以 Authorization code: ****** 的格式输出当前使用的密码。