只要几分钟,就能让手机、电脑、Mac、Linux之间的复制粘贴瞬间同步,省掉来回开邮件、聊天记录的麻烦。这篇文章教你如何用 Docker 一键部署 SyncClipboard 服务器,以及在各平台上配置客户端,让剪贴板像自来水一样随时随地流通。
先说清楚:我们要解决的痛点
- 不同系统之间复制的文字、图片、文件总是需要手动转发。
- 市面上很多“跨平台复制”功能要么收费,要么只能在同一家生态(如 Apple)内部使用。
- 即使有开源方案,也往往散落在各个 README 里,看得头疼,部署步骤复杂。
这篇文不讲理论,直接把核心步骤拆成三块:服务器、客户端、进阶安全」,每一步都配上最小化命令,让你省心省力。
一、把服务器装进 Docker 容器——只要一行命令
准备一台可以随时联网的机器(VPS、家里服务器、或者局域网电脑):
- 安装 Docker 与 Docker‑compose(
apt install docker.io docker-compose)。 - 新建目录并写入
docker-compose.yml,内容如下:
services:
syncclipboard-server:
image: jericx/syncclipboard-server:latest
container_name: syncclipboard-server
restart: unless-stopped
ports:
- "5033:5033"
environment:
- SYNCCLIPBOARD_USERNAME=你的用户名
- SYNCCLIPBOARD_PASSWORD=你的密码
volumes:
- /data/syncclipboard:/app/data
保存后执行 docker compose up -d,等镜像拉好就算跑起来了。默认 5033 端口对外提供 HTTP 接口,后面我们会讲怎么加 HTTPS。
二、客户端怎么连接
SyncClipboard 提供 Windows、Linux、macOS 三个官方桌面客户端,Android / iOS 通过 “HTTP Request Shortcuts” 或者 Tasker 也能打通。
- Windows:下载
SyncClipboard.zip,解压后双击SyncClipboard.exe,在弹窗里填入服务器地址http://你的IP:5033,以及上面设置的用户名、密码。 - Linux/macOS:同样下载对应的二进制文件,执行前记得给文件
chmod +x。启动后在系统托盘里右键可以打开设置页面。 - Android:在 F‑Droid 或 Google Play 下载 “HTTP Request Shortcuts”,导入官方提供的 JSON(里面已经写好 GET/PUT 接口),把
UserName、UserToken、url替换成自己的。 - iOS:使用官方的快捷指令模板,填入同样的三个参数即可。
配置好后,复制一段文字或图片,客户端会自动把它推送到服务器,其他设备马上弹出通知并写进本地剪贴板。整个过程像自来水一样,不需要手动操作。
三、让传输更安全——HTTPS + 反向代理
明文 HTTP 在公网里裸奔极不安全,建议再加一层 Nginx Proxy Manager(或 Caddy):
- 在 NPM 新建代理,域名指向服务器 IP,内部端口填写 5033。
- 勾选 “Force SSL”,让 Nginx 自动给你申请免费的 Let's Encrypt 证书。
- 之后客户端把地址改成
https://你的域名,其余账号密码不变。
这样即使在咖啡店公共 WiFi 里,也能放心同步。
四、常见坑和小技巧
- Linux 桌面在 Wayland 环境下,Clipboard 需要额外安装
xclip或wl-clipboard,不然同步会卡。 - Mac 上首次打开会提示“未验证的开发者”,打开系统设置 → 隐私与安全 → 仍要打开 即可。
- 如果想保留历史记录,可以在服务器的
appsettings.json里打开History开关,文件会自动保存在/app/data目录。 - 想在公司内部局域网使用,直接把
-p 5033:5033改成不冲突的端口,省去域名、HTTPS 的麻烦。
五、进阶玩法:把剪贴板当成小型云盘
SyncClipboard 支持上传文件(最大 2 MB),只要把文件拖到客户端界面,它会自动生成一个唯一文件名,其他设备通过 /file/文件名 下载。你可以把它当作随手记事本、脚本片段甚至小图片库。
之前聊过的 WebDAV 网盘也能直接当服务器,只要把 URL 指向网盘的子目录,省去自行部署的麻烦。对不想自己开 VPS 的朋友,这算是免费版的“多平台云剪贴”。
结语 & 互动时间
把这套方案搬到自己的设备上,只要十分钟,就能实现跨系统的复制粘贴,彻底摆脱“手动转发”这件事。如果你已经跑通,或者在配置过程中遇到奇怪的报错,欢迎在评论区聊聊你的经验和问题,大家一起调试。
评论 (0)