cloud-clipboard-go

基于 TransparentLC 项目,用go复刻了一个

在 yurenchen000 基础上增加一些功能

截图

桌面端

移动端

使用方法

这里是 go 版服务端

Android 端快捷方式(仿iOS快捷方式)

• 要求: 服务端版本 ≥ v4.5.10

1. 下载 http-shortcuts
2. 下载 cloud-clipboard-shortcuts.zip
3. 打开http-shortcuts,点击右上角三个点菜单-->导入/导出-->从文件导入-->选择第2步下载的文件
4. 点击右上角三个点菜单-->变量-->修改url值为你的服务器IP和端口(如果有prefix参数,需添加在端口后);room可选,默认值为空;auth可选,默认值为空;其它勿动

傻瓜式运行(UI辅助器,推荐小白用户们)

点击查看预览图

去 UI辅助器 下载后,双击使用

使用 Docker 运行

# dockerhub镜像(二选一)
docker run -d --name=cloud-clipboard-go -p 9501:9501 -v /path/your/dir/data:/app/server-node/data jonnyan404/cloud-clipboard-go
# github镜像(二选一)
docker run -d --name=cloud-clipboard-go -p 9501:9501 -v /path/your/dir/data:/app/server-node/data ghcr.io/jonnyan404/cloud-clipboard-go

• vi docker-compose.yml

services:
    cloud-clipboard-go:
        container_name: cloud-clipboard-go
        restart: always
        ports:
            - "9501:9501"
        environment:
            - LISTEN_IP= #默认为0.0.0.0,可设置为 127.0.0.1 不懂勿动
            - LISTEN_IP6= #默认为空,ipv6地址,可设置为::,不懂勿动
            - LISTEN_PORT= #默认为9501,可设置为其他端口
            - PREFIX= #子路径,可配合nginx使用,格式: /cloud-clipboard
            - MESSAGE_NUM= #历史记录的数量,默认为10
            - AUTH_PASSWORD= #访问密码,默认为false,可自定义字符串密码
            - TEXT_LIMIT= #文本长度限制,默认为4096(2048个汉字),可设置为其他长度
            - FILE_EXPIRE= #文件过期时间,默认为3600(1小时),可设置为其他时间,单位为秒
            - FILE_LIMIT= #文件大小限制,默认为104857600(100MB),可设置为其他大小,单位为字节
            - MKCERT_DOMAIN_OR_IP= #mkcert域名或IP,默认为空,可设置为其他域名或IP,多个用空格分隔,仅域名支持通配符*
            - MANUAL_KEY_PATH= #手动设置证书路径,默认为空,该参数优先级高于MKCERT_DOMAIN_OR_IP
            - MANUAL_CERT_PATH= #手动设置证书路径,默认为空,该参数优先级高于MKCERT_DOMAIN_OR_IP
        volumes:
            - /path/your/dir/data:/app/server-node/data #请注意修改为你自己的目录
        image: jonnyan404/cloud-clipboard-go:latest

• 访问主页: http://127.0.0.1:9501
• 访问 http://127.0.0.1:9501/content/latest 将永远返回最新的一条内容,可添加房间参数?room=xxx

使用 homebrew 运行

已知问题:brew services 无法tab补全,参考:https://github.com/orgs/Homebrew/discussions/6047#discussioncomment-12668536

默认配置文件分别在homebrew根目录下的etc/cloud-clipboard-go和var目录

brew update
#安装
brew install Jonnyan404/tap/cloud-clipboard-go
# 启动服务
brew services start cloud-clipboard-go
# 查看服务状态
brew services info cloud-clipboard-go
# 停止服务
brew services stop cloud-clipboard-go
# 重启服务
brew services restart cloud-clipboard-go

使用 OpenWrt 运行

✅ OpenWrt 24.10.0 测试通过

查看所属架构命令: opkg print-architecture (最后一行第二列就是)

去 https://github.com/Jonnyan404/cloud-clipboard-go/releases 的pre-release下载对应系统的*平台.ipk文件和*_all.ipk文件

然后在命令行执行下列命令

opkg install *平台.ipk
opkg install *_all.ipk

点击预览luci界面

使用二进制文件运行

去项目 release 下载对应系统文件运行即可

参数优先级: 命令行参数 > 配置文件

• 命令行参数: -host 用来自定义服务器监听地址
• 命令行参数: -port 用来自定义服务器监听端口
• 命令行参数: -auth 用来自定义密码
• 命令行参数: -config 用来加载自定义配置文件
• 命令行参数: -static 用来加载自定义外部前端文件

使用源代码运行

• 需要安装 Node.js>=22.12。
• 需要安装 go>=1.22

cd client
npm install
npm run build

# 运行服务端
cd ../cloud-clip
go mod tidy
go run -tags embed .

配置文件说明

• 请查看: https://github.com/Jonnyan404/cloud-clipboard-go/blob/main/cloud-clip/config.md

HTTP API

• 请查看: https://github.com/Jonnyan404/cloud-clipboard-go/blob/main/cloud-clip/config.md

衍生项目

• 为 cloud-clipboard-go 制作的启动器,方便不想或不会使用终端的用户,cloud-clipboard-go-launcher