Synergy-core 编译 使用 教程

Synergy

如果你平时同时两台或多台电脑，你是如何他们之间协作的，又是如何共享文件的呢？

诚然我知道Windows官方出品的鼠标有 无界 功能。提供文件共享的服务有很多。而今天我想介绍的Synergy，让普通键鼠就能跨屏幕操作，还能复制粘贴文字，图片等。而且还不受平台限制，只两台桌面电脑ip互联互通。

无界鼠标由于是微软出品的，所以只支持 Windows 平台，安装包也是 MSI 文件格式。

Synergy是一个跨平台的 鼠标、键盘、剪切板共享软件，支持Windows，Mac，Linux主流桌面平台。也就是说你可以用连接在Mac电脑上键鼠，操作旁边的Windows电脑。

官网：https://symless.com/synergy

开源地址：https://github.com/symless/synergy-core

下载

GUI版程序只能官网付费上下载，没有登陆App Store, 还有点需要注意1.8.8及以前的版本都是32位的程序，所以这次来折腾下64位的开源版。

Mac OS Cotalina 开始，就完全不能运行32位的程序了

安装

如果是官网下载Synergy GUI版，那双击就完事了。

编译

这里说下github上开源的core版本，编译，安装。

Mac OS 编译

安装依赖，编译软件，编译，安装：

# Install Homebrew

## 安装相关编译软件
$ brew install cmake
$ brew install qt
$ brew install openssh
$ brew install git

## 检查qt 安装信息，以及目录，等下需要用到 /usr/local/Cellar/qt/5.15.0/Frameworks/
$ brew info qt

## 添加一个环境变量
$ export CMAKE_PREFIX_PATH="/usr/local/Cellar/qt/5.15.0/Frameworks/"

# 下载源码并进入源码目录
$ git clone https://github.com/symless/synergy-core.git
$ cd synergy-core
$ mkdir build
$ cd build
## 准备编译参数
$ cmake -DCMAKE_OSX_SYSROOT=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.15.sdk  -DCMAKE_OSX_DEPLOYMENT_TARGET=10.15 -DCMAKE_OSX_ARCHITECTURES=x86_64 
## 编译
make

Windows 编译

$ cd Projects\synergy
$ mkdir build
$ cd build
$ call "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat"
$ cmake -G "Visual Studio 14 2015 Win64" -DCMAKE_BUILD_TYPE=Debug ..
$ msbuild synergy-core.sln /p:Platform="x64" /p:Configuration=Debug /m
$ cd ..
$ copy ext\openssl\windows\x64\bin\* build\

Linux 编译

$ cd Projects/synergy
$ mkdir build
$ cd build
$ cmake ..
$ make

编译成功，会生成3个可执行文件。编辑后产物在：

./synergy-core/build/bin/

可执行文件

synergy-core

命令行程序：synergy-core, synergyc, synergys.

Synergy Core v1.x

对于1.x版本，client，server是两个程序，也就是分别对应：synergyc，synergys。

OS	Command
Windows	synergyc [server IP]
macOS	./synergyc [server IP]
Linux	./synergyc [server IP]

OS	Command
Windows	synergys -c [path to config file]
macOS	./synergys -c [path to config file]
Linux	./synergys -c [path to config file]

Synergy Core v2.x

v2.x，server，client 都是一个程序了，通过不同的命令来确定自己的职责。

OS	Command
Windows	synergy-core --client [server IP]
macOS	./synergy-core --client [server IP]
Linux	./synergy-core --client [server IP]

OS	Command
Windows	synergy-core --server -c [path to config file]
macOS	./synergy-core --server -c [path to config file]
Linux	./synergy-core --server -c [path to config file]

Command help

通过一下命令：

$ ./synergyc --help
$ ./synergys --help

你能获取v1.x synergy的帮助信息，但是v2.x不知道是不是忘了把这个加上。

$ ./synergy-core --help     ## 不会显示帮助信息

所以我就把它应有的帮助信息放这里了。

Options for synergy-core --client

Usage: synergy-core --client [--yscroll ] [--daemon|--no-daemon] [--name ] [--restart|--no-restart] [--debug ] 

Connect to a synergy mouse/keyboard sharing server.

  -d, --debug       filter out log messages with priority below level.
                             level may be: FATAL, ERROR, WARNING, NOTE, INFO,
                             DEBUG, DEBUG1, DEBUG2.
  -n, --name  use screen-name instead the hostname to identify
                             this screen in the configuration.
  -1, --no-restart         do not try to restart on failure.
*     --restart            restart the server automatically if it fails.
  -l  --log          write log messages to file.
      --no-tray            disable the system tray icon.
      --enable-drag-drop   enable file drag & drop.
  -f, --no-daemon          run in the foreground.
*     --daemon             run as a daemon.
      --yscroll     defines the vertical scrolling delta, which is
                             120 by default.
  -h, --help               display this help and exit.
      --version            display version information and exit.

* marks defaults.

The server address is of the form: [][:].  The hostname
must be the address or hostname of the server.  The port overrides the
default port, 24800.

Options for synergy-core --server

Usage: synergy-core --server [--address 
] [--config ] [--daemon|--no-daemon] [--name ] [--restart|--no-restart] [--debug ]

Start the synergy mouse/keyboard sharing server.

  -a, --address 
  listen for clients on the given address.
  -c, --config   use the named configuration file instead.
  -d, --debug       filter out log messages with priority below level.
                             level may be: FATAL, ERROR, WARNING, NOTE, INFO,
                             DEBUG, DEBUG1, DEBUG2.
  -n, --name  use screen-name instead the hostname to identify
                             this screen in the configuration.
  -1, --no-restart         do not try to restart on failure.
