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.

68.4 KB
Raw Blame

更新记录 / Changelog

2.10.1 — 2026-11-07

This release makes background images work and lets you replace the theme scenery with your own pictures, yourself or through AI.

Changes

  • Background images: Settings › Appearance › Background image fills the window behind the sidebar and pages with a picture. The sidebar and lists become translucent, and blur, scrim and panel opacity have three steps each. Use image colors takes the accent from the picture. It can also show in Quick Paste, and the Android app can pick a background photo.
  • Custom scenery: Settings › Appearance › Scenery replaces the picture behind the page header and the one at the bottom of the sidebar with your own, in any theme; in the pixel theme these are the pixel landscape and camp. Scenery can also be turned off.
  • AI: the MCP theme format now describes background, scenery and scene, so AI apps can set a background image or replace the scenery with pictures imported through background_import.

Fixes

  • Background images saved in a theme, including by AI through MCP, were accepted but never shown. They now appear in the app.
  • The minimum scrim for readable text was calculated too light. It is now measured the way the app draws it, against the theme's own text colors, and text on a background image or header picture always reaches 4.5:1.

Upgrade notes

  • Mac, Windows and Linux apps: optional; update to use background images and custom scenery. Existing themes, pairings, friends, history and settings are preserved, and themes without pictures look the same as before.
  • Android: optional; adds the background photo setting.
  • Server: no update needed.
  • The device-to-device protocol is unchanged and compatible with existing releases. Themes and their pictures stay on each device.

2.10.0 — 2026-11-06

This release adds themes: a new Appearance setting with built-in and custom themes, a pixel-art theme, and an MCP server that lets AI apps design and apply themes.

Changes

  • Themes: Settings › Appearance lists the built-in themes and your custom themes, with light, dark or system appearance. Themes apply to the main window and Quick Paste on this device and are not synced to other devices. The Android app has its own Appearance setting.
  • Pixel theme: a built-in pixel-art theme with a bitmap font, notched borders, bevelled buttons, neutral graphite and paper palettes with a pixel-green accent, page-header scenes, pixel illustrations for empty pages, game-style menu cursors and loading squares, and optional CRT scanlines.
  • Custom themes: duplicate a built-in theme, import or export theme files, and delete themes you no longer need. Text contrast is checked when a theme is saved, and low-contrast colors are reported.
  • AI-designed themes: pasteferry-cli mcp runs an MCP server so AI apps such as Claude and Cursor can read the theme format, design a palette, check contrast, save and apply themes. It only provides theme and background tools, not clipboard history, devices or friends.

Fixes

  • Malformed compressed data from another device can no longer crash the background service (compression library updated for GO-2026-6865).

Upgrade notes

  • Mac, Windows and Linux apps: recommended; update to use themes and to receive the compression fix. Existing pairings, friends, history and settings are preserved, and the default theme looks the same as before.
  • Android: recommended; adds the Appearance setting and includes the compression fix.
  • Server: no update needed.
  • The device-to-device protocol is unchanged and compatible with existing releases. Theme settings stay on each device.

2.9.0 — 2026-11-04

This release adds script-friendly desktop CLI queries and an official Homebrew installation option for Mac, and fixes a pairing-purpose race.

Changes

  • The desktop CLI now reports its own version and provides read-only JSON queries for background status, paired devices, recent clipboard history and settings, with consistent success and error responses.
  • Mac users can install the official desktop app and its bundled CLI from the baiyuze/tap Homebrew cask. The installation guide covers upgrades and existing manual installations.

Fixes

  • Device pairing now rejects a friend code even when a delayed reply from an earlier pairing attempt arrives first.

Upgrade notes

  • Mac, Windows and Linux apps: recommended for the pairing fix and the new CLI version and JSON queries. Existing pairings, friends, history and settings are preserved.
  • Android: optional; includes the shared pairing fix, with no Android-specific interface changes.
  • Server: no update needed.
  • The device-to-device protocol is unchanged and compatible with existing releases.
  • If you installed an earlier 2.9.0 test build, reinstall from this release to receive the final pairing fix; both builds use the same version number. The final desktop build is 53ee171d.

2.8.3 — 2026-11-01

This release improves connection recovery, prevents misleading compatibility messages during connection setup, and makes friend file transfers cancellable.

Fixes

  • Devices now show "Connecting" while the connection and capabilities are being established, instead of misleading update or version mismatch messages. Reconnection also refreshes stale capability information.
  • Settings no longer wait indefinitely for a background-service request. Startup failures can be retried, and settings become available as soon as the configuration is loaded.
  • A failed initial connection can recover without restarting the app. Network setup failures release the failed connection, changing the signaling server cancels the old startup attempt, and Windows retries failed local-network advertisements.
  • Files being sent to a friend can be cancelled from the friend conversation and send dialog, including queued transfers and transfers waiting for acceptance. Ongoing transfers remain visible when the dialog is reopened.
  • File transfer streams remain open until the receiver confirms completion, and cancellation no longer stalls subsequent transfers.
  • Adding a friend can recover when the initial handshake reply arrives before the pairing session is ready.

Upgrade notes

  • Mac, Windows and Linux apps: recommended on each device to receive the connection and Settings fixes. Pairings, friends, history and settings are preserved.
  • Android: optional; includes the shared connection recovery fixes.
  • Server: no update needed.
  • The device-to-device protocol is unchanged and compatible with existing releases.

2.8.2 — 2026-10-30

This release fixes missing desktop history for browser file transfers.

Fixes

  • Browser-to-computer file transfers now appear immediately in the computer's Received list. Computer-to-browser transfers also appear in Sent, with per-file completion, cancellation and live updates.
  • Retained browser transfer records from 2.8.1 are imported into desktop history once. Retries and restarts do not duplicate records or restore deleted history; removing a browser cancels its waiting transfers without deleting received files.

Upgrade notes

  • Mac, Windows and Linux apps: update the computer hosting the phone web page, then reload the browser page. Existing browser sessions and saved files are preserved.
  • Android: native app transfers were not affected by this browser history issue. Android browser users receive the fix from the updated computer.
  • Server: no update needed. The device-to-device protocol is unchanged.
  • A browser download is marked complete when handed to the browser; the page cannot confirm that the browser saved it to disk.

2.8.1 — 2026-10-30

This release improves file transfers on phones, adds a dedicated browser transfer page, and refreshes the cross-device product introduction.

Changes

  • Phone web transfers now have a separate Send Files page with batch uploads, encrypted downloads, progress and persistent records. Computers can queue files for a registered browser from Devices. These transfers do not enter clipboard history or change the clipboard.
  • Android photo and file pickers accept multiple items in one selection for both Send and Send Files, with batch confirmation and an optional Add More action.
  • The website and project introduction now describe clipboard sync, searchable history and file transfer across computers and phones, and highlight the Android file transfer features introduced in 2.8.

Fixes

  • Android and phone web transfer lists use compact rows with actions on the right, readable filenames and metadata, and the same bidirectional transfer icon. Secondary Android actions are available from the row menu.
  • Android and phone web toasts now fit their content, stay horizontally centered and use the existing theme, with wrapping for longer messages.

