Synergy-core跨平台键鼠共享工具安装指南

一、功能解析：跨设备控制的核心能力

Synergy-core作为开源跨平台键鼠共享工具，核心功能在于实现Windows、macOS和Linux系统间的无缝控制。通过局域网内的网络通信，用户可使用一套键盘鼠标控制多台设备，支持剪贴板共享、跨屏幕拖拽文件等高级功能。该工具采用C++编写，通过CMake构建系统实现跨平台兼容性，底层使用TCP/IP协议确保数据传输的稳定性。

二、环境适配：跨平台兼容性矩阵

功能特性	Windows 10/11	macOS 12+	Linux (Ubuntu 20.04+)
基础键鼠控制	✅ 完全支持	✅ 完全支持	✅ 完全支持
剪贴板共享	✅ 文本/文件	✅ 文本/文件	✅ 文本/文件
拖放文件传输	✅ 支持	✅ 支持	✅ 支持
加密连接	✅ TLS 1.3	✅ TLS 1.3	✅ TLS 1.3
多显示器支持	✅ 最多8台	✅ 最多8台	✅ 最多8台
热键自定义	✅ 完全支持	✅ 完全支持	✅ 完全支持

三、分步实施：系统特性与针对性部署

Windows系统：图形化部署方案

环境预检 🛠️

1. 操作目的：确认系统兼容性与必要组件
2. 执行命令：

   # 检查系统版本
   winver
   # 验证.NET Framework 4.8安装
   reg query "HKLM\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" /v Release
   

3. 预期结果：系统版本显示为Windows 10 1809以上，注册表查询返回Release值≥528040

注意事项：Windows系统需开启"开发者模式"以支持符号链接，可通过"设置→更新和安全→开发者选项"启用

依赖部署

1. 操作目的：安装编译所需基础工具链
2. 执行命令：

   # 安装Chocolatey包管理器
   @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
   
   # 安装编译依赖
   choco install -y git cmake visualstudio2022-workload-vctools qt6-base
   

3. 预期结果：命令执行完成后，git、cmake和VS2022构建工具成功安装

核心编译

1. 操作目的：从源码构建可执行程序
2. 执行命令：

   # 克隆项目仓库
   git clone https://gitcode.com/GitHub_Trending/sy/synergy-core
   cd synergy-core
   
   # 配置编译系统
   cmake -B build --preset=windows-release -DCMAKE_INSTALL_PREFIX=C:\Program Files\Synergy
   
   # 执行编译过程
   cmake --build build --config Release -j8
   
   # 安装到系统目录
   cmake --install build
   

3. 预期结果：在build/bin目录下生成deskflow.exe等可执行文件，安装完成后在开始菜单出现Synergy图标

性能优化参数

• 添加-DCMAKE_BUILD_TYPE=Release启用优化编译
• 使用-DENABLE_CLIPBOARD_ENCRYPTION=ON开启剪贴板加密
• 添加-DUSE_SSE2=ON针对Intel处理器优化指令集

验证测试

1. 操作目的：确认核心功能正常工作
2. 执行命令：

   # 运行单元测试
   "C:\Program Files\Synergy\bin\unittests.exe"
   
   # 启动主程序
   "C:\Program Files\Synergy\bin\deskflow.exe"
   

3. 预期结果：单元测试全部通过，程序启动后显示配置界面

macOS系统：终端快捷部署方案

环境预检 🔍

1. 操作目的：验证系统版本与开发工具链
2. 执行命令：

   # 检查macOS版本
   sw_vers -productVersion
   
   # 确认Xcode命令行工具已安装
   xcode-select -p
   

3. 预期结果：macOS版本显示12.0以上，xcode-select返回/Library/Developer/CommandLineTools

依赖部署

1. 操作目的：通过Homebrew安装必要依赖
2. 执行命令：

   # 安装Homebrew包管理器
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   
   # 安装编译依赖
   brew install git cmake qt@6 openssl@3
   

3. 预期结果：所有依赖包成功安装，无错误提示

核心编译

1. 操作目的：从源码构建应用程序包
2. 执行命令：

   # 克隆项目仓库
   git clone https://gitcode.com/GitHub_Trending/sy/synergy-core
   cd synergy-core
   
   # 配置编译系统
   cmake -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=$(brew --prefix qt@6)
   
   # 执行编译过程
   cmake --build build -j$(sysctl -n hw.ncpu)
   
   # 生成应用程序包
   cmake --build build --target package
   

3. 预期结果：在build目录下生成Synergy.app应用程序包和dmg安装文件

性能优化参数

• 添加-DENABLE_QUICKLOOK=ON启用macOS快速查看支持
• 使用-DCMAKE_OSX_ARCHITECTURES="x86_64;arm64"构建通用二进制
• 添加-DUSE_APP_SANDBOX=ON启用应用沙箱支持

