Barrier KVM 配置

配置 Barrier 软件 KVM，实现通过一套键盘/鼠标跨局域网控制多台计算机。Linux 作为服务端（键盘/鼠标连接于此），Windows/Mac 作为客户端。

触发条件

用户说出以下任一关键词时触发：“barrier”、“KVM”、“share keyboard mouse”、“一套键鼠控制多台电脑”、“键鼠共享”

步骤 1：收集信息

向用户询问以下信息：

• Linux 主机名（用作屏幕名称，默认取自 hostname 命令输出）
• Windows 主机名（用作屏幕名称）
• Linux 屏幕位于 Windows 屏幕的哪一侧？（左 / 右 / 上 / 下）
• Linux IP 地址（自动检测）
• 屏幕信息：Linux 屏幕为横屏还是竖屏？Windows 是单显示器还是双显示器？

步骤 2：下载并安装 Barrier

本技能不包含任何二进制文件，所有组件均按需动态获取。

Linux（Deepin / Ubuntu / Debian）

# 通过 apt 安装 Barrier
sudo apt update && sudo apt install barrier -y

# 验证安装
barrier --version

Windows 安装程序 → 桌面

下载 Windows 安装程序，并将其置于 Linux 桌面，供用户手动传输至 Windows 电脑：

# 通过 GitHub 镜像代理下载（适用于中国大陆网络环境）
wget -O ~/Desktop/BarrierSetup-2.4.0-release.exe 
  "https://ghfast.top/https://github.com/debauchee/barrier/releases/download/v2.4.0/BarrierSetup-2.4.0-release.exe"

# 若 ghfast.top 不可用，可使用备用代理：
# wget -O ~/Desktop/BarrierSetup-2.4.0-release.exe 
#   "https://gh-proxy.com/https://github.com/debauchee/barrier/releases/download/v2.4.0/BarrierSetup-2.4.0-release.exe"

随后提示用户：

请将桌面上的 BarrierSetup-2.4.0-release.exe 文件通过 U 盘或 SMB 共享方式拷贝至 Windows 电脑，然后双击运行安装。

步骤 3：生成 SSL 证书

mkdir -p ~/.local/share/barrier/SSL
openssl req -x509 -newkey rsa:2048 
  -keyout ~/.local/share/barrier/SSL/Barrier.pem 
  -out ~/.local/share/barrier/SSL/Barrier.pem 
  -days 3650 -nodes -subj "/CN=Barrier"

步骤 4：创建配置文件

编写配置文件 ~/.config/barrier/barrier.conf，并将其中的 LINUX-PC 和 WINDOWS-PC 替换为实际主机名：

section: screens
    LINUX-PC:
    WINDOWS-PC:
end

section: links
    LINUX-PC:
        right = WINDOWS-PC
    WINDOWS-PC:
        left = LINUX-PC
end

根据用户实际屏幕布局，调整 right/left/up/down 等方向参数。

步骤 5：启动服务端

关键启动参数 —— 缺少任一参数均会导致连接失败：

barriers -f 
  --config ~/.config/barrier/barrier.conf 
  --enable-crypto 
  --disable-client-cert-checking 
  --name LINUX-PC

若端口 24800 已被占用，请先终止旧进程：

fuser -k 24800/tcp; pkill -9 barriers

步骤 6：指导 Windows 端配置

向用户提供以下 Windows 侧操作指南：

1. 使用 BarrierSetup-2.4.0-release.exe（步骤 2 中已下载至 Linux 桌面，需通过 USB 或 SMB 传输至 Windows）在 Windows 电脑上安装 Barrier
2. 打开 Barrier 应用 → 确认选择 Client 模式（非 Server）
3. 服务器 IP：填写 Linux 的 IP 地址
4. 屏幕名称：必须与配置文件中定义的名称完全一致（区分大小写）
5. 点击 Apply → Start 启动连接
6. 如需手动配置 SSL：点击 Edit → Settings → Security → 确保勾选 “Enable SSL Encryption”

步骤 7：验证连接

检查连接状态：

ss -tnp | grep 24800

输出中应包含 ESTABLISHED 状态。测试鼠标是否能平滑跨越屏幕边缘进行切换。

常见问题与注意事项

1. SSL 拒绝连接：最常见问题。务必始终启用 --disable-client-cert-checking 参数。
2. 端口冲突：残留的 barriers 进程可能持续占用 24800 端口。启动前请先执行 fuser -k 24800/tcp 清理。
3. 屏幕名称不匹配：Linux 服务端与 Windows 客户端的屏幕名称必须完全一致（严格区分大小写）。
4. 横屏/竖屏混用：Barrier 按比例映射 Y 轴坐标。当屏幕宽度差异较大（例如 1080px → 3000px）时，鼠标跨屏移动可能出现跳跃感，属正常行为。
5. barrierc 自动连接干扰：Barrier 图形界面可能自动启动 barrierc 客户端进程。若发生冲突，请手动终止：pkill barrierc。
6. Windows 客户端立即断开：几乎总是由 SSL 证书配置问题导致。请再次确认服务端已启用 --disable-client-cert-checking。

可选：开机自启（systemd）

创建用户级 systemd 服务文件 ~/.config/systemd/user/barriers.service（请将 LINUX-PC 替换为实际主机名）：

[Unit]
Description=Barrier Server
After=graphical-session.target

[Service]
ExecStart=/usr/bin/barriers -f 
  --config %h/.config/barrier/barrier.conf 
  --enable-crypto 
  --disable-client-cert-checking 
  --name LINUX-PC
Restart=on-failure

[Install]
WantedBy=graphical-session.target

启用该服务：

systemctl --user daemon-reload
systemctl --user enable --now barriers.service