Skip to content

PasteFerry (隔空贴): clipboard and file sync across macOS, Windows and Linux. Direct-first, end-to-end encrypted. Optional official access: no server to host. Independent self-hosting remains available.

16.4 KB
Raw Blame

隔空贴图标

隔空贴 PasteFerry

跨设备剪贴板、复制历史与隔空传送,电脑和手机一起用。
Mac、Windows、Linux、安卓互通,不限账号。电脑间复制粘贴;电脑与安卓在同一网络互传照片和文件,手机也能扫码用网页。

下载 · 项目主页 · 功能演示 · 国内镜像(Gitee) · English

版本 macOS 13+ Windows 10 / 11 Linux x64 / ARM64 AGPL-3.0 许可

快捷粘贴窗口:搜索框、全部/文本/链接/图片/文件/收藏六个页签,下面是带序号的复制记录

如果隔空贴帮到了你,欢迎点一个 ⭐ Star,让更多人看到它。

它解决什么问题

通用剪贴板要同一个 Apple ID、两台离得近;隔空投送每次都要点接收;发给自己要手动下载,文件还留在别人的服务器上。一台 Mac 一台 Windows 时,系统自带的办法一个都用不了。

隔空贴的做法:两台电脑配对一次,之后在一台上复制,另一台直接粘贴。复制过的内容都在复制记录里,按 ⌥V(Windows、Linux 上是 Alt+V)就能找出来贴进正在用的 App。

隔空贴 通用剪贴板 隔空投送 聊天软件
不同 Apple ID 之间 ✓ — 需对方接收 ✓
不在同一个网络(家里 ↔ 公司) ✓ — — ✓
复制后直接粘贴,不用点接收 ✓ ✓ — —
Mac 与 Windows 之间 ✓ — — ✓
文件与整个文件夹 ✓ 不稳定 ✓ 打包后可以
复制历史,随时找回 ✓ — — 翻聊天记录
仅自己的设备可解密内容 ✓ ✓ ✓ —

功能

在这台复制,到那台粘贴

  • 文本、带格式的文本、图片、文件、整个文件夹都能同步,复制什么,对面粘贴出来就是什么。
  • 按大小分流:50 MB 以内(可调)复制时就传好;更大的只同步一条记录,需要时点一下再取。
  • 对方离线也不丢:这期间复制的,连上后补进对方的复制记录。

隔空传送(2.5 新增)

  • 打开「隔空传送」,配对过的电脑都在雷达上。把文件或整个文件夹拖到其中一台,就直接发过去。
  • 不限大小:能看到进度、速度和剩余时间;断了会从断点接着传,每个文件用 SHA-256 校验。
  • 收到的文件默认存到「下载」(可以改),不进复制记录。两台都要是 2.5 或更新的版本。

给好友发文件(2.6 新增)

  • 别人的电脑不用配对:用一次性的好友码加个好友,之后把文件拖到对方的头像上就发过去,可以附一句备注。
  • 收不收,对方说了算:每批文件先弹出请求(谁发的、什么文件、备注),接受后才开始传;常来往的好友可以设成自动接收。
  • 谁能发给你,你来定:均不允许、仅限好友(默认),或者在局域网里对所有人开放 10 分钟。
  • 好友之间只传文件和图片,看不到你的剪贴板、复制记录和其他设备。不在同一个网络时,两边都打开「服务」。两台都要是 2.6 或更新的版本。

快捷粘贴

  • 在任何 App 里按 ⌥V(Windows、Linux 上是 Alt+V),复制记录出现在屏幕中间。
  • 打几个字搜索,中文可以打拼音:huiyi 或 hy 都能找到「会议」。
  • 按 1–9 或回车,选中的内容直接粘贴到刚才的光标处;⇧↩ 粘贴纯文本,⌘↩ 只复制。快捷键可以在设置里更换或关闭。

复制记录与收藏

  • 复制记录:所有设备最近 3 天(可调)复制过的内容,可以按文本、链接、图片、文件筛选。鼠标停一下就能看到全文、大图或完整的文件列表。
  • 收藏:常用的内容点一下星标另存一份,不会过期,清空复制记录也还在。
复制记录:鼠标停在一条会议记录上,提示框显示全文 收藏页:周报模板、常用回复、下载链接等收藏

