Linux 使用手册

HangLink 在 Linux 上支持 X11 和 Wayland 显示协议，可在银河麒麟、Ubuntu、Debian 等主流发行版上运行。本手册涵盖安装、配置和常见问题排查。

快速安装

方式一：使用 deb 安装包（推荐）

从 下载页面 获取 hanglink_1.4.9_amd64.deb 安装包，然后执行：

sudo dpkg -i hanglink_1.4.9_amd64.deb
sudo apt --fix-broken install

安装完成后，可在应用菜单搜索「HangLink」启动，或在终端运行 hanglink。

方式二：从源码编译（开发者）

git clone https://github.com/rustdesk-org/rustdesk.git
cd rustdesk
cargo build --features "flutter,linux-pkg-config" --release
cd flutter
flutter build linux --release

银河麒麟 V10 安装指南

银河麒麟 V10 是国产 Linux 桌面操作系统，基于 Ubuntu 20.04 LTS。HangLink 在银河麒麟 V10 x86_64 上可正常运行。

系统依赖

安装前需确保以下系统库已就绪（apt install 会自动解决）：

# 银河麒麟 V10 预装缺失的开发包
sudo apt install -y ninja-build clang cmake pkg-config
sudo apt install -y libgtk-3-dev liblzma-dev libsecret-1-dev libjsoncpp-dev
sudo apt install -y libjpeg-dev libvpx-dev libopus-dev libpam0g-dev

Git 代理配置

银河麒麟通常无法直接访问 GitHub，如需从源码构建，需配置 Git URL 重写：

git config --global url."https://ghfast.top/https://github.com/".insteadOf "https://github.com/"

防火墙配置（重要！）

银河麒麟 V10 的安全中心默认启用网络防火墙，会阻止其他设备连接本机。最简单的解决方法是关闭防火墙。

方法一：通过安全中心关闭防火墙（推荐）

  1. 打开「安全中心」→「防火墙与网络保护」
  2. 找到「专用网络」或「公用网络」的开关
  3. 点击开关将其关闭
  4. 关闭后其他设备即可正常连接本机

方法二：通过命令行关闭防火墙

# 临时关闭所有防火墙规则
sudo iptables -F INPUT
sudo iptables -P INPUT ACCEPT

# 如果使用 firewalld
sudo systemctl stop firewalld
sudo systemctl disable firewalld
注意：如果其他设备连接本机时一直显示「连接中」，99% 是防火墙未关闭导致的。请优先检查此项。

已知限制

  • 桌面环境采用 UKUI，部分 GTK 主题路径与标准 GNOME 不同。如遇图标显示异常，可在启动脚本中设置 export GTK_THEME=Adwaita。
  • 银河麒麟默认使用 Wayland 显示协议，如需最佳兼容性建议切换到 X11 会话。
  • ARM 架构（飞腾/鲲鹏）用户需单独下载 ARM 版本 deb 包。

X11 环境要求

HangLink 在 Linux 上需要 X11 显示服务器。大多数桌面发行版默认已安装 X11。

如果您的系统使用 Wayland，建议在登录界面切换到 X11 会话以确保最佳兼容性。

提示：您可以通过 echo $XDG_SESSION_TYPE 查看当前显示协议。

安装 X11 相关依赖（Ubuntu/Debian/Kylin）：

sudo apt install xorg xserver-xorg

无头模式（Headless）支持

无头模式允许在没有物理显示器的服务器上运行远程桌面。需要安装虚拟显示驱动。

安装虚拟显示驱动：

sudo apt install xserver-xorg-video-dummy

配置虚拟显示（示例）：

sudo tee /etc/X11/xorg.conf.d/10-dummy.conf << 'EOF'
Section "Monitor"
    Identifier "Monitor0"
    Modeline "1920x1080" 148.50 1920 2008 2052 2200 1080 1084 1089 1125
    Option "PreferredMode" "1920x1080"
EndSection
EOF

添加虚拟显示配置后重启 X 服务即可使用远程桌面。

注意：无头模式需要一定的 Linux 系统管理知识。

服务器与连接

HangLink 默认连接官方服务器，安装后无需额外配置即可使用。所有用户共享同一套服务器资源。

连接方式

客户端通过官方服务器的 Rendezvous 和 Relay 端口进行信令协商与流量转发。首次启动时会自动注册设备。

防火墙配置

如果用户的网络环境有出站防火墙，需确保 HangLink 能访问官方服务器的相应端口（TCP 协议）。具体端口信息请联系管理员获取。

提示：HangLink 使用 P2P 直连和服务器中继两种模式。优先尝试 P2P 直连，失败时自动回退到服务器中继，保证在 NAT 环境下也能稳定连接。

权限与输入问题

无法控制远程鼠标键盘

可能是权限问题，请检查：

  • 当前用户是否在 input 用户组中：sudo usermod -aG input $USER
  • SELinux/AppArmor 是否阻止了输入模拟
  • Wayland 会话下输入控制受限，建议切换到 X11
# 检查用户组
groups $USER

# 添加到 input 组（需要重新登录生效）
sudo usermod -aG input $USER

登录界面使用 HangLink

要在登录界面（GDM/LightDM）使用 HangLink，需要：

  • HangLink 服务以系统权限运行（sudo systemctl enable hanglink）
  • X11 显示管理器允许远程会话
  • 防火墙已开放相关端口

常见问题排查

应用启动后闪退

可能的原因和排查方法：

# 检查动态库依赖是否完整
ldd /usr/share/hanglink/lib/librustdesk.so | grep "not found"

# 直接运行并查看错误输出
/usr/bin/hanglink 2>&1

图标显示异常

如果应用菜单、任务栏或桌面图标显示为 GTK 默认图标：

# 手动刷新图标缓存
sudo gtk-update-icon-cache -q /usr/share/icons/hicolor 2>/dev/null
sudo update-desktop-database -q /usr/share/applications 2>/dev/null

# 确认图标文件存在
ls /usr/share/icons/hicolor/256x256/apps/hanglink.png
ls /usr/share/pixmaps/hanglink.png

连接一直处于「连接中」

这通常是网络问题：

  • 确认网络能访问互联网（官方服务器需要出站 TCP 连接）
  • 检查公司/学校防火墙是否拦截了 HangLink 的出站连接
  • 尝试切换网络（例如手机热点）排除本地网络问题
  • 虚拟机用户注意：NAT 网络的 VM 对外连接可能不稳定，建议使用桥接（Bridge）模式
  • 银河麒麟用户：请检查「安全中心 → 防火墙与网络保护」，确保已开放 HangLink 的入站端口（参见上方防火墙配置章节）

Wayland 下输入控制失效

Wayland 协议限制了跨应用的输入模拟权限。在 Wayland 会话下，HangLink 可能无法正确控制远程机器的鼠标键盘。建议切换到 X11 会话。

切换方法：注销当前会话 → 在登录界面点击齿轮图标 → 选择「Ubuntu on Xorg」或「银河麒麟 X11」。

卸载

sudo apt remove hanglink

卸载后配置目录将保留在 ~/.config/HangLink/，如需彻底清除可手动删除。