ProxmoxVE 如何使用 Serial 登录 KVM 虚拟机？

noVNC Vs Serial

对比维度	noVNC（默认图形控制台）	串口登录（Serial Console）
访问方式	通过 Proxmox Web 界面嵌入的 VNC 客户端访问	通过 `qm terminal <VMID>` 命令或 Web 控制台中的“串口控制台”标签页访问
资源开销	较高（需渲染图形界面，占用更多 CPU/内存/带宽）	极低（仅传输文本，几乎无图形开销）
适用场景	有桌面环境的 VM、图形化安装、GUI 应用调试	最小化安装、救援模式、内核调试
配置复杂度	默认启用，无需额外配置	需在 VM 中启用串口设备（如 ttyS0），并配置 getty 或 systemd 服务
复制粘贴	无法访问系统粘贴板，不支持复制粘贴	依赖 ProxmoxVE 访问系统粘贴板，支持复制粘贴
日志记录	不便于自动记录控制台输出	易于重定向或记录串口输出，适合审计或调试

一、关机状态下添加硬件

虚拟机 → 硬件 → 添加 → 串行端口 → [输入串行端口号] → 添加

二、开机修改 `GRUB` 配置

1：启动虚拟机

虚拟机 → 控制台 → Start Now

2. 登录系统

3. 修改 `GRUB` 配置文件

vi /etc/default/grub

在 grub 配置文件末尾添加

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
# 将控制台输出同时发送到本地显示（tty0）和串口（ttyS0）
# 本地端口 console=tty0
# 串行端口 console=ttyS0,115200n8
GRUB_CMDLINE_LINUX="console=tty0 console=ttyS0,115200n8"
# 让 GRUB 菜单（启动选择界面）本身也输出到串行端口
GRUB_TERMINAL=serial
# 定义串行端口的具体通信参数
# 波特率 --speed=115200
# 串口号 --unit=0
# 数据位 --word=8
# 关闭奇偶校验 --parity=no
# 停止位 --stop=1
GRUB_SERIAL_COMMAND="serial --speed=115200 --unit=0 --word=8 --parity=no --stop=1"

4. 重新生成系统启动 `GRUB` 配置文件

按系统执行以下命令，重新生成 grub.cfg

Debian/Ubuntu
1 2
# Debian/Ubuntu update-grub

RHEL/CentOS/Fedora/Rocky等

1
grub2-mkconfig -o /boot/grub2/gurb.cfg

查看 grub.cfg 文件验证配置是否生效

1
grep "linux.*console" /boot/grub/grub.cfg

5. 启用串行端口登录服务

1
sudo systemctl enable serial-getty@ttyS0.service

6. 重启虚拟机

1
reboot

三、使用串口登录虚拟机

在 ProxmoxVE Shell 使用 qm terminal <VMID> 登录虚拟机

1
qm terminal 100

按下 Enter 出现登录提示 [Hostname] Login:
输入用户名 root
输入密码
确保用户名、密码正确，按下 Enter 即可成功登录
如需退出虚拟机，按 Ctrl+O 退出登录

此文档由杨文于 2025年10月01日 编写。

noVNC Vs Serial

一、关机状态下添加硬件

二、开机修改 GRUB 配置

1：启动虚拟机

2. 登录系统

3. 修改 GRUB 配置文件

4. 重新生成系统启动 GRUB 配置文件

5. 启用串行端口登录服务

6. 重启虚拟机

三、使用串口登录虚拟机

二、开机修改 `GRUB` 配置

3. 修改 `GRUB` 配置文件

4. 重新生成系统启动 `GRUB` 配置文件