Skip to content
/ SyncClipboard Public

跨平台剪贴板同步、历史记录管理工具 / Cross-platform cipboard syncing, history management tool

License

MIT license
3.9k stars 172 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

Jeric-X/SyncClipboard

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,134 Commits
.github
.github
 
 
LICENSES
LICENSES
 
 
build
build
 
 
docs
docs
 
 
script
script
 
 
src
src
 
 
.gitignore
.gitignore
 
 
Changes.md
Changes.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 

Repository files navigation

SyncClipboard

build

中文 | English

目录

功能

  • 跨平台（Windows/macOS/Linux）剪贴板实时同步、剪贴板历史记录管理、历史记录同步
  • 支持客户端内置服务器、docker部署服务器，也可以使用支持WebDAV协议的网盘作为服务器
  • 基于第三方工具的移动端剪贴板同步
  • 优化图片类型的剪贴板，功能有：
    • 从任意位置复制图片时，可以直接向文件系统粘贴图片文件，反之亦然
    • 从浏览器复制图片后，后台下载原图到本地，解决无法从浏览器直接复制动态图的问题
    • 从文件系统复制较新格式类型的图片文件时（webp/heic等），在剪贴板内储存gif或jpg格式，用于直接向支持图片的文本框粘贴图片

Warning

剪贴板历史记录功能处于早期阶段，请做好丢失全部信息的准备，重要信息不要仅依赖本工具保存

服务器

独立服务器

SyncClipboard.Server支持跨平台运行，依赖ASP.NET Core 8.0，安装ASP.NET Core 运行时后，通过以下命令运行

dotnet /path/to/SyncClipboard.Server.dll --contentRoot ./

工作目录与dll所在目录一致，需要写入权限。如需修改工作目录，拷贝一份appsettings.json到新工作目录并修改--contentRoot后的路径

服务器配置

服务器通过appsettings.json文件配置，形式如下：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "Kestrel": {
    "Endpoints": {
      "http": {
        "Url": "http://*:5033"
      },
      //"https": {
      //  "Url": "https://*:5033"
      //}
    },
    //"Certificates": {
    //  "Default": {
    //    "Path": "/path/to/pem",
    //    "KeyPath": "/path/to/pem_key"
    //  }
    //}
  },
  "AppSettings": {
    "UserName": "your_username",
    "Password": "your_password",
    "MaxSavedHistoryCount": 1000
  }
}

如需启用HTTPS，请取消https和Certificates部分的注释，并设定HTTPS证书路径。最后将http部分注释或删除以关闭不安全的连接。如需同时启用HTTP和HTTPS，请将二者Url设置为不同的端口号
不同类型证书的配置方法可以参考微软官方文档

用户名和密码支持使用环境变量配置，当环境变量SYNCCLIPBOARD_USERNAME、SYNCCLIPBOARD_PASSWORD均不为空时，将优先使用这两个环境变量作为用户名和密码

环境变量ASPNETCORE_hostBuilder__reloadConfigOnChange用于配置是否自动识别appsettings.json变动并重载配置，默认值为false，修改为任何非false值后会启用此功能

Warning

HTTP使用明文传输，在公共网络部署服务器请启用HTTPS或使用反向代理工具配置HTTPS。无法从证书颁发机构获取证书时，推荐使用开源工具mkcert或其他方式生成自签名证书

Docker

# docker
docker run -d \
  --name=syncclipboard-server \
  -p 5033:5033 \
  -e SYNCCLIPBOARD_USERNAME=your_username \
  -e SYNCCLIPBOARD_PASSWORD=your_password \
  -v /data/syncclipboard-server:/app/data \
  --restart unless-stopped \
  jericx/syncclipboard-server:latest

# docker compose
curl -sL https://github.com/Jeric-X/SyncClipboard/raw/master/src/SyncClipboard.Server/docker-compose.yml >> docker-compose.yml
docker compose up -d

首次启动容器后，在容器目录/app/data（即主机/data/syncclipboard-server目录）下会自动创建默认的appsettings.json
修改appsettings.json时，涉及文件路径的，请注意容器与主机间的文件映射关系

Arch Linux

可以直接从 AUR 安装（由 @devome 维护）：

paru -Sy syncclipboard-server

配置文件路径为/etc/syncclipboard/appsettings.json，修改配置后使用systemctl命令启动即可：

sudo systemctl enable --now syncclipboard.service

客户端内置服务器

