Deskflow

使用文档

从安装到组网，再到故障排查，这份文档帮助你快速、稳定地使用 Deskflow。

快速上手

Deskflow 采用“服务端 + 客户端”架构：连接键盘鼠标的那台电脑作为服务端（Server），其余被控制的电脑作为客户端（Client）。整体只需四步。

服务端（Server）

连接键鼠的电脑，提供输入

局域网 · TLS 加密

客户端（Client）

被控制的电脑，可多台

  1. 全部安装：在每台电脑安装 Deskflow，并连接到同一个局域网。
  2. 设定服务端：在连接键鼠的电脑选择“Use this computer's keyboard and mouse（server）”，点击 Start 启动。
  3. 客户端连接：在其他电脑选择“Use another computer's mouse and keyboard（client）”，输入服务端 IP 后 Connect/Start。
  4. 排布并使用：在服务端确认 Add，进入 Configure 拖动设备位置并 OK，鼠标即可跨越边缘控制。

准备工作

开始前请确认以下事项，可避免绝大多数连接问题。

  • 所有电脑安装同一大版本的 Deskflow，并处于同一局域网 / 同一网络。
  • 记下服务端电脑的 IP 地址（客户端需要填写）。
  • 允许 Deskflow 通过系统防火墙，必要时在路由器上关闭“AP 隔离”。

如何查看服务端 IP

# Windows（命令提示符 / PowerShell）
ipconfig

# macOS / Linux
ip addr        # 或 ifconfig

Deskflow 主界面顶部会显示“本机名称和 IP”，可直接在该处查看本机 IP 与主机名。

配置服务端

  1. 在连接键盘鼠标的电脑上，选择左侧单选项 Use this computer's keyboard and mouse (make this computer the server)。
  2. 点击界面下方的 Start（或 Apply）启动服务，日志区会显示服务已启动、等待客户端。
  3. 点击 Configure 可进入服务端配置，设置各电脑的相对位置（见下文“屏幕布局”）。
  4. 当有新客户端发起连接时，会弹出“A new client called … wants to connect”，点击 Add client 允许接入。

配置客户端

  1. 在需要被控制的电脑上，选择右侧单选项 Use another computer's mouse and keyboard (make this computer the client)。
  2. 在 Server IP address or hostname 输入框中填写服务端的 IP 地址。
  3. 点击 Connect，再点击 Start（或直接 Start），日志区会显示正在连接与已连接。
  4. 回到服务端，在弹窗中确认 Add，客户端即加入网络。

配置屏幕布局

在服务端点击 Configure 打开 Server Configuration，切换到 Computers 标签，按设备在桌面上的真实物理位置，把对应电脑拖动到网格中的相应方位。

  • 例如服务端在左、客户端在右，则把客户端图标拖到服务端的右侧相邻格子。
  • 把屏幕拖到左上角垃圾桶可删除；若误删了正在使用的屏幕，可能需要重启服务端才能重新连接。
  • 排布完成后点击 OK 保存，鼠标从对应边缘移出即可切换设备。
  • 需要临时断开时，点击界面右下角 Stop。

剪贴板共享

剪贴板会在所有已连接设备间自动同步，无需额外操作：在任意一台电脑复制，到另一台直接粘贴。

支持：纯文本、富文本以及图片（包括屏幕截图）的跨设备复制粘贴。

暂不支持：通过剪贴板直接复制粘贴文件；传输文件请改用局域网共享等方式。

常见问题与故障排查

以下汇总了使用中最常见的问题，按现象查找对应处理方法。

客户端一直连不上服务端怎么办？

请按顺序排查：

  • 确认所有电脑连接同一个局域网，服务端已点击 Start、日志显示正在等待客户端。
  • 核对客户端填写的服务端 IP 地址是否正确（用 ipconfig / ip addr 复核）。
  • 检查系统防火墙是否放行 Deskflow；无线路由器若开启“AP 隔离 / 客户端隔离”需关闭。
  • 确认 Deskflow 版本满足兼容要求（与 Barrier/Input Leap 互通需 1.17.0.96+）。
  • 查看双方界面底部 Logs 日志中的具体报错信息再定位。
macOS 上鼠标或键盘没有反应？

通常是权限未授予完整。请到“系统设置 → 隐私与安全性 → 辅助功能”，同时允许 Deskflow App 与 deskflow 进程；升级版本后若列表中已有旧条目，需先选中删除，再重新添加并授权。macOS Sequoia 还需在“本地网络”中允许 Deskflow。

Windows 启动报错或提示缺少 DLL？

请安装 Microsoft Visual C++ Redistributable 运行库（x64 / ARM64），安装后重新启动 Deskflow。

鼠标能切换，但键盘不工作或键位错乱？

跨系统使用时注意修饰键差异：macOS 的 Command 键会映射为 Windows 的 Ctrl 功能，以匹配常用快捷键。若仍异常，可检查当前键盘布局与输入法是否一致，并确认没有修饰键被卡住（锁屏解锁后偶发，可重新切换一次设备）。

Wayland 下部分功能不可用？

Wayland 支持依赖 libei 1.3+ 与 libportal 0.8+，个别功能在 Wayland 下可能受限或异常（项目维护有“已知 Wayland 问题”清单）。请确认系统与库版本，必要时改用 Flatpak 版本或在 X11 会话下使用。

连接频繁断开或感觉卡顿？

多与网络质量有关：建议使用信号良好的 5GHz Wi-Fi 或有线网络，关闭网卡的节能/省电选项，避免设备休眠。Deskflow 内置看门狗，在核心进程异常时会尝试自动重连。

如何开机自启并在后台驻留？

可在设置中开启开机自动启动，连接配置会自动保存；启动后程序驻留系统托盘，可通过托盘图标快速 Start/Stop，无需每次重新配置。

如何确认我的连接已经加密？

Deskflow 默认启用 TLS，新设备首次连接时会要求确认对方指纹，校验通过后建立加密连接；你也可以在日志中看到 TLS/SSL 相关的握手信息。

从源码构建

如果你希望自行编译、审查代码或参与开发，可以从 GitHub 获取源代码。构建通常需要 CMake、支持 C++ 的编译器以及 Qt 等依赖，完整步骤请以项目 Wiki 的 Building 页面为准。

git clone https://github.com/deskflow/deskflow.git
cd deskflow
# 随后按 Wiki「Building」说明，使用 CMake 配置并编译

仍未解决问题？可在 GitHub Issues 搜索或提交问题，或到 Matrix 中文/官方讨论 寻求帮助；也可重新下载最新版本后再试。