Skip to content

常见问题与浏览器兼容性 ​

为什么自建部署必须配置 HTTPS? ​

GCopy 依赖现代浏览器的 Clipboard API。出于浏览器安全策略限制,除 localhost 外,所有局域网 IP 或公网域名都必须在 HTTPS 安全上下文下才能调用剪贴板读写接口。因此自建部署时请配置内置 TLS 证书或通过 Caddy / Nginx / Cloudflare Tunnel 提供 HTTPS。

为什么在 Safari 上有时提示「请再按一次」? ​

macOS 和 iOS 上的 Safari 对剪贴板权限有严格的用户手势时效要求:读写剪贴板必须在点击事件的极短同步窗口内触发。当 GCopy 先向服务器请求判断同步方向后,网络耗时可能导致手势令牌失效,此时按提示再点一下按钮即可在全新手势中瞬间完成读写。

Safari on iOS

为什么复制微信图片后会提示按 Ctrl+V / Cmd+V? ​

部分桌面客户端(如微信)写入系统剪贴板的图片格式不标准,浏览器的异步 navigator.clipboard.read() 接口出于安全清洗策略会返回空数组。此时按照提示直接按 Ctrl+V(Mac 按 Cmd+V),GCopy 会通过页面原生 paste 事件读取原始图片数据并完成上传。

我的剪贴板数据会被服务器持久化保存吗? ​

不会。GCopy 不使用任何数据库,也不将剪贴板内容写入磁盘。所有数据仅暂存在 Go 服务端的内存中,若 24 小时内无更新会自动过期清理;容器重启也会立即清空全部内存数据。

已测试浏览器列表 ​

浏览器测试版本状态
Chrome (macOS / Windows / Android)107+ / 121+✅ 已测试
Edge (Windows / Linux / Android / HarmonyOS)108+ / 122+ / 130+✅ 已测试
Safari (macOS)15.6+✅ 已测试
Safari (iOS)16.1+✅ 已测试
Opera (macOS / Windows)109+✅ 已测试

基于 MIT 许可发布