验证测试

1. 操作目的：确认应用功能完整性
2. 执行命令：

   # 运行集成测试
   ./build/bin/integtests
   
   # 启动应用程序
   open ./build/Synergy.app
   

3. 预期结果：测试通过，应用启动后请求辅助功能权限

Linux系统：发行版适配部署方案

环境预检 ✅

1. 操作目的：检查系统兼容性与必要组件
2. 执行命令：

   # 检查发行版信息
   cat /etc/os-release
   
   # 确认gcc版本
   gcc --version
   

3. 预期结果：显示Ubuntu 20.04+/Fedora 34+/openSUSE Leap 15.3+，gcc版本≥9.0

注意事项：Linux系统需要安装X11开发库，Wayland用户需启用XWayland兼容模式

依赖部署

1. 操作目的：根据发行版安装对应依赖
2. 执行命令：

   # Ubuntu/Debian
   sudo apt update && sudo apt install -y git cmake build-essential qt6-base-dev libssl-dev libx11-dev libxtst-dev
   
   # Fedora
   sudo dnf install -y git cmake gcc-c++ qt6-qtbase-devel openssl-devel libX11-devel libXtst-devel
   
   # openSUSE
   sudo zypper install -y git cmake gcc-c++ libqt6-devel libopenssl-devel libX11-devel libXtst-devel
   

3. 预期结果：所有开发依赖成功安装

核心编译

1. 操作目的：构建适合Linux桌面环境的版本
2. 执行命令：

   # 克隆项目仓库
   git clone https://gitcode.com/GitHub_Trending/sy/synergy-core
   cd synergy-core
   
   # 配置编译系统
   cmake -B build -DCMAKE_BUILD_TYPE=Release -DBUILD_GUI=ON
   
   # 执行编译过程
   cmake --build build -j$(nproc)
   
   # 安装到系统
   sudo cmake --install build
   

3. 预期结果：程序安装到/usr/local/bin，桌面快捷方式添加到应用菜单

性能优化参数

• 添加-DUSE_UDEV=ON启用udev设备管理支持
• 使用-DENABLE_WAYLAND=ON构建Wayland原生支持（实验性）
• 添加-DCMAKE_INSTALL_PREFIX=/usr指定系统级安装路径

验证测试

1. 操作目的：验证核心功能与系统集成
2. 执行命令：

   # 运行单元测试
   ./build/bin/unittests
   
   # 启动服务与GUI
   deskflowd &
   deskflow
   

3. 预期结果：服务成功启动，GUI界面正常显示，无错误日志输出

四、问题诊断：故障树结构解决方案

依赖安装失败

• 症状：cmake配置阶段提示缺少Qt组件
• 原因：Qt6开发包未正确安装或环境变量未配置
• 解决方案：

  # Ubuntu/Debian
  sudo apt install -y qt6-base-dev qt6-tools-dev qt6-tools-dev-tools
  
  # 手动指定Qt路径
  cmake -B build -DCMAKE_PREFIX_PATH=/path/to/qt6
  

编译错误

• 症状：编译过程中出现"undefined reference to SSL_*"
• 原因：OpenSSL开发库版本不兼容或未正确链接
• 解决方案：

  # 安装特定版本OpenSSL
  sudo apt install -y libssl-dev=1.1.1f-1ubuntu2
  
  # 强制链接系统OpenSSL
  cmake -B build -DOPENSSL_ROOT_DIR=/usr/lib/ssl
  

运行时问题

• 症状：启动后无法检测到其他设备
• 原因：防火墙阻止或网络配置问题
• 解决方案：

  # 添加防火墙规则
  sudo ufw allow 24800/tcp
  
  # 检查网络连通性
  nc -zv <server-ip> 24800
  

五、高级功能扩展：源码编译定制选项

安全增强配置

通过以下编译选项增强安全性：

cmake -B build \
  -DENABLE_ENCRYPTION=ON \
  -DUSE_TLS13=ON \
  -DENABLE_CERT_PINNING=ON \
  -DSECURITY_HARDENING=ON

功能定制

根据需求启用/禁用特定功能：

# 禁用GUI组件（仅命令行模式）
cmake -B build -DBUILD_GUI=OFF

# 启用调试日志
cmake -B build -DENABLE_DEBUG_LOGGING=ON

# 自定义默认端口
cmake -B build -DDEFAULT_PORT=24801

集成系统服务

为Linux系统创建systemd服务：

# 编译时启用服务支持
cmake -B build -DINSTALL_SYSTEMD_SERVICE=ON

# 安装后启用并启动服务
sudo systemctl enable deskflowd
sudo systemctl start deskflowd

通过以上定制选项，可根据具体需求构建适合特定场景的Synergy-core版本，满足企业级部署或个人定制化需求。