桌面客户端（Windows/Linux/macOS）内置了服务器功能，可以使用可视界面配置

WebDAV服务器

可以使用支持WebDAV协议的网盘作为服务器
测试过的服务器：

客户端

桌面客户端（Windows/Linux/macOS）运行在后台时将自动同步剪贴板

展开/折叠截图

Windows

免安装板

在Release页面下载名字以SyncClipboard_win_开头的zip文件，解压后运行SyncClipboard.exe

故障排除

  • 支持的最低系统版本为Windows10 2004
  • 在Windows 10中运行SyncClipboard时界面图标大范围出错，请下载安装微软Segoe Fluent Icons图标字体

macOS

手动安装

在Release页面下载名字以SyncClipboard_macos_开头的安装包，双击后拖动SyncClipboard图标到Applications文件夹

故障排除

  • 系统提示由于开发者无法验证，“SyncClipboard”无法打开： 在macOS的设置->隐私与安全性页面，点击仍要打开
  • 系统提示“SyncClipboard”已损坏，无法打开：在终端中执行sudo xattr -d com.apple.quarantine /Applications/SyncClipboard.app
  • 部分功能需要模拟键盘输入实现复制或粘贴，依赖辅助功能权限，软件在需要时会弹窗提示授权

Linux

手动安装

在Release页面下载名字以SyncClipboard_linux_开头的安装包

Arch Linux

Arch Linux 用户可以直接从AUR安装（由 @devome 维护）：

paru -Sy syncclipboard-desktop

安装后从菜单中启动即可。如果在命令行中使用命令syncclipboard-desktop启动报错，请将环境变量LANG设置为en_US.UTF-8，以LANG=en_US.UTF-8 syncclipboard-desktop来启动。

故障排除

  • 剪贴板同步不及时、无法同步、上传乱码：建议在系统内安装xclip（X11）或wl-clipboard（Wayland），SyncClipboard会使用这些工具辅助获取剪贴板以增强稳定性。使用xclip -version或wl-paste -version命令确认是否已安装
  • 使用deb、rpm安装包时，升级安装失败时，请先删除旧版再安装新版
  • 使用AppImage包时，请确认AppImage文件具有可执行权限
  • 快捷键在Wayland可能无法使用

Note

需要彻底删除SyncClipboard时请手动删除配置文件和临时文件目录：
%AppData%\SyncClipboard\(Windows)，~/Library/Application Support/SyncClipboard/(macOS)，~/.config/SyncClipboard/(Linux)

桌面客户端命令行参数

--shutdown-previous

关闭已经运行的SyncClipboard，运行新的实例

--command-{command-name}

运行指定命令，{command-name}为命令名称，设置快捷键后，在配置文件中可以查看对应的命令名称，即使清除快捷键配置，命令行参数仍然有效
当存在已经运行的SyncClipboard时，不会启动新的实例，而是调用已经运行的SyncClipboard执行命令。当不存在已经运行的SyncClipboard时，将在启动完成后立刻执行命令
支持多个--command-{command-name}参数，多个命令同时执行

Note

macOS使用命令行参数时，请使用可执行程序的完整路径/Applications/SyncClipboard.app/Contents/MacOS/SyncClipboard.Desktop.MacOS

IOS

使用快捷指令

  • 手动同步，导入这个快捷指令，手动触发上传或下载
  • 自动同步，导入这个快捷指令，运行后设备会自动在后台同步剪贴板内容，此快捷指令将执行无限时长，需要手动关闭，你还可以手动修改同步后是否发送系统通知、查询的间隔秒数
  • 自动上传短信验证码，参考这个帖子中的视频教程 #60

Android

使用HTTP Request Shortcuts

导入这个配置文件，修改变量中的UserName，UserToken，url， url不要以斜线分隔符/结尾。HTTP Request Shortcuts支持从下拉菜单、桌面组件、桌面图标、分享菜单中使用

导入配置文件后修改配置图示
  • 通过变量修改账号、密码、网址

  • 下载文件时，如果你希望自动将文件存储到文件系统，请根据下图修改储存位置

  • 下载文件时，如果你想修改默认行为（默认行为：弹出一个展示页面等待用户处理，并将文件保存到前面选择的位置），可以根据你的需求修改如下内容

使用Sync Clipboard Flutter

这是一个使用 Flutter 构建的 Material 3 风格的、适配了SyncClipboard API的安卓客户端应用，支持从控制中心快捷上传或下载。

