UniClipboard

English | 简体中文 | 繁體中文 | 日本語 | Русский | Português (Brasil)

Кто поддерживает проект? (Об авторах и доверии, на английском)

Компьютер ↔ компьютер — двусторонняя синхронизация буфера обмена в реальном времени.

_amd64.deb sudo apt-get install -f # resolve missing deps if any # Fedora / RHEL / openSUSE (one-shot, no COPR) sudo dnf install ./UniClipboard--1.x86_64.rpm # AppImage (any distro) chmod +x UniClipboard__amd64.AppImage ./UniClipboard__amd64.AppImage ``` > Установки из COPR / Snap / rpm / deb не обновляются автоматически из приложения — используйте менеджер пакетов. В Linux встроенное обновление предназначено для AppImage. ### Homebrew (macOS) На macOS можно установить приложение через официальный tap [`UniClipboard/homebrew-tap`](https://github.com/UniClipboard/homebrew-tap): ```bash brew tap UniClipboard/tap # Homebrew 6.0+ requires you to trust third-party taps before it will load # their formulae/casks. Skip this and you'll hit # "Refusing to load ... from untrusted tap". It only needs to run once. brew trust UniClipboard/tap # Desktop app (.app bundle) brew install --cask uniclipboard # CLI only — installs the `uniclip` command brew install uniclipboard ``` Можно установить напрямую без предварительного добавления tap, но один раз разрешить доверие всё равно необходимо: ```bash brew trust UniClipboard/tap # Homebrew 6.0+, one-time brew install --cask UniClipboard/tap/uniclipboard # GUI brew install UniClipboard/tap/uniclipboard # CLI ``` Cask и formula могут сосуществовать: установите оба, если нужны графическое приложение и команда `uniclip`. ### Обновление с 0.19.x Версия 1.0 переводит локальные данные на новый формат хранения и защиты и использует новую схему сопряжения: - Обновляйте поверх старой версии тем же способом установки. При первом запуске история автоматически копируется, поэтому он занимает больше времени. - Вернуться к 0.19 после этого нельзя; устройства с 0.19 и 1.0 не могут синхронизироваться друг с другом. - Старые сопряжения удаляются. Когда все устройства обновлены до 1.0, выполните сопряжение заново на странице **Устройства**. Порядок действий, расположение копий и восстановление описаны в [руководстве по переходу с 0.19 на 1.0](https://docs.uniclipboard.app/migration/upgrade-0-19-to-v1). ### Сборка из исходного кода Необходимы инструментарий Rust, закреплённый в `rust-toolchain.toml`, [Bun](https://bun.sh), [Go](https://go.dev) (версия в `apps/gui-go/go.mod`) и [зависимости Wails v3](https://v3alpha.wails.io/getting-started/installation/) для вашей ОС. Команда разработки `bun wails:dev` поддерживает macOS и Windows. ```bash git clone https://github.com/UniClipboard/UniClipboard.git cd UniClipboard # Install dependencies bun install # Start development mode (isolated `dev` profile, so it doesn't touch an installed app's data) bun wails:dev # Build a local macOS app bundle apps/gui-go/build.sh ``` Структура пакета описана в `apps/gui-go/README.md`. Разработка для нескольких устройств, тесты и правила проекта приведены в [CONTRIBUTING.md](./CONTRIBUTING.md) на английском. ## Использование ### Первое устройство: создание пространства 1. Запустите приложение, выберите **Это моё первое устройство** и нажмите **Создать новое пространство**. 2. Задайте парольную фразу шифрования. Она защищает все данные пространства и нужна для добавления устройств, поэтому храните её надёжно. 3. Готово. Скопированное содержимое хранится в этом пространстве в зашифрованном виде. ### Добавление устройств по приглашению 1. На существующем устройстве откройте страницу **Устройства** и нажмите **Пригласить устройство**, чтобы создать краткосрочный код приглашения. 2. На новом устройстве выберите **Я уже использую UniClipboard на другом устройстве** → **Присоединиться через сопряжение** и введите код приглашения вместе с парольной фразой пространства. 3. После подтверждения сопряжения устройство присоединяется и синхронизация запускается автоматически. > Хотите перейти в другое пространство после настройки? Выберите **Присоединиться к другому пространству** на странице устройств или выполните `uniclip space join --switch` в CLI. Локальная история буфера обмена переносится в новое пространство. Без `--switch` команда `uniclip space join` выполняет безопасное повторное сопряжение, не меняя пространство. ### Подключение телефона **[Мобильное приложение UniClipboard](https://github.com/UniClipboard/UniClip)** работает на **iOS** ([публичная бета TestFlight](https://testflight.apple.com/join/nyNQ8dQe)) и **Android** ([скачивание APK](https://github.com/UniClipboard/UniClip/releases/latest)). На компьютере откройте **Устройства** и нажмите значок телефона, чтобы открыть **Подключить телефон**. Доступны два способа: - **Обычная синхронизация** (по умолчанию) — режим совместимости по HTTP. Настольный daemon запускает небольшой HTTP-сервис, совместимый с SyncClipboard; диалог регистрирует телефон и показывает QR-код с адресом и одноразовыми учётными данными для сканирования приложением. - **Подключение устройства (экспериментально)** — телефон присоединяется к зашифрованному пространству по коду приглашения, как ещё один компьютер. Ограничения обычной синхронизации: - **Не P2P** — телефон является обычным HTTP-клиентом без обхода NAT и ретрансляции. Он работает в локальной сети; для других сетей используйте [серверный узел без графического интерфейса](https://docs.uniclipboard.app/guides/self-host-server-node) с публичным HTTPS либо Tailscale / VPN. - **На стороне сервиса — открытый HTTP + Basic Auth**: включайте только в доверенной сети или разместите за обратным прокси с TLS. - **Телефон не является участником пространства**: у него нет ID узла и доступа к зашифрованной базе истории. - **На iOS нет незаметной фоновой синхронизации**: система не предоставляет общего фонового перехватчика буфера обмена, поэтому синхронизация выполняется при открытом приложении либо через расширения клавиатуры и общего доступа. См. [FAQ о фоновой синхронизации iOS](https://docs.uniclipboard.app/help/faq#why-cant-the-ios-app-sync-clipboard-silently-in-the-background-like-the-desktop). > ⚠️ Если TestFlight сообщает об ошибке сертификата или кнопка **Установить** бесконечно показывает загрузку, временно отключите прокси / VPN (включая глобальные правила, TUN и расшифровку HTTPS / MitM), чтобы TestFlight подключился напрямую. После установки верните настройки. Полная настройка описана в [руководстве мобильного приложения](https://docs.uniclipboard.app/mobile) и [руководстве мобильной синхронизации на компьютере](https://docs.uniclipboard.app/core-features/mobile-sync). ### Основные страницы - **История** — история буфера обмена с полнотекстовым поиском, фильтрами и подробным просмотром - **Быстрая панель** — оверлей для быстрого доступа к буферу обмена сочетанием клавиш - **Устройства** — приглашения, подключение телефонов, состояние соединений, индивидуальная синхронизация, смена и пересоздание пространств - **Настройки** — общие параметры, внешний вид, сочетания клавиш, быстрая панель, синхронизация, безопасность, сеть, хранилище (включая копии перед обновлением), сведения о приложении ## Дополнительные возможности ### Как это работает ```mermaid flowchart LR subgraph A["Устройство A (ноутбук)"] direction TB CC["Ctrl+C"] --> EA["шифрование
(ваш ключ)"] end subgraph B["Устройство B (компьютер)"] direction TB DB["расшифровка
(ваш ключ)"] --> CV["Ctrl+V"] end EA -->|"P2P через NAT"| DB EA -.->|"при отсутствии прямой связи"| R["Ретранслятор
(видит только
шифротекст)"] R -.-> DB ``` - **Сопряжение**: новое устройство присоединяется по одноразовому приглашению и парольной фразе пространства. Без облачной учётной записи и электронной почты. - **Передача**: прямое подключение, если устройства доступны друг другу в одной сети или через NAT; иначе используется зашифрованный ретранслятор. - **Шифрование**: шифрование содержимого независимо от транспорта — даже вредоносный ретранслятор видит только шифротекст. - **Хранение**: локальная история, предпросмотры и поисковый индекс зашифрованы на диске. - **Устойчивость**: соединения восстанавливаются после смены сети, сна или краткого разрыва. Подключение устройства можно обновить и вручную на странице устройств. **Компоненты.** Настольное приложение состоит из GUI (Go/Wails + React), фонового daemon `uniclipd`, который синхронизирует и сохраняет буфер обмена, и CLI `uniclip`. GUI и CLI обращаются к одному локальному daemon по loopback HTTP / WebSocket API и потому показывают одно состояние. Синхронизация, шифрование и хранение реализованы в отдельном репозитории [UniClipboard Engine](https://github.com/UniClipboard/Engine); фиксированная ревизия указана в `Cargo.toml` этого репозитория. ### Командная строка CLI `uniclip` работает как с GUI, так и без него, например на сервере. Частые команды: ```bash uniclip space init # Create a new encrypted space on this device uniclip space invite # Generate a short-lived invitation code uniclip space change-passphrase # Change the space passphrase (unlocked, single-device space) uniclip space join --code # Join a space (re-pair, non-destructive) uniclip space join --switch --code # Switch to another space uniclip space status # Inspect the active space and daemon uniclip member list # List paired devices and presence uniclip send "hello" # Send text to other devices uniclip send ./report.pdf # Send an existing file printf '%s\n' ./a.png './b c.pdf' | uniclip send --file # Send paths from stdin uniclip send --text report.pdf # Force an existing filename to be sent as text uniclip get # Fetch the latest entry uniclip get --wait # Wait for the next synced entry uniclip get --copy # Copy the latest entry to this computer's clipboard uniclip search "invoice" # Search clipboard history uniclip run # Foreground daemon lifecycle uniclip service start / restart / status / stop # User service lifecycle ``` Полный список доступен через `uniclip --help` и в [справочнике CLI](https://docs.uniclipboard.app/cli/reference). ### Конфиденциальность и безопасность **Какие данные мы собираем** — два отдельных анонимных канала: диагностика (сбои, ошибки и обезличенные логи) и аналитика использования (события, например результаты настройки и синхронизации). Они никогда не содержат буфер обмена, имена и пути файлов, парольные фразы, ключи или поисковые запросы. Оба включены по умолчанию; уведомление при первом запуске позволяет отключить оба, а **Настройки → Общие → Конфиденциальность** — управлять каждым отдельно. Точные поля описаны в разделе [Конфиденциальность и сбор данных](https://docs.uniclipboard.app/core-features/privacy). **Что видит ретранслятор** — зашифрованные байты и метаданные соединения: ID отправителя и получателя. Расшифровать содержимое он не может. **Что хранится на диске** — зашифрованная база SQLite и поисковый индекс. Текст, заголовки, предпросмотры, теги и имена файлов шифруются до записи. **Если устройство потеряно** — удалите его с другого сопряжённого устройства. Остальные устройства перестанут отправлять ему новые данные. **Всё можно проверить** — настольное приложение и [Engine](https://github.com/UniClipboard/Engine), включая криптографию, доступны с открытым исходным кодом на GitHub. #### Криптографические подробности - **XChaCha20-Poly1305 AEAD** шифрует содержимое буфера обмена со случайным nonce длиной 24 байта и ключами в 256 бит, обеспечивая конфиденциальность, целостность и подлинность. - **Argon2id** выводит материал для шифрования ключей из парольной фразы пространства (по умолчанию: 128 MiB памяти, 3 итерации, 4 линии параллелизма), затрудняя взлом на GPU / ASIC. - **Иерархия ключей**: ключи содержимого находятся в зашифрованном хранилище каждого профиля. Системное защищённое хранилище (macOS Keychain, Windows Credential Manager, Linux Secret Service) содержит только материал для автоматической разблокировки. Если он потерян, исходная парольная фраза позволяет восстановить доступ. - **Изоляция пространств**: у каждого пространства собственные ключи. ## Частые вопросы