Upgrade notes

  • Mac, Windows and Linux apps: update the computer hosting the phone web page to use browser file transfers, then reload the phone page.
  • Android: recommended for native batch selection and the improved transfer layout.
  • Server: no update needed.
  • The device-to-device protocol is unchanged. Browser transfer endpoints are additive; existing web sessions remain valid.
  • Browser transfers require the page to remain open on the same network as the computer. Downloads support up to 200 MB per file, uploads up to 4 GB per file, and batches up to 64 files. Interrupted browser uploads must be selected again; queued and completed records survive a reload.

2.8.0 — 2026-10-30

Android can now send and receive files with Send Files (隔空传送), the same feature the desktop apps have.

Changes

  • Android file transfer: the phone has a new Send Files page. Pick a device, choose files or folders, and watch progress; received files can be saved to Downloads or shared to other apps, and an interrupted transfer continues where it stopped. On the same local network the phone uses the same encrypted TCP fast link as the computers, and the phone and a computer can send to each other in both directions.
  • Android capability reporting: the phone now advertises the file transfer capabilities it actually has, so computers stop offering it a feature it cannot use.

Fixes

  • Sending a file from a computer to a phone waited 30 seconds, then failed with "no answer" on every reconnect. The Android app announced file-transfer support it did not implement, and the desktop trusted that announcement; the phone now implements it, and computers no longer treat an older Android build as able to receive files.
  • A received clipboard item whose download timed out was marked failed with no log entry at all, which made the case impossible to diagnose from a diagnostics report. It now logs the reason.
  • A push that failed right after the offer was delivered was dropped permanently when offline catch-up was off. It is now retried when the connection returns, without touching the offline catch-up setting.
  • An outgoing transfer that got no answer showed only "Interrupted". It now says the other device did not respond.
  • The diagnostics report now lists each device's version and whether it can receive files.
  • Copying files whose paths cannot be read (for example from a zip preview or a mail attachment) failed silently. The app now tells the user that nothing was synced.
  • The phone web page showed its toast on a white surface over a near-white page, so the message was hard to see. The toast is now dark with light text, matching the app.

Upgrade notes

  • Mac, Windows and Linux apps: recommended. The diagnostics report and the retry for failed pushes are in the background service, and computers need this version to be offered file transfer from an Android phone.
  • Server: no update needed.
  • Android: required for file transfer. Install the arm64 APK on Android 9 or later; the fixed signing key supports updating in place.
  • The device-to-device protocol is unchanged: a phone and a computer on 2.8.0 use the existing file transfer messages, and older Android builds keep working for clipboard sync.

2.7.4 — 2026-10-29

Android can copy and share images selected from the phone, and phone notifications no longer cover the bottom controls.

Fixes

  • On Android, copying or sharing an image picked from the phone failed because its temporary cache path was not configured for sharing. These images and files now use valid content URIs, and sharing grants the receiving app read access.
  • All toast messages in the Android app and phone web page now appear at the top, below the system safe area, instead of covering bottom controls. Media actions show a short explanation if they fail, rather than a raw exception and stack trace.

Upgrade notes

  • Mac, Windows and Linux apps: recommended when using phone web transfer, which is served by the desktop background service. Pairings, contacts, history and settings are preserved.
  • Server: no update needed.
  • Android: recommended for image copying and sharing. Install the same arm64 APK on Android 9 or later; the fixed signing key supports updating in place.
  • The device-to-device protocol is unchanged and compatible with 2.6.0.

2.7.3 — 2026-10-28

One APK now supports Android 9 and later, and Windows guides phone connections through firewall setup.

Changes

  • Android: the same arm64 APK now supports Android 9 (API 28) and later. Saving photos and files asks for storage access only on Android 9; Android 10 and later keep using MediaStore without that permission.

Fixes

  • On Windows, opening the phone QR code now checks firewall access and requests administrator approval when needed. Cancelled or failed setup stays visible with a retry button, and success is shown only after the rules are verified. Existing access does not prompt again.

Upgrade notes

  • Mac, Windows and Linux apps: recommended on Windows for phone web transfer; optional on Mac and Linux. Pairings, contacts, history and settings are preserved.
  • Server: no update needed.
  • Android: install the same arm64 APK on Android 9 or later. Existing installations can update in place with the fixed signing key. Android 9 asks for storage access only when saving photos or files.
  • The device-to-device protocol is unchanged and compatible with 2.6.0.

2.7.2 — 2026-10-28

The Sent list on the phone can cover more or fewer days.

Changes

  • Android: Settings › Keep sent records sets how many days the Sent list on the send page covers: 1, 3, 7 or 30 days, three when unset.

Upgrade notes

  • Mac, Windows and Linux apps: recommended; pairings, contacts, history and settings are preserved.
  • Server: no update needed.
  • Android: install the APK by hand, or use Settings › Check for updates to open the download link.
  • The device-to-device protocol is unchanged and compatible with 2.6.0.

2.7.1 — 2026-10-28

The phone page no longer records its own copies, the Android app asks before sending and can check for updates.

Changes

  • Android: picking photos or files now opens a sheet that lists every file with its size, and nothing is sent until Send is tapped. Multi-select works.
  • Android: the send page ends with the records this phone sent in the last three days, three rows high so the composer stays in place. Tapping one opens the usual preview; View all shows the whole list and can clear it.
  • Android: Settings has Check for updates. It reads the version list, and when a newer version exists it opens the APK download link in the browser.

Fixes

  • Tapping Copy in the phone page wrote the text into the clipboard of the computer running it, which the app then stored as another record. The same text is now ignored for a minute (images and files keep the short window), so copying the same record again only updates the clipboard.

Upgrade notes

  • Mac, Windows and Linux apps: recommended; the duplicate-record fix is in the background service. Pairings, contacts, history and settings are preserved.
  • Server: no update needed.
  • Android: install the APK by hand; Settings › Check for updates opens the download link.
  • The device-to-device protocol is unchanged and compatible with 2.6.0.

2.7.0 — 2026-10-28

Scan a code with your phone to read the records on the computer, copy one, or send text, photos and files back. Nothing to install.

Changes

  • Phone web transfer: Devices › Phone web transfer turns it on and shows a QR code. Scanning it opens a page in the phone browser, on the same local network, that lists the records from the computer: search them, filter by type, copy a text, look at a picture, download a file. Text, photos and files sent from the page arrive on the computer as a normal record and go into its clipboard. Contents are encrypted between the phone and the computer. A code registers one phone and expires after ten minutes; registered phones can be removed in the same panel. The switch is off by default.
  • Records that came from the phone say so in the history, with the phone's name.
  • Android app (beta): a first build for phones, in PasteFerry-android-arm64.apk. It pairs with the computer the same way, keeps the records and puts what the computer copies into the Android clipboard, and sends text, photos and files back. It is signed with a debug key for now, so Android asks before installing it; a release key comes later.
  • On the phone page, copying and sending report in place instead of over the list, and pressing and holding a record no longer opens the browser's own copy bar.

Upgrade notes

  • Mac, Windows and Linux apps: recommended for phone web transfer. Pairings, contacts, history and settings are preserved. The feature stays off until it is turned on in Devices.
  • Server: no update needed.
  • The device-to-device protocol is unchanged and compatible with 2.6.0.

2.6.3 — 2026-10-27

Quick paste picks items with Option+1–9 on a Mac and lets you choose the key; failed updates now say why.