功能详情、使用步骤、系统要求等信息请查看该项目的 README

使用Autox.js

  • 自动同步，使用这个js文件。由于安卓系统限制，在安卓10及以上的系统应用无法在后台读取剪贴板，但可以使用基于Root权限的工具(Magisk/Xposed)解除应用后台读取剪贴版的权限，如Riru-ClipboardWhitelist、Clipboard Whitelist。由于在安卓13及以上的系统应用必须由用户手动授权才被允许访问系统日志（剪贴板），也可以使用Xposed自动为应用授权访问系统日志的权限，如DisableLogRequest/禁用日志访问请求
  • 自动上传验证码，使用这个js文件，这个脚本运行在后台时将读取所有通知消息，在识别到验证码类信息时将证码上传到服务器

导入js文件、修改每个文件头部的用户配置后，手动点击运行，或者为每个js文件设置触发方式，例如：开机时触发

使用SmsForwarder

  • 自动上传验证码， #109

使用Tasker

Tasker是一款安卓系统上非常强大的自动化工具软件，你可以根据SyncClipboard的API创建适合自己的配置文件，如果你认为你的配置文件非常通用并希望分享出来，欢迎联系我置于此处

客户端配置说明

全平台依赖三条必要配置（配置的拼写可能会有所不同，含义相同）。

  • user
  • password
  • url，格式为http(s)://ip(或者域名):port。使用WebDav服务器时，url需要具体到一个已存在的文件夹作为工作目录，例如https://domain.com/dav/folder1/working%20folder，特殊符号需要使用url转义字符代替，不要使用这个文件夹存储其他文件。不使用桌面客户端（Windows/Linux/macOS）时需在工作目录中再创建file文件夹以同步文件，桌面客户端会在设置服务器时自动创建file文件夹。url尽量不要以斜线分隔符/结尾，在部分客户端中会出现问题。

API

在独立服务器运行环境下设定环境变量ASPNETCORE_ENVIRONMENT为Development后运行服务器，或桌面客户端打开服务器并打开设置里的诊断模式后， 访问http://ip:端口/swagger/index.html可以打开API描述页面

API路径不以/api/起始的为WebDAV兼容API，实现客户端时，调用此类API可以同时支持基于WebDAV服务器与SyncClipboard官方服务器的剪贴板同步功能，其中的关键API的说明如下

获取剪贴板

GET /SyncClipboard.json
GET /file/dataName            # optional

上传剪贴板

PUT /file/dataName            # optional
PUT /SyncClipboard.json

SyncClipboard.json

{
  "type": "Text",             // or Image/File/Group, required
  "hash": "string",           // optional, empty string is treated as null
  "text": "string",           // required
  "hasData": true,            // or false, required  
  "dataName": "string",       // if hasData is true, required
  "size": 0                   // optional
}
  • API所有字段大小写敏感
  • text储存剪贴板预览字符串，或完整的Text类型剪贴板内容
  • hasData标识是否使用一个额外文件存储完整的剪贴板信息
    • 对于Image/File/Group类型，hasData恒为true
    • 对于Text类型，可以根据原字符串的长度，可选是否使用额外的UTF8编码的.txt文件存储完整字符串，如果这样做，text字段仅储存完整字符串的起始部分内容
  • hash值为剪贴板内容的唯一标识，计算方法请参考docs/Hash.md
    • 发送方应尽量提供hash信息
    • 当hash值存在时，接收方应验证hash信息与剪贴板内容的一致性，在不一致时执行错误处理流程
    • 当hash为空时，或处于无法计算hash的环境，可以使用type/text的组合简单判断剪贴板内容的相等性
  • size标识复制文件的总字节大小，或Text类型剪贴板完整字符串的长度，仅用于展示

项目依赖

NativeNotification
Magick.NET
.NET Community Toolkit
H.NotifyIcon
WinUIEx
moq
Avalonia
FluentAvalonia.BreadcrumbBar
FluentAvalonia
AsyncImageLoader.Avalonia
Vanara
Tmds.DBus
SharpHook
Quartz.NET
MiSans

About

跨平台剪贴板同步、历史记录管理工具 / Cross-platform cipboard syncing, history management tool

Resources

Readme

License

MIT license
Activity

Stars

3.9k stars

Watchers

13 watching

Forks

172 forks
Report repository

Releases 90

v3.1.1 Latest
Feb 6, 2026
+ 89 releases

Contributors 10

Languages