Windows 剪贴板同步工具使用教程（基于 ntfy 的 EXE 程序）

在多设备协作、远程办公、运维与开发场景中，剪贴板往往是效率断点：
电脑复制了一段内容，手机或另一台电脑还要重新操作一次。

本文介绍一款 Windows 剪贴板同步工具（EXE 版），基于 ntfy 服务实现，无需 Python 环境，双击即可使用，支持托盘运行、开机自启、关键词过滤与实时同步。

一、这个工具能做什么？

一句话概括：把 Windows 剪贴板与 ntfy topic 实时双向同步

主要功能包括：

• 📤 剪贴板上行同步：Windows 剪贴板变化 → 自动发送到 ntfy
• 📥 剪贴板下行同步：ntfy 收到消息 → 自动写入本机剪贴板
• 🔍 敏感关键词过滤：命中关键词的内容会被自动拦截
• 🔔 Windows 系统通知提醒
• 🖥 GUI 界面 + 托盘后台运行
• 🚀 支持开机自启动（不写注册表）

二、使用前准备

1️⃣ 准备一个 ntfy 地址

你需要一个 ntfy 的 topic 地址，格式如下：

https://ntfy.example.com/my_clip

来源可以是：

• 自建 ntfy（VPS / 局域网）
• 公网 ntfy 服务（⚠ 有安全风险，后文说明）

你只需要填写这个地址，不需要手动加 /ws 或 /json

2️⃣ 下载并运行 EXE 程序

• 这是一个 已打包好的 Windows EXE
• 无需安装 Python
• 无需额外依赖
• 双击即可运行

首次运行时，程序所在目录会自动生成：

• clip_config.json —— 配置文件
• clip_sync.log —— 运行日志

三、界面配置说明（一步一步）

1️⃣ ntfy 地址

在「ntfy 地址」输入框中填写你的 topic 地址，例如：

https://ntfy.example.com/ms

如果你使用 query 参数做鉴权（例如 token）：

https://ntfy.example.com/ms?auth=xxxx

程序会自动处理 HTTP / WebSocket 地址，无需手动配置。

2️⃣ 过滤关键词（强烈建议配置）

用于阻止敏感内容被同步。

示例填写：

密码,OTP|验证码

规则说明：

• 支持 , 或 |
• 只要剪贴板内容 包含任意关键词
• 就会被拦截：
  • 不发送到 ntfy
  • 不写入本地剪贴板
• 同时记录日志并弹出提示

这是避免“剪贴板裸奔”的关键功能。

3️⃣ 写入剪贴板（下行开关）

• 勾选：ntfy 收到内容后 → 写入 Windows 剪贴板
• 取消勾选：只接收、不覆盖剪贴板（仅通知 + 日志）

适合「只想从本机发内容，不希望被远端覆盖剪贴板」的场景。

4️⃣ Windows 通知

控制是否弹出系统通知：

• 发送成功
• 接收成功
• 过滤词命中

不影响同步逻辑，仅影响提示方式。

5️⃣ 开机自启动

• 使用 启动文件夹 .bat 实现
• 不会写注册表
• 支持中文路径、空格路径

如果启用失败，常见原因包括：

• EXE 放在 Program Files
• 被安全软件拦截
• 没有写入启动文件夹权限

推荐路径示例：

D:\tools\ntfy_clip\

四、开始剪贴板同步

▶ 点击「开始同步」

成功后：

• 后台同步线程启动
• WebSocket 自动连接
• 托盘图标颜色表示状态：
  • 🟢 已连接
  • 🟡 同步中但连接异常
  • 🔴 已停止

此时：

• Ctrl+C 的内容会自动发送到 ntfy
• ntfy 收到的内容会同步回剪贴板（如开启）

⏸ 停止同步

点击「停止同步」即可：

• 停止监听剪贴板
• 断开 ntfy 连接
• 程序仍保留在托盘中

五、托盘后台运行说明

关闭窗口或点击「最小化到托盘」后：

• 程序不会退出
• 会常驻托盘后台
• 右键托盘图标可：
  • 打开界面
  • 开始 / 停止同步
  • 退出程序

这是推荐的日常使用方式。

六、日志与排错方式

日志文件位置

程序所在目录\clip_sync.log

GUI 下方也会实时显示日志，常见内容包括：

• 剪贴板变化
• ntfy 发送 / 接收状态
• WebSocket 断线与重连
• 过滤关键词命中记录

同步异常时，第一时间查看日志即可定位问题。

七、安全与风险告知（请务必阅读）

⚠ 重要说明：

• ntfy 本质是消息广播服务
• 公网 ntfy topic：
  • 任何知道 topic 的人都可能订阅
• 剪贴板可能包含：
  • 密码
  • Token
  • Cookie
  • 内部地址

建议的安全做法：

• ✅ 自建 ntfy（内网 / VPS）
• ✅ 使用随机、不可猜测的 topic 名
• ✅ 启用关键词过滤
• ❌ 不要当作密码管理器
• ❌ 不要在公共 topic 长期运行

本工具定位是：效率工具，而不是安全容器

八、结语

这个 Windows 剪贴板同步工具，是在实际开发、运维和自动化使用中逐步打磨出来的 EXE 工具，目标只有一个：减少重复操作，让思路不断档

如果你经常：

• 在多台设备间切换
• 使用 ntfy 做通知或自动化
• 希望剪贴板同步可控、可停、可审计

那么它会是一个非常顺手的小工具。

后续也会继续完善功能与安全细节。