主题(2.10 新增)

  • 设置 › 外观里分「软件自带」(默认、像素)与「自定义」两组,浅色、深色、跟随系统随你选。
  • 像素主题:缝合像素字体、切角方块、按钮斜面,配色是中性的「石墨」与「纸」加像素绿。页眉是夜景或白天,侧边栏底下有篝火或小房子,空页面有像素插画;隔空传送时纸飞机飞过去,完成时迸出星星。还可以打开 CRT 扫描线。
  • 自定义主题:复制一份自带主题,导入、导出 .pasteferry-theme.json,不要的删掉。保存时检查文字对比度,看不清会提醒。
  • 让 AI 帮你做主题:pasteferry-cli mcp 让 Claude、Cursor 等支持 MCP 的应用配色、校验并应用主题(见下文)。
  • 主题只作用于这一台设备(电脑上包括主窗口和快捷粘贴窗口),不在设备之间同步;安卓 App 在自己的「设置 › 外观」里单独选。
像素主题的复制记录:页眉是夜里的远山和月亮,侧边栏底下有帐篷和篝火 设置 › 外观:软件自带与自定义主题、导入主题、让 AI 帮你做主题

其他

  • 后台常驻,开机自启,崩溃自动恢复;App 里检查更新,确认后自动安装。
  • 简体中文、繁体中文(台湾、香港)、英文、日文界面。

核心:打洞直连

隔空贴的一切都建立在「两台电脑直接连起来」上:内容在两台电脑之间直接传,不经过谁的服务器。

flowchart LR
    A["电脑 A<br>在这里复制"] -- 信令:交换连接信息 --> S[("服务<br>或自建服务器")]
    B["电脑 B<br>在这里粘贴"] -- 信令 --> S
    A <== "打洞直连 · DTLS 端到端加密" ==> B
    A -. "打不通时:加密中转" .-> S
  • 同一网络里不需要服务器:靠 mDNS 互相发现,输入配对码就能直连。
  • 跨网络时服务器只牵线:「服务」或自建服务器帮两台电脑交换连接信息,然后它们打洞直连(WebRTC,基于 pion)。
  • 多出口网络也能直连:公司双线这类网络按目标地址选出口。隔空贴在同一个 UDP 端口上同时询问多台 STUN 服务器,拿到每个出口的地址一并告诉对端;还会安排好哪一边先发包,避开会占住端口的路由器。实测公司 4 个出口与家里宽带之间可以直连。
  • 打不通才中转:中转转发的是端到端加密的数据包,服务器解不开;空闲时会再试打洞,成功后切回直连。
  • 配对时核对安全指纹:两块屏幕显示同样的两行指纹,之后的每条消息都带签名,服务器无法冒充你的设备。
  • 每次提交都在实验室里验证:NAT 打洞实验室 用 Linux 网络命名空间和 iptables 模拟家用路由器、多出口网络、端口随机分配的 NAT 等 16 种场景,用隔空贴真实的连接代码各跑一遍。

细节见工作原理与技术方案:多出口网络的 NAT 打洞、局域网直连。

开始使用

第一次用?跟着 快速开始 一步步来,有截图。

1. 在每台电脑上安装 App,到 下载页 选:

  • Mac(macOS 13 以上):Apple 芯片版或 Intel 版;也有两种芯片都能用的通用版。
  • Windows 10/11:安装程序或便携版。
  • Linux(X11,或带 XWayland 的 Wayland 桌面):Ubuntu、Debian 用 .deb(x64、ARM64),其他发行版用 tar.gz(x64、ARM64),解压后运行 ./PasteFerry/install.sh 加进应用菜单。

Mac 版还没有经过 Apple 公证,Windows 版还没有代码签名:Mac 上第一次打开时到 系统设置 → 隐私与安全性 点 仍要打开;Windows 上点 更多信息 → 仍要运行。然后点 启用后台同步。Windows 防火墙询问、macOS 询问能否查找本地网络上的设备时,都选择允许。想让快捷粘贴直接粘贴,Mac 上按 ⌥V 后点底栏的 去授权,在「辅助功能」里打开隔空贴。

**2. 配对。**一台点 设备 → 添加设备 → 生成配对码,另一台点 输入配对码。两边显示的两行安全指纹完全一致后再确认。之后在任意一台上复制,另一台就能直接粘贴。

3. 跨网络时(可选),选一种连接方式:

