模块流解决什么问题
传统软件仓库里一个软件同一时间只有一个版本可选，而实际环境常需要并存多个版本，例如一台机器装较新的运行时尚，另一台仍需兼容旧应用。模块化仓库把软件按「流」组织，同一软件的不同版本各自成流，机器通过启用某个流来确定安装哪个版本。装出来的版本与预期不符时，先检查启用的流往往能直接找到原因。
基本信息
| 适用平台 | 使用模块化仓库的 RHEL 系发行版及其兼容发行版 |
|---|---|
| 语法 | dnf module list / enable / disable / reset / switch-to / install |
| 典型软件 | 运行时语言、Web 服务器等有多个并行版本需求的组件 |
| 权限要求 | 查看可普通用户，启用与安装需要特权 |
典型使用场景
- 同一批服务器上要部署不同版本的应用，需要选择对应版本流
- 安装后发现版本比预期低，确认是否默认流在起作用
- 从旧版本流升级到新版本流，并评估影响范围
- 排查依赖冲突，确认模块流是否与已有软件包互斥
- 把选定的流固定下来并记录，避免环境漂移
查看与启用
查看与启用
sudo dnf module list php # 列出可用流及其状态（启用中或禁用）
sudo dnf module list --enabled # 只看当前已启用的流
sudo dnf module info php:8.2 # 查看某个流的详细内容与依赖
sudo dnf module enable php:8.2 # 启用指定流
sudo dnf module install php:8.2/standard # 按流安装指定的软件包集合
php -v # 安装后核对实际版本切换与重置
切换与重置
sudo dnf module reset php # 重置该软件的流状态
sudo dnf module enable php:8.3 # 再启用目标流
sudo dnf distro-sync # 同步到新流对应的版本，注意变更量
sudo dnf module list php # 复核状态
dnf history list | head # 记录本次变更，便于回滚对照子命令读法
| 子命令 | 作用 | 注意 |
|---|---|---|
| list | 列出可用流与状态 | 先看清有哪些流再动手 |
| info | 查看流的详细内容与依赖关系 | 切换前用它评估影响面 |
| enable | 启用某个流 | 启用后安装才会取到对应版本 |
| reset | 清除当前流的选择状态 | 会回到发行版默认行为 |
| switch-to | 直接切换到另一个流 | 与重置后启用效果类似，语义更直接 |
| install | 按流安装软件包集合 | 集合名写错会装到非预期内容 |
切换流会影响依赖该流的所有软件包集合，可能触发大量包版本变化；生产环境先在测试机演练，并留好回滚与变更记录。
实施建议
- 启用流后立即核对实际安装版本，确认与预期一致
- 把选定的流写进部署文档与配置管理代码，避免逐台手工设置
- 切换前先看该流的依赖与影响范围，并预留变更窗口
- 变更后检查依赖该组件的应用是否正常启动
- 保留操作历史，出现问题时能快速定位并回退
重置流会回到发行版默认选择，已有环境若依赖非默认流，重置后再次安装可能得到更低版本，操作前先确认默认流是什么。