部署到公網伺服器

所有電腦都直接連線到它

伺服器在公網上，每部電腦不論身處哪個網絡，都能直接連上。複製的內容優先在兩部電腦之間直連傳輸；打不通直連時經伺服器中轉，內容依然加密。

• 信令，TCP 8787。每部電腦一直連着它，用來發現對方、配對、交換連線資訊。
• 直連。兩部電腦在不同網絡裏時，靠 NAT 打洞直接相連，大多數家庭和公司網絡都能打通。
• 中轉，UDP 3478 與中轉端口。打不通直連時經伺服器轉發，內容依然加密，速度受伺服器頻寬限制。

開始之前

一部雲端伺服器

Linux，x86_64 或 ARM64 都可以，最低配置已經足夠，伺服器程式只佔約 15 MB 記憶體。需要 root 權限。

一個公網 IP

雲端伺服器本身的公網 IP 就可以，最好是固定的（彈性 IP）。地址改變了，每部電腦都要重新填寫。

能登入它

能用 ssh 登入，或者使用雲端供應商網頁上的遠端終端機。

在內地的雲端伺服器

域名未有 ICP 備案時，用戶端裏要直接填 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），按 Enter 儲存。

3. 查看連線狀態

   「連接狀態」變成綠色的「已連接」就完成了。如果仍未配對，請在「設備」裏配對。

仍未安裝 App？見快速開始。

常見問題