news 2026/5/10 16:21:38

保姆级教程:手把手教你用Qemu在Win10上虚拟树莓派(从下载镜像到SSH连接)

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
保姆级教程:手把手教你用Qemu在Win10上虚拟树莓派(从下载镜像到SSH连接)

零基础实战:Windows 10环境下用Qemu搭建树莓派虚拟开发环境

在技术爱好者和开发者的世界里,树莓派以其小巧的体积和强大的功能成为了学习和实践的热门选择。然而,并非所有人都有条件随时准备一块实体树莓派板子。这时,虚拟化技术就派上了用场——通过Qemu这个开源的机器模拟器和虚拟器,我们完全可以在Windows 10系统上模拟出一个完整的树莓派环境。

本文将带你从零开始,一步步完成这个有趣的技术实践。不同于简单的概念介绍,我们会深入每个操作细节,包括如何选择正确的镜像文件、配置复杂的启动参数、解决常见的网络连接问题等。无论你是想学习ARM架构开发,还是需要测试树莓派环境下的软件兼容性,这个虚拟环境都能满足你的需求。

1. 准备工作与环境搭建

在开始之前,我们需要准备好所有必要的工具和文件。这个过程看似简单,但很多新手往往在这里就遇到了第一个障碍——下载了错误的文件版本或者遗漏了关键组件。

首先,我们需要下载Qemu for Windows的安装包。推荐从官网获取最新稳定版本:

https://www.qemu.org/download/

选择Windows版本的安装程序,建议下载64位的qemu-w64-setup-xxxx.exe文件。安装过程中,记得勾选"Add QEMU to the system PATH for all users"选项,这样我们就可以在任意目录下使用Qemu命令了。

接下来是获取树莓派系统镜像。树莓派官方提供了多个版本的Raspbian系统,对于初学者来说,建议选择带有桌面环境的完整版:

https://www.raspberrypi.com/software/operating-systems/

下载完成后,你会得到一个.img.xz的压缩文件,我们需要使用7-Zip等工具解压出.img镜像文件。这个步骤看似简单,但很多新手容易犯以下错误:

  • 直接双击.xz文件导致解压失败
  • 解压后找不到.img文件
  • 下载了错误的架构版本(必须选择ARM版本)

提示:解压后的.img文件通常有数GB大小,请确保磁盘有足够空间。建议专门创建一个工作目录存放所有相关文件。

2. 获取必要的内核与固件文件

要让Qemu正确模拟树莓派硬件,我们还需要一些特殊的文件——内核镜像(kernel)和设备树二进制文件(dtb)。这些文件定义了硬件的基本参数和启动方式。

树莓派社区在GitHub上维护了这些关键文件,我们可以直接从官方仓库获取:

https://github.com/dhruvvyas90/qemu-rpi-kernel

下载仓库中的以下关键文件:

  • kernel-qemu-4.19.50-buster(内核镜像)
  • versatile-pb-buster.dtb(设备树二进制)

将这些文件与之前下载的系统镜像放在同一个目录下,这样后续操作会更加方便。文件结构应该如下所示:

qemu-rpi/ ├── 2022-01-28-raspios-buster-armhf.img ├── kernel-qemu-4.19.50-buster └── versatile-pb-buster.dtb

常见问题排查

  • 如果启动时提示找不到内核文件,检查文件名是否完全匹配
  • 不同版本的Raspbian需要对应版本的内核文件
  • 确保文件没有损坏,可以重新下载验证

3. 配置Qemu启动参数

这是整个过程中最具技术含量的部分,也是新手最容易出错的地方。Qemu的启动命令包含多个参数,每个都有其特定作用。下面是一个典型的启动命令:

qemu-system-arm \ -M versatilepb \ -cpu arm1176 \ -m 256 \ -drive file=2022-01-28-raspios-buster-armhf.img,format=raw \ -kernel kernel-qemu-4.19.50-buster \ -dtb versatile-pb-buster.dtb \ -append "root=/dev/sda2 panic=1 rootfstype=ext4 rw" \ -no-reboot \ -net nic -net user,hostfwd=tcp::5022-:22 \ -nographic

让我们分解这个命令的每个关键部分:

参数说明注意事项
-M versatilepb指定机器类型为Versatile PB必须与dtb文件匹配
-cpu arm1176模拟ARM1176 CPU树莓派1代使用的CPU
-m 256分配256MB内存可根据需要调整
-drive file=...指定系统镜像文件路径必须正确
-kernel指定内核文件版本必须匹配
-dtb指定设备树文件必须与机器类型匹配
-append内核启动参数root参数特别重要
-net网络配置端口转发设置在此

注意:-net user,hostfwd=tcp::5022-:22这一参数设置了端口转发,将主机的5022端口映射到虚拟机的22端口(SSH),这是我们后续远程连接的关键。

4. 首次启动与系统配置

执行启动命令后,Qemu会开始加载内核并启动系统。第一次启动可能会比较慢,请耐心等待。当看到登录提示时,使用默认凭证:

  • 用户名:pi
  • 密码:raspberry

