1. 安装 OpenSSH 服务器
首先,确保系统已更新,然后安装 OpenSSH 服务器。
# 切换到 root 用户(或使用 sudo)sudosu-# 更新软件包列表aptupdate# 安装 openssh-serveraptinstallopenssh-server-y2. 启动服务并设置开机自启
安装完成后,启动 SSH 服务并设置为开机自动启动。
# 启动 SSH 服务并设置开机自启systemctlenable--nowssh3. 验证 SSH 服务状态
通过以下命令检查 SSH 服务是否正常运行。
# 检查 SSH 服务状态systemctl statusssh# 检查 22 端口是否在监听ss-tulpn|grep:224. 本地连接测试
在本地尝试 SSH 连接,验证服务是否可访问。
# 使用当前用户连接本地 SSH 服务sshhome@localhost5. 额外配置与检查
为了避免后续连接问题,建议进行以下配置。
5.1 防火墙放行 SSH 端口
如果系统启用了防火墙(如ufw),需要放行 SSH 端口。
# 允许 SSH 端口(默认 22)ufw allowssh# 重新加载防火墙规则ufw reload5.2 确认允许密码登录
默认情况下,Ubuntu 22.04 的 SSH 配置可能禁止密码登录。请检查并修改配置文件。
# 编辑 SSH 服务配置文件nano/etc/ssh/sshd_config找到PasswordAuthentication一行,确保其设置为yes:
PasswordAuthenticationyes保存文件后,重启 SSH 服务使配置生效。
systemctl restartssh6. 远程部署路径配置(.pro 文件)
在 Qt 项目的.pro文件中,可以指定远程部署路径,方便通过 Qt Creator 进行远程部署。
# 指定远程目标路径 target.path = /home/pc/myApp INSTALLS += target7. 远程运行环境变量设置
在远程主机上运行 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-0sudoldconfig9. 编写启动脚本
创建一个启动脚本(例如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.sh10. 安装远程调试工具
为了支持远程调试(例如使用 GDB),需要在远程主机上安装gdbserver,在本地开发机安装gdb。
# 在远程主机(Ubuntu 22.04)上安装 gdbserversudoaptupdatesudoaptinstallgdbserver gdb-y安装后,即可在远程主机启动gdbserver,在本地通过gdb连接进行远程调试。
总结
本文详细介绍了在 Ubuntu 22.04 上安装和配置 SSH 服务,以及为远程 Qt 应用程序部署和调试准备环境的完整步骤。涵盖了服务安装、防火墙配置、环境变量设置、依赖安装和启动脚本编写,帮助开发者快速搭建稳定的远程开发和调试环境。