Changes

  • Quick paste: on a Mac, Option+1–9 now pastes one of the first nine items, the same place as Alt+1–9 on Windows and Linux. Settings › Quick paste lets you pick the key: Option, Command or Control on a Mac; Alt or Ctrl on Windows and Linux.

Fixes

  • Messages such as "Report copied" were hidden behind an open dialog. They now appear on top.
  • When an automatic update failed, the app only said it didn't finish. It now says why, and the reason is also in the log and the diagnostics report.
  • On Linux, when the system showed no password prompt for the update (for example because PasteFerry was started over SSH), the app said the update was cancelled. It now says that no prompt appeared and how to restart PasteFerry from the desktop.

Upgrade notes

  • Mac, Windows and Linux apps: recommended; contacts, pairings, history and settings are preserved. If you got used to ⌘1–9 in 2.6.2, choose Command in Settings › Quick paste.
  • Server: no update needed.
  • The device-to-device protocol is unchanged and compatible with 2.6.0.

2.6.2 — 2026-10-27

Numbers can be searched in quick paste.

Fixes

  • In quick paste, typing a number into the empty search box pasted that item, so numbers such as tracking or phone numbers could not be searched. Numbers now always go into the search box; press ⌘1–⌘9 on a Mac or Alt+1–Alt+9 on Windows and Linux to paste one of the first nine items.

Upgrade notes

  • Mac, Windows and Linux apps: recommended if you use quick paste; contacts, pairings, history and settings are preserved.
  • Server: no update needed.
  • The device-to-device protocol is unchanged and compatible with 2.6.0.

2.6.1 — 2026-10-26

Contacts get their own page in the sidebar, and Mac updates download only the package for the computer's chip.

Changes

  • Contacts now have their own page in the sidebar: search your contacts and see who is online, open one to send files, see your transfers or turn on automatic accepting, or drop files onto it. A badge shows contact requests waiting for you. Send Files keeps its contacts as before.
  • The "Let these people send me files" and avatar menus now look like the other menus in the app.

Fixes

  • In-app updates on a Mac downloaded the universal package (about 50 MB) on every computer; from this version on they download the package for the computer's chip, about half the size.

Upgrade notes

  • Mac, Windows and Linux apps: optional; contacts, pairings, history and settings are preserved.
  • Server: no update needed.
  • The device-to-device protocol is unchanged and compatible with 2.6.0.

2.6.0 — 2026-10-26

Send files to other people's computers: add them as a contact once, then drop files on their avatar. Settings are now split into categories.

Changes

  • Send files to contacts: add someone else's computer once with a contact code, no pairing needed, then drop files or images on their avatar with an optional note of up to 200 characters. Each batch arrives only after they accept it (contacts they trust can be accepted automatically), and contacts never see your clipboard, history or devices. On different networks, both sides turn on Service.
  • Choose who can send you files: no one, contacts only (the default), or everyone on the local network, which switches back to contacts only after 10 minutes.
  • Set a display name and avatar for your contacts. Each contact has a page with their status, automatic accepting and every transfer between you.
  • Paste copied files or images into the Send dialog with Cmd+V or Ctrl+V.
  • Settings now open on a short list of categories (General, Connection, Sync, Quick paste, Send Files, Storage, About), each with its own page, instead of one long page.

Fixes

  • Notifications showed files under 1 MB as 0.0 MB; small sizes are now shown in KB or bytes.

Upgrade notes

  • Mac, Windows and Linux apps: update both computers to use contacts; a 2.5 computer reports that a contact code is not a valid pairing code. Pairings, history and settings are preserved.
  • Server: no update needed.
  • The device-to-device protocol between paired devices is unchanged and compatible with 2.5.x; contacts are a new addition that needs 2.6 on both sides.

2.5.4 — 2026-10-26

Send Files no longer asks you to update a computer that is only still connecting, and the official service is now called Service.

Changes

  • The official service is now called Service in the app, on the website and in the guides.

Fixes

  • In Send Files, a paired computer that was online but not yet connected could show as needing an update, and kept doing so when no connection could be made. It now shows Connecting… until its capabilities are known (click it to reconnect), is treated as outdated only when it stays connected without announcing them, and its last known capabilities are kept across restarts.

Upgrade notes

  • Mac, Windows and Linux apps: optional; update the computers where you use Send Files. Pairings, history and settings are preserved.
  • Server: no update needed.
  • The device-to-device protocol is unchanged and remains compatible with earlier 2.5.x versions (devices now also announce their version, which older versions ignore).

2.5.3 — 2026-10-23

Control which computers share your clipboard, choose whether to catch up after reconnecting, and quit the app completely.

Changes

  • Real-time clipboard sharing can now be paused globally or for each paired computer. Local history, manual downloads and Send Files remain available.
  • Offline clipboard catch-up is now off by default, including after upgrading. Reconnecting or resuming sharing starts with new copies. Optional catch-up adds up to 20 missed copies from the last 24 hours to history without replacing the current clipboard.
  • Launch at login now has its own setting. Changing it does not stop the current session, and quitting does not change the next-login preference. New installations start with it off; upgrades preserve existing login entries.

Fixes

  • Quit PasteFerry now stops the main window, clipboard background service and quick paste helper without immediately restarting them. Closing the window keeps the app running and explains this on first use.

Upgrade notes

  • Mac, Windows and Linux apps: update each computer where you want the new controls and complete exit behavior. Offline catch-up is disabled by default after upgrading; enable it in Settings if needed. Pairings, history and existing launch-at-login choices are preserved.
  • Server: no update needed.
  • The device-to-device protocol is unchanged and remains compatible with earlier 2.5.x versions.

2.5.2 — 2026-10-22

Reliable device capability detection and a circular radar at small window sizes.

Fixes

  • An up-to-date device could incorrectly show as needing an update in Send Files when its capability announcement was lost at connection startup. The control receiver is now installed before the connection is announced, and capabilities are refreshed periodically.
  • The Send Files radar now stays circular in small windows. The rings, device icons and labels scale together instead of stretching into a narrow ellipse; the selected side-by-side or stacked layout is preserved.

Upgrade notes

  • Mac, Windows and Linux apps: update both computers to make capability exchange reliable in both directions. Existing pairings and settings are preserved.
  • Server: no update needed.
  • The device-to-device protocol is unchanged and remains compatible with 2.5.0 and 2.5.1.

2.5.1 — 2026-10-22

Faster Send Files on the local network, with more reliable recovery and a layout that stays side by side.

Changes

  • Send Files uses an encrypted TCP fast link on the local network. A 1 GB file reached 144.3 MB/s from Mac to a Linux VM, up from 18.7 MB/s. If the fast link is unavailable, transfers automatically use the existing data channel; internet and relay transfers keep their existing transport.
  • On Windows, the firewall Allow button now permits both UDP and TCP traffic for PasteFerry.

Fixes

  • A transfer whose request was lost while the receiver restarted could stay interrupted after reconnection. It now retries once after a short delay when the devices are already connected.
  • If the delivery receipt is lost, resuming a completed transfer now marks it as delivered instead of sending a second copy.
  • The Send Files page now keeps the radar and transfer list side by side at every window size when that layout is selected. Device labels no longer overlap in narrow windows.

Upgrade notes

  • Mac, Windows and Linux apps: update both computers to use the local network fast link. Updating only one side is safe; transfers keep using the existing data channel. Actual speed depends on the network and disks.
  • Server: no update needed.
  • The device-to-device protocol is backward compatible: 2.5.1 adds an optional fast-link capability and address that older versions ignore.

