彰化县网站建设_网站建设公司_一站式建站_seo优化

一、问题概述

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

二、详细问题及解决方案

问题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部署的基础环境