Skip to content

PasteFerry (隔空贴): clipboard and file sync across macOS, Windows and Linux. Direct-first, end-to-end encrypted. Optional official access: no server to host. Independent self-hosting remains available.

build(ci): package the Linux client on x64 and ARM64

baiyuzecbcc9bd910d0
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 451c572..219c67e 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -22,7 +22,7 @@ jobs:
client-core:
name: 后台服务
- # 剪贴板部分是 cgo + AppKit,只能在 macOS 上编译
+ # 剪贴板部分是 cgo + AppKit,只能在 macOS 上编译。Linux、Windows 上的测试在各自的客户端任务里
runs-on: macos-latest
steps:
- uses: actions/checkout@v4
@@ -95,3 +95,48 @@ jobs:
path: |
dist/windows/CopySync-Setup.exe
dist/windows/CopySync-windows-x64.zip
+
+ linux:
+ name: Linux 客户端(${{ matrix.arch }})
+ # Flutter 不能交叉编译 Linux 桌面程序,两种架构各用一台机器。
+ # 在 22.04 上构建:产物依赖的 glibc 与 GTK 版本较老,新的发行版也能运行
+ strategy:
+ fail-fast: false
+ matrix:
+ include:
+ - runner: ubuntu-22.04
+ arch: amd64
+ - runner: ubuntu-22.04-arm
+ arch: arm64
+ runs-on: ${{ matrix.runner }}
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-go@v5
+ with:
+ go-version-file: client-core/go.mod
+ cache-dependency-path: client-core/go.sum
+ - name: 安装构建依赖
+ run: |
+ sudo apt-get update -q
+ sudo apt-get install -y -q clang cmake ninja-build pkg-config libgtk-3-dev xvfb xclip
+ # flutter-action 不提供 Linux ARM64 的 Flutter,两种架构都直接取 stable 分支
+ - name: 安装 Flutter
+ run: |
+ git clone --depth 1 -b stable https://github.com/flutter/flutter.git "$RUNNER_TEMP/flutter"
+ echo "$RUNNER_TEMP/flutter/bin" >> "$GITHUB_PATH"
+ - run: flutter --version
+ # X11 剪贴板的测试在虚拟显示器里跑,xclip 扮演别的程序
+ - run: go vet ./... && xvfb-run -a go test ./...
+ working-directory: client-core
+ - run: xvfb-run -a go test -v -count=1 -run Linux ./internal/clipboard/
+ working-directory: client-core
+ - run: flutter pub get && flutter analyze && flutter test
+ working-directory: ui
+ - run: ./scripts/package-linux.sh
+ - uses: actions/upload-artifact@v4
+ with:
+ name: CopySync-linux-${{ matrix.arch }}
+ path: |
+ dist/linux/CopySync-linux-${{ matrix.arch }}.deb
+ dist/linux/CopySync-linux-${{ matrix.arch }}.tar.gz
+ if-no-files-found: error
diff --git a/scripts/package-linux.sh b/scripts/package-linux.sh
new file mode 100755
index 0000000..52ff1be
--- /dev/null
+++ b/scripts/package-linux.sh
@@ -0,0 +1,97 @@
+#!/usr/bin/env bash
+# 在 Linux 上构建并打包 CopySync 客户端:界面(Flutter,GTK)、后台服务 copysyncd、命令行 copysync-cli。
+#
+# ./scripts/package-linux.sh
+#
+# 产出放在 dist/linux/:
+# CopySync-linux-<arch>.deb Debian、Ubuntu 及其衍生版,装在 /opt/CopySync,自动出现在应用菜单里
+# CopySync-linux-<arch>.tar.gz 其他发行版:解压即用,运行里面的 install.sh 加进应用菜单
+#
+# <arch> 是 amd64 或 arm64,取决于运行脚本的机器:Flutter 不能交叉编译 Linux 桌面程序,
+# 所以 CI 在两种架构的机器上各跑一次。
+#
+# 需要 Go、Flutter,以及 Flutter 的 Linux 构建依赖:
+# sudo apt install clang cmake ninja-build pkg-config libgtk-3-dev
+# 文件名不带版本号,网站上的 releases/latest/download/<文件名> 链接才不会随发版失效。
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+VERSION=${VERSION:-$(sed -n 's/^VERSION=\${VERSION:-\(.*\)}$/\1/p' scripts/build.sh)}
+case "$(uname -m)" in
+ x86_64) ARCH=amd64 FLUTTER_ARCH=x64 ;;
+ aarch64 | arm64) ARCH=arm64 FLUTTER_ARCH=arm64 ;;
+ *)
+ echo "不支持的架构:$(uname -m)" >&2
+ exit 1
+ ;;
+esac
+
+OUT=dist/linux
+APP=$OUT/CopySync
+rm -rf "$OUT" && mkdir -p "$APP"
+
+echo "▶ 后台服务与命令行($VERSION,$ARCH)"
+# 纯 Go,不依赖 glibc 版本:剪贴板经 X11 协议直接通信,不链接 libX11
+(cd client-core && CGO_ENABLED=0 go build -trimpath -ldflags "-s -w -X main.version=$VERSION" \
+ -o "../$APP/copysyncd" ./cmd/copysyncd)
+(cd client-core && CGO_ENABLED=0 go build -trimpath -ldflags "-s -w" -o "../$APP/copysync-cli" ./cmd/copysync-cli)
+
+echo "▶ 界面"
+(cd ui && flutter build linux --release --build-name "$VERSION" --dart-define=APP_VERSION="$VERSION")
+cp -R "ui/build/linux/$FLUTTER_ARCH/release/bundle/." "$APP/"
+
+# ── tar.gz:解压即用 ──
+echo "▶ CopySync-linux-$ARCH.tar.gz"
+TAR=$OUT/tar/CopySync
+mkdir -p "$TAR/share"
+cp -R "$APP/." "$TAR/"
+cp tools/linux/install.sh tools/linux/uninstall.sh "$TAR/"
+cp tools/linux/com.copysync.app.desktop tools/linux/icons/*.png "$TAR/share/"
+tar -C "$OUT/tar" -czf "$OUT/CopySync-linux-$ARCH.tar.gz" --owner=0 --group=0 CopySync
+
+# ── deb:装在 /opt/CopySync ──
+echo "▶ CopySync-linux-$ARCH.deb"
+DEB=$OUT/deb
+mkdir -p "$DEB/DEBIAN" "$DEB/opt" "$DEB/usr/bin" "$DEB/usr/share/applications"
+cp -R "$APP" "$DEB/opt/CopySync"
+sed 's#@EXEC@#/opt/CopySync/copysync#' tools/linux/com.copysync.app.desktop \
+ > "$DEB/usr/share/applications/com.copysync.app.desktop"
+for size in 256 512; do
+ mkdir -p "$DEB/usr/share/icons/hicolor/${size}x$size/apps"
+ cp "tools/linux/icons/com.copysync.app-$size.png" "$DEB/usr/share/icons/hicolor/${size}x$size/apps/com.copysync.app.png"
+done
+ln -s /opt/CopySync/copysync "$DEB/usr/bin/copysync"
+ln -s /opt/CopySync/copysync-cli "$DEB/usr/bin/copysync-cli"
+
+# libgtk-3-0:Ubuntu 24.04 起改名为 libgtk-3-0t64,新包也提供旧名字,写旧名字两边都能装
+cat > "$DEB/DEBIAN/control" <<EOF
+Package: copysync
+Version: $VERSION
+Architecture: $ARCH
+Maintainer: baiyuze <[email protected]>
+Installed-Size: $(du -sk "$DEB" | cut -f1)
+Depends: libgtk-3-0 (>= 3.22)
+Recommends: fonts-noto-cjk
+Section: utils
+Priority: optional
+Homepage: https://baiyuze.github.io/copysync/
+Description: Sync what you copy between your computers
+ CopySync keeps the clipboard in sync across Mac, Windows and Linux:
+ text, images and files, directly over the local network or through
+ your own server. Content is end-to-end encrypted.
+EOF
+# 卸载时结束正在运行的后台服务:程序文件已经没了。升级时不结束,界面打开时会按新版本重启它
+cat > "$DEB/DEBIAN/prerm" <<'EOF'
+#!/bin/sh
+set -e
+if [ "$1" = remove ]; then
+ pkill -x copysyncd || true
+fi
+EOF
+chmod 755 "$DEB/DEBIAN/prerm"
+dpkg-deb --build --root-owner-group "$DEB" "$OUT/CopySync-linux-$ARCH.deb" >/dev/null
+
+rm -rf "$OUT/tar" "$DEB"
+echo
+echo "完成:"
+ls -lh "$OUT"/CopySync-linux-*
diff --git a/tools/linux/com.copysync.app.desktop b/tools/linux/com.copysync.app.desktop
new file mode 100644
index 0000000..6e8ecb9
--- /dev/null
+++ b/tools/linux/com.copysync.app.desktop
@@ -0,0 +1,17 @@
+[Desktop Entry]
+Type=Application
+Name=CopySync
+GenericName=Clipboard Sync
+GenericName[zh_CN]=剪贴板同步
+GenericName[ja]=クリップボード同期
+Comment=Sync what you copy between your computers
+Comment[zh_CN]=在电脑之间同步复制的内容
+Comment[ja]=コンピューター間でコピーした内容を同期
+Exec=@EXEC@
+Icon=com.copysync.app
+Terminal=false
+Categories=Utility;
+Keywords=clipboard;sync;copy;paste;
+Keywords[zh_CN]=剪贴板;同步;复制;粘贴;
+StartupWMClass=com.copysync.app
+StartupNotify=true
diff --git a/tools/linux/icons/com.copysync.app-256.png b/tools/linux/icons/com.copysync.app-256.png
new file mode 100644
index 0000000..ad96008
Binary files /dev/null and b/tools/linux/icons/com.copysync.app-256.png differ
diff --git a/tools/linux/icons/com.copysync.app-512.png b/tools/linux/icons/com.copysync.app-512.png
new file mode 100644
index 0000000..a0f878d
Binary files /dev/null and b/tools/linux/icons/com.copysync.app-512.png differ
diff --git a/tools/linux/install.sh b/tools/linux/install.sh
new file mode 100755
index 0000000..26c746c
--- /dev/null
+++ b/tools/linux/install.sh
@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# 把解压出来的 CopySync 加进当前用户的应用菜单(不需要 root)。
+#
+# ./install.sh
+#
+# 程序留在原地运行:之后挪了这个文件夹,重新运行一次即可。卸载运行 ./uninstall.sh。
+set -euo pipefail
+here=$(cd "$(dirname "$0")" && pwd)
+data=${XDG_DATA_HOME:-$HOME/.local/share}
+
+mkdir -p "$data/applications" "$data/icons/hicolor/256x256/apps" "$data/icons/hicolor/512x512/apps"
+# Exec 里的路径按 Desktop Entry 规范放在引号里,允许文件夹名带空格
+sed "s#@EXEC@#\"$here/copysync\"#" "$here/share/com.copysync.app.desktop" > "$data/applications/com.copysync.app.desktop"
+cp "$here/share/com.copysync.app-256.png" "$data/icons/hicolor/256x256/apps/com.copysync.app.png"
+cp "$here/share/com.copysync.app-512.png" "$data/icons/hicolor/512x512/apps/com.copysync.app.png"
+command -v update-desktop-database >/dev/null && update-desktop-database -q "$data/applications" || true
+command -v gtk-update-icon-cache >/dev/null && gtk-update-icon-cache -q -t "$data/icons/hicolor" || true
+
+echo "已把 CopySync 加进应用菜单。也可以直接运行:$here/copysync"
diff --git a/tools/linux/uninstall.sh b/tools/linux/uninstall.sh
new file mode 100755
index 0000000..577cdae
--- /dev/null
+++ b/tools/linux/uninstall.sh
@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# 撤销 install.sh:从应用菜单移除 CopySync,停用后台同步与开机自启。
+# 历史记录与配对关系保存在 ~/.local/share/copysync,不会删除;不再需要时手动删掉这个文件夹。
+set -euo pipefail
+data=${XDG_DATA_HOME:-$HOME/.local/share}
+config=${XDG_CONFIG_HOME:-$HOME/.config}
+
+pkill -u "$(id -u)" -x copysyncd 2>/dev/null || true
+rm -f "$config/autostart/copysync-daemon.desktop" \
+ "$data/applications/com.copysync.app.desktop" \
+ "$data/icons/hicolor/256x256/apps/com.copysync.app.png" \
+ "$data/icons/hicolor/512x512/apps/com.copysync.app.png"
+command -v update-desktop-database >/dev/null && update-desktop-database -q "$data/applications" || true
+echo "已移除。现在可以删掉 CopySync 所在的文件夹。"