*     --restart            restart the server automatically if it fails.
  -l  --log          write log messages to file.
      --no-tray            disable the system tray icon.
      --enable-drag-drop   enable file drag & drop.
  -f, --no-daemon          run in the foreground.
*     --daemon             run as a daemon.
  -h, --help               display this help and exit.
      --version            display version information and exit.

* marks defaults.

The argument for --address is of the form: [][:].  The
hostname must be the address or hostname of an interface on the system.
The default is to listen on all interfaces.  The port overrides the
default port, 24800.

If no configuration file pathname is provided then the first of the
following to load successfully sets the configuration:
  $HOME/.synergy.conf
  /etc/synergy.conf

配置

GUI的配置就不讲了，这里说下cli程序的配置。

原文在这里Synergy Text Config，我这里简单提一下。然后按照我给的模版来改改就能用，需要特殊定制可看看官方wiki，或者留言问我。

Synergy 的配置文件基本格式：

section: ''name''
    ''args''
end

配置类型有4大类：

• screens
• aliases
• links
• options

aliases

定义 host name 和 屏幕命名的关系。

那么如何获取 host name呢？

mac os 环境下：

$ hostname
## 或者
$ echo $HOSTNAME

screens

定义我们的屏幕，命名，以及在操作各个屏幕时，是否响应一些特殊按键。

Windows，Linux，Mac 都有各自的特殊按键，如win, command, meta按键等，如果不是跨平台，都不需要做特殊处理。

links

定义各个屏幕之间的排列方位，这个很重要。

{left|right|up|down}[] = name[]

关于range参数就比较有意思了，合理配置可是下如下效果。

section: links
     moe:
         right        = larry
         up(50,100)   = curly(0,50)
     larry:
         left         = moe
         up(0,50)     = curly(50,100)
     curly:
         down(0,50)   = moe
         down(50,100) = larry(0,50)
 end

实现了：

#       +-----------+  
#       |   curly   |  
#       |           | 
#       +-----------+ 
# +----------+ +----------+
# |    moe   | |  larry   | 
# |          | |          | 
# +----------+ +----------+ 

也就是在curly屏幕时，鼠标往左下滑，会滑到moe屏幕，往右下滑，会滑到larray屏幕。

options

其他选项，例如定义心跳间隔，屏幕切换粘连时间，

配置样例

好的还是来一个大而全的配置文件例子吧。

启动一个Synergy-core server，配置文件是必须的！

Example textual configuration file
This example comes from doc/synergy-basic.conf

# sample synergy configuration file
#
# comments begin with the # character and continue to the end of
# line.  comments may appear anywhere the syntax permits.
# +----------+  +---------+ +---------+
# | mac-mini |  | macbook | | windows |
# |          |  |         | |         |
# +----------+  +---------+ +---------+

section: screens
    # three hosts named:  mac-mini, macbook, and windows
    # These are the nice names of the hosts to make it easy to write the config file
    # The aliases section below contain the "actual" names of the hosts (their hostnames)
    mac-mini:
    macbook:
    windows:
end

section: links
    # windows is to the right of macbook
    # mac-mini is to the left of macbook
    macbook:
        right(0,100) = windows # the numbers in parentheses indicate the percentage of the screen's edge to be considered active for switching)
        left  = mac-mini
        # shift = shift (shift, alt, super, meta can be mapped to any of the others)

    # macbook is to the right of mac-mini
    mac-mini:
        right = macbook

    # macbook is to the left of windows
    windows:
        left  = macbook
end

section: aliases
    # The "real" name of windows is John-Smiths-windows-3.local. 
    # If we wanted we could remove this alias and instead use John-Smiths-windows-3.local everywhere windows is above. 
    # Hopefully it should be easy to see why using an alias is nicer
    macbook:
        Pauls-MBP.local
    mac-mini:
        jumei-deMac-xp-mini.local
end

section: options
    switchDelay = 400   # 鼠标滑到边缘时，提留多久才能切换屏幕
    clipboardSharing = true # 共享剪切板
    clipboardSharingSize = 10000    # 剪切板共享字节大小限制，单位：千字节
end

启动

## 启动服务端
$ ./synergy-core --server --address 172.20.50.25:24800 --no-daemon --name macbook --config ./synergy.conf

## 启动其中一个客户端
$ ./synergy-core --client --no-daemon --name mac-mini 172.20.50.25:24801

常见问题

问题1:FATAL: An error occurred: assistive devices does not trust this process, allow it in system settings.

这是应为你运行命令行程序调用了系统的敏感接口，所有报错了。你需要给这个命令行软件授予权限.

也就是说，你用iTerm运行Synergy-core，就给iTerm授权，你用系统terminal运行的就给terminal授权。

我用的Mac，就在 系统偏好设置 > 安全性隐私 > 隐私 为其配置上。

如果是第一次授权，一般会有个弹窗，你按照弹框点进去就行了。

问题2: synergy-core[66198:16759205] pid(66198)/euid(501) is calling TIS/TSM in non-main thread environment, ERROR : This is NOT allowed. Please call TIS/TSM in main thread!!!

你是不是还启动 Synergy GUI 程序，把它关掉就好了。

总结

synergy-core程序用着还不错，虽然配置麻烦了一点，不过鼠标，键盘映射都没问题，复制粘贴（图片都能跨屏幕传）也都正常。不过还没试过跨macos，windows使用过。试了再回来

参考

• https://github.com/symless/sy...
• https://my.oschina.net/k4nz/b...
• https://apple.macx.cn/thread-...