使用 SyncClipboard 实现多端同步剪贴板

使用 Docker 部署（推荐）#

创建 docker-compose.yml 文件：

1
services:
2
  syncclipboard:
3
    image: jericx/syncclipboard-server:latest
4
    container_name: syncclipboard
5
    restart: unless-stopped
6
    ports:
7
      - "5033:5033"
8
    volumes:
9
      - ./syncclipboard-data:/app/data
10
    environment:
11
      - SYNCCLIPBOARD_USERNAME=your_username
12
      - SYNCCLIPBOARD_PASSWORD=your_password

启动服务：

1
docker-compose up -d

服务启动后，访问 http://<你的服务器IP>:5033 即可看到服务端页面。

NOTE

环境变量中设置的用户名和密码优先级高于配置文件，建议通过环境变量管理凭据。

高级配置#

服务端配置文件 appsettings.json 位于数据目录中，可调整以下参数：

1
{
2
  "MaxSavedHistoryCount": 1000
3
}

• MaxSavedHistoryCount：历史记录最大保存数量，默认 1000。

反向代理

如需配合反向代理使用（如 Nginx Proxy Manager），将 SyncClipboard 放在 HTTPS 域名后面可以更安全地在公网使用。配置 Forward Port 为 5033 即可。

Windows#

• 系统要求：Windows 10 2004 及以上。
• 下载 最新 Release 中的 Windows 版本并运行。
• 在设置中填写服务端地址、用户名和密码。

TIP

如果托盘图标显示异常，需安装 Segoe Fluent Icons 字体。

macOS#

下载 macOS 版本后，如果系统提示无法打开，执行以下命令解除限制：

1
sudo xattr -d com.apple.quarantine /Applications/SyncClipboard.app

打开后在设置中配置服务端信息。

Linux#

• AUR 用户可直接安装 syncclipboard-desktop。
• 其他发行版从 Release 页面下载对应版本。
• Wayland 环境建议安装 wl-clipboard，X11 环境建议安装 xclip。

通用配置#

所有客户端需要配置以下三项：

WARNING

URL 不要以斜线 / 结尾，否则可能导致连接异常。

手动同步剪贴板#

安装以下快捷指令，可在通知中心小组件或分享菜单中手动触发剪贴板的上传与下载：

手动同步剪贴板快捷指令

自动同步剪贴板#

安装以下快捷指令，配合 iOS 自动化功能实现打开指定 App 时自动同步剪贴板：

自动同步剪贴板快捷指令

自动同步短信验证码#

安装以下快捷指令，可在收到短信验证码时自动上传到服务端，方便在电脑端直接粘贴使用：

自动同步验证码快捷指令

设置自动化步骤：

1. 打开 快捷指令 App → 自动化 → 新建自动化。
2. 选择触发条件 收到信息，发送者填留空匹配所有短信。
3. 操作选择 运行快捷指令，选择上面安装的自动同步验证码快捷指令。
4. 关闭 运行前询问。

配置提醒

所有快捷指令安装后需要在指令内部填写服务端地址、用户名和密码，与客户端配置保持一致。