nbd

NBD 网络块设备

补充说明

NBD（Network Block Device）把远程磁盘映射成本地块设备，常用于云主机、无盘启动和测试环境。服务端导出文件/设备，客户端通过 nbd-client 映射。

核心组件：nbd-server、nbd-client、内核 nbd 模块。

常用示例

加载模块：

modprobe nbd max_part=16
lsmod | grep nbd

服务端配置：

cat > /etc/nbd-server/config <<'EOF'
[generic]
[data]
exportname = /data/disk.img
port = 10809
authfile = /etc/nbd-server/allow
EOF
systemctl enable --now nbd-server

客户端映射：

nbd-client 10.0.0.10 10809 /dev/nbd0
lsblk /dev/nbd0
mount /dev/nbd0 /mnt

断开：

umount /mnt
nbd-client -d /dev/nbd0

易错点与排错

• 内核没有 nbd 模块，/dev/nbd0 不存在。
• 服务端导出文件权限不足，客户端连接被拒绝。
• 防火墙未放行 10809。
• 多个客户端同时写同一后端，文件系统损坏。
• 客户端断线后没有重连，挂载点卡住。
• max_part 太小，分区不可见。
• 直接断开正在使用的 NBD，导致 IO 错误。