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

1. 安装 OpenSSH 服务器

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

# 切换到 root 用户（或使用 sudo）
sudo su –

# 更新软件包列表
apt update

# 安装 openssh-server
apt install openssh-server -y

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

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

# 启动 SSH 服务并设置开机自启
systemctl enable –now ssh

3. 验证 SSH 服务状态

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

# 检查 SSH 服务状态
systemctl status ssh

# 检查 22 端口是否在监听
ss -tulpn | grep :22

4. 本地连接测试

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

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

5. 额外配置与检查

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

5.1 防火墙放行 SSH 端口

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

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

5.2 确认允许密码登录

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

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

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

PasswordAuthentication yes

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

systemctl restart ssh

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

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

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

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

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

# 设置显示和权限
export DISPLAY=:0
export XAUTHORITY=/home/pc/.Xauthority

# 设置库路径（包含自定义库和系统库）
export LD_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 插件路径
export QT_QPA_PLATFORM_PLUGIN_PATH=/home/pc/myApp/plugins/platforms

# 另一种动态库路径设置方式（使用当前目录）
export LD_LIBRARY_PATH="$PWD/lib:$PWD/lib/Galaxy:$PWD/lib/OpenCV:/usr/lib/x86_64-linux-gnu"

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

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

sudo apt update && sudo apt install –reinstall -y libxcb-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-0
sudo ldconfig

9. 编写启动脚本

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

#!/bin/bash
cd "$(dirname "$0")"

# 强制指定库路径，包含本地库和系统库
export LD_LIBRARY_PATH="$PWD/lib:/usr/lib/x86_64-linux-gnu"

# 强制指定 Qt 插件路径
export QT_QPA_PLATFORM_PLUGIN_PATH="$PWD/plugins/platforms"

# 强制使用 xcb 平台，避免 wayland 干扰
export QT_QPA_PLATFORM=xcb

# 开启 Qt 插件调试，方便定位问题
export QT_DEBUG_PLUGINS=1

# 启动应用程序
./HA5001HM

赋予脚本执行权限：

chmod +x start.sh

10. 安装远程调试工具

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

# 在远程主机（Ubuntu 22.04）上安装 gdbserver
sudo apt update
sudo apt install gdbserver gdb -y

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

总结

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