从安装到排查，一页写完。上方选择你的平台。
双击 clipraft.exe 运行，无需安装。托盘出现图标即表示已启动。开机自动运行可在托盘菜单勾选「开机自启」。
首次运行新程序时，Windows 可能提示「Windows 已保护你的电脑」，「仍要运行」收在「更多信息」内。点「更多信息」，再点「仍要运行」。仅需一次。
位于右下角时钟旁。图标可能被折叠，点向上的箭头展开。左键点击图标即「立即同步一次」。
托盘菜单包含：立即同步一次、查找设备、添加设备、设备列表、发送文件、开机自启、退出。
配对只需一次。加入同一组的设备须连在同一 Wi-Fi 下，或接入同一台路由器。
配对码 5 分钟内有效。「添加设备」窗口开启期间，可用同一个码连续添加多台设备。
更换设备前，先在「设备列表」中移除不用的设备。移除后会自动轮换主密钥，被移除的设备无法再接收内容。需要更多设备请使用商业版，联系我们。
配对完成后无需任何操作。在一台设备上复制，到另一台直接粘贴。
在任意位置按 Ctrl+C，内容自动推送到组内其他设备。收到的内容直接进入剪贴板，Ctrl+V 粘贴。
| 文字 | 8 MB |
| 图片 | 32 MB |
限制仅在读取剪贴板一侧生效。在 Windows 上复制 1 MB 文字，Mac 可以收到；同一段文字在 Mac 上复制则无法发送。
文件为点对点传输，只发送给指定的那台设备，不像剪贴板那样广播给全组。
可同时选中多个文件，将排队依次传输。
单个文件最大 4 GB。
直接存入接收方的下载文件夹，不询问也不弹窗。重名自动改名，report.pdf 变为 report (2).pdf，不覆盖原文件。传输完成后会弹出通知，点它就能打开所在文件夹。
| 收到的文件在 | 下载文件夹（%USERPROFILE%\Downloads） |
同时传输多个大文件会相互抢占带宽，因此选中多个文件时会排队依次传输。传输过程中菜单出现「取消传输」，取消后对方会立即删除未完成的文件。
| 配置 | %APPDATA%\clipraft\ |
| 日志 | %APPDATA%\clipraft\clipraft.log |
打开 dmg，将 ClipRaft 拖入「应用程序」。图标位于屏幕右上角菜单栏，不在程序坞。
首次打开会提示「无法验证开发者」。在「应用程序」中按住 Control 点 ClipRaft，选「打开」，在弹窗中再点一次「打开」。仅需一次。
也可在「系统设置 › 隐私与安全性」中点「仍要打开」。
位于屏幕右上角时间旁。左键点击图标即「立即同步一次」。
菜单包含：立即同步一次、查找设备、添加设备、设备列表、发送文件、开机自启、退出。
配对只需一次。加入同一组的设备须连在同一 Wi-Fi 下，或接入同一台路由器。
配对码 5 分钟内有效。「添加设备」窗口开启期间，可用同一个码连续添加多台设备。
更换设备前，先在「设备列表」中移除不用的设备。移除后会自动轮换主密钥，被移除的设备无法再接收内容。需要更多设备请使用商业版，联系我们。
配对完成后无需任何操作。在一台设备上复制，到另一台直接粘贴。
在任意位置按 ⌘C，内容自动推送到组内其他设备。收到的内容直接进入剪贴板，⌘V 粘贴。
| 文字 | 150 KB |
| 图片 | 8 MB |
限制仅在读取剪贴板一侧生效。在 Windows 上复制 1 MB 文字，Mac 可以收到；同一段文字在 Mac 上复制则无法发送。
文件为点对点传输，只发送给指定的那台设备，不像剪贴板那样广播给全组。
可同时选中多个文件，将排队依次传输。
单个文件最大 4 GB。
macOS 不允许应用自行启用该项，因此刚安装时「共享」中没有 ClipRaft。打开「系统设置 › 通用 › 登录项与扩展 › 共享」，勾选 ClipRaft，仅需一次。也可在右键菜单底部点「编辑扩展…」直接跳转。
直接存入接收方的下载文件夹，不询问也不弹窗。重名自动改名，report.pdf 变为 report (2).pdf，不覆盖原文件。传输完成后会弹出通知，点它就能打开所在文件夹。
| 收到的文件在 | 下载文件夹（~/Downloads） |
同时传输多个大文件会相互抢占带宽，因此选中多个文件时会排队依次传输。传输过程中菜单出现「取消传输」，取消后对方会立即删除未完成的文件。
macOS 的开机自启通过 SMAppService 实现，要求应用位于「应用程序」文件夹。安装在其他位置会提示失败。需 macOS 13 或更新版本。
| 配置 | ~/Library/Application Support/clipraft/ |
| 日志 | ~/Library/Application Support/clipraft/clipraft.log |
下载后先加可执行权限：在文件管理器中右键 › 属性 › 勾选「允许作为程序执行」，或在终端运行 chmod +x。之后双击运行（个别文件管理器要右键选「作为程序运行」），无需安装。托盘出现图标即表示已启动。
GNOME 在屏幕右上角的顶栏，KDE、Xfce 等在任务栏右侧。单击图标打开菜单，KDE 上用右键。
菜单包含：立即同步一次、发送文件、添加设备、设备列表、开机自启、帮助、退出。还没加入同步组时只有「设置」。
配对只需一次。加入同一组的设备须连在同一 Wi-Fi 下，或接入同一台路由器。
配对码 5 分钟内有效。「添加设备」窗口开启期间，可用同一个码连续添加多台设备。
更换设备前，先在「设备列表」中移除不用的设备。移除后会自动轮换主密钥，被移除的设备无法再接收内容。需要更多设备请使用商业版，联系我们。
配对完成后无需任何操作。在一台设备上复制，到另一台直接粘贴。
在任意位置按 Ctrl+C，内容自动推送到组内其他设备。收到的内容直接进入剪贴板，Ctrl+V 粘贴。
| 文字 | 8 MB |
| 图片 | 16 MB |
限制仅在读取剪贴板一侧生效。在 Windows 上复制 1 MB 文字，Mac 可以收到；同一段文字在 Mac 上复制则无法发送。
文件为点对点传输，只发送给指定的那台设备，不像剪贴板那样广播给全组。
单个文件最大 4 GB，一次发送一个。
直接存入接收方的下载文件夹，不询问也不弹窗。重名自动改名，report.pdf 变为 report (2).pdf，不覆盖原文件。传输完成后会弹出通知，点它就能打开所在文件夹。
| 收到的文件在 | 下载文件夹（系统设置的下载目录，通常是 ~/Downloads 或 ~/下载） |
同时传输多个大文件会相互抢占带宽，因此选中多个文件时会排队依次传输。传输过程中菜单出现「取消传输」，取消后对方会立即删除未完成的文件。
Ubuntu 自带「Ubuntu AppIndicators」扩展，一般已启用。Fedora 等发行版需先安装「AppIndicator and KStatusNotifierItem Support」扩展，在「扩展」应用中启用，再注销并重新登录。KDE、Xfce、Cinnamon 原生支持托盘，无需操作。锁屏期间 GNOME 会暂时停用这个扩展，解锁后图标自动回来。
运行时加参数可直接打开对应窗口：--setup 建组或加入，--devices 设备列表，--add-device 添加设备，--manual-add 按 IP 手动添加。例如 ./clipraft-*.AppImage --setup。
勾选后会在 ~/.config/autostart/ 写一个启动项，指向 AppImage 当前所在的位置；挪动文件后在新位置运行一次即可更新。Sway、Hyprland 等窗口管理器不读取这个目录，需自行配置。
Wayland 会话下通过 XWayland 读写剪贴板，GNOME、KDE 默认开启，无需设置。图片只读取 PNG 格式，个别程序复制的图片不带 PNG，这类图片不会同步；超过约 16 MB 的图片目前读不全，会跳过。
Linux 版的设备列表还没有「查找设备」按钮。找不到设备时，管理员可在「添加设备」窗口中点「手动添加设备」填写对方 IP；其他设备运行时加 --manual-add。
Ubuntu、Fedora Workstation 等桌面版默认的防火墙不影响使用。Fedora Server 这类默认只放行 ssh 的系统，需放行 TCP 8677 和 UDP 8678。
| 配置 | ~/.config/clipraft/ |
| 日志 | ~/.config/clipraft/clipraft.log |
即将在应用商店上架。以下为上架后的使用方式。
从应用商店安装。
打开 ClipRaft，点「加到快捷设置」。Android 13 及以上会直接弹出确认框；Android 12 及以下需下拉面板，点编辑（铅笔图标），将 ClipRaft 拖入上方一排。
未添加磁贴时，每次同步都需先打开应用。
配对只需一次。加入同一组的设备须连在同一 Wi-Fi 下，或接入同一台路由器。
配对码 5 分钟内有效。「添加设备」窗口开启期间，可用同一个码连续添加多台设备。
更换设备前，先在「设备列表」中移除不用的设备。移除后会自动轮换主密钥，被移除的设备无法再接收内容。需要更多设备请使用商业版，联系我们。
电脑上复制，手机从顶端下拉打开快捷设置，点击 ClipRaft，内容即进入手机剪贴板，在输入框中长按粘贴。
支持「分享」的应用：选中文字或图片，点「分享」，选 ClipRaft，电脑上直接粘贴。仅支持「复制」的应用：复制后下拉点击 ClipRaft 即可发送。
这是设计选择。Android 10 起系统也不允许应用在后台读取剪贴板。电脑发送的内容暂存于电脑端，下拉点击即可取回。
| 文字 | 8 MB |
| 图片 | 32 MB |
限制仅在读取剪贴板一侧生效。在 Windows 上复制 1 MB 文字，Mac 可以收到；同一段文字在 Mac 上复制则无法发送。
文件为点对点传输，只发送给指定的那台设备，不像剪贴板那样广播给全组。
单个文件最大 50 MB，传输过程中请勿锁屏。
直接存入接收方的下载文件夹，不询问也不弹窗。重名自动改名，report.pdf 变为 report (2).pdf，不覆盖原文件。传输完成后会弹出通知，点它就能打开所在文件夹。
| 收到的文件在 | 「下载」文件夹，打开「文件」或者「下载」就能看到 |
同时传输多个大文件会相互抢占带宽，因此选中多个文件时会排队依次传输。传输过程中菜单出现「取消传输」，取消后对方会立即删除未完成的文件。
| 配置 | 应用私有目录（不需要你管） |
| 日志 | app 里 |
即将在 App Store 上架。以下为上架后的使用方式。
从 App Store 安装。
从屏幕右上角下滑打开控制中心，进入编辑状态，点底部「添加控制」，搜索 ClipRaft 并点击添加。之后可按住拖动调整位置。
配对只需一次。加入同一组的设备须连在同一 Wi-Fi 下，或接入同一台路由器。
配对码 5 分钟内有效。「添加设备」窗口开启期间，可用同一个码连续添加多台设备。
更换设备前，先在「设备列表」中移除不用的设备。移除后会自动轮换主密钥，被移除的设备无法再接收内容。需要更多设备请使用商业版，联系我们。
电脑上复制，手机从右上角下滑打开控制中心，点击 ClipRaft，内容即进入手机剪贴板，在输入框中长按粘贴。
支持「共享」的应用：选中文字或图片，点「共享」，选 ClipRaft，电脑上直接粘贴。仅支持「复制」的应用：复制后从右上角下滑点击 ClipRaft 即可发送。
系统不允许后台读取剪贴板，也不允许应用持续运行。所以电脑发送的内容会暂存在电脑端，下拉点击即可取回。这是系统限制。
iOS 16 起系统不再向应用提供用户设定的设备名，因此需在 ClipRaft 中自行填写。多台设备同名为 iPhone 时，电脑上的设备列表无法区分。
| 文字 | 8 MB |
| 图片 | 32 MB |
限制仅在读取剪贴板一侧生效。在 Windows 上复制 1 MB 文字，Mac 可以收到；同一段文字在 Mac 上复制则无法发送。
文件为点对点传输，只发送给指定的那台设备，不像剪贴板那样广播给全组。
单个文件最大 50 MB，传输过程中请勿锁屏。
直接存入接收方的下载文件夹，不询问也不弹窗。重名自动改名，report.pdf 变为 report (2).pdf，不覆盖原文件。传输完成后会弹出通知，点它就能打开所在文件夹。
| 收到的文件在 | 「文件」app →「我的 iPhone」→ ClipRaft |
同时传输多个大文件会相互抢占带宽，因此选中多个文件时会排队依次传输。传输过程中菜单出现「取消传输」，取消后对方会立即删除未完成的文件。
| 配置 | 应用私有目录（不需要你管） |
| 日志 | app 里 |
按顺序排查，多数情况第一步即可解决。
部分路由器默认开启 AP 隔离（客户端隔离），同一 Wi-Fi 下的设备互相不可见，需进入路由器管理页关闭。酒店、机场等公共 Wi-Fi 通常开启此项，无法使用。
企业无线网络常过滤组播，大网段下自动发现会失效，手动填写 IP 仍可使用。
最近一次请求成功。复制的内容会直接推送过去。
手机进入后台会被系统挂起，此时无法接收推送。两个方向仍然可用：手机可主动发送；电脑发送的内容暂存于发送方，手机下拉点击即可取回。这不是故障，手机系统本就不允许应用常驻。
尚未发现该设备的地址。点「查找设备」，或手动填写。
内容仅在局域网内直连传输，端到端加密，不经过任何服务器。我们既不收集邮箱、手机号和姓名，也没有账号体系。日志仅记录事件和字节数，不记录剪贴板内容。