方式 适合 要准备
服务 跨网络,不想自建服务器 每台电脑在「设置 → 连接」里打开「使用服务」(默认关闭)。打不通直连时的中转当前默认每天 100 MB,直连不计
同一网络 电脑都连着同一个路由器 什么都不用
公网服务器 想完全自己掌控 一台有公网 IP 的 Linux 云主机,最低配置就够
Tailscale 跨网络,但没有服务器 每台电脑都装 Tailscale,配对时输入对方的 Tailscale 地址

自建服务器只要一条安装命令,见服务器部署说明(Linux、macOS、Windows、Docker)。

要求
Mac 客户端 macOS 13 Ventura 及以上;Apple 芯片与 Intel 芯片
Windows 客户端 Windows 10 与 11,x64
Linux 客户端 x64 或 ARM64;X11 桌面,或带 XWayland 的 Wayland 桌面(GNOME、KDE 默认都带);GTK 3
服务器 可选:Linux(x86_64、ARM64;systemd 或 Docker)、macOS,或 Windows 10/11 x64
iPhone / iPad 暂不支持:iOS 不允许 App 在后台监听剪贴板

通过 Homebrew 安装 Mac 版

官方 tap 安装的是完整桌面 App,并提供 App 内置的 pasteferry-cli:

brew tap baiyuze/tap
brew install --cask baiyuze/tap/pasteferry

已有手动安装的 App 时,先退出并移走 /Applications/PasteFerry.app,保留应用数据,再执行安装。 首次打开后启用后台同步并按提示授权。通过 Homebrew 升级:

brew update
brew upgrade --cask --greedy baiyuze/tap/pasteferry

--greedy 会包含支持 App 内更新的软件。卸载使用 brew uninstall --cask baiyuze/tap/pasteferry,保留配对、历史和设置。 详见 官方 tap。

命令行查询(2.9 起)

桌面 App 自带 CLI;Homebrew 会把它加入命令路径。手动安装的 Mac App 可以从 /Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli 调用;Windows 使用安装目录中的 pasteferry-cli.exe,Linux 使用 pasteferry-cli。

pasteferry-cli version
pasteferry-cli -json status
pasteferry-cli -json devices
pasteferry-cli -json history
pasteferry-cli -json config get

version 无需后台服务;其他查询读取当前登录用户正在使用的后台服务。 -json 放在命令前,输出统一的 ok/data 或 ok/error JSON;历史返回最近 20 条摘要。 不加 -json 时沿用文本输出。可用 -data-dir DIR 指定一个已经运行的实例的数据目录;CLI 本身不启动后台服务。 JSON 模式支持上述只读查询,格式及示例见 CLI JSON 接口。

让 AI 帮你做主题(MCP)

pasteferry-cli mcp 是一个 MCP 服务(2.10 起)。把它加到 AI 应用里,然后直接说「帮我做一套赛博朋克风的主题」:AI 会读取主题格式、配色、检查对比度,保存后应用。它只能读写主题和背景图,看不到复制记录、设备和好友。「设置 › 外观 › 让 AI 帮你做主题」里有填好本机路径的配置,可以直接复制。

Claude Desktop 与 Cursor(~/.cursor/mcp.json):

{
  "mcpServers": {
    "pasteferry": {
      "command": "/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli",
      "args": ["mcp"]
    }
  }
}

Claude Code:

claude mcp add pasteferry -- /Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli mcp

Windows 上命令是 %LOCALAPPDATA%\Programs\PasteFerry\pasteferry-cli.exe,Linux 的 .deb 包是 /usr/bin/pasteferry-cli。后台服务要在运行。工具清单与更多例子见让 AI 帮你做主题。

文档

参与贡献

提交 PR 前请阅读贡献规范。每个 PR 只处理一个独立目标,相关测试和文档可以一并提交。 较大改动请先开 Issue 讨论,并在 PR 模板中写清修改范围和实际验证结果。

支持一下

隔空贴免费开源。如果它帮到了你,点一个 ⭐ Star 就是最好的支持,也能让更多需要它的人看到。遇到问题或有想法,欢迎提 issue。

许可

隔空贴以 GNU AGPL-3.0 免费开源:任何人(包括公司)都可以使用和修改,但分发它、或通过网络提供修改过的版本时,必须以同样的许可公开你的源码。详见 LICENSING.md。1.2.0 及更早的版本仍适用 MIT 许可。