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. 问题排查顺序

正确的排查流程:

  1. 网络连通性:ping测试(外网、DNS)

  2. 服务状态:检查SSH服务、端口监听

  3. 配置验证:查看配置文件是否正确

  4. 工具检查:确认系统命令是否存在

  5. 权限验证:文件权限、用户权限

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 "初始化完成"

五、最终结果

经过上述问题解决,当前环境状态:

  • ✅ AlmaLinux系统正常运行

  • ✅ SSH远程连接稳定

  • ✅ VSCode Remote-SSH功能正常

  • ✅ 系统基础工具(tar、unzip等)已安装

  • ✅ 具备后续LiveKit部署的基础环境


相关推荐
ScilogyHunter20 小时前
[14] TMS570LC4357_VIM向量中断:128 通道、双 VIM 与硬件向量分发
单片机·编辑器·vim·excel·hercules·tms570
宝桥南山2 天前
Visual Studio 2026新特性 - 可以直接连接DeepSeek(使用Custom Endpoint Provider配置项)
ide·microsoft·微软·aigc·.net·visual studio
wangqiaowq2 天前
Protégé 开源本体(Ontology)编辑器
编辑器
张紫娃4 天前
idea 如何看一个类的 .class 文件
java·ide·intellij-idea
NoteDeep 深度笔记4 天前
DOM 被改乱了怎么办?Notedeep 编辑器的 normalize 设计
前端·javascript·编辑器
顧棟4 天前
组件生命周期设计:从硬编码初始化到状态机
java·ide
jianqiang.xue5 天前
Espressif-IDE进入维护模式:乐鑫把ESP32开发的宝押给VS Code
前端·css·ide
Solange__7 天前
Blender 3D模型优化:普通复制、共享网格、实例、合并怎么选?
人工智能·3d·ai·自然语言处理·编辑器·blender·材质