2.5.0 — 2026-10-22

Send Files: drop files or folders onto a device to send them straight to it.

Changes

  • Send Files: a new Send Files page shows your paired devices on a radar. Drop files or whole folders onto a device, or click it and choose them, to send them straight to that computer. There's no size limit, and received files go to your Downloads folder (changeable in Settings) instead of your history.
  • Resumable transfers: transfers show progress, speed and time left. If the connection drops, they pick up where they stopped: automatically within 30 minutes, or later with Continue. Every file is checked with SHA-256, and the computer doesn't fall asleep while files are moving.
  • Official relay: when only the official relay gets through, you're asked before sending. A transfer pauses when the day's allowance runs out and continues once the devices connect directly or the allowance resets.
  • Settings: a Send Files section to turn receiving on or off, choose where files are saved, turn notifications on or off, and put the transfer list beside or below the radar.
  • Sidebar: grouped into History, Favorites and Send Files first, then Devices, Official service and Settings.

Upgrade notes

  • Mac, Windows and Linux apps: update both computers to send files between them. A device still on an older version shows on the radar as needing an update; clipboard sync keeps working either way.
  • Server: no update needed.
  • The device-to-device protocol is compatible: 2.5.0 adds a capability message and new transfer messages that older versions ignore.

2.4.2 — 2026-10-22

Reconnect a device from its menu and give your favorites names, plus a fix for previewing favorited images.

Changes

  • Reconnect: a paired device on a relay or offline now has Reconnect in its menu. It tries a direct connection right away instead of waiting for the next automatic retry, and stays on the relay without dropping the connection if a direct one still isn't possible. Devices that are already connected directly don't show it.
  • Rename favorites: hover over a favorite and click the pencil to give it a name, such as “Expense receipt” for a screenshot. Favorites and quick paste show the name, and search finds it, by pinyin too. Clear the name to show the content again.

Fixes

  • Clicking a favorited image in Favorites said “This image has been deleted from the history” instead of showing it. It opens the preview now.

Upgrade notes

  • Mac, Windows and Linux apps: recommended. Reconnect is quickest when both devices run 2.4.2: when the other device is older, a reconnect started from this side may wait for that device's own retry.
  • Server: no update needed.
  • The device-to-device protocol is unchanged; 2.4.2 adds an optional reconnect request that older versions ignore.

2.4.1 — 2026-10-21

Search Chinese text by pinyin, plus two quick paste fixes.

Changes

  • Pinyin search: search Chinese text by pinyin, in quick paste and in History: full pinyin (huiyi), initials (hy) or a mix (huiy) all find 会议. Polyphones match every reading.

Fixes

  • On a Mac, Allow… in quick paste now always puts PasteFerry back in the Accessibility list, even after you removed it there.
  • While you type a search in quick paste, the list keeps the previous results until the new ones arrive instead of flashing “No results”.

Upgrade notes

  • Mac, Windows and Linux apps: recommended. Pinyin search runs in the background service of each computer, so update the computers where you search. Mac permissions granted to 2.4.0 are kept.
  • Server: no update needed.
  • The device-to-device protocol is unchanged.

2.4.0 — 2026-10-21

Quick paste: press ⌥V or Alt+V in any app to pick from your history and paste it right where you are typing. Plus favorites, a Links filter and hover cards.

Changes

  • Quick paste: press ⌥V on a Mac or Alt+V on Windows and Linux in any app to bring up your history. Type to search, then press a number or Return to paste the item where you were typing; Shift+Return pastes plain text and ⌘Return or Ctrl+Enter only copies. You can change or turn off the shortcut in Settings.
  • Pasting for you: on a Mac this needs the Accessibility permission; without it the item is copied and you press ⌘V. On Linux with Wayland, picked items are copied and you press Ctrl+V.
  • Favorites: star an item to keep a copy of it. Favorites never expire, stay when you clear your history and appear in quick paste too. They stay on the computer where you saved them.
  • Links filter and hover cards: History has a Links filter, and resting the pointer on an item shows its full text, a larger image or every file name.
  • Mac signing: the Mac app is now signed with a fixed PasteFerry certificate, so permissions you grant, such as Accessibility, are kept when the app updates.

Fixes

  • Apps that write the clipboard twice for one copy no longer leave two identical records.
  • Content PasteFerry put on the clipboard itself, such as an item received from another device, could occasionally be recorded again as a new copy, and in rare cases the background service crashed while doing so.
  • A background service that hangs while quitting is now stopped after 10 seconds, so it can no longer keep the new one from starting after an update or restart.
  • While you type with an input method, History search waits until you pick the characters instead of searching the romanization.

Upgrade notes

  • Mac, Windows and Linux apps: recommended on every computer; quick paste and favorites work on each computer on its own. On a Mac, this version changes the app's signature once: if macOS asks again for a permission (such as Local Network), allow it. To let quick paste paste for you, turn on PasteFerry in System Settings → Privacy & Security → Accessibility. Later updates keep these permissions.
  • Server: no update needed.
  • The device-to-device protocol is unchanged.

2.3.0 — 2026-10-19

Update PasteFerry from inside the app: check for a new version, read what changed in your language, and install it after you confirm.

Changes

  • Check for updates: in Settings → About. After you confirm, PasteFerry downloads, verifies and installs the new version and reopens by itself; your devices, history and settings stay. This works for the macOS app, the Windows installer and portable builds, and the Linux .deb and tar.gz builds.
  • Release notes in your language: English, Simplified Chinese, Traditional Chinese (Taiwan and Hong Kong) and Japanese. If you are several versions behind, each version is listed.
  • Automatic checks: a daily check shows a quiet hint in the sidebar when a new version is out. You can skip a version or turn automatic checks off. The check only reads the update list on GitHub and Gitee and sends nothing that identifies you.
  • Signed updates: the app only installs a package whose checksum appears in an update list signed by the PasteFerry release key.
  • Gitee mirror: in mainland China, installers are also mirrored on Gitee, linked from the Chinese download pages. Updates download from whichever of GitHub and Gitee answers first.

Fixes

  • On Linux, restarting the background service with the window open, as the app does after it is upgraded by hand, could leave the service stopped until PasteFerry was opened again. The service now stops within two seconds, so the restart goes through.
  • A device that closes Search nearby now disappears from the other devices' lists right away, instead of sometimes lingering for up to seven seconds.

Upgrade notes

  • Mac, Windows and Linux apps: install 2.3.0 by hand once; later versions can be installed from the app. Mixing 2.3.0 with 2.1.0 and 2.2.0 devices is fine.
  • Server: no upgrade needed; the self-hosted server is unchanged.
  • The device-to-device protocol is unchanged.

2.2.0 — 2026-10-19

See today's relay allowance as soon as official access is enabled, before any relay is used, and see how each device connects.

Changes

  • Relay allowance at a glance: the official service page shows the remaining allowance, the daily limit and a bar that stays full until relay is used, followed by used, upload, download, reset and update time. Figures are fetched when official access is enabled and after restarts, refreshed every 60 seconds while idle and every 15 seconds while relaying.
  • How devices connect: the same page lists whether each paired device is connected directly, through relay or offline. Direct connections do not use the allowance.
  • Connection state: shown as a status dot beside the page title, in normal colors unless something is actually wrong.
  • Command line: pasteferry-cli status prints the official allowance.
  • Privacy: the allowance check uses only the device signature. It does not request relay or read a machine identifier.

