下载 RealtimeClipboard

这些你其实一样都不需要。RealtimeClipboard 在你每一台设备的浏览器标签页里就能跑，这就是产品的全部。桌面应用只多做一件浏览器根本做不到的事：你在别处干活的时候，它也看得见你复制了什么。

一次点击 · 不用终端

装上它

下载、打开、装好。挑你正坐在前面的那台机器。

桌面 —— Windows、macOS、Linux

桌面应用是给同一个页面套了个窗口，再加一个盯着系统剪贴板的小小原生助手。那个助手就是它存在的理由：在任何程序里复制，你还没切过去，内容已经在你别的设备上了。

它开着的时候，你每一次复制它都读得到。你装的就是这个。它从不把任何内容写到磁盘上，离开这台机器之前也已经加密 —— 但如果你更希望它只发你挑出来的内容，就在设置里把它切到应用内。

Windows 10 和 11

下载安装程序

.msi · 64 位

后台剪贴板抓取：支持

Windows 安装指南

macOS 11 及以上

下载应用

.dmg · Intel 和 Apple Silicon 共用一个版本

后台剪贴板抓取：支持

macOS 安装指南

Linux

下载

.deb、.rpm 和 AppImage

后台抓取：X11 上可以，Wayland 上 KDE 和 wlroots 也可以 —— GNOME 不行，它没有对应的 portal。

哪些合成器可以，为什么

这些构建还没有做代码签名，你的电脑会这么告诉你。Windows 会弹出 “Windows 已保护你的电脑” —— 点更多信息 → 仍要运行。macOS 会拒绝第一次启动；打开系统设置 → 隐私与安全性，再点仍要打开。这两个都不代表文件坏了：证书要按年付钱，这个项目没有买，所以除了发布页上的校验和、以及你可以把每一行源码读完这件事，没有别的东西为这个二进制文件作保。

Android、iPhone 和 iPad

没有 App 要装，而这是想清楚之后的决定，不是缺口。两个平台都不允许任何应用在后台读取剪贴板 —— Android 从版本 10 起就收紧了，iOS 则从来没放开过。所以一个原生应用能多给你的，只有一个分享菜单按钮和一条商店条目，除此之外没有一件事是你正读着这段话的页面做不到的。

所以，把它添加到主屏幕就好。它会有自己的图标和窗口，离线也能用。

Android 和 ChromeOS

用 Chrome 打开应用。
菜单 → 添加到主屏幕，或者点那条安装提示。

打开应用

后台剪贴板抓取：做不到 —— 长按粘贴进应用，或者从应用里复制。

Android 安装指南

iPhone 和 iPad

用 Safari 打开应用。iOS 上的 Chrome 装不了它。
点分享 → 添加到主屏幕。

打开应用

后台剪贴板抓取：做不到 —— 粘贴进应用，或者分享给它。

iPhone 安装指南

命令行 · 进阶

从终端安装

同样的构建，交给你本来就信任、也愿意让它替你更新的包管理器 —— 另外，给完全没有桌面的机器备了一个只有管道、没有窗口的客户端。

包管理器

两个，而且只在它们真的可用之后才写在这里。每一个都是 tools/release/manifest.mjs 从发布产物生成的清单，之后还得由别人审核并合并 —— 所以命令上的标签说它能用，它才能用，不会提前。

Windows —— winget

审核中

winget install AkshayNikhare.RealtimeClipboard

0.3.0 的清单已经提交，正在等微软的审核，这件事按天算而不是按分钟算。合并的那一刻这条命令就开始生效，在那之前不会。 Windows 包管理说明

macOS —— Homebrew

brew install --cask akshaynikhare/tap/realtimeclipboard

这个 cask 装的就是上面那个按钮给你的通用构建，用 brew upgrade 更新。它还会去掉隔离标记，所以手动下载要跳的那段 Gatekeeper 舞步可以省了。 macOS 包管理说明

Linux —— 没有

没有 Flathub、Snap 或 AUR 包，这里也不摆一条假装有的命令。用上面的 .deb、.rpm 或 AppImage；每一个都是单独一个文件，谁也不需要仓库。 Linux 包管理说明

在你的编辑器里

一个跟着你在机器之间走的剪贴板，而且不用离开你已经在的那个窗口。编辑器退到后台时它照样同步，这正是网页版做不到的那一件事。

VS Code

code --install-extension cadnative.realtimeclipboard

或者在扩展视图里搜 RealtimeClipboard。需要 VS Code 1.100 或更新的版本。在 Marketplace 上查看

Cursor、Windsurf、VSCodium

ext install cadnative.realtimeclipboard

VS Code 的这些分支都不能用微软的 Marketplace，所以同一个构建也发布到了 Open VSX，它们都去那里找。Gitpod 和 code-server 也一样。在 Open VSX 上查看

在你的浏览器里

一个弹窗加两个快捷键，用来在不打开应用的情况下把你复制的东西发出去。

Edge

一键安装，并且会自动更新。Edge 加载项是它唯一上架的 Chromium 商店，而且只能装进 Edge。前往 Edge 加载项

Chrome、Brave、Opera、Arc —— 加载已解压的扩展

# 1. 从上面的发布页取 realtimeclipboard-browser-<version>.zip
# 2. 解压到一个你会长期留着的位置
# 3. chrome://extensions -> 开发者模式 -> 加载已解压的扩展程序 -> 选那个文件夹

文件夹要留着：浏览器每次启动都会去读它，所以随手清空的下载目录是个错误的家。这种方式没有自动更新，Chrome 还会偶尔问你是不是真要留着一个开发者模式的扩展。这里没有一键安装程序，因为没有哪次发布带 .crx —— 而且在 Windows 和 macOS 上，Chrome 本来也会拒绝一个来自它自家商店之外的包。最新发布

只限 Chromium 内核 —— Chrome、Edge、Brave、Opera、Arc。Firefox 不行：剪贴板桥接需要一个 Firefox 没有实现的 API。而且它在任何浏览器上都不做后台同步，那正是桌面应用和编辑器扩展要干的活。

服务器、SSH 和脚本

一个命令行客户端，给那些根本没有剪贴板的机器用。它说的是和浏览器一样的协议、一样的加密 —— 它导入的就是同一批文件 —— 所以从服务器发出的一条剪贴内容，和别的没有任何两样地出现在你的笔记本上。

npx realtimeclipboard D75LV

它是干什么用的

# 把东西管道进来
echo "deploy key" | npx realtimeclipboard send D75LV

# 接住下一条剪贴内容然后退出
npx realtimeclipboard watch D75LV --once > token.txt

# 从一台你 ssh 上去的机器
ssh build-01 'cat /var/log/deploy.log' | npx realtimeclipboard send D75LV

需要 Node 22 或更新的版本，而且什么都不用装：npx 会按需去拉。命令行指南

自己跑一个中继服务器

中继服务器在设备之间搬运加密后的剪贴内容。它除了房间哈希和密文之外什么也看不到，也什么都不存 —— 但你不必只凭信任，因为你可以自己跑一个。它就是一个 Python 文件，没有数据库。

docker run -p 8000:8000 ghcr.io/akshaynikhare/realtimeclipboard-relay

或者从源码跑

pip install -r backend/requirements.txt
python -m uvicorn main:app --app-dir backend --port 8000

要 TLS 和一个真实域名就用 deploy/docker-compose.yml，旁边还放着一份 Helm chart。然后在应用里把中继服务器指过去： 设置 → 中继服务器。自建部署指南

每个平台写得更长的一版，连同这些限制背后的理由：安装指南。