NVMe 驱动自动加载配置指南

博主： admin
发布时间：2026 年 03 月 16 日
1 次浏览
暂无评论
3662字数
分类： Linux Kernel 运维技术文档

# NVMe 驱动自动加载配置指南

# 一、概述

## 1. 简介
### A. 是什么
NVMe（Non-Volatile Memory Express）是一种专为闪存存储设计的通信协议和驱动接口。Linux 内核 6.12.63 已内置完整的 NVMe 驱动模块，但默认情况下未配置为启动时自动加载。

### B. 为什么需要配置
虽然现代 Linux 系统支持 udev 按需自动加载模块，但显式配置自动加载有以下优势：
- 确保 NVMe 设备驱动在设备插入前已就绪，避免竞态条件
- 系统启动时提前加载驱动，减少设备识别延迟
- 明确的配置便于系统维护和故障排查

### C. 配置后效果
- 系统启动时自动加载 nvme 及其依赖模块
- 插入 NVMe 设备后系统可立即识别
- 可通过 lsmod、lsblk 等命令快速验证模块状态

## 2. 前置知识
### A. 必备技能
- 基本 Linux 命令行操作
- 了解 systemd 管理机制

### B. 推荐知识
- 了解 Linux 内核模块管理
- 熟悉 systemd 配置目录结构

# 二、系统环境

## 1. 系统要求
- Linux 内核版本：6.12.63+（已内置 NVMe 驱动）
- systemd 管理的系统（大多数现代 Linux 发行版）
- root 权限或 sudo 访问权限

## 2. 模块依赖关系

```mermaid
graph TD
    A[nvme] -->|依赖| B[nvme_core]
    B -->|依赖| C[nvme_auth]
    D[modules-load配置] -->|加载| A
```