Fixes

  • The official service page no longer shows "Relay not requested; allowance not yet verified" in warning colors while every device connects directly.
  • After the official gateway restarts, the app requests a new allowance token instead of reporting the allowance as unavailable for up to 15 minutes.

Upgrade notes

  • Mac, Windows and Linux apps: upgrade to see the allowance before relay is used. Mixing 2.1.0 and 2.2.0 devices is fine.
  • Server: no upgrade needed; the self-hosted server is unchanged.
  • The device-to-device protocol is unchanged.

2.1.0 — 2026-10-16

Sync across networks without hosting a server. Enable optional official access, try direct connections first and use encrypted relay only when needed. The official website is now https://pasteferry.cc/.

Changes

  • Official service: enable one switch in Settings on each computer, with no server address to configure. Both peers try direct NAT traversal before separately authorizing an encrypted WSS relay tunnel to standard TURN.
  • Relay allowance: view upload, download, remaining allowance and reset time in a dedicated sidebar page, with MB shown to two decimal places. The current default is 100 MB per machine quota group per day, upload plus download, resetting at midnight Beijing time. Direct traffic does not use this allowance.
  • Clear settings: save custom servers with Save and connect or Enter; unsaved edits do not change the active connection. Shorter settings copy keeps full privacy and service-disable information in the action confirmations.
  • Large-file feedback: receive files explicitly from History, follow their transfer state and receive desktop notifications when supported and enabled.
  • Privacy: official access is off on fresh installs. Public handshakes use generic device labels, and real names travel through the encrypted peer channel. Machine quota identification happens only when relay is requested.
  • Website and guides: publish official-service onboarding in five languages at pasteferry.cc, with direct-first routing, allowance and privacy information. Existing GitHub Pages addresses redirect to the new official website.
  • Dependencies: update the Go toolchain and networking dependencies.

Fixes

  • Resume relay automatically after allowance is increased and retire closed tunnels immediately so interrupted clipboard updates enter the retry queue.
  • Release authenticated signaling sockets after abrupt or half-closed TCP disconnects so reconnects do not accumulate server connections.
  • Preserve received history when writing the clipboard fails, and report the failure so a completed transfer is not confused with a failed clipboard action.
  • Isolate pairing checks from public STUN and align local relay binding with the transport fixtures for hosted Windows runners.
  • Fix macOS packaging under UTF-8 locales when reporting DMG filenames.

Upgrade notes

  • Mac, Windows and Linux apps: update both peers to 2.1.0 for official relay. Existing identities, pairings and history are retained. Official access must be enabled on each computer; current limits and availability appear in the app.
  • Server: updating is recommended for dependency and signaling fixes. Self-hosted servers remain independent of the private official gateway and require no private authorization API, callback or SDK.
  • The device-to-device protocol adds optional signed negotiation and encrypted display metadata. Existing LAN and self-hosted transfers remain compatible. Older apps retain official signaling and direct support, but cannot use or bypass the new official relay gateway.

2.0.0 — 2026-10-14

CopySync is now PasteFerry (隔空贴 in Chinese). Everything carries the new name, and your pairings, history and settings come along.

Changes

  • New name: the app, the installers, the background service (pasteferryd), the command-line tool (pasteferry-cli), the server (pasteferry-server) and the data folders are now called PasteFerry, and 隔空贴 in Chinese. The project moved to github.com/baiyuze/pasteferry and the website to baiyuze.github.io/pasteferry; old links redirect.
  • Moving over from CopySync: the first time PasteFerry opens, it stops and removes the old CopySync background service, and turns background sync on for PasteFerry if it was on before. PasteFerry's background service then moves the old data folder into place, so you don't need to pair again. The Windows installer removes the old installation, and the Linux package replaces the copysync package. On a Mac, drag the old CopySync app to the Trash.

Upgrade notes

  • Mac, Windows and Linux apps: upgrade every computer. On the same network, PasteFerry 2.0.0 and CopySync 1.x no longer find each other.
  • Server: optional. The server protocol is unchanged, so a CopySync 1.x server keeps working. To rename it too, run the new install script: it removes the old copysync-server service and keeps its settings. With Docker, remove the old container first (docker rm -f copysync-server).
  • The device-to-device protocol changed on the local network: discovery and LAN packets use new identifiers, so devices on 1.x and 2.0.0 don't see each other there. Connections through a server are unchanged.

1.7.0 — 2026-10-13

Search your history, use CopySync in Traditional Chinese, and report problems with a diagnostics report you can read before posting.

Changes

  • Search the history: a search field on the History page finds earlier copies by their text or file name, across everything you keep, not only the newest items. Matches are highlighted, and for long text the list shows the part around the match. Press ⌘F (Ctrl+F on Windows and Linux) to jump to it and Esc to clear it. It works together with the All, Text, Images and Files filter.
  • Traditional Chinese: the app is now in Traditional Chinese for Taiwan and for Hong Kong, each in its own wording. It follows the system language (Hong Kong and Macau use the Hong Kong version), or you can pick it in Settings. The website has Traditional Chinese pages too, and a language menu in the top bar.
  • Report a problem: Settings → Report a problem shows a diagnostics report with the app version, your system, settings, connection state and recent logs. Device names, the server address, public IP addresses, your user folder and file names are replaced before you see it, and what you copy is never logged. Copy it or save it as a file, then open a GitHub issue with the version filled in; nothing is uploaded for you. For connection problems, turn on detailed logging for 30 minutes, make the problem happen again, and regenerate the report.

Upgrade notes

  • Mac, Windows and Linux apps: upgrading is recommended on every computer; search, Traditional Chinese and the problem report come with the new app.
  • Server: no changes; upgrading is optional.
  • The device-to-device protocol is unchanged.

1.6.4 — 2026-10-13

A fix for the Mac app: the background service no longer uses more and more memory the longer it runs.

Fixes

  • On a Mac, the background service (CopySync Daemon) leaked a few kilobytes every time it checked the clipboard, which it does several times a second. Its memory grew by about 1 GB a day, and Activity Monitor could show it at 1 GB or more. Copying images and files leaked their data too. Its memory now stays flat. Your clipboard history and copied files were never kept in memory: the history is stored in a database on disk and files in a cache folder, so nothing was lost.

Upgrade notes

  • Mac, Windows and Linux apps: upgrading the Mac app is recommended. Until you upgrade, quitting and reopening CopySync frees the memory. Nothing changed for Windows and Linux; upgrading them is optional.
  • Server: no changes; upgrading is optional.
  • The device-to-device protocol is unchanged.

1.6.3 — 2026-10-12

The Windows app now brings the Visual C++ runtime it needs, so it also starts on computers that don't have it installed.

Fixes

  • On Windows, the app needs three Visual C++ runtime files (msvcp140.dll, vcruntime140.dll, vcruntime140_1.dll) that Windows doesn't always include. On a computer without the Visual C++ Redistributable, CopySync didn't open and Windows reported that MSVCP140.dll was not found. The installer and the portable zip now include these files next to CopySync.exe; you still don't need administrator rights or a separate download.

