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.
Dart airdrop-alternativeclipboardclipboard-sharingclipboard-synccopy-pastecross-platformend-to-end-encryptionfile-syncfile-transferfluttergolanglinuxmacosnat-traversalp2pself-hostedtailscaleuniversal-clipboardwebrtcwindows
# PasteFerry (隔空贴)
> PasteFerry is a free, open-source (GNU AGPL-3.0) app for macOS, Windows and Linux that syncs the clipboard and files between computers: copy on one, paste on another, in any combination of Mac, Windows and Linux. It works across different accounts and different networks. On the same network no server is needed: devices find each other over mDNS and pair with a code. Across networks, opt-in official access introduces them without requiring users to host a server; custom servers and Tailscale also remain available. Devices connect peer-to-peer over WebRTC with end-to-end DTLS encryption; when a direct connection fails, official traffic is relayed over an authorized WSS tunnel to TURN, with a current default allowance of 100 MB per machine quota group per day (upload plus download, Beijing midnight reset); direct traffic is not charged. The server stores no accounts and cannot read clipboard content.
>
> 隔空贴是一款免费开源(GNU AGPL-3.0)的跨设备剪贴板、复制历史与文件传送工具,支持 macOS、Windows、Linux 和 Android。安卓 App 与电脑可在同一网络双向传送照片和文件;手机浏览器扫码后可查看复制记录及独立收发文件,无需安装,网页传输需保持页面打开。电脑端在两台电脑之间同步剪贴板与文件:一台复制,另一台直接粘贴,Mac、Windows、Linux 互通。不要求同一个账号,跨网络可用。同一网络里不需要服务器,设备靠 mDNS 互相发现、用配对码配对;跨网络时主动开启官方服务即可,无需自建;也可继续使用自建服务器或 Tailscale。设备间 WebRTC 直连、DTLS 端到端加密,打不通时才申请加密中转,当前默认每机器额度组每日 100 MB 上下行合计,直连不扣额度;服务器不存账号,看不到复制内容。
Name: PasteFerry in English, 隔空贴 in Chinese. Versions before 2.0.0 (October 2026) were called CopySync.
Key facts:
- Current version: 2.10.1, released 2026-11-07. Themes can now show a background image across the window (with a scrim that keeps text readable and translucent panels) and replace the page-header and sidebar scenery with your own pictures, from Settings › Appearance or through the `pasteferry-cli mcp` MCP server. Themes stay on each device. The device protocol is unchanged; no server update is required.
- Downloads: https://pasteferry.cc/download/ and GitHub Releases. For mainland China, the code and the installers of the latest two releases are mirrored at https://gitee.com/baiyuze/pasteferry/releases (same files; verify with SHA256SUMS).
- Mac client: macOS 13 Ventura or later. Distributed as a DMG for Apple silicon (PasteFerry-mac-apple-silicon.dmg), one for Intel (PasteFerry-mac-intel.dmg), and a universal one (PasteFerry.dmg); not notarized by Apple, so the first launch needs "Open Anyway" in System Settings → Privacy & Security.
- Windows client: Windows 10 and Windows 11, x64. Per-user installer (PasteFerry-Setup.exe, no admin rights) or portable zip; not code-signed, so SmartScreen needs "More info → Run anyway" once. Runs in the notification area; pasted files are real files usable in Explorer, WeChat and Office. Skips content that password managers mark as sensitive.
- Linux client: x64 and ARM64, GTK 3; X11 desktops, or Wayland desktops with XWayland (GNOME and KDE include it by default). Tested on Ubuntu 24.04 GNOME. A .deb for Debian, Ubuntu and derivatives (installs to /opt/PasteFerry and adds a menu entry), or a tar.gz for other distributions (run install.sh to add a menu entry). The background service starts at login through an XDG autostart entry; data lives in ~/.local/share/pasteferry. No tray icon; reopen the window from the app menu. Skips content that password managers mark as sensitive.
- Local network mode (no server): devices on the same subnet find each other over mDNS (`_pasteferry._udp`, broadcasting only an anonymous token that changes daily) and exchange signed signaling over UDP 8788. On a different subnet, the user enters the address shown under the pairing code; addresses are remembered afterwards. Over Tailscale, the user enters the other computer's 100.x address when pairing. On Windows, Settings → Local network → Allow adds a firewall rule (one UAC prompt); on macOS 15, the background service needs the Local Network permission.
- Server (optional; only to sync across networks): a single static Go binary for Linux (x86_64, ARM64), macOS or Windows 10/11 x64. Install scripts register it as a systemd service (Linux), a LaunchAgent (macOS) or a Windows service with a firewall rule (Windows), and default to the machine's LAN address; Docker Compose also works on Linux. The three ways to connect are: the same network (no server), a public server (a cloud VM with a public IP; reachable from any network), or Tailscale (no server; pair by Tailscale address). A server on a LAN is still useful when two subnets can't reach each other. Ports: 8787/tcp (signaling), 3478/udp (STUN/TURN), plus OS-assigned UDP relay ports. In mainland China, cloud providers intercept plain HTTP (including the WebSocket handshake) for domains without an ICP filing, so clients should use the server's IP.
- Content synced: plain text, rich text (HTML plus a plain-text copy), images, files, folders.
- Works on multi-uplink networks (e.g. offices with two ISPs) that pick an uplink per destination: the client probes several STUN servers from one shared port to learn its address on every uplink and sends all of them to the peer. Diagnose with `pasteferry-cli nat`. If a connection lands on the relay first, the client retries the direct path with an ICE restart while idle.
- Items under 50 MB (adjustable 1 MB–1 GB) are pushed on copy; larger files sync as a record and are pulled on demand.
- History keeps 3 days by default (adjustable 1 hour–30 days).
- Pairing: 6-character code valid for 5 minutes (matched on the LAN, or through the server), plus a human check that both devices show the same two fingerprints (one per device's Ed25519 public key), which prevents man-in-the-middle attacks by the server.
- Not supported: iPhone/iPad (iOS forbids background clipboard monitoring). The server stores nothing: while the other computer is unreachable, the latest 20 items are kept in memory and sent when it reconnects (added to its history, not its clipboard).
- Themes (2.10 and later): Settings → Appearance lists built-in themes (Default and Pixel) and custom themes, with light, dark or match-the-system. The Pixel theme uses a bitmap font (Fusion Pixel), notched blocks, bevelled buttons, a neutral graphite/paper palette with a pixel-green accent, header scenes, pixel illustrations and stepped animations; CRT scanlines are optional. Custom themes can be duplicated from a built-in theme, imported or exported as `.pasteferry-theme.json`, and are checked for text contrast when saved. A theme applies only to the device it is set on (on a computer, the main window and quick paste) and is not synced; the Android app has its own Settings → Appearance.
- AI theme editing (MCP): `pasteferry-cli mcp` is a stdio MCP server (protocol 2025-06-18 and 2025-03-26). Tools: theme_list, theme_get, theme_schema, theme_validate, theme_save, theme_apply, theme_delete, background_import, background_analyze; resources pasteferry://themes/schema and pasteferry://themes/{id}. It exposes only themes and background images, never history, devices or contacts, and needs the background service to be running. CLI paths: /Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli (Mac), %LOCALAPPDATA%\Programs\PasteFerry\pasteferry-cli.exe (Windows), /usr/bin/pasteferry-cli (Linux .deb).
- Compared with Apple's Universal Clipboard: no same-Apple-ID or proximity requirement, keeps a history, handles large files and folders.
## Docs
- [Website (English)](https://pasteferry.cc/en/), [简体中文](https://pasteferry.cc/), [繁體中文(台灣)](https://pasteferry.cc/zh-tw/), [繁體中文(香港)](https://pasteferry.cc/zh-hk/), [日本語](https://pasteferry.cc/ja/)
- [Features](https://pasteferry.cc/en/features/): Send Files, sending to contacts, themes, quick paste, favorites, history, files, cross-network sync ([中文](https://pasteferry.cc/features/), [日本語](https://pasteferry.cc/ja/features/))
- [How it works](https://pasteferry.cc/en/how/), [Security](https://pasteferry.cc/en/security/), [FAQ](https://pasteferry.cc/en/faq/)
- [Quick start](https://pasteferry.cc/en/start/): install the apps, pick a way to connect, and pair ([中文](https://pasteferry.cc/start/), [日本語](https://pasteferry.cc/ja/start/))
- [On the same network](https://pasteferry.cc/en/lan/): no server; pairing across subnets, firewall and macOS permission notes ([中文](https://pasteferry.cc/lan/), [日本語](https://pasteferry.cc/ja/lan/))
- [Run the server on a public server](https://pasteferry.cc/en/cloud/): security group, install script, checks ([中文](https://pasteferry.cc/cloud/), [日本語](https://pasteferry.cc/ja/cloud/))
- [Run the server on your LAN](https://pasteferry.cc/en/server/): for subnets that can't reach each other; step-by-step guide for Windows, macOS and Linux ([中文](https://pasteferry.cc/server/), [日本語](https://pasteferry.cc/ja/server/))
- [Use it across networks with Tailscale](https://pasteferry.cc/en/tailscale/): sync across networks with no server, pairing by Tailscale address ([中文](https://pasteferry.cc/tailscale/), [日本語](https://pasteferry.cc/ja/tailscale/))
- [Download](https://pasteferry.cc/en/download/): every client package, with Mac builds for Apple silicon and Intel ([中文](https://pasteferry.cc/download/), [日本語](https://pasteferry.cc/ja/download/))
- [README (English)](https://github.com/baiyuze/pasteferry/blob/main/README.md): features and getting started ([中文](https://github.com/baiyuze/pasteferry/blob/main/README.zh-CN.md))
- [How it works](https://github.com/baiyuze/pasteferry/blob/main/guide/how-it-works.md): architecture, NAT traversal, security model, fallbacks, lessons learned
- [Troubleshooting](https://github.com/baiyuze/pasteferry/blob/main/guide/troubleshooting.md) and known limitations
- [Themes guide](https://pasteferry.cc/en/themes/): change themes, light and dark, make your own theme, the theme file format, and AI-made themes over MCP ([中文](https://pasteferry.cc/themes/), [日本語](https://pasteferry.cc/ja/themes/))
- [Make a theme with AI](https://github.com/baiyuze/pasteferry/blob/main/guide/ai-themes.md): configure `pasteferry-cli mcp` in Claude Desktop, Claude Code or Cursor ([中文](https://github.com/baiyuze/pasteferry/blob/main/guide/ai-themes.zh-CN.md))
- [Server deployment](https://github.com/baiyuze/pasteferry/blob/main/server/deploy/README.md): Windows, macOS, Linux (systemd), Docker and manual setup
- [Licensing](https://github.com/baiyuze/pasteferry/blob/main/LICENSING.md): AGPL-3.0 terms; versions 1.2.0 and earlier remain MIT
- [Windows client design (中文)](https://pasteferry.cc/design/windows-client.html): clipboard formats, file-name compatibility, background process, installer
- [NAT traversal design (中文)](https://pasteferry.cc/design/nat-traversal.html): multi-uplink probing, relay-to-direct upgrade, measurements and the NAT lab
- [Local network mode design (中文)](https://pasteferry.cc/design/lan-mode.html): mDNS discovery, UDP signaling, pairing across subnets, Windows Firewall and macOS Local Network findings, NAT lab scenarios
- [Linux client design (中文)](https://pasteferry.cc/design/linux-client.html): X11 clipboard over XWayland, INCR transfers, XDG autostart, packaging
- [Changelog](https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md)
- [Official service](https://pasteferry.cc/en/official/): optional cross-network access without self-hosting, direct-first relay and quota ([中文](https://pasteferry.cc/official/))
## Download
- [Latest release](https://github.com/baiyuze/pasteferry/releases/latest): DMGs for macOS (Apple silicon, Intel, universal), PasteFerry-Setup.exe and a portable zip for Windows, .deb and tar.gz packages for Linux (x64, ARM64), and server packages for Linux, macOS and Windows
- [Source code](https://github.com/baiyuze/pasteferry)