部署到公网服务器

所有电脑都直接连它

服务器在公网上，每台电脑不管在哪个网络里，都能直接连上。复制的内容优先在两台电脑之间直连传输；打不通直连时经服务器中转，内容依然加密。

• 信令，TCP 8787。每台电脑一直连着它，用来发现对方、配对、交换连接信息。
• 直连。两台电脑在不同网络里时，靠 NAT 打洞直接相连，大多数家庭和公司网络都能打通。
• 中转，UDP 3478 与中转端口。打不通直连时经服务器转发，内容依然加密，速度受服务器带宽限制。

开始之前

一台云主机

Linux，x86_64 或 ARM64 都行，最低配置就够，服务器只占约 15 MB 内存。需要 root 权限。

一个公网 IP

云主机自带的公网 IP 就行，最好是固定的（弹性 IP）。地址变了，每台电脑都要重新填。

能登录它

能用 ssh 登录，或者用云厂商网页上的远程终端。

国内的云主机

域名没有备案时，客户端里要直接填 IP，不能填域名，原因见下面的常见问题。

第 1 步

在安全组里放行端口

在云厂商的控制台里，给这台云主机的安全组添加下面三条入站规则。

第 2 步

运行安装脚本

把公网 IP 带给安装脚本，它会装好服务器、注册为开机自启的 systemd 服务，最后显示客户端要填的地址。

$ sudo ./install.sh 203.0.113.10
▶ 安装二进制到 /usr/local/bin
▶ 写入 systemd 单元
▶ 生成配置 /etc/copysync/server.env（中转地址 203.0.113.10）
▶ 启动
  ✓ 已启动

安装完成：copysync-server 1.6.4
在每台电脑的 CopySync「设置 → 信令服务器地址」填：

    ws://203.0.113.10:8787/signal

  配置   /etc/copysync/server.env
  日志   journalctl -u copysync-server -f
  重启   systemctl restart copysync-server
  卸载   sudo ./install.sh uninstall

防火墙需放行：TCP 8787（信令）、UDP 3478（STUN 与 TURN）、UDP 32768-60999（中转端口，系统随机分配）

第 3 步

检查能不能访问到它

在任意一台电脑的浏览器里打开 http://203.0.113.10:8787/healthz（换成你的公网 IP），看到下面这一行就通了。

{"status":"ok","version":"1.6.4"}

打不开的话，看下面的常见问题。

第 4 步

在每台电脑上填地址

1. 打开设置

   在每台电脑上打开 CopySync，进入「设置」。

2. 填公网地址

   在「信令服务器地址」里填 ws://203.0.113.10:8787/signal（换成你的公网 IP），按回车保存。

3. 看连接状态

   「连接状态」变成绿色的「已连接」就好了。还没配对的话，在「设备」里配对。

还没装 App？见快速开始。

常见问题