Upgrade notes

  • Mac, Windows and Linux apps: upgrading the Windows app is recommended, and needed if it didn't start before. Nothing changed for Mac and Linux; upgrading them is optional.
  • Server: no changes; upgrading is optional.
  • The device-to-device protocol is unchanged.

1.6.2 — 2026-10-12

The Windows installer now runs on every version of Windows 10.

Fixes

  • On Windows 10 versions before 21H2, the installer stopped with "This program does not support the version of Windows your computer is running", although the app itself works there. It now installs on any version of Windows 10, and on Windows 11 as before.

Upgrade notes

  • Mac, Windows and Linux apps: the apps themselves are unchanged; upgrading is optional. On Windows 10 before 21H2, you can now use the installer instead of the portable zip.
  • Server: no changes; upgrading is optional.
  • The device-to-device protocol is unchanged.

1.6.1 — 2026-10-12

A fix for the Mac app: discovery on the local network no longer restarts every minute or two while a paired computer is offline.

Fixes

  • On a Mac, while a paired computer on the same network was offline, the background service mistook the failed sends to it for macOS blocking local network access. It then restarted discovery on the local network every one to two minutes, which could make the Search nearby list flicker. Now it tells the two cases apart, and still shows the local network notice when macOS really blocks access.

Upgrade notes

  • Mac, Windows and Linux apps: upgrading the Mac app is recommended. Nothing changed for Windows and Linux; upgrading them is optional.
  • Server: no changes; upgrading is optional.
  • The device-to-device protocol is unchanged.

1.6.0 — 2026-10-12

CopySync now runs on Linux, and the Mac app comes in separate downloads for Apple silicon and Intel.

Changes

  • Linux client: syncs text, rich text, images, files and folders with Mac and Windows, on the same network or through a server. It runs on x64 and ARM64 with X11, or with Wayland through XWayland (GNOME and KDE include it). Get the .deb for Debian, Ubuntu and derivatives, or the tar.gz for other distributions. The background service starts at login and keeps syncing after you close the window.
  • Mac downloads per chip: CopySync-mac-apple-silicon.dmg and CopySync-mac-intel.dmg are about half the size of the universal CopySync.dmg, which is still available.
  • Download page: the website has one download button that opens a page listing every package. It suggests the build for your system, including your Mac's chip.

Fixes

  • On macOS 13 and 14, the background service and the command line tool could not start: they were built to require macOS 15. They now run on macOS 13 and later, like the app.

Upgrade notes

  • Mac, Windows and Linux apps: install the Linux app on each Linux computer and pair it as usual. Mac and Windows don't need to upgrade to sync with it. Upgrade Macs on macOS 13 or 14; elsewhere upgrading is optional. On a Mac, you can switch to the build for your chip; your settings and pairings stay.
  • Server: no changes; upgrading is optional.
  • The device-to-device protocol is unchanged.

1.5.0 — 2026-10-12

Pair two computers on the same network without a code: open Search nearby on both and click the other one. This release also fixes mixed fonts on Windows.

Changes

  • Search nearby: a new button next to Add device opens a radar showing the nearby computers that have the same window open. Click one to pair; both screens then show the usual fingerprints to compare. Add device and pairing codes work as before and are still the way to pair across subnets.
  • Privacy on the network: a computer broadcasts its name only while Search nearby is open. The rest of the time, others on the network still see only an anonymous entry that changes daily.
  • Command line: copysync-cli nearby [NAME] does the same from a terminal.
  • Website: the same network guide explains pairing without a code.

Fixes

  • On Windows, Chinese text mixed glyphs from different fonts within one line. The app now uses Segoe UI with Microsoft YaHei UI for Chinese (Yu Gothic UI in the Japanese interface), and Consolas for codes, fingerprints and addresses.

Upgrade notes

  • Mac and Windows apps: upgrade both computers to use Search nearby. A computer on an older version doesn't appear on the radar but still pairs with a code and keeps syncing.
  • Server: no changes; upgrading is optional.
  • The device-to-device protocol is unchanged. Search nearby adds two messages on the local network and two mDNS TXT fields; older versions ignore them.

1.4.0 — 2026-10-11

Computers on the same network now pair and sync without a server. You only need a server to connect computers on different networks.

Changes

  • No server on the same network: computers on one network find each other and pair with the usual six-character code. There is nothing to deploy.
  • Different subnets: the pairing dialog shows this computer's address under the code. If the two computers are on different subnets, type that address on the other one. Addresses are remembered afterwards; if both change, use Enter its address… in the device's menu.
  • Tailscale without a server: pair by typing the other computer's Tailscale (100.x) address.
  • The server is optional: leave its address empty in Settings to sync on your network only. Devices paired on the network also sync through a server once you add one. With both, computers on the same network connect directly and keep syncing when the server is down.
  • Settings → Local network: turn local discovery on or off. On Windows, Allow adds a firewall rule for CopySync with one administrator prompt. On a Mac, CopySync tells you when macOS blocks local network access and links to the setting.
  • Privacy on the network: other people on the network see only an anonymous entry that changes daily, never the device name. Messages between devices are signed as before, and pairing still asks you to compare fingerprints.
  • Website: a new guide for computers on the same network. The Tailscale guide no longer needs a server, and the LAN server guide stays for networks that keep devices apart, such as guest Wi-Fi.

Fixes

  • Unpairing a device now closes its connection right away.
  • A device now accepts a signed message only when the message is addressed to it.

Upgrade notes

  • Mac and Windows apps: upgrade both computers to sync without a server; with a server, 1.4.0 still works with older versions. If you never changed the server address (the built-in 127.0.0.1 placeholder), it is cleared and the app runs without a server. On macOS 15, allow CopySync Daemon when macOS asks about finding devices on your local network; on Windows, allow CopySync when the firewall asks.
  • Server: no changes; upgrading is optional.
  • The device-to-device protocol is unchanged. Computers on the same network also exchange messages over UDP port 8788 and find each other over mDNS (_copysync._udp); older versions ignore both.

1.3.4 — 2026-10-11

New step-by-step guides on the website for getting started and for choosing where to run the server. The apps and the server are unchanged apart from the version number.

Changes

  • Quick start: a new quick start walks through installing the apps, choosing where to run the server, entering its address and pairing.
  • Three ways to run the server, each with its own guide: a public server reachable from any network, your LAN, or LAN + Tailscale to sync across networks without a public server.
  • The website, README and server deployment guide are reorganized around these three options, in English, Chinese and Japanese.

Upgrade notes

  • Mac and Windows apps: no functional changes; upgrading is optional.
  • Server: no changes; upgrading is optional.
  • The device-to-device protocol is unchanged.

