Synergy-core跨平台键鼠共享工具实用指南

Synergy-core是一款开源工具，能够实现Windows、macOS和Linux系统间的键盘鼠标共享，让用户通过一套键鼠设备无缝控制多台电脑，提升跨系统协作效率。本文将详细介绍该工具的安装配置流程，帮助用户快速搭建多设备控制环境。

价值定位：为何选择Synergy-core

在多设备办公场景中，频繁切换键盘鼠标不仅影响工作效率，还会增加操作复杂度。Synergy-core通过网络传输输入信号，实现多系统键鼠共享，其核心优势包括：支持跨平台操作、低延迟响应、开源免费以及安全加密传输。无论是程序员、设计师还是多设备办公用户，都能通过该工具简化设备管理，专注于内容创作而非设备切换。

环境校验：系统与网络准备

在开始安装前，需确保环境满足以下条件：

硬件与系统要求

• 至少两台电脑，支持Windows 10+、macOS 10.15+或Linux（Kernel 5.4+）系统
• 所有设备连接至同一局域网，建议网络延迟低于50ms
• 服务器端设备需具备稳定的网络连接和中等以上性能

网络环境检测

网络连通性测试： 👉 ping <服务器IP地址>

• 预期结果：网络延迟应低于50ms，无丢包现象
• 若延迟过高，建议使用有线网络或调整路由器设置

多路径实现：安装与编译方案

前置依赖安装

所有系统需先安装基础编译工具和依赖库：

Linux系统： 👉 ./scripts/install_deps.sh

• 操作目的：自动安装CMake、GCC、Qt6等编译依赖
• 预期结果：终端显示"Dependencies installed successfully"

Windows系统： 👉 python scripts/install_deps.py

• 操作目的：通过Python脚本安装Visual Studio构建工具和必要库
• 预期结果：生成"deps_install.log"文件，无错误记录

macOS系统： 👉 ./scripts/install_deps.sh

• 操作目的：使用Homebrew安装编译依赖
• 预期结果：Homebrew自动完成所有依赖项安装

安装方案对比

安装类型	适用场景	操作复杂度	功能完整性
最小化安装	临时测试、资源受限设备	⭐⭐	基础键鼠共享
完整功能安装	日常办公、生产环境	⭐⭐⭐	含加密、剪贴板共享等高级功能

源码编译流程

通用编译步骤：

1. 克隆项目仓库 👉 git clone https://gitcode.com/GitHub_Trending/sy/synergy-core

2. 创建构建目录 👉 mkdir build && cd build

3. 配置构建选项 👉 cmake .. -DCMAKE_BUILD_TYPE=Release

   • 参数说明：-DCMAKE_BUILD_TYPE指定构建类型，Release为发布版本

4. 并行编译 👉 cmake --build . -j$(nproc)

   • 参数说明：-j$(nproc)使用所有可用CPU核心加速编译

5. 安装程序 👉 sudo make install (Linux/macOS) 或 cmake --install . (Windows)

场景化配置：多系统部署指南

通用配置流程

1. 服务器设置（主控制设备）：

   • 启动Synergy-core服务 👉 deskflow-server --config ~/.synergy.conf
   • 配置安全密码 👉 deskflow-server --set-password

2. 客户端设置（被控设备）：

   • 连接至服务器 👉 deskflow-client --server <服务器IP>:24800
   • 验证连接状态 👉 deskflow-client --status

系统特性配置

Windows系统：

• 启用自动启动：将deskflow-client添加至"启动"文件夹
• 防火墙配置：允许Synergy-core通过私有和公共网络
• 系统特有问题速查表：

  问题现象	解决方案
  连接频繁断开	关闭Windows快速启动
  键盘映射错误	运行deskflow-config --reset-keys

macOS系统：

• 权限设置：在"系统偏好设置>安全性与隐私"中允许辅助功能访问
• 屏幕共享配置：启用"系统偏好设置>共享>屏幕共享"
• 系统特有问题速查表：

  问题现象	解决方案
  菜单栏图标缺失	重新登录用户账户
  剪贴板共享失败	授予终端完全磁盘访问权限