成功登录后,建议立即进行以下基本配置:

  1. 扩展文件系统:运行sudo raspi-config,选择"Advanced Options" > "Expand Filesystem"来充分利用虚拟磁盘空间
  2. 更改密码:在同一个菜单中,选择"Change User Password"设置更安全的密码
  3. 启用SSH:在"Interface Options"中启用SSH服务
  4. 配置本地化:设置正确的时区和键盘布局

完成这些基本配置后,建议更新系统软件包:

sudo apt update && sudo apt upgrade -y

常见启动问题解决方案

  • 如果卡在启动界面,尝试增加内存分配(如-m 512
  • 出现文件系统错误,检查-append参数中的root设备是否正确
  • 网络不可用,确认-net参数设置正确
  • 图形界面问题,可以尝试添加-display gtk参数

5. 配置SSH远程连接

虽然Qemu提供了直接的交互界面,但通过SSH连接会更加方便,特别是需要复制粘贴命令时。我们在启动参数中已经设置了端口转发,现在只需要在主机上连接即可。

从Windows主机连接虚拟树莓派的步骤:

  1. 确保虚拟树莓派已启动并正常运行
  2. 打开Windows命令提示符或PowerShell
  3. 使用以下命令连接:
ssh -p 5022 pi@localhost

首次连接时会提示确认主机密钥,输入yes继续。然后输入密码(默认为raspberry,如果你更改过则使用新密码)。

为了提高安全性,建议:

  • 禁用root用户的SSH登录
  • 使用密钥认证代替密码
  • 更改默认SSH端口

可以在虚拟树莓派上编辑SSH配置文件:

sudo nano /etc/ssh/sshd_config

修改以下参数:

PermitRootLogin no PasswordAuthentication no Port 2222

然后重启SSH服务:

sudo systemctl restart ssh

记得更新Qemu启动命令中的端口转发参数以匹配新的SSH端口。

6. 优化虚拟环境性能

默认配置下,虚拟机的性能可能不尽如人意。以下是几个提升性能的技巧:

1. 启用KVM加速(如果主机支持)修改启动参数,添加-enable-kvm选项(仅限Linux主机)

2. 增加CPU核心数使用-smp参数,如-smp 4分配4个CPU核心

3. 使用更高效的文件系统考虑将镜像转换为qcow2格式,节省空间并提高性能:

qemu-img convert -f raw -O qcow2 raspios.img raspios.qcow2

然后修改启动命令中的-drive参数:

-drive file=raspios.qcow2,format=qcow2

4. 调整显示设置如果不需要图形界面,可以添加-nographic参数减少资源占用

5. 内存分配根据主机配置适当增加内存分配,如-m 1024分配1GB内存

7. 常见问题与高级技巧

即使按照步骤操作,仍然可能遇到各种问题。以下是一些常见问题的解决方案:

问题1:启动时卡在"Booting from Hard Disk..."

  • 检查内核和dtb文件版本是否匹配
  • 确认-append参数中的root设备正确(可能是sda1或sda2)

问题2:SSH连接被拒绝

  • 确认虚拟树莓派上SSH服务正在运行:sudo systemctl status ssh
  • 检查端口转发设置是否正确
  • 确认防火墙没有阻止连接

问题3:图形界面显示异常

  • 尝试不同的显示后端:-display gtk-display sdl
  • 或者直接使用-nographic以纯文本模式运行

高级技巧1:共享文件夹可以通过Samba或SFTP在主机和虚拟机之间共享文件。更简单的方法是使用9p文件系统:

启动参数添加:

-fsdev local,security_model=none,id=fsdev0,path=共享目录路径 \ -device virtio-9p-pci,id=fs0,fsdev=fsdev0,mount_tag=hostshare

然后在虚拟机中挂载:

sudo mkdir /mnt/hostshare sudo mount -t 9p -o trans=virtio hostshare /mnt/hostshare

高级技巧2:快照管理qcow2格式支持快照功能,可以保存系统状态:

创建快照:

qemu-img snapshot -c 快照名称 raspios.qcow2

恢复快照:

qemu-img snapshot -a 快照名称 raspios.qcow2

列出快照:

qemu-img snapshot -l raspios.qcow2

在实际使用中,我发现最常遇到的问题还是文件路径和版本匹配。特别是当树莓派官方更新系统镜像后,可能需要等待qemu-rpi-kernel仓库更新对应的内核文件。遇到问题时,仔细检查控制台输出的错误信息,通常都能找到线索。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/10 16:21:09

从IBUF、OBUF到IOBUF:深入剖析FPGA双向端口原语与inout实现机制

1. FPGA双向端口的基本概念 第一次接触FPGA的inout端口时,我完全被它搞懵了。为什么一个端口既能输入又能输出?这背后到底是怎么实现的?后来在实际项目中踩过几次坑才明白,原来inout的实现离不开三个关键原语:IBUF、OB…

作者头像 李华
网站建设 2026/5/10 16:02:01

Claudecode-Codex-Gemini:本地部署多模型AI编程助手实战指南

1. 项目概述与核心价值最近在开发者圈子里,关于如何高效利用大语言模型(LLM)来辅助编程的讨论越来越热。大家可能都试过直接和ChatGPT、Claude或者Gemini对话来写代码,但说实话,体验有点割裂:要么得在网页和…

作者头像 李华