1.3.3 — 2026-10-11

  • 服务器可以装在 Windows 上了:新增 copysync-server-windows-amd64.zip,解压后双击 install.cmd,注册为开机自启的 Windows 服务(低权限的 LOCAL SERVICE 账户),并在 Windows 防火墙里只为它放行;双击 uninstall.cmd 卸载。 The server now runs on Windows. Extract copysync-server-windows-amd64.zip and double-click install.cmd: it registers a Windows service under LOCAL SERVICE that starts with Windows, and adds a firewall rule for the server only. uninstall.cmd removes it.
  • Mac 上一条命令装好服务器:copysync-server-macos.tar.gz 里新增 install.sh,注册为 LaunchAgent,登录后自动运行,不需要管理员权限。 One-command server install on a Mac: the macOS package now includes install.sh, which registers a LaunchAgent; no administrator rights needed.
  • 三个平台的安装脚本默认用本机的局域网地址启用 TURN 中转,也可以指定地址;重复运行即为升级,设置保留;都支持 uninstall。Linux 的 sudo ./install.sh 不带参数时也改为使用局域网地址(此前不启用中转)。 All install scripts default to the machine's LAN address for the TURN relay, accept an explicit address, upgrade in place and can uninstall. On Linux, sudo ./install.sh without an address now uses the LAN address instead of disabling the relay.
  • 服务器新增 -log <文件> 参数,日志写入文件,超过 10 MB 自动换新。 New -log <file> server option; the log rotates at 10 MB.
  • 官网新增在局域网里部署服务器图文教程(中文、英文、日文),顶部导航可以直达。README 精简,工作原理、排障、从源码构建移到 guide/。 New LAN server guide on the website, linked from the top bar. The README is shorter; how it works, troubleshooting and building moved to guide/.
  • 客户端没有变化,不需要升级;设备间协议不变。 No client changes and no protocol changes; clients don't need to upgrade.

1.3.2 — 2026-10-10

  • 修复与 UU 远程同时使用时,.uuremote_aeawv… 临时占位文件不断进入复制记录并被转发的问题。发送前过滤占位文件,混合选择保留真实文件;接收端忽略旧版发来的纯占位记录与后续传输头。 Fixed repeated UU Remote placeholder file records and forwarding. Filter placeholders before sending; preserve ordinary files in mixed selections and ignore placeholder-only offers from older clients.
  • 启动时清理历史中仅包含已确认占位文件的记录,不删除 UU 源文件,不清空正常记录。普通空文件、隐藏文件与大文件保持原行为。 Remove placeholder-only history on startup without deleting UU source files or ordinary history. Normal empty, hidden and large files retain their behavior.
  • 50 MB 自动传输阈值和 UDP P2P 设置无需改动。建议两端都升级,服务器不需要升级,设备间协议不变。 No change to the 50 MB auto-transfer threshold, UDP P2P settings or wire protocol. Upgrade both clients; no server upgrade required.

1.3.1 — 2026-10-09

  • 点一下记录就能预览图片,去掉了单独的「预览」按钮(它和悬停才出现的按钮挤在一起,位置看起来是错的)。 Click a history item to preview it; the separate Preview button is gone.
  • 复制的图片文件也能预览:PNG、JPEG、GIF、WebP、BMP,Mac 上还有 iPhone 照片常见的 HEIC 和 TIFF (由系统转换,按拍摄方向转正)。一次复制了几张图片的,可以用左右箭头或方向键翻看。 Copied image files can be previewed too: PNG, JPEG, GIF, WebP, BMP, plus HEIC and TIFF on Mac. Step through several with the arrows or arrow keys.
  • 单张图片文件在列表里显示图片图标。 Single image files show an image icon in the list.

1.3.0 — 2026-10-09

  • 界面支持简体中文、英文、日文:默认跟随系统语言,也可以在「设置 → 这台 Mac / 这台电脑 → 语言」里切换。 Windows 托盘菜单也跟着变。图片和文件记录的标题按当前语言显示。 The interface is now in English, Simplified Chinese and Japanese. It follows the system language and can be switched in Settings; the Windows tray menu follows too.
  • **许可改为 GNU AGPL-3.0,另提供商业授权。**个人和公司都可以免费使用和修改;分发、或通过网络提供修改过的版本时, 需要以同样的许可公开源码。闭源产品、不公开的修改、托管服务等情况可以购买商业授权,见 LICENSING.md。 1.2.0 及更早的版本仍适用 MIT。 License changed to the GNU AGPL-3.0, with commercial licenses available. Versions 1.2.0 and earlier remain MIT. See LICENSING.md.
  • 复制记录:鼠标移到一行上时,「预览」按钮不再被挤开换位置,不容易点错。 History: the Preview button no longer shifts when you hover a row.
  • 图片预览按应用窗口的比例定大小(窗口的 80%),小图按原始大小显示、不放大。 Image preview is sized relative to the app window, and small images are no longer upscaled.
  • 配对对话框在文字较长(英文、日文、系统字号调大)时改为滚动,不再溢出。 The pairing dialog scrolls instead of overflowing with longer text.
  • 网站改版:整页深色,新增日文页面,首次打开按浏览器语言显示;技术方案放到网站上,不用再跳到 GitHub。 New website design with a Japanese page and language detection; design notes are now hosted on the site.
  • 服务器不需要升级;设备之间的协议没有变化。 No server upgrade needed; the device-to-device protocol is unchanged.

1.2.0 — 2026-10-09

  • 新增 Windows 客户端:Windows 10(21H2 起)与 Windows 11,x64。与 Mac 互通,Mac 与 Mac、 Mac 与 Windows、Windows 与 Windows 都可以配对同步。文本、带格式文本、图片、文件、文件夹都支持, 粘贴文件时得到的是真实文件,能直接粘进资源管理器、微信、Office。 New: Windows client (Windows 10 21H2+ and 11, x64). Works with Macs and with other Windows PCs; pasted files are real files.
    • 安装程序按用户安装,不需要管理员权限;另有便携版 zip。开机自启、崩溃后自动重启, 关掉窗口后在右下角托盘里继续运行,桌面上有快捷方式。 Per-user installer with no admin rights, plus a portable zip. Starts at login, restarts after a crash, and stays in the notification area; desktop shortcut included.
    • Mac 上合法、Windows 上不合法的文件名(含冒号、问号等)换成对应的全角字符;只差大小写的 文件不会互相覆盖;跳过 .DS_Store 等 Mac 系统文件。 File names Windows doesn't allow get full-width characters; names differing only in case never overwrite each other.
    • 密码管理器标记为「不要记录」的内容不同步、不进复制记录(Mac 版尚未支持)。 Content that password managers mark as sensitive is skipped (not yet on Mac).
    • 设备私钥用 Windows 的 DPAPI 加密存放。 The device key is encrypted with DPAPI.
  • 复制记录里的图片可以点开预览:缩放、拖动、适应窗口;还没下载的先拉取,预览用的下载 不会改写当前剪贴板。 Image preview in the history, with zoom and pan; downloading for a preview doesn't touch your clipboard.
  • 修复:配对成功后多出一个确认框,点了也没用。 Fixed: an extra, useless confirmation dialog after pairing.
  • 修复:打包文件夹时其中某个文件打不开(比如正被别的程序锁住),整个传输都会失败。现在跳过那一个。 Fixed: one unreadable file inside a folder broke the whole transfer; it's now skipped.
  • 网站与 README 增加 Windows 的安装说明;技术方案见 design/windows-client.md,实机验证记录见 design/windows-validation-2026-10-09.md。
  • 服务器不需要升级。新增的 GetImagePreview 只是界面与本机后台服务之间的接口,设备之间的协议没有变化。 No server upgrade needed; the device-to-device protocol is unchanged.