Linux系统：

• 服务配置：创建systemd服务实现开机自启

  [Unit]
  Description=Synergy-core Client
  After=network.target
  
  [Service]
  ExecStart=/usr/local/bin/deskflow-client --server 192.168.1.100:24800
  
  [Install]
  WantedBy=multi-user.target
  

• 系统特有问题速查表：

  问题现象	解决方案
  Wayland不支持	切换至X11会话
  权限被拒绝	添加用户至input组：sudo usermod -aG input $USER

问题诊断：常见故障排除

连接问题排查流程

1. 网络连通性检查： 👉 telnet <服务器IP> 24800

   • 预期结果：成功建立连接，显示"Connected to..."

2. 日志分析： 👉 tail -f ~/.synergy/debug.log

   • 关键错误关键词："Connection refused"（连接被拒绝）、"Timeout"（超时）

3. 防火墙设置： 👉 sudo ufw allow 24800/tcp (Linux) 👉 netsh advfirewall firewall add rule name="Synergy" dir=in action=allow protocol=TCP localport=24800 (Windows)

跨系统兼容性矩阵

服务器系统\客户端系统	Windows 10	Windows 11	macOS 12	Ubuntu 22.04	Fedora 36
Windows 10	✅	✅	✅	✅	✅
Windows 11	✅	✅	✅	✅	✅
macOS 12	✅	✅	✅	✅	✅
Ubuntu 22.04	✅	✅	⚠️	✅	✅
Fedora 36	✅	✅	⚠️	✅	✅

⚠️ 注意：Linux作为服务器时，macOS客户端可能需要额外配置剪贴板权限

性能优化参数

当网络延迟>100ms时：调整缓冲区参数 👉 deskflow-server --buffer 200

• 参数说明：--buffer设置输入信号缓冲区大小（毫秒），值越大延迟越高但连接越稳定

当帧率<30fps时：降低图像质量 👉 deskflow-server --quality 80

• 参数说明：--quality设置图像传输质量（0-100），降低值可减少带宽占用

进阶操作

点击展开高级配置

1. 自定义键盘映射

创建~/.synergy/keymap.conf文件：

section: keymap
    keystroke(Alt+Tab) = keystroke(Cmd+Tab)
end

2. 加密连接配置

生成SSL证书： 👉 deskflow-certgen --cn synergy-server --days 365 配置服务器： 👉 deskflow-server --use-ssl --cert ~/.synergy/cert.pem --key ~/.synergy/key.pem

3. 多显示器设置

在配置文件中定义显示器布局：

section: screens
    main-pc:
    laptop:
end

section: links
    main-pc:
        right = laptop
    laptop:
        left = main-pc
end

4. 剪贴板共享高级设置

启用双向剪贴板同步： 👉 deskflow-server --clipboard-bidirectional true

5. 命令行控制界面

使用交互式控制台： 👉 deskflow-cli

• 支持status、connect、disconnect等命令

附录：常用配置文件模板

1. 基础服务器配置 (~/.synergy.conf)

section: screens
    office-pc:
    home-laptop:
end

section: links
    office-pc:
        right = home-laptop
    home-laptop:
        left = office-pc
end

section: options
    relativeMouseMoves = true
    screenSaverSync = true
    clipboardSharing = true
end

2. 安全增强配置

section: security
    password = your-secure-password-here
end

section: options
    ssl = true
    sslCert = /etc/synergy/cert.pem
    sslKey = /etc/synergy/key.pem
end

3. 多显示器复杂布局

section: screens
    main: 1920x1080
    left-monitor: 1920x1080
    laptop: 1366x768
end

section: links
    main:
        left = left-monitor
        right = laptop
    left-monitor:
        right = main
    laptop:
        left = main
end

section: options
    mouseAccel = 0.5
    scrollAccel = 1.2
end

通过以上配置，您可以根据实际需求灵活调整Synergy-core的工作方式，实现高效的多设备协同工作环境。