SyncClipboard跨平台剪贴板同步工具安装与配置指南

一、项目基础介绍

SyncClipboard是一个开源的跨平台剪贴板同步工具，它支持文字、图片和文件的同步。该工具采用服务器/客户端架构，可以使用客户端内置服务器、独立部署服务器或支持WebDAV协议的网盘作为服务器来进行同步。

主要编程语言

• C#：项目的主要开发语言，用于服务器和桌面客户端的开发。
• JavaScript：用于Android客户端的开发。

二、项目使用的关键技术和框架

• ASP.NET Core：用于开发独立服务器，提供WebDAV服务。
• WebDAV协议：一种网络协议，用于用户通过网络编辑和管理存储在远端服务器上的文件。
• Magick.NET：用于处理和转换图像文件。
• .NET Community Toolkit、WinUIEx等：用于桌面客户端的用户界面和功能开发。

三、项目安装和配置的准备工作

在开始安装前，请确保您的系统满足以下要求：

1. 操作系统：Windows、Linux或macOS。
2. .NET运行时：安装.NET 6.0桌面运行时和ASP.NET Core 6.0运行时。
3. 环境变量（可选）：如果需要，设置环境变量SYNCCLIPBOARD_USERNAME和SYNCCLIPBOARD_PASSWORD。

安装步骤

1. Windows客户端安装

• 下载Release页面中的SyncClipboard.zip。
• 解压缩后运行SyncClipboard.exe。
• 根据提示安装所需的.NET运行时。

2. Linux和macOS客户端安装

• 根据系统选择对应的安装包SyncClipboard.Desktop。
• 名称中带有no-self-contained的安装包需要依赖.NET 6.0桌面运行时和ASP.NET Core 6.0运行时。
• 名称中带有self-contained的安装包通常可以直接运行。
• 安装后，配置文件存放在~/.config/SyncClipboard/（Linux）或~/Library/Application Support/SyncClipboard/（macOS）。

3. 服务器安装

独立服务器

• 运行以下命令以运行服务器：

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

• 修改appsettings.json文件来设置IP地址、端口和认证信息。

Docker

• 运行以下命令以使用Docker运行服务器：

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

4. 客户端配置

• 所有平台都需要配置以下三项信息：user、password和url（格式为http(s)://ip:port）。
• 使用WebDAV服务器时，url需要指向一个具体的文件夹作为工作目录。

完成以上步骤后，您就可以开始使用SyncClipboard进行跨平台剪贴板的同步了。