1.1.2 — 2026-10-09

  • **修复:家里那台一重启就只能中转,重试也换不回直连。**谁的包先到,谁的路由器就先收到陌生来源的包; 实测公司路由器会为它占住端口,本机随后往外发只好换端口,打洞失败。对方重启、或 ICE 重启时,总是对方 先拿到本机的地址、先发包。现在由规则决定谁先发包:一方先公布出口地址,另一方收到后先往那边发包再公布 自己的;初次握手由发起方等,换直连的重试里两种顺序轮流用。 Fixed: restarting the home Mac always fell back to the relay, and retries never got back to direct. Some routers lock a port when the other side's packet arrives first. A rule now decides who sends first, and retries alternate the order.
  • NAT 打洞实验室新增两种「路由器会为外来的包占住端口」的场景,并给信令加上延迟,共 11 种。 The NAT lab adds two port-locking router scenarios with signaling delay (11 in total).
  • 协议:SdpOffer 新增 answerer_waits 字段。服务器不需要升级。 Protocol: SdpOffer.answerer_waits. No server upgrade needed.

1.1.1 — 2026-10-09

  • **修复:对方断线后,复制的内容发不过去。**连接悄悄断了(对方睡眠、断网、重启),本端却以为还连着, 不重连,复制的内容全部发进一条死连接,日志还记成「已发送」。现在连接失效会立即关闭并重连;对方重建了 连接,本端也随之换新;没真正送达的不再算成功。 Fixed: items copied after the other Mac dropped off never arrived. A connection that died silently was never closed or reconnected, and everything copied afterwards went into it. Dead connections are now closed and rebuilt, and a transfer only counts once the data has actually left.
  • 补发:复制时对方连不上,就记下最近 20 条,连接恢复后补发。补发的只进复制记录,不写进对方的剪贴板。 Catch-up: items copied while the other Mac is unreachable (latest 20) are sent when it reconnects. They go into its history, not its clipboard.
  • 先中转,再换直连:对端刚启动时出口地址可能晚到,第一次握手落到中转后就一直中转。现在中转时由发起方 在空闲时用 ICE 重启再打一次洞,打通就换成直连(10 秒后第一次,之后间隔逐步拉长到 15 分钟)。 Relay first, direct later: a connection that lands on the relay now retries the direct path with an ICE restart while idle, and switches when it works.
  • 出口探测并发解析域名,整轮从约 1.6 秒降到 0.2 秒以内;中转等待从 3 秒放宽到 5 秒。 Uplink probing resolves hostnames in parallel (about 1.6 s down to under 0.2 s); the relay wait is now 5 s.
  • NAT 打洞实验室新增「一开始打不通,先中转后换直连」场景,共 9 种。 The NAT lab adds a relay-then-direct scenario (9 in total).
  • 协议:ClipOffer 新增 backlog 字段。服务器不需要升级。 Protocol: ClipOffer.backlog. No server upgrade needed.

1.1.0 — 2026-10-08

  • 多出口网络也能直连:公司双线、运营商 NAT 地址池这类网络有多个出口,并按目标地址选出口。 以前只向自己的服务器探测一次,只知道其中一个出口的地址,发往对端的包从别的出口出去就对不上, 只能走中转。现在所有连接共用一个本地端口,在这个端口上向多台服务器探测,拿到每个出口的地址 一并发给对端;会改端口的出口也能拿到真实映射,探测漏掉的不改端口出口按历史推算。 Direct connections on multi-uplink networks. Office networks with several uplinks pick an uplink per destination; CopySync now probes every uplink from one shared port and sends all of them to the peer.
  • 中转路径要等 3 秒才允许被选中,给直连留出打通的时间。 Relay paths wait 3 s before they can be selected.
  • 设置里新增「用公共服务器探测网络出口」开关,关闭后只用自己的服务器。 New setting to probe with your own server only.
  • 新增 copysync-cli nat:查看本机有几个出口、各设备走直连还是中转。 New copysync-cli nat diagnostics.
  • 新增 NAT 打洞实验室(tools/natlab),在 CI 里用真实的网络拓扑验证 8 种场景。 New NAT lab that checks 8 network topologies in CI.
  • 服务器:TURN 可以绑定指定 IP(relay.Options.ListenIP)。 Server: TURN can bind to a specific IP.

1.0.2 — 2026-10-08

  • 修复:一端经中转时,另一端误显示为「直连」,两台设备显示不一致。只有发送方能确定自己的数据 是否走 TURN,现在连接建立后两端互相告知,任一端经中转即两端都显示「中转」。 Fixed: when only one side was relayed, the other side showed "direct". Only the sender knows whether its traffic goes through TURN, so the two sides now tell each other after connecting; if either is relayed, both show "relay".
  • 修复:收到图片或文件后,复制记录里同一条出现两行,其中一行进度条一直在动。 Fixed: a received image or file appeared twice in the history, one row with a progress bar that never stopped.
  • 修复:本机复制的图片在发送后一直显示进度条。 Fixed: items copied on this Mac kept showing a progress bar after sending.
  • 传输进度按真实比例显示,并做了节流,大文件传输时不再挤掉「传输完成」的事件。 Transfer progress now shows the actual percentage and is throttled, so large transfers no longer crowd out the completion event.

1.0.1 — 2026-10-08

  • 修复:配对时两台 Mac 显示的安全指纹不一样,无从核对。之前每台只显示「对方」的指纹; 现在两台显示同样的两行(双方各一行,按固定顺序),两块屏幕逐行一致即可确认。命令行的 pair / join 同步修改。 Fixed: the two Macs showed different fingerprints during pairing, so they could never be compared. Each Mac used to show only the other's fingerprint; both now show the same two lines, one per device, in a fixed order. The CLI's pair / join follow the same rule.
  • 对话框与菜单加上投影。 Dialogs and menus now have a drop shadow.
  • 发布资源改用不带版本号的文件名(如 CopySync.dmg),下载直链不再随版本失效。 Release assets now use versionless names (e.g. CopySync.dmg) so direct download links keep working.

1.0.0 — 2026-10-08

第一个正式版本。 First public release.

Mac 客户端 / Mac app

  • 同步文本、带格式的文本、图片、文件与文件夹;50 MB 以内复制即推送,更大的按需拉取。 Syncs text, rich text, images, files and folders; items under 50 MB are pushed on copy, larger ones are pulled on demand.
  • 复制记录:查看最近 3 天所有设备上复制过的内容,随时放回剪贴板。 History of everything copied on any of your Macs in the last 3 days.
  • 6 位配对码 + 安全指纹核对。 Pairing with a 6-character code and fingerprint check.
  • DMG 拖拽安装;首次打开时由 App 自己启用后台同步,不需要终端。 Drag-to-install DMG; the app enables background sync itself on first launch, no Terminal needed.
  • 覆盖安装新版、或移动 App 位置后,自动校正后台服务。 After an in-place update or moving the app, the background service is re-pointed and restarted automatically.
  • 带格式的文本同时写入纯文本,粘贴到只认纯文本的输入框不再出现 HTML 标签。 Rich text is also written as plain text, so no HTML markup leaks into plain-text fields.
  • 界面在信令连接与对端上下线时实时刷新。 Connection status updates live.
  • Intel 与 Apple 芯片通用;支持深色外观。 Universal binary; dark appearance.

服务器 / Server

  • 信令 + 自带 STUN + TURN 中转,单个静态二进制。 Signaling, built-in STUN and TURN relay in one static binary.
  • 提供 systemd 一键安装脚本与 Docker Compose 配置。 One-step systemd installer and Docker Compose setup.
  • 新增 -version 参数。 Added the -version flag.