![NVMe 模块依赖关系](https://static.op123.ren/static/08/083bc7389032095e.svg)

# 三、配置原理

## 1. systemd modules-load 机制

systemd-modules-load.service 是 systemd 提供的一个服务，负责在系统启动早期阶段自动加载内核模块。该服务会读取 /etc/modules-load.d/ 目录下的配置文件，并将列出的模块传递给 modprobe 命令进行加载。

## 2. 配置目录结构

```mermaid
graph LR
    A[/etc/modules-load.d] -->|优先级高| B[nvme.conf]
    C[/usr/lib/modules-load.d] -->|优先级低| D[系统默认配置]
    E[systemd-modules-load.service] -->|读取| A
    E -->|读取| C
```

![systemd modules-load 配置目录](https://static.op123.ren/static/ea/ea7d275ea535d604.svg)

# 三、配置原理

## 1. systemd modules-load 机制

## 2. 配置目录结构

/etc/modules-load.d/ 目录中的配置文件优先级高于 /usr/lib/modules-load.d/，系统会自动合并两个目录中的配置，冲突时以 /etc/ 目录为准。

# 四、配置步骤

## 1. 创建模块自动加载配置文件

创建 /etc/modules-load.d/nvme.conf 文件，添加 nvme 模块：

```bash
sudo tee /etc/modules-load.d/nvme.conf > /dev/null << 'EOF'
# NVMe 驱动模块自动加载配置
# 添加 nvme 模块以确保 NVMe 设备驱动在启动时加载
# nvme 模块会自动加载依赖的 nvme-core 模块

nvme
EOF
```

## 2. 配置文件说明

配置文件内容简洁，仅包含模块名称 nvme。模块加载时会自动处理依赖关系：

| 模块名 | 大小 | 说明 |
|-------|------|------|
| nvme | 约 57KB | NVMe 主驱动模块 |
| nvme_core | 约 225KB | NVMe 核心功能模块（自动加载） |
| nvme_auth | 约 24KB | NVMe 认证模块（自动加载） |

## 3. 可选扩展配置

如需支持 NVMe over TCP 或 RDMA 传输，可在配置文件中添加额外模块：

```bash
# 编辑配置文件添加
sudo nano /etc/modules-load.d/nvme.conf

# 添加以下模块（按需选择）
nvme-tcp      # NVMe over TCP 传输
nvme-rdma     # NVMe over RDMA 传输
nvme-fabrics   # Fabric 传输核心模块
```

# 五、验证配置

## 1. 验证配置文件

使用 systemd-analyze 命令验证配置是否正确：

```bash
systemd-analyze cat-config modules-load.d/nvme.conf
```

预期输出显示配置文件路径和内容。

## 2. 重载 systemd 配置

```bash
sudo systemctl daemon-reload
```

## 3. 检查服务状态

```bash
sudo systemctl status systemd-modules-load.service --no-pager
```

服务状态应显示为 active（exited），表示模块加载服务已正常运行。

# 六、测试模块加载

## 1. 手动加载模块验证

使用 modprobe 手动加载模块测试：

```bash
sudo modprobe nvme
```

## 2. 检查已加载模块

```bash
lsmod | grep nvme
```

预期输出：
```
nvme                   57344  0
nvme_core             225280  1 nvme
nvme_auth              24576  1 nvme_core
```

## 3. 模块加载流程

```mermaid
sequenceDiagram
    participant A as 系统启动
    participant B as systemd-modules-load
    participant C as modprobe
    participant D as 内核

A->>B: 启动阶段
    B->>B: 读取 /etc/modules-load.d/*.conf
    B->>C: 调用 modprobe nvme
    C->>D: 加载 nvme 模块
    D->>C: 返回依赖 nvme_core
    C->>D: 加载 nvme_core
    D->>C: 返回依赖 nvme_auth
    C->>D: 加载 nvme_auth
    D-->>B: 模块加载完成
    B-->>A: 服务退出
```

![模块加载时序图](https://static.op123.ren/static/b7/b7e0c404fe9b3408.svg)

# 七、设备验证

## 1. 检查 NVMe 设备

系统重启后，插入 NVMe 设备，使用以下命令验证设备识别：

```bash
# 查看块设备
lsblk | grep nvme

# 或使用 nvme 命令（需安装 nvme-cli）
sudo nvme list
```

## 2. 设备识别成功标志

- lsblk 输出中显示 nvme 开头的设备（如 nvme0n1）
- dmesg 日志中显示 NVMe 设备识别信息
- /dev/nvme* 设备节点存在

## 3. 安装 nvme-cli 工具（可选）

如需查看详细的 NVMe 设备信息，可安装 nvme-cli：

```bash
# Ubuntu/Debian
sudo apt install nvme-cli

# CentOS/RHEL
sudo yum install nvme-cli

# Arch Linux
sudo pacman -S nvme-cli
```

# 八、故障排查

## 1. 模块加载失败

如果模块加载失败，检查以下事项：

| 问题排查 | 解决方案 |
|---------|---------|
| 模块不存在 | 确认内核版本包含 NVMe 驱动 |
| 配置文件语法错误 | 检查配置文件内容格式 |
| 权限不足 | 使用 sudo 或 root 权限操作 |

## 2. 设备未识别

如果设备插入后未识别：

```bash
# 检查内核日志
dmesg | grep -i nvme

# 检查模块是否加载
lsmod | grep nvme

# 检查硬件信息
sudo lspci | grep -i nvme
```

## 3. 常见问题

### A. 重启后模块未加载
确认配置文件位置正确，使用 systemd-analyze 验证配置。

### B. 设备识别慢
可能是 udev 按需加载导致延迟，确认配置生效后应解决。

### C. 多个 NVMe 设备
配置无需修改，驱动会自动支持多个 NVMe 设备。

# 九、总结

配置 NVMe 驱动自动加载的完整流程如下：

```mermaid
flowchart TD
    A[开始] --> B[创建配置文件]
    B --> C[验证配置语法]
    C --> D{验证通过?}
    D -->|否| E[修正配置]
    E --> C
    D -->|是| F[重载 systemd]
    F --> G[手动测试加载]
    G --> H{加载成功?}
    H -->|否| I[排查故障]
    I --> J[检查内核日志]
    J --> G
    H -->|是| K[重启系统]
    K --> L[验证自动加载]
    L --> M{设备识别正常?}
    M -->|是| N[配置完成]
    M -->|否| O[检查硬件连接]
    O --> L
```

![配置流程图](https://static.op123.ren/static/c0/c028c23786cb476a.svg)

***

## 参考资料

1. [systemd-modules-load.service(8) - Linux manual page](https://man7.org/linux/man-pages/man8/systemd-modules-load.service.8.html)
2. [modprobe(8) - Linux manual page](https://man7.org/linux/man-pages/man8/modprobe.8.html)
3. [NVMe Technical Specifications](https://nvmexpress.org/specifications/)

最后修改：2026 年 03 月 16 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

NVMe 驱动自动加载配置指南

admin • 2026 年 03 月 16 日

# NVMe 驱动自动加载配置指南

# 一、概述

### C. 配置后效果
- 系统启动时自动加载 nvme 及其依赖模块
- 插入 NVMe 设备后系统可立即识别
- 可通过 lsmod、lsblk 等命令快速验证模块状态

## 2. 前置知识
### A. 必备技能
- 基本 Linux 命令行操作
- 了解 systemd 管理机制

### B. 推荐知识
- 了解 Linux 内核模块管理
- 熟悉 systemd 配置目录结构

# 二、系统环境

## 1. 系统要求
- Linux 内核版本：6.12.63+（已内置 NVMe 驱动）
- systemd 管理的系统（大多数现代 Linux 发行版）
- root 权限或 sudo 访问权限

## 2. 模块依赖关系

```mermaid
graph TD
    A[nvme] -->|依赖| B[nvme_core]
    B -->|依赖| C[nvme_auth]
    D[modules-load配置] -->|加载| A
```

![NVMe 模块依赖关系](https://static.op123.ren/static/08/083bc7389032095e.svg)

# 三、配置原理

## 1. systemd modules-load 机制

## 2. 配置目录结构

![systemd modules-load 配置目录](https://static.op123.ren/static/ea/ea7d275ea535d604.svg)

# 三、配置原理

## 1. systemd modules-load 机制

## 2. 配置目录结构

/etc/modules-load.d/ 目录中的配置文件优先级高于 /usr/lib/modules-load.d/，系统会自动合并两个目录中的配置，冲突时以 /etc/ 目录为准。

# 四、配置步骤

## 1. 创建模块自动加载配置文件

创建 /etc/modules-load.d/nvme.conf 文件，添加 nvme 模块：

nvme
EOF
```

## 2. 配置文件说明

配置文件内容简洁，仅包含模块名称 nvme。模块加载时会自动处理依赖关系：

## 3. 可选扩展配置

如需支持 NVMe over TCP 或 RDMA 传输，可在配置文件中添加额外模块：

```bash
# 编辑配置文件添加
sudo nano /etc/modules-load.d/nvme.conf

# 添加以下模块（按需选择）
nvme-tcp      # NVMe over TCP 传输
nvme-rdma     # NVMe over RDMA 传输
nvme-fabrics   # Fabric 传输核心模块
```

# 五、验证配置

## 1. 验证配置文件

使用 systemd-analyze 命令验证配置是否正确：

```bash
systemd-analyze cat-config modules-load.d/nvme.conf
```

预期输出显示配置文件路径和内容。

## 2. 重载 systemd 配置

```bash
sudo systemctl daemon-reload
```

## 3. 检查服务状态

```bash
sudo systemctl status systemd-modules-load.service --no-pager
```

服务状态应显示为 active（exited），表示模块加载服务已正常运行。

# 六、测试模块加载

## 1. 手动加载模块验证

使用 modprobe 手动加载模块测试：

```bash
sudo modprobe nvme
```

## 2. 检查已加载模块

```bash
lsmod | grep nvme
```

预期输出：
```
nvme                   57344  0
nvme_core             225280  1 nvme
nvme_auth              24576  1 nvme_core
```

## 3. 模块加载流程

```mermaid
sequenceDiagram
    participant A as 系统启动
    participant B as systemd-modules-load
    participant C as modprobe
    participant D as 内核

![模块加载时序图](https://static.op123.ren/static/b7/b7e0c404fe9b3408.svg)

# 七、设备验证

## 1. 检查 NVMe 设备

系统重启后，插入 NVMe 设备，使用以下命令验证设备识别：

```bash
# 查看块设备
lsblk | grep nvme

# 或使用 nvme 命令（需安装 nvme-cli）
sudo nvme list
```

## 2. 设备识别成功标志

- lsblk 输出中显示 nvme 开头的设备（如 nvme0n1）
- dmesg 日志中显示 NVMe 设备识别信息
- /dev/nvme* 设备节点存在

## 3. 安装 nvme-cli 工具（可选）

如需查看详细的 NVMe 设备信息，可安装 nvme-cli：

```bash
# Ubuntu/Debian
sudo apt install nvme-cli

# CentOS/RHEL
sudo yum install nvme-cli

# Arch Linux
sudo pacman -S nvme-cli
```

# 八、故障排查

## 1. 模块加载失败

如果模块加载失败，检查以下事项：

## 2. 设备未识别

如果设备插入后未识别：

```bash
# 检查内核日志
dmesg | grep -i nvme

# 检查模块是否加载
lsmod | grep nvme

# 检查硬件信息
sudo lspci | grep -i nvme
```

## 3. 常见问题

### A. 重启后模块未加载
确认配置文件位置正确，使用 systemd-analyze 验证配置。

### B. 设备识别慢
可能是 udev 按需加载导致延迟，确认配置生效后应解决。

### C. 多个 NVMe 设备
配置无需修改，驱动会自动支持多个 NVMe 设备。

# 九、总结

配置 NVMe 驱动自动加载的完整流程如下：

![配置流程图](https://static.op123.ren/static/c0/c028c23786cb476a.svg)

***

## 参考资料

NVMe 驱动自动加载配置指南

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

搭建国内LabHub

CentOS 7.9 编译并使用rpm方式升级openssh9.6p1（包括后续更新9.8p1等）

一天从 redis 大 key 开始

安装eve-ng

重装ensp

HUATUO eBPF 云原生操作系统可观测性平台技术分析

与 LLM 对话如何改善思考能力

Fluid 与 S3FS 对接 S3 存储及性能测试

苹果向iPhone 5s等超上古机型发布iOS 12.5.8更新技术分析

nattimeout 项目技术解析

NVMe 驱动自动加载配置指南

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

NVMe 驱动自动加载配置指南

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款