开源工具Synergy-core无缝部署指南：3大平台+5种安装方式实现多系统控制

在多设备办公环境中，频繁切换键盘鼠标成为影响效率的隐形障碍。跨平台键鼠共享工具（指一套输入设备控制多系统）通过网络协议实现设备间输入信号的无缝传输，让Windows、macOS和Linux系统共享一套键盘鼠标。本文将系统讲解开源方案Synergy-core的部署流程，帮助用户快速实现多设备协同工作。

🌟 Synergy-core核心价值与适用场景

Synergy-core作为开源跨平台键鼠共享解决方案，具备三大核心优势：零成本部署（基于MIT协议开源）、低延迟信号传输（优化的网络协议栈）、跨系统兼容性（支持Windows 10+、macOS 10.15+、Linux内核5.4+）。特别适合程序员、设计师等需要多设备协作的专业用户，以及追求桌面整洁的极简主义者。

📋 环境适配与前置检查

网络环境要求

• 所有设备必须处于同一局域网（支持有线/无线混合组网）
• 防火墙需开放TCP 24800端口（Synergy-core默认通信端口）
• 建议网络延迟≤20ms（可通过ping命令测试设备间连通性）

硬件最低配置

• CPU：双核处理器
• 内存：2GB RAM
• 存储：100MB可用空间

🖥️ Windows系统：包管理器与源码编译双方案

环境检查

# 检查系统版本
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"
# 确认PowerShell版本≥5.1
$PSVersionTable.PSVersion

部署方案一：Chocolatey包管理器（推荐）

# 安装Chocolatey（若未安装）
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 安装Synergy-core
choco install synergy-core -y

部署方案二：源码编译

# 克隆仓库
git clone https://gitcode.com/GitHub_Trending/sy/synergy-core
cd synergy-core

# 安装依赖与构建
python scripts/install_deps.py
cmake -B build --preset=windows-release
cmake --build build -j8

验证步骤

# 检查版本
deskflow --version
# 启动服务
deskflow --server --config "C:\ProgramData\Synergy\synergy.conf"

平台特有注意事项

• Windows 11需在"设置→隐私和安全性→开发者选项"中开启"允许旁加载应用"
• 企业环境可能需要通过组策略配置防火墙例外规则
• 多显示器配置需在"显示设置"中调整屏幕排列顺序与Synergy配置一致

🍎 macOS系统：拖放安装与Homebrew方案

环境检查

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

部署方案一：拖放安装

1. 下载最新dmg包并挂载
2. 将Deskflow拖入Applications文件夹

部署方案二：Homebrew安装

# 安装Homebrew（若未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装Synergy-core
brew install synergy-core

验证步骤

# 启动应用
open -a Deskflow
# 检查后台进程
ps aux | grep deskflow

平台特有注意事项

• macOS 12+需在"系统偏好设置→安全性与隐私→辅助功能"中授予Deskflow控制权
• 屏幕录制权限需在"安全性与隐私→屏幕录制"中开启
• 若出现"无法打开"提示，需在"安全性与隐私"中点击"仍要打开"

🐧 Linux系统：源码编译与包管理器双方案

环境检查

# 检查发行版与内核版本
cat /etc/os-release && uname -r
# 确认编译工具链
gcc --version && cmake --version

部署方案一：源码编译（通用）

# 克隆仓库
git clone https://gitcode.com/GitHub_Trending/sy/synergy-core
cd synergy-core

# 安装依赖
./scripts/install_deps.sh

# 构建与安装
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)
sudo cmake --install build

部署方案二：发行版专用包

Debian/Ubuntu

```bash sudo apt update && sudo apt install -y synergy ```

Fedora/RHEL

```bash sudo dnf install -y synergy ```

Arch Linux

```bash sudo pacman -S synergy ```

验证步骤

# 启动服务
synergy-core --server --config ~/.synergy.conf
# 检查服务状态
systemctl status synergy

平台特有注意事项

• Wayland会话需设置KWIN_USE_VIRTUAL_DESKTOPS=1环境变量
• Ubuntu 22.04+需安装libqt5svg5依赖包
• SELinux环境需执行sudo setsebool -P domain_can_mmap_files 1

⚙️ 进阶技巧与最佳实践

配置文件优化

创建高级配置文件实现精细化控制：

section: screens
    Linux-PC:
        halfDuplexCapsLock = false
        halfDuplexNumLock = false
        halfDuplexScrollLock = false
        xtestIsXineramaUnaware = false
        switchCorners = none 
        switchCornerSize = 0
    Windows-PC:
        halfDuplexCapsLock = false
        halfDuplexNumLock = false
        halfDuplexScrollLock = false
        xtestIsXineramaUnaware = false
        switchCorners = none 
        switchCornerSize = 0
end

section: links
    Linux-PC:
        right = Windows-PC
    Windows-PC:
        left = Linux-PC
end

自动启动配置

systemd服务配置

```ini [Unit] Description=Synergy-core Keyboard/Mouse Sharing Service After=network.target

[Service] ExecStart=/usr/bin/synergy-core --server --config /etc/synergy.conf Restart=always User=root

[Install] WantedBy=multi-user.target

</details>

## 🔍 你可能遇到的3个典型问题

### 问题1：设备间无法发现
**排查步骤**：
1. 确认防火墙规则：`sudo ufw allow 24800/tcp`
2. 检查网络连通性：`telnet <server-ip> 24800`
3. 验证配置文件中的主机名解析：`ping <hostname>`

### 问题2：鼠标移动卡顿
**优化方案**：
1. 更换5GHz Wi-Fi或使用有线连接
2. 调整缓冲区大小：`synergy-core --server --buffer 2048`
3. 关闭网络节能模式：`sudo iwconfig wlan0 power off`

### 问题3：剪贴板同步失效
**解决方法**：
1. 检查剪贴板权限：`xclip -o`（Linux）
2. 清除缓存：`rm -rf ~/.local/share/synergy/`
3. 更新至最新版本：`git pull && cmake --build build`

## ✅ 部署成功的3个验证步骤

1. **基础功能验证**：
   - 鼠标跨屏幕无缝移动
   - 键盘输入在所有设备生效
   - 剪贴板内容跨设备粘贴

2. **高级功能测试**：
   - 拖拽文件跨设备传输
   - 屏幕唤醒功能（移动鼠标唤醒休眠设备）
   - 热键切换（默认ScrollLock+方向键）

3. **稳定性测试**：
   - 连续使用2小时无断开
   - 网络波动后自动重连
   - 高分辨率屏幕下无卡顿

通过以上步骤，您已成功部署Synergy-core跨平台键鼠共享解决方案。如需进一步优化或定制功能，可参考官方文档或参与技术社区讨论。

欢迎在项目讨论区分享您的使用体验和定制方案，共同完善这一开源工具的生态系统。