2026年正点原子开发板移植方案——从0开始的Rootfs之路（5）WSL + NFS 网络启动踩坑记：从挂载失败到成功启动的完整历程

2026年正点原子开发板移植方案——从0开始的Rootfs之路5WSL NFS 网络启动踩坑记从挂载失败到成功启动的完整历程项目已经开源尝试使用IMX-Forge给你的开发板跑新的Linux 7.0内核https://github.com/Awesome-Embedded-Learning-Studio/imx-forge其他教程也已经全部同步到仓库中也可以访问静态网站https://awesome-embedded-learning-studio.github.io/imx-forge获得更好的阅读体验前言为什么选择 NFS在嵌入式 Linux 开发中Rootfs 的部署方式有好几种烧录到 Flash把 Rootfs 打包成镜像烧录到 eMMC、SD 卡或 NAND Flash。缺点是每次修改都要重新烧录开发效率低。UBI 文件系统使用 UBI/UBIFS 管理原始 Flash 设备。适合量产阶段但配置复杂。NFS 网络挂载开发板通过网络从主机挂载 Rootfs。修改立即生效无需重新烧录。对于开发阶段NFS 是最方便的选择——你可以在主机上修改文件、添加程序开发板重启后立即看到效果。但是NFS 的配置也是出了名的坑多尤其是当你使用 WSL2 作为开发环境时各种问题接踵而至。这一章我会分享我从 NFS 挂载失败到成功启动的完整排查过程以及中间踩过的各种坑。环境说明开发板i.MX6ULL主机环境WSL2Ubuntu 22.04Windows 11网络模式WSL2networkingModemirrored内核版本Linux 6.12BusyBox 版本1.37.0最终工作配置速查在你被各种问题折磨得想砸键盘之前先给你一个最终答案——这是我经过无数次尝试后验证可用的完整配置U-Boot bootargs 配置setenv bootargsconsolettymxc0,115200 root/dev/nfs nfsroot192.168.60.1:/home/charliechen/imx-forge/rootfs/nfs,vers3,prototcp rw ip192.168.60.200:192.168.60.1:192.168.60.1:255.255.255.0::eth0:offsaveenv参数解析consolettymxc0,115200控制台设备和波特率root/dev/nfs指定根文件系统是 NFSnfsroot主机IP:rootfs路径,vers3,prototcpNFS 服务器地址、路径、版本和协议ip板子IP:主机IP:网关IP:子网掩码::网卡:off网络配置/etc/exports 配置/home/charliechen/imx-forge/rootfs/nfs192.168.60.0/24(rw,sync,no_root_squash,no_subtree_check)选项说明rw读写权限sync同步写入数据更安全no_root_squash不压缩 root 用户权限客户端 root 用户就是服务端 root 用户no_subtree_check不检查子目录提高性能/etc/nfs.conf 端口固定[mountd] port20048 [lockd] port32803 udp-port32769 [statd] port32765Windows 防火墙规则# 在管理员 PowerShell 中执行New-NetFirewallRule-DisplayNameNFS-TCP-111-Direction Inbound-Protocol TCP-LocalPort 111-Action Allow-Profile AnyNew-NetFirewallRule-DisplayNameNFS-UDP-111-Direction Inbound-Protocol UDP-LocalPort 111-Action Allow-Profile AnyNew-NetFirewallRule-DisplayNameNFS-TCP-2049-Direction Inbound-Protocol TCP-LocalPort 2049-Action Allow-Profile AnyNew-NetFirewallRule-DisplayNameNFS-mountd-20048-Direction Inbound-Protocol TCP-LocalPort 20048-Action Allow-Profile AnyNew-NetFirewallRule-DisplayNameNFS-lockd-32803-Direction Inbound-Protocol TCP-LocalPort 32803-Action Allow-Profile AnyNew-NetFirewallRule-DisplayNameNFS-statd-32765-Direction Inbound-Protocol TCP-LocalPort 32765-Action Allow-Profile Any# 网桥网卡改为 Private如果被识别为 Public 网络Set-NetConnectionProfile-InterfaceAlias网桥-NetworkCategory PrivateNFS 服务端配置详解安装 NFS 服务器sudoaptupdatesudoaptinstallnfs-kernel-server配置 /etc/exports/etc/exports是 NFS 服务器的主配置文件定义了哪些目录可以被哪些客户端挂载。基本语法导出目录 客户端1(选项) 客户端2(选项) ...客户端地址格式192.168.1.100单个 IP192.168.1.0/24IP 网段推荐*.example.com域名通配符*所有客户端不推荐安全隐患常用选项选项作用推荐值ro只读-rw读写开发阶段推荐sync同步写入数据更安全推荐async异步写入性能更好不推荐no_root_squash不压缩 root 权限开发阶段推荐root_squash压缩 root 权限为 nfsnobody生产环境推荐no_subtree_check禁用子树检查提高性能推荐subtree_check启用子树检查不推荐配置示例# /etc/exports/home/charliechen/imx-forge/rootfs/nfs192.168.60.0/24(rw,sync,no_root_squash,no_subtree_check)配置完成后应用更改sudoexportfs-ra验证配置生效sudoexportfs-v输出示例/home/charliechen/imx-forge/rootfs/nfs 192.168.60.0/24(rw,wdelay,no_root_squash,no_subtree_check,secsys,rw,secure,no_root_squash,no_all_squash)配置 /etc/nfs.conf 固定端口这是WSL2 环境下最关键的一步因为 Windows 防火墙默认阻止所有端口而 NFS 的 mountd、lockd、statd 服务默认使用随机端口每次重启都会变化根本无法提前配置防火墙规则。编辑 /etc/nfs.confsudonano/etc/nfs.conf添加以下内容[nfsd] debug0 port2049 [mountd] debug0 port20048 [lockd] port32803 udp-port32769 [statd] debug0 port32765重启 NFS 服务sudosystemctl restart nfs-server验证端口固定rpcinfo-plocalhost输出示例program vers proto port service 100000 4 tcp 111 portmapper 100000 3 tcp 111 portmapper 100000 2 tcp 111 portmapper 100000 4 udp 111 portmapper 100005 1 tcp 20048 mountd 100005 3 tcp 20048 mountd 100024 1 tcp 32765 status 100021 1 tcp 32803 nlockmgr 100003 3 tcp 2049 nfs如果mountd、status、nlockmgr的端口固定了说明配置成功。Windows 防火墙配置WSL2 mirrored 模式的特殊性WSL2 有两种网络模式NAT 模式默认WSL2 有自己的虚拟网络端口通过 NAT 映射Mirrored 模式WSL2 直接镜像主机的网络栈看起来像是和主机在同一网络在mirrored模式下如果firewalltrueWindows 防火墙规则会同步到 WSL2。这意味着如果 Windows 防火墙阻止了某个端口WSL2 里的服务也无法从外部访问。检查 WSL2 网络模式在 Windows 用户目录下创建或编辑.wslconfig文件[wsl2] networkingModemirrored firewalltrue创建防火墙规则在管理员 PowerShell中执行# 基础 NFS 端口New-NetFirewallRule-DisplayNameNFS-TCP-111-Direction Inbound-Protocol TCP-LocalPort 111-Action Allow-Profile AnyNew-NetFirewallRule-DisplayNameNFS-UDP-111-Direction Inbound-Protocol UDP-LocalPort 111-Action Allow-Profile AnyNew-NetFirewallRule-DisplayNameNFS-TCP-2049-Direction Inbound-Protocol TCP-LocalPort 2049-Action Allow-Profile Any# mountd、lockd、statd 端口需与 /etc/nfs.conf 一致New-NetFirewallRule-DisplayNameNFS-mountd-20048-Direction Inbound-Protocol TCP-LocalPort 20048-Action Allow-Profile AnyNew-NetFirewallRule-DisplayNameNFS-lockd-32803-Direction Inbound-Protocol TCP-LocalPort 32803-Action Allow-Profile AnyNew-NetFirewallRule-DisplayNameNFS-statd-32765-Direction Inbound-Protocol TCP-LocalPort 32765-Action Allow-Profile Any验证规则创建Get-NetFirewallRule|Where-Object{$_.DisplayName-likeNFS*}|Format-Table-AutoSize测试端口连通性Test-NetConnection-ComputerName 192.168.60.1-Port 2049如果TcpTestSucceeded : True说明端口已放行。踩坑案例 1bootargs 中 nfsroot 路径写错现象开发板启动后内核日志显示IP-Config: Complete: deviceeth0, hwaddr02:aa:bb:cc:dd:ee, ipaddr192.168.60.200, mask255.255.255.0, gw192.168.60.1 host192.168.60.200, domain, nis-domain(none) bootserver192.168.60.1, rootserver192.168.60.1, rootpath Root-NFS: No NFS server available注意rootpath是空的原因bootargs中的nfsroot参数格式错误或者 IP 地址配置错误。排查步骤在 U-Boot 命令行中printenvbootargsprintenvipaddrprintenvserverip确认nfsroot中的 IP 和路径是否正确ip参数中的 IP 配置是否正确网络是否通畅可以ping主机解决方法重新设置bootargs确保格式正确setenv bootargsconsolettymxc0,115200 root/dev/nfs nfsroot192.168.60.1:/home/charliechen/imx-forge/rootfs/nfs,vers3,prototcp rw ip192.168.60.200:192.168.60.1:192.168.60.1:255.255.255.0::eth0:offsaveenv经验每次setenv后必须用printenv bootargs逐字核对逗号前后不能有空格踩坑案例 2bootargs 字符串被截断现象printenv bootargs输出bootargsconsolettymxc0,115200 root/dev/nfs nfsroot192.168.60.1:/home/.../rootfs/ip192.168.60.200:...注意/nfs,vers3,prototcp rw整段丢失ip直接拼到路径后面原因setenv输入时漏掉了参数之间的空格或者nfsroot选项格式错误。解决方法确保nfsroot的格式是nfsrootIP:路径,选项选项之间用逗号分隔不能有空格。正确示例nfsroot192.168.60.1:/home/charliechen/imx-forge/rootfs/nfs,vers3,prototcp错误示例nfsroot192.168.60.1:/home/charliechen/imx-forge/rootfs/nfs,vers3,prototcp# ^ 有空格踩坑案例 3/etc/exports 文件不存在现象NFS 服务启动日志报错exportfs: cant open /etc/exports for reading重启后导出规则丢失exportfs -v输出为空。原因只用了exportfs命令临时导出没有写入/etc/exports文件。解决方法必须把配置写入/etc/exports文件sudobash-ccat /etc/exports EOF /home/charliechen/imx-forge/rootfs/nfs 192.168.60.0/24(rw,sync,no_root_squash,no_subtree_check) EOF然后应用配置sudoexportfs-rasudosystemctl restart nfs-server验证sudoexportfs-v应该看到你的导出规则。经验临时导出只在当前会话有效重启后丢失。配置必须持久化到/etc/exports。踩坑案例 4WSL2 mirrored 模式下防火墙拦截 NFS现象主机本地挂载 NFS 正常sudo mount -t nfs 127.0.0.1:/home/.../nfs /mnt开发板连接超时内核日志在 IP 配置完成后停止输出IP-Config: Complete: ... VFS: Mounted root (nfs filesystem). Freeing unused kernel memory: 1024K # 然后就没反应了...原因WSL2networkingModemirroredfirewalltrue模式下Windows 防火墙规则同步到 WSL开发板发来的 NFS 请求被拦截。排查步骤1. 在 Windows PowerShell 中测试端口连通性Test-NetConnection-ComputerName 192.168.60.1-Port 2049如果输出WARNING: TCP connect to (192.168.60.1 : 2049) failed说明端口被拦截。2. 检查 WSL2 防火墙日志可选sudodmesg|grep-ifirewall解决方法按照前面的步骤创建 Windows 防火墙规则确保端口 111、2049、20048、32803、32765 全部放行。踩坑案例 5mountd / lockd 使用动态随机端口现象放行 111 和 2049 后仍然挂载失败。排查rpcinfo-p|grepmountd输出100005 1 tcp 46611 mountd 100005 3 tcp 48315 mountd端口每次重启都变根本无法提前配置防火墙原因NFS mountd、lockd、statd 默认使用随机端口。解决方法在/etc/nfs.conf中固定端口[mountd] port20048 [lockd] port32803 udp-port32769 [statd] port32765重启 NFS 服务sudosystemctl restart nfs-server验证rpcinfo-p|grepmountd输出100005 1 tcp 20048 mountd 100005 3 tcp 20048 mountd端口固定了然后在 Windows 防火墙中放行这些端口。经验WSL2 环境下必须固定 NFS 相关端口否则防火墙配置无法生效。踩坑案例 6防火墙规则 Profile 为 Public 导致不生效现象防火墙规则已添加Get-NetFirewallRule可以查到但端口仍然不通。排查Get-NetConnectionProfile输出Name : 网桥 InterfaceAlias : 网桥 InterfaceIndex : 27 NetworkCategory : Public ← 问题所在 Domain : False IPv4Connectivity : Internet IPv6Connectivity : Internet原因网桥网卡被 Windows 识别为「公用网络Public」而新建防火墙规则默认只对「专用网络Private」生效。解决方法方法 1把网卡改为 PrivateSet-NetConnectionProfile-InterfaceAlias网桥-NetworkCategory Private方法 2防火墙规则覆盖所有 ProfileGet-NetFirewallRule|Where-Object{$_.DisplayName-likeNFS*}|Set-NetFirewallRule-Profile Any验证Get-NetFirewallRule-DisplayNameNFS-TCP-2049|Select-ObjectDisplayName,Profile输出DisplayName Profile ----------- ------- NFS-TCP-2049 Any经验WSL2 mirrored 模式下网桥可能被识别为 Public 网络防火墙规则需要覆盖所有 Profile。NFS 挂载完整流程图理解 NFS 挂载的完整流程有助于快速定位问题┌─────────────────────────────────────────────────────────────────────┐ │ 开发板上电 │ └─────────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ U-Boot 阶段 │ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ 1. 配置网络ipaddr, serverip │ │ │ │ 2. TFTP 下载内核tftp 0x82000000 zImage │ │ │ │ 3. TFTP 下载设备树tftp 0x83000000 imx6ull-14x14-evk.dtb │ │ │ │ 4. 设置 bootargs包含 nfsroot 和 ip 参数 │ │ │ │ 5. 启动内核bootz 0x82000000 - 0x83000000 │ │ │ └─────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 内核启动阶段 │ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ 1. 解析 bootargs 中的 ip 参数配置 eth0 网卡 │ │ │ │ 2. 输出IP-Config: Complete: ... │ │ │ │ 3. 发起 NFS 挂载请求 │ │ │ └─────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ NFS 挂载阶段 │ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ Step 1: 连接 rpcbind (TCP 111) │ │ │ │ └─ 获取 mountd 端口 (20048) │ │ │ │ │ │ │ │ Step 2: 连接 mountd (TCP 20048) │ │ │ │ └─ 获取 NFS 文件句柄 │ │ │ │ │ │ │ │ Step 3: 连接 nfsd (TCP 2049) │ │ │ │ └─ 挂载根文件系统 │ │ │ │ │ │ │ │ 成功VFS: Mounted root (nfs filesystem) │ │ │ │ 失败Root-NFS: No NFS server available │ │ │ └─────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 启动 /sbin/init │ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ 1. 执行 /etc/inittab 中的 sysinit 动作 │ │ │ │ 2. 运行 /etc/init.d/rcS 初始化脚本 │ │ │ │ 3. 挂载 /proc, /sys, /tmp 等 │ │ │ │ 4. 运行 mdev -s 创建设备节点 │ │ │ │ 5. 启动 getty / sh │ │ │ └─────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 系统就绪出现 shell 提示符 │ │ Welcome to i.MX6ULL Embedded Linux! │ │ / # │ └─────────────────────────────────────────────────────────────────────┘排查工具速查主机侧命令命令作用sudo exportfs -v查看当前 NFS 导出规则sudo ss -tnlp | grep -E 2049|111确认端口监听rpcinfo -p localhost查看所有 RPC 服务端口sudo mount -t nfs -o vers3,prototcp IP:路径 /mnt本地验证挂载sudo tail -f /var/log/syslog查看 NFS 服务日志Windows PowerShell 命令命令作用Get-NetConnectionProfile查看网卡网络类别Get-NetFirewallRule | Where-Object {$_.DisplayName -like NFS*}查看 NFS 防火墙规则Test-NetConnection -ComputerName IP -Port 2049测试端口连通性Set-NetConnectionProfile -InterfaceAlias 网桥 -NetworkCategory Private改变网络类别U-Boot 命令命令作用printenv bootargs查看 bootargs 配置printenv ipaddr查看开发板 IPprintenv serverip查看主机 IPping 主机IP测试网络连通性内核启动日志关键字关键字含义IP-Config: Complete网络配置成功Root-NFS: No NFS server availableNFS 服务器无法访问VFS: Mounted root (nfs filesystem)NFS 挂载成功Kernel panic - not syncing: No init found找不到 /sbin/init常见错误信息汇总NFS 服务器侧错误信息原因解决方法exportfs: cant open /etc/exports/etc/exports 不存在或格式错误检查文件语法fsid 0: no export entry导出路径不匹配检查 /etc/exports 中的路径refused mount request from 192.168.60.200客户端 IP 未授权检查 /etc/exports 中的客户端范围开发板侧错误信息原因解决方法Root-NFS: No NFS server available网络不通或防火墙拦截检查网络、防火墙NFS: server 192.168.60.1 not respondingNFS 服务未启动或端口未放行检查 NFS 服务状态、防火墙nfs: server 192.168.60.1 OK成功-VFS: Mounted root (nfs filesystem) on device 0:15成功-验证 NFS 挂载成功当你看到内核日志输出以下内容时恭喜你NFS 挂载成功了IP-Config: Complete: deviceeth0, hwaddr02:aa:bb:cc:dd:ee, ipaddr192.168.60.200, mask255.255.255.0, gw192.168.60.1 host192.168.60.200, domain, nis-domain(none) bootserver192.168.60.1, rootserver192.168.60.1, rootpath/home/charliechen/imx-forge/rootfs/nfs Looking up port of RPC 100003/2 on 192.168.60.1 Looking up port of RPC 100005/2 on 192.168.60.1 VFS: Mounted root (nfs filesystem). Freeing unused kernel memory: 1024K Welcome to i.MX6ULL Embedded Linux! / #看到/ #提示符说明你已经成功进入了开发板的 shell下一步应用集成现在 Rootfs 已经通过 NFS 成功挂载系统可以正常启动了。但是这个 Rootfs 还是最小化的只有 BusyBox 提供的基本命令。实际应用中我们还需要添加更多的命令、库文件、自定义程序等。下一章我们将讲解如何添加更多常用命令和工具静态链接 vs 动态链接的选择如何处理库文件依赖如何添加自定义应用程序如何配置系统启动服务准备好了吗让我们继续完善这个 Rootfs