教程►Linux/远程控制

ToDesk 在 Ubuntu 24.04 安装与配置教程（含无人值守访问）

ToDesk 在 Ubuntu 24.04 安装与配置教程（含无人值守访问）

本教程记录在 Ubuntu 24.04 LTS (x86_64) 上安装 ToDesk 远程控制软件，并解决「卡住 / 没有桌面环境 / 需要安装 X11」等常见问题，最后配置开机自动登录的无人值守访问。

适用版本：ToDesk Linux v4.8.6.2 / Ubuntu 24.04 LTS

一、环境说明

  • 系统：Ubuntu 24.04 LTS (Noble Numbat)，x86_64
  • 桌面：默认 GNOME（官网下载页只提供 uos / kylin / nfschina 版 deb，标准 Ubuntu 包需从直链下载）
  • 目标：ToDesk Linux v4.8.6.2

二、下载与安装

官网下载页只列出 Windows / macOS / iOS / Android；Linux 页（todesk.com/linux.html）给出的 deb 是 uos / kylin / nfschina 版。Ubuntu 用的标准包名是 todesk-v4.8.6.2-amd64.deb，但官网直链会被反爬验证页拦截，需带浏览器标识（User-Agent + Referer）下载：

1
2
3
4
5
6
7
8
cd /tmp
UA="Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0 Safari/537.36"
curl -fSL -A "$UA" -e "https://www.todesk.com/linux.html" -o todesk.deb \
  https://dl.todesk.com/linux/todesk-v4.8.6.2-amd64.deb
file todesk.deb                 # 确认是 "Debian binary package"（约 106M）
sudo dpkg -i todesk.deb
sudo apt-get install -f -y     # 自动修复依赖
rm -f todesk.deb

验证安装：

1
2
dpkg -l | grep todesk                       # 应看到  ii  todesk  4.8.6.2
systemctl status todeskd.service --no-pager | head -n 3   # active (running), enabled

启动客户端（图形界面）：

1
todesk

或在「应用程序」菜单搜索 ToDesk。启动后界面会显示本机设备代码与临时密码。

三、关键问题：Wayland / Unity 会话导致无法远程

症状

  • 连上后画面卡住 / 黑屏，对方收不到画面
  • 提示「没有桌面环境或显示器，无法远程」
  • 提示「需要自行安装 X11 桌面环境」

根因

Ubuntu 24.04 默认是 Wayland 会话；若登录的是 Unity（或其它 ToDesk 不支持的桌面），ToDesk 无法在该环境下捕获并推流屏幕，日志会出现：

1
2
[zrtc] Publish error. stream label:desktop-stream
session send 0 frame

重要：出现上述提示不代表真的缺少 X11。xserver-xorg 通常早已装好（/usr/bin/Xorg 存在），问题是「当前会话类型」不是 ToDesk 支持的 X11 桌面，而非系统没装 X。

解法：切到标准 GNOME on Xorg 会话

1) 关闭 GDM 的 Wayland（改为默认 X11）：

1
sudo sed -i 's/^#\?WaylandEnable=false/WaylandEnable=false/' /etc/gdm3/custom.conf

2) 将用户默认会话锁定为 ubuntu-xorg（纯 X11 GNOME）：

1
2
3
sudo sed -i 's/^Session=.*/Session=ubuntu-xorg/' /var/lib/AccountsService/users/$USER
# 确认：
grep Session /var/lib/AccountsService/users/$USER   # 应显示 Session=ubuntu-xorg

3) 注销并重新登录（或登录界面齿轮选「Ubuntu on Xorg」）。

重登后确认会话类型：

1
2
echo $XDG_SESSION_TYPE     # 应为 x11
echo $XDG_CURRENT_DESKTOP  # 应为 ubuntu:GNOME

四、配置无人值守访问（对方免确认直连）

1. 设置本机安全密码（必须在 GUI 操作）

ToDesk 的本机密码是加密存储的，无法用命令行写入。请在客户端操作：

  1. 打开 ToDesk
  2. 右上角菜单 / 「设置」齿轮 → 安全设置
  3. 勾选「设置本机密码」（即无人值守访问），输入一组固定密码并保存

设置后，对方用这组固定密码即可随时连入，不需你每次发临时码或手动确认。

可选：连接后自动锁屏（controlledautolock=1）默认已开启，较安全。

2. 开机自动登录（重启后也能被控）

编辑 GDM 配置，让机器重启后自动进入桌面：

1
sudo grep -q '^AutomaticLogin=' /etc/gdm3/custom.conf || sudo sed -i '/^\[daemon\]/a AutomaticLoginEnable=true\nAutomaticLogin='$USER /etc/gdm3/custom.conf

确认 [daemon] 段含有：

1
2
AutomaticLoginEnable=true
AutomaticLogin=你的用户名

配置需重启生效：

1
sudo reboot

重启后机器自动登录 X11 桌面，ToDesk 随系统自启，对方即可无人值守连入。

安全提示：开启自动登录后，任何能物理接触这台机器的人可免密码进桌面；但远程连接仍须你的本机安全密码，整体仍安全。

五、验证

  1. 重启后确认会话：
    1
    echo $XDG_SESSION_TYPE     # x11
  2. 对方用你的设备代码 + 你设的本机安全密码连入，应能正常看到并操作桌面。
  3. 服务状态：
    1
    systemctl is-enabled todeskd.service   # enabled

六、常用运维指令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
todesk                                    # 启动客户端
sudo systemctl status todeskd.service     # 查看服务状态
sudo systemctl restart todeskd.service    # 重启服务

# 重新初始化（覆盖安装后密码变更 / 异常时）
sudo systemctl stop todeskd.service
sudo mv /opt/todesk/config/config.ini /opt/todesk/config/config.ini.bak
sudo systemctl start todeskd.service

# 查看日志（日志文件名带随机串，用通配匹配当天日期）
tail -f /var/log/todesk/service*_$(date +%Y_%m_%d).log
tail -f ~/.local/share/todesk/Logs/client*_$(date +%Y_%m_%d).log
# 或只跟最新的一个：
tail -f "$(ls -t /var/log/todesk/service*_$(date +%Y_%m_%d).log 2>/dev/null | head -1)"

# 卸载
sudo dpkg -r todesk

七、排错速查表

现象 可能原因 处理方式
连上黑屏 / 卡住 Wayland 下推流失败 切 X11 会话（第三节）
提示「没有桌面环境」 当前为 Unity / Wayland 会话 改默认 ubuntu-xorg 并重登
提示「需要安装 X11」 同上，非真缺 X11 切标准 GNOME on Xorg 会话
需每次发临时码 未设本机密码 安全设置里设本机密码
重启后连不上 停在登录界面 开启自动登录（第四节）
连上但无操作响应 被控端处于锁屏 确认自动登录已生效或解锁

八、重点回顾

  1. Ubuntu 24.04 直链下载 ToDesk deb 需带浏览器标识，否则拿到反爬验证页。
  2. ToDesk 在 Wayland / Unity 会话下无法推流，必须用 **GNOME on Xorg (X11)**。
  3. 「需要安装 X11」通常是会话问题，不是真的缺 Xorg。
  4. 无人值守 = 设本机安全密码（GUI）+ 开机自动登录（GDM）。