Ubuntu 22.04 安装 SSH 服务与远程调试环境配置指南

1. 安装 OpenSSH 服务器

首先，确保系统已更新，然后安装 OpenSSH 服务器。

# 切换到 root 用户（或使用 sudo）sudosu-# 更新软件包列表aptupdate# 安装 openssh-serveraptinstallopenssh-server-y

2. 启动服务并设置开机自启

安装完成后，启动 SSH 服务并设置为开机自动启动。

# 启动 SSH 服务并设置开机自启systemctlenable--nowssh

3. 验证 SSH 服务状态

通过以下命令检查 SSH 服务是否正常运行。

# 检查 SSH 服务状态systemctl statusssh# 检查 22 端口是否在监听ss-tulpn|grep:22

4. 本地连接测试

在本地尝试 SSH 连接，验证服务是否可访问。

# 使用当前用户连接本地 SSH 服务sshhome@localhost

5. 额外配置与检查

为了避免后续连接问题，建议进行以下配置。

5.1 防火墙放行 SSH 端口

如果系统启用了防火墙（如ufw），需要放行 SSH 端口。

# 允许 SSH 端口（默认 22）ufw allowssh# 重新加载防火墙规则ufw reload

5.2 确认允许密码登录

默认情况下，Ubuntu 22.04 的 SSH 配置可能禁止密码登录。请检查并修改配置文件。

# 编辑 SSH 服务配置文件nano/etc/ssh/sshd_config

找到PasswordAuthentication一行，确保其设置为yes：

PasswordAuthenticationyes

保存文件后，重启 SSH 服务使配置生效。

systemctl restartssh

6. 远程部署路径配置（.pro 文件）

在 Qt 项目的.pro文件中，可以指定远程部署路径，方便通过 Qt Creator 进行远程部署。

# 指定远程目标路径 target.path = /home/pc/myApp INSTALLS += target

7. 远程运行环境变量设置

在远程主机上运行 Qt 应用程序时，可能需要设置以下环境变量。

# 设置显示和权限exportDISPLAY=:0exportXAUTHORITY=/home/pc/.Xauthority# 设置库路径（包含自定义库和系统库）exportLD_LIBRARY_PATH=/home/pc/myApp/lib:/home/pc/myApp/lib/Galaxy:/home/pc/myApp/lib/OpenCV:/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH# 设置 Qt 插件路径exportQT_QPA_PLATFORM_PLUGIN_PATH=/home/pc/myApp/plugins/platforms# 另一种动态库路径设置方式（使用当前目录）exportLD_LIBRARY_PATH="$PWD/lib:$PWD/lib/Galaxy:$PWD/lib/OpenCV:/usr/lib/x86_64-linux-gnu"

8. 安装 xcb 依赖（解决 Qt 图形界面问题）

如果远程应用程序使用 Qt 且基于 xcb 平台，需要安装相关依赖。

sudoaptupdate&&sudoaptinstall--reinstall-ylibxcb-cursor0 libxcb-util-dev libxcb-image0 libxcb-keysyms1 libxcb-render-util0 libxcb-shape0 libxcb-sync1 libxcb-xfixes0 libxcb-randr0 libxcb-shm0 libxcb-icccm4 libxcb-render0 libxcb-xkb1 libxkbcommon-x11-0sudoldconfig

9. 编写启动脚本

创建一个启动脚本（例如start.sh），统一设置环境并启动应用程序。

#!/bin/bashcd"$(dirname"$0")"# 强制指定库路径，包含本地库和系统库exportLD_LIBRARY_PATH="$PWD/lib:/usr/lib/x86_64-linux-gnu"# 强制指定 Qt 插件路径exportQT_QPA_PLATFORM_PLUGIN_PATH="$PWD/plugins/platforms"# 强制使用 xcb 平台，避免 wayland 干扰exportQT_QPA_PLATFORM=xcb# 开启 Qt 插件调试，方便定位问题exportQT_DEBUG_PLUGINS=1# 启动应用程序./HA5001HM

赋予脚本执行权限：

chmod+x start.sh

10. 安装远程调试工具

为了支持远程调试（例如使用 GDB），需要在远程主机上安装gdbserver，在本地开发机安装gdb。

# 在远程主机（Ubuntu 22.04）上安装 gdbserversudoaptupdatesudoaptinstallgdbserver gdb-y

安装后，即可在远程主机启动gdbserver，在本地通过gdb连接进行远程调试。

总结

本文详细介绍了在 Ubuntu 22.04 上安装和配置 SSH 服务，以及为远程 Qt 应用程序部署和调试准备环境的完整步骤。涵盖了服务安装、防火墙配置、环境变量设置、依赖安装和启动脚本编写，帮助开发者快速搭建稳定的远程开发和调试环境。