Linux 安装说明

一键脚本自动选 bundle、装运行环境、配权限、建桌面图标。支持 KYLIN 2503 / 统信 UOS / openEuler / Ubuntu 20.04+ / Debian 11+。

本页内容

→ 一键安装（推荐）
→ 手动安装（portable）
→ KYLIN 2503 特别说明
→ 故障排除
→ 卸载

一键安装（推荐）

打开终端粘贴：

sudo bash <(curl -fsSL https://helink.96ck.com/dl/helink-install.sh)

或者分两步（系统没 curl 时用）：

wget https://helink.96ck.com/dl/helink-install.sh
sudo bash helink-install.sh

安装器会自动完成：

步骤	做了什么
1. 探测 glibc	`ldd --version` ≥ 2.39 选 modern bundle；[2.31, 2.39) 选 kylin bundle
2. 下载	从 `helink.96ck.com/dl/` 拉相应 portable bundle 到 `/tmp/`
3. 解压	到 `/opt/helink/`（系统级，所有用户共享）
4. 系统菜单	写 `/usr/share/applications/helink.desktop`，应用程序列表自动出现
5. 桌面快捷方式	拷到当前用户 `~/Desktop/` 和 `~/桌面/`，已标 trusted（双击免警告）
6. 命令行入口	软链 `/usr/local/bin/helink`，终端可直接 `helink` 启动
7. uinput 权限	udev 规则 + 加入 `input` 组（自动）

⚠ 必须注销重登

uinput 权限通过 input 组生效，新组成员关系要新 session 才识别。装完注销并重新登录，否则鼠标键盘控制无响应。

验证：id | grep input

手动安装（portable）

无 sudo 或不想全局安装：

# 选一个 bundle（看自己系统 glibc 版本：ldd --version）
# 现代系统（Ubuntu 24.04+ / Debian 13）：
wget https://helink.96ck.com/dl/helink-portable-linux-v0.46.11.tar.gz

# 老系统（KYLIN 2503 / openEuler / Ubuntu 20.04+）：
wget https://helink.96ck.com/dl/helink-portable-kylin-v0.46.11.tar.gz

tar xzf helink-portable-*-v0.46.11.tar.gz
cd helink-portable-*-0.46.11-linux-x86_64

# 一次性开 uinput 权限（KYLIN/UKUI 必须）
sudo ./install_uinput.sh
# 注销重登

./run.sh

提示

portable bundle 已经自带 Qt6、X11、PulseAudio、OpenH264 等所有运行时库，目标系统不需要再 apt install 任何东西。

KYLIN 2503 / UKUI 桌面特别说明

KYLIN 桌面用了硬件光标 + libinput 直读 input 设备，X11 标准的 XTest 注入鼠标键盘会被合成器静默丢弃。HeLink 用 Linux 内核 /dev/uinput 创建虚拟硬件输入设备绕过——必须给当前用户写 /dev/uinput 权限。

一键安装器自动配置；手动安装跑 install_uinput.sh 也行。原理：

# 装 udev 规则（永久）
sudo tee /etc/udev/rules.d/99-helink-uinput.rules <<'EOF'
KERNEL=="uinput", GROUP="input", MODE="0660"
EOF

# 把自己加入 input 组
sudo gpasswd -a $USER input

# 立即生效（本登录有效；新登录由 udev 规则永久生效）
sudo chgrp input /dev/uinput
sudo chmod 0660 /dev/uinput

# 注销重新登录

启动 HeLink 后，被控端启动屏幕共享时日志会显示：

🔬 uinput virtual device created at /dev/uinput ✓

否则会 fallback 到 XTest（KYLIN 下不工作）：

🔬 uinput unavailable (Permission denied), using XTest: ...

故障排除

下载失败 / 网络不通

替换 BASE_URL 用代理或离线镜像：

sudo HELINK_BASE_URL=http://mirror.example.com/helink \
     bash helink-install.sh

报 GLIBC_2.XX not found

当前系统 glibc 比 bundle 用的还老。ldd --version 看你的版本， < 2.31 的系统暂未支持。可联系 contact@96ck.com 请求更老兼容版本。

启动报 qt.network.ssl: No functional TLS backend

这是 v0.46.9 及之前的 bundle 漏了 Qt6 TLS plugin 的旧 bug，请升级到 v0.46.10 或更新版本。一键脚本默认装 v0.46.11。

画面卡在"等待对方第一帧"

看 Win 端或 Linux 端日志：

"⚠ ScreenCapture 报告 0×0"——没装 X server / DISPLAY 未设置
"⚠ H.264 编码器加载失败"——libopenh264.so.7 找不到。portable bundle 已经自带，重新下载覆盖即可

鼠标控制不响应

第一原因永远是 uinput 没启。检查：

ls -la /dev/uinput          # MODE 应该是 660 / 666
id | grep input             # 应该看到 input 组

如果 input 组没出现，是没注销重登。注销重新登录后就行。

Wayland 会话

HeLink 当前不支持 Wayland 屏幕捕获（XShm 不可用）。KYLIN 2503 默认 X11，其它发行版如果默认 Wayland，登录界面选 "X11 / Xorg" 会话。

卸载

sudo bash helink-install.sh --uninstall

删除：

/opt/helink/
/usr/share/applications/helink.desktop（系统菜单）
~/Desktop/helink.desktop / ~/桌面/helink.desktop（桌面）
/usr/local/bin/helink
/etc/udev/rules.d/99-helink-uinput.rules

不会移除：input 组（避免影响其它用 uinput 的程序）。要彻底清理：

sudo gpasswd -d $USER input