VSCode远程连接AlmaLinux虚拟机问题总结

一、问题概述

今天在通过VSCode Remote-SSH插件连接AlmaLinux虚拟机（VirtualBox）时，主要遇到以下三个阶段的问题：

问题阶段	核心问题	影响	解决状态
第一阶段	SSH认证失败	无法建立连接	✅ 已解决
第二阶段	VS Code Server安装失败	连接后无法初始化	✅ 已解决
第三阶段	系统工具缺失	影响后续操作	✅ 已解决

二、详细问题及解决方案

问题1：SSH认证失败（第一阶段）

现象：

VSCode连接时提示"Permission denied (publickey,gssapi-keyex,gssapi-with-mic)"
无法通过密码认证登录

根本原因：

AlmaLinux最小化安装默认SSH配置限制：

PermitRootLogin设置为prohibit-password（禁止密码登录）
未启用密码认证

解决方案：

# 修改SSH配置 vim /etc/ssh/sshd_config # 修改以下配置项： PermitRootLogin yes PasswordAuthentication yes # 重启SSH服务 systemctl restart sshd

验证方法：

在Windows终端执行：ssh root@localhost -p 9091
成功输入密码登录即解决

问题2：VS Code Server安装失败（第二阶段）

现象：

SSH连接成功后，VSCode自动安装VS Code Server时失败
错误信息："Failed to install the VS Code Server"
日志显示："tar: command not found"

根本原因：

AlmaLinux最小化安装缺少以下关键工具：

tar命令（用于解压VS Code Server压缩包）
其他解压相关工具

解决方案：

# 安装必要工具 dnf install -y tar gzip wget curl # 验证安装 tar --version # 应显示版本信息

补充说明：

网络测试确认正常（ping baidu.com、8.8.8.8均通）
问题并非网络导致，而是系统工具缺失
安装tar后，VSCode自动重试即可成功

问题3：dnf进程锁定（第三阶段）

现象：

执行dnf install时提示"Waiting for process with pid XXXX to finish"
命令卡住或提示进程被锁定

根本原因：

之前某个dnf进程异常中断，导致锁文件残留
系统检测到已有dnf实例在运行

解决方案：

# 结束卡住的dnf进程 pkill dnf pkill python3 # 删除锁文件 rm -f /var/run/dnf.pid rm -f /var/lib/dnf/rpmdb_lock.pid # 清理缓存 dnf clean all # 重新执行安装 dnf install -y unzip # 或其他需要的包

三、关键经验总结

1. 最小化安装的局限性

AlmaLinux最小化安装（Minimal Install）默认只包含最基础的软件包，缺少：

常用工具（tar、unzip、wget等）
开发工具链
网络诊断工具

建议：生产环境建议选择"Server with GUI"或"Server"安装类型，或手动安装必要工具包。

2. SSH安全配置与便利性

默认安全配置限制了密码登录，虽然安全但影响开发便利性。开发环境可适当放宽限制，生产环境需谨慎。

3. 问题排查顺序

正确的排查流程：

网络连通性：ping测试（外网、DNS）
服务状态：检查SSH服务、端口监听
配置验证：查看配置文件是否正确
工具检查：确认系统命令是否存在
权限验证：文件权限、用户权限

4. 日志的重要性

VSCode Remote-SSH插件提供了详细日志（通过"Remote-SSH: Show Log"命令），是定位问题的关键依据。

四、预防措施

环境准备清单

下次部署类似环境时，建议提前执行：

# 系统安装后立即执行 dnf update -y dnf install -y tar gzip wget curl vim net-tools dnf install -y epel-release # 可选，扩展软件源 # 配置SSH（开发环境） sed -i 's/^PermitRootLogin.*/PermitRootLogin yes/' /etc/ssh/sshd_config sed -i 's/^PasswordAuthentication.*/PasswordAuthentication yes/' /etc/ssh/sshd_config systemctl restart sshd

自动化脚本

可编写初始化脚本，避免重复问题：

#!/bin/bash # init_alma.sh - AlmaLinux初始化脚本 echo "安装基础工具..." dnf install -y tar gzip wget curl vim unzip echo "配置SSH..." cp /etc/ssh/sshd_config /etc/ssh/sshd_config.backup sed -i 's/^PermitRootLogin.*/PermitRootLogin yes/' /etc/ssh/sshd_config sed -i 's/^PasswordAuthentication.*/PasswordAuthentication yes/' /etc/ssh/sshd_config systemctl restart sshd echo "初始化完成"