安装

macOS 推荐使用官方 Homebrew tap。

brew tap UniClipboard/tap

# Homebrew 6.0+ 默认要求先信任第三方 tap 才会加载其 formula/cask，
# 否则会报 “Refusing to load ... from untrusted tap”。该步骤只需执行一次。
brew trust UniClipboard/tap

# 桌面应用（.app）
brew install --cask uniclipboard

# 仅安装 CLI，命令名为 `uniclip`
brew install uniclipboard

也可以省去 brew tap，一行直装（仍需先信任一次该 tap）：

brew trust UniClipboard/tap                          # Homebrew 6.0+，一次性
brew install --cask UniClipboard/tap/uniclipboard    # GUI
brew install UniClipboard/tap/uniclipboard           # CLI

cask 与 formula 互不冲突，需要的话两个都装即可（GUI + 终端 uniclip）。

更习惯手动安装？前往 Releases 页面下载最新 .dmg，把应用拖入 /Applications。

首次启动权限

UniClipboard 注册全局快捷面板快捷键时，macOS 可能请求 输入监控（Input Monitoring） 权限。请在 系统设置 → 隐私与安全性 → 输入监控 中授权，然后完全退出并重新启动应用。

辅助功能（Accessibility） 是另一项独立的可选权限，只在启用快捷面板的双击修饰键触发方式时需要。UniClipboard 不会在后台主动请求；对应设置会显示一个按钮，由你明确打开 隐私与安全性 → 辅助功能 并授权，然后返回应用。剪贴板同步本身不依赖辅助功能权限。

Windows 提供两种形式：安装版（NSIS 安装包，推荐大多数人）和 便携版（绿色版，免安装）。两种都覆盖 x64（Intel/AMD）与 arm64（Windows on ARM）。

安装版（NSIS）

下载 UniClipboard_<version>_<arch>-setup.exe（<arch> 为 x64 或 arm64），一路下一步即可。安装器会写入开始菜单，并在 设置 → 应用 下注册卸载项。

安装包已数字签名。

便携版（绿色版）

不想安装、想随身带着跑（比如放 U 盘），就用便携版。下载 UniClipboard_<version>_<arch>-portable.zip，解压后双击里面的 UniClipboard.exe 即可运行——免安装、不写注册表、不在系统目录留痕。

• 数据就放在程序旁边。 所有数据（加密数据库、密钥、搜索索引、日志）都保存在 UniClipboard.exe 同目录下自动创建的 data 文件夹里。把整个文件夹（exe + portable.dat + data）一起拷走，配置就跟着走；删掉 data 即可重置。
• portable.dat 是开关。 压缩包里这个标记文件用来开启便携模式。删掉它，应用就会和安装版一样把数据写到 %LOCALAPPDATA%\app.uniclipboard.desktop\。
• 选对架构。 arm64 版用于 Surface Pro X 等 Windows on ARM 设备，x64 版用于常见的 Intel/AMD 电脑。

按需从 Releases 页面下载安装包或便携包。

每次发布都会构建 .deb、.rpm 与 .AppImage 三种格式，覆盖 x86_64 与 aarch64。按你的发行版挑最合适的渠道：

Fedora / RHEL / openSUSE — 推荐 COPR

通过 Fedora COPR 一键安装并自动跟随版本升级：

# Alpha 渠道（含预发布版本，更新更频繁）
sudo dnf copr enable mkdir700/uniclipboard-alpha
sudo dnf install uniclipboard

# 正式渠道（仅稳定版）
sudo dnf copr enable mkdir700/uniclipboard
sudo dnf install uniclipboard

启用后 sudo dnf upgrade 会自动拉取新版本。详见 COPR 部署手册。

Ubuntu / Debian / 老发行版 — 推荐 Snap

Snap 包基于 core22 严格沙箱构建，自带 GTK + WebKit 运行时，因此在 Ubuntu 20.04+、Debian 11+、RHEL 9、openSUSE Leap 等老发行版上都能正常运行。

# 正式渠道（稳定版，amd64 + arm64 双架构）
sudo snap install uniclipboard

# Edge 渠道（含预发布版本，更新更频繁）
sudo snap install uniclipboard --edge

安装后再授权 snap 访问系统钥匙串（GNOME Keyring / KWallet），让守护进程把长期身份密钥放进系统密钥环：

sudo snap connect uniclipboard:password-manager-service

不接这一步也能跑——守护进程会降级到文件 KEK，存放在 snap 数据目录下（日志里能看到 System secure storage probe failed; falling back to file-based KEK）。接上 plug 只是把 KEK 搬进 OS 管理的钥匙串，跟其他系统应用走同一套机制。

password-manager-service 当前不是 auto-connect interface；等 snap store 的 auto-connect 申请通过后，新安装就不再需要手动执行这条命令。

没有 snapd？请参考 Snapcraft 安装指南 查看你所用发行版的安装方式。

任意发行版 — AppImage

每个 release 也会发布 AppImage。从 Releases 页面下载，赋予可执行权限即可运行：

chmod +x UniClipboard_<version>_amd64.AppImage
./UniClipboard_<version>_amd64.AppImage

AppImage 是 Linux 上 App 内更新器唯一支持的自更新格式 —— 走 COPR / Snap / dpkg 安装的版本不会通过应用内更新器升级，请用对应包管理器。

一次性手动安装单个 .deb / .rpm

不想加仓库？也可以从 Releases 直接下单文件安装：

# Debian / Ubuntu
sudo dpkg -i uniclipboard_<version>_amd64.deb
sudo apt-get install -f                                 # 如有缺失依赖，由 apt 补齐

# Fedora / RHEL / openSUSE（一次性，不加 COPR 仓库）
sudo dnf install ./UniClipboard-<version>-1.x86_64.rpm

无桌面环境（仅安装 CLI）

服务器、SSH 会话或任何没有桌面的环境，可以从 Releases 单独下载 uniclip CLI —— 查找 uniclip-<version>-<arch> 产物（与 musl 静态链接）。CLI 内置守护进程，无需 GUI 即可运行。