---
title: Ubuntu 下 DM Multipath 多路径配置实践
description: 面向企业 IT 运维，介绍 Ubuntu 自带 DM Multipath 的组件构成、安装准备、配置步骤、验证方法与回退建议。内容涵盖 multipath.conf 编写、WWID 黑名单、服务启停与集群命名一致性注意事项，所有环境参数以占位符表示，具体版本行为请查阅对应官方文档。
url: "https://www.lanever.com/docs/ubuntu-%e4%b8%8b-dm-multipath-%e5%a4%9a%e8%b7%af%e5%be%84%e9%85%8d%e7%bd%ae%e5%ae%9e%e8%b7%b5/"
updated: "2026-10-12"
category: Odoo
---

# Ubuntu 下 DM Multipath 多路径配置实践

> **参考来源与致谢**
>
>
>
> - **引用来源：**[Ubuntu系统下的多路径软件 DM Multipath 配置。 - pipci - 博客园](https://www.cnblogs.com/pipci/p/9247858.html)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

服务器通过多条物理链路连接同一 SAN 存储卷时，操作系统会看到多个同源块设备。DM Multipath 是 Ubuntu 自带的设备映射器多路径工具，用于把这些路径聚合为一个逻辑设备，并在链路故障时切换 I/O 路径。适用于双控存储、双 HBA、双交换机等冗余组网环境。

若仅使用本地磁盘或单链路直连存储，通常无需启用多路径。

## 组件说明

- **dm_multipath**：内核模块，为路径与路径组重新分配 I/O，提供出错冗余。
- **multipath-tools**：用户态程序集，负责配置并启用设备映射器多路径。
- **multipath**：命令，列出并配置多路径设备。
- **multipathd**：守护进程，监视路径状态，路径恢复后触发路径组切换；修改 `/etc/multipath.conf` 后需使其重新加载。
- **kpartx**：为设备中的分区生成映射设备，处理 DOS 分区时常用。

## 准备与风险

操作前请确认：

- 已在测试环境验证，或已对业务数据完成备份。
- 已记录当前磁盘拓扑，包括各路径的 WWID。
- 已确认存储侧映射与 zoning 配置正确。
- 已准备回退方案，例如可卸载软件包、恢复原 `multipath.conf`。

> 分区、格式化、LVM 操作具有破坏性。请先备份数据，并在测试环境验证命令，再在生产环境执行。

## 处理步骤

### 1. 检查软件包

```
dpkg -l | grep multipath-tools
```

无输出表示未安装。可通过 apt 源安装；无法访问外网时，可挂载系统 ISO 配置本地源，具体方法参见对应 Ubuntu 版本官方文档。

### 2. 安装软件包

```
apt-cache search multipath-tools
apt-get install multipath-tools
```

若需从 SAN 引导，再安装 `multipath-tools-boot`；否则可不装。

### 3. 检查服务状态

```
systemctl list-unit-files | grep multipath
```

若未启用：

```
systemctl enable multipath-tools.service
```

### 4. 生成配置文件

默认无 `/etc/multipath.conf`。安装后模板位于 `/usr/share/doc/multipath-tools/examples/`，可复制为正式配置：

```
cp -v /usr/share/doc/multipath-tools/examples/multipath.conf.synthetic /etc/multipath.conf
```

### 5. 编辑配置

模板内容多为注释，可按环境取消相关行注释，或直接追加。示例：

```
defaults {
 user_friendly_names yes
 path_grouping_policy multibus
}

blacklist {
 wwid [本地磁盘WWID]
}
```

查看磁盘 WWID：

```
ll /dev/disk/by-id/
```

把本地磁盘加入黑名单，避免多路径接管系统盘。

### 6. 启动守护进程

```
systemctl start multipathd.service
```

修改配置后使其生效：

```
systemctl reload multipathd.service
```

### 7. 检查模块

```
lsmod | grep dm_multipath
```

### 8. 查看多路径设备

```
multipath -ll
```

输出中应出现聚合设备及其多条路径。使用 `fdisk -l` 时，针对存储卷请操作 `/dev/mapper/` 下的多路径设备，不要直接操作 `/dev/sdb`、`/dev/sdc` 等单路径设备，本地系统盘除外。

## 验证方法

- `multipath -ll` 显示设备状态为 active ready，路径数符合预期。
- `lsblk` 或 `fdisk -l` 可见 `/dev/mapper/` 下的聚合设备。
- 在测试环境断开一条链路，观察 I/O 是否继续，路径状态是否变化。
- 恢复链路后确认路径重新上线。

## 回退建议

- 停止并禁用相关服务：`systemctl stop multipathd.service`、`systemctl disable multipathd.service`。
- 恢复修改前的 `/etc/multipath.conf`，或移除新增配置。
- 必要时卸载软件包，并确认业务已切换到其他访问方式。
- 回退前确保无业务正在使用多路径设备。

## 常见问题

### user_friendly_names 是否应设为 yes

设为 yes 时，设备别名为 `mpathn`，但该名称仅在单节点唯一，不保证集群各节点一致。集群中若需名称统一，建议设为 no，且不要为设备配置 alias。使用 LVM 时通常不受影响。

### /dev/mapper 与 /dev/dm-n 区别

`/dev/mapper/` 下的设备用于业务访问；`/dev/dm-n` 仅供内部使用，不要直接引用。

### 修改配置后未生效

需执行 `systemctl reload multipathd.service` 或重启守护进程。

### 本地磁盘被多路径接管

检查 blacklist 中的 WWID 是否正确，确认后重新加载配置。

不同 Ubuntu 版本在软件包名称、服务单元、模板路径上可能存在差异，请以对应版本官方文档为准。