Почему не использовать Универсальный буфер обмена iCloud?

Если у вас только устройства Apple, история не нужна и вы полностью доверяете закрытому сквозному шифрованию Apple, iCloud подойдёт. Когда появляется Windows или Linux, нужен поиск по истории или возможность самостоятельно проверить шифрование, требуется другой инструмент.

Почему не использовать собственный сервер синхронизации, например ClipCascade?

Собственный сервер нужно обслуживать. UniClipboard работает сразу: сначала прямое P2P-соединение, а зашифрованная ретрансляция — только если оно невозможно. Управлять инфраструктурой не требуется.

Работает ли приложение в локальной сети без ретранслятора?

Устройства, доступные друг другу в одной сети, подключаются напрямую. **Настройки → Сеть → Только локальная сеть** полностью отключает переход на ретранслятор; при этом устройства в разных сетях не смогут соединиться. О том, какие обращения к интернету остаются в этом режиме, см. [FAQ](https://docs.uniclipboard.app/help/faq).

Где находится история буфера обмена?

Только на ваших устройствах, в зашифрованном виде. Серверы UniClipboard никогда не получают и не хранят содержимое вашего буфера обмена.

Есть ли мобильное приложение?

Да — **[UniClipboard для телефона](https://github.com/UniClipboard/UniClip)** поддерживает iOS и Android. По умолчанию используется обычная синхронизация; экспериментальное подключение устройства позволяет войти в пространство по приглашению. См. [подключение телефона](#mobile-companion-lan).

После обновления с 0.19 устройства перестали синхронизироваться. Что случилось?

Это ожидаемо: в 1.0 новая схема сопряжения, поэтому старые связи удаляются, а устройства с 0.19 и 1.0 несовместимы. Обновите всё до 1.0 и выполните сопряжение заново. См. [руководство по обновлению](https://docs.uniclipboard.app/migration/upgrade-0-19-to-v1).

## Участие в разработке Приветствуются любые формы участия! Подробности окружения разработки, ветвления, соглашений о коммитах и процесса PR приведены в [CONTRIBUTING.md](./CONTRIBUTING.md) на английском. Быстрый старт: 1. Сделайте fork репозитория. 2. Создайте ветку для изменений (`git checkout -b feature/amazing-feature`). 3. Сделайте коммит по [правилам проекта](./CONTRIBUTING.md#commit-conventions). 4. Отправьте ветку (`git push origin feature/amazing-feature`). 5. Откройте Pull Request в ветку `main`. ## Лицензия Проект распространяется по лицензии AGPL-3.0; подробности — в файле [LICENSE](./LICENSE). ## Благодарности - [Wails](https://wails.io) — кроссплатформенный фреймворк приложений - [React](https://react.dev) — фреймворк пользовательского интерфейса - [Rust](https://www.rust-lang.org) — безопасный и эффективный язык реализации серверной части - [iroh](https://www.iroh.computer) — P2P-сеть на QUIC для прямых межсетевых соединений и передачи blob - [Tokio](https://tokio.rs) — асинхронная среда выполнения для сетевых операций и ввода-вывода - [shadcn/ui](https://ui.shadcn.com) — составные компоненты на основе Radix UI - [Radix UI](https://www.radix-ui.com) — доступные примитивы без заданного оформления для интерфейса приложения - [Tailwind CSS](https://tailwindcss.com) — утилитарные стили всего интерфейса - [SQLite](https://www.sqlite.org) — встроенная база для локальной истории буфера обмена ## Сообщество Общайтесь с другими пользователями и командой разработки:

Группа QQ	Группа WeChat	Группа Telegram

--- **Есть вопросы или предложения?** [Создайте Issue](https://github.com/UniClipboard/UniClipboard/issues/new) или свяжитесь с нами!