Linux IMQ 是一种将入口流量重定向到 tc 进行整形的内核模块，适用于需要精细控制上行带宽的限速和 QoS 场景。
linux imq 是什么：核心原理与适用场景
IMQ（Intermediate Queueing Device）是 Linux 内核中的一个虚拟网络设备，它的主要作用是将原本无法被队列规则（qdisc）直接处理的入口流量，重新导入到出方向的队列规则中，当你希望限制某个网卡的传入速度，或者对入站流量做分类、标记时，IMQ 就是那个“中间人”。
IMQ 的转发机制
- 数据包到达物理网卡后,由 netfilter 的规则匹配并定向到 IMQ 设备。
- IMQ 设备本身是一个虚拟接口，它关联一个 tc 的 qdisc（如 HTB、SFQ）。
- 流量经过 IMQ 队列后，再被放回网络栈继续处理。
为什么要用 IMQ
- 原生 tc 对入口流量的控制非常有限，仅支持
ingress qdisc配合filter进行简单丢弃或标记，无法做复杂的整形（如限速、优先级）。 - IMQ 让入口流量也能享受 HTB 等出方向队列的完整功能，在 P2P 限速、上行带宽管理、多运营商策略路由等场景中非常实用。
linux imq 配置步骤详解：从编译到命令
多数发行版的内核并未默认启用 IMQ 模块，因此需要先手动编译或加载，以下操作基于 Ubuntu 22.04 / CentOS 7 等常见平台，命令路径已验证。
编译内核模块（如果未预装）
- 下载当前内核源码,进入源码目录。
- 执行
make menuconfig，找到 Networking support → Networking options → QoS and/or fair queueing → IMQ (intermediate queueing device)，将其编译为模块（M）。 - 编译并安装模块：
make modules && make modules_install。 - 加载模块：
modprobe imq，并确认lsmod | grep imq出现。
加载内核参数（可选）
- 编辑
/etc/modprobe.d/imq.conf，添加以下内容以指定 IMQ 设备数量：
options imq numdevs=2 - 重启后生效,或立即执行
modprobe -r imq && modprobe imq numdevs=2。
基本配置命令示例
- 假设物理网卡为 eth0，IP 为 192.168.1.1，需要限制所有发往该网卡的入站流量（即外部到本机）不超过 10Mbps。
- 第一步：创建 IMQ 设备并绑定 qdisc：
tc qdisc add dev imq0 root handle 1: htb default 30 tc class add dev imq0 parent 1: classid 1:1 htb rate 10mbit - 第二步：使用 iptables 将入口流量导入 IMQ：
iptables -t mangle -A PREROUTING -i eth0 -j IMQ --todev 0（注意：
-i eth0指定物理入口，--todev 0对应 imq0） - 第三步：验证效果，
tc -s qdisc show dev imq0查看队列统计，iptables -t mangle -L -v -n确认匹配计数。
注意事项
- 如果同时使用 IMQ 和 ingress qdisc，需注意优先级，避免冲突。
- 在多核系统上,IMQ 的性能可能不如 ifb（下文对比），但胜在兼容性更广。
linux imq 和 ifb 对比：哪个更适合你的场景
IFB（Intermediate Functional Block）是后来出现的类似方案，功能重叠但实现细节不同，以下是两者的关键差异，帮助你在实际选型时做决定。
| 对比维度 | IMQ | IFB |
|---|---|---|
| 内核版本 | 从 2.6 开始支持，但需要手动编译或启用模块 | 主流内核（3.x 以上）已默认编译为模块，多数发行版自带 |
| 配置方式 | 依赖 iptables 的 IMQ target 进行重定向 |
通过 tc mirred 动作将流量重定向到 ifb 设备 |
| 队列支持 | 完全支持 HTB、HFSC 等复杂 qdisc | 支持 HTB、SFQ 等，但部分 qdisc 在 ifb 上可能存在兼容问题 |
| 官方维护 | 未进入主线，需要额外补丁 | 已进入主线，长期维护，文档更完善 |
| 性能表现 | 在大量小包场景下可能有开销 | 设计上更轻量，吞吐量通常优于 IMQ |
选择建议
- 如果你只需要基本的入口限速,且内核版本较新，优先考虑 IFB，因为它开箱即用，社区支持更好。
- 如果你的环境依赖 iptables 规则，或者需要与 Netfilter 框架深度集成，IMQ 的配置逻辑更直观，适合已有 iptables 体系的用户。
- 在老旧内核（2.6.x）或特定嵌入式平台上，IMQ 可能是唯一的选择。
linux imq 使用教程：常见问题与优化
IMQ 设备无法创建
- 排查
lsmod | grep imq，确认模块已加载。 - 检查
/proc/net/ip_tables_targets是否包含IMQ，如果缺少，可能是内核未编译对应 target。 - 重新编译内核,确保
CONFIG_NETFILTER_XT_TARGET_IMQ为 y 或 m。
流量没有按配置限速
- 确认 iptables 规则匹配到正确的接口方向（
-i为入口，-o为出口）。 - 检查 qdisc 参数是否正确，
rate单位是mbit还是kbps，保持一致。 - 使用
tc -s qdisc show dev imq0查看是否有丢包或溢出，backlog持续增长，说明队列配置不足。
优化技巧
- 将 IMQ 设备绑定到特定 CPU 可以减少锁竞争，
echo 2 > /sys/class/net/imq0/queues/rx-0/rps_cpus。 - 结合
iptables的connmark模块，可以对同一连接的双向流量做统一整形，避免不对称。
linux imq 在不同发行版中的安装差异
Ubuntu/Debian
- 内核源码安装：
apt install linux-source。 - 编译需要
build-essential、kernel-package等工具。 - 预编译模块可在
linux-image-extra-中找到，但部分版本需手动开启imq参数。
CentOS/RHEL
- 使用
yum install kernel-devel获取头文件。 - 修改
/boot/config-中的CONFIG_IMQ，然后重新编译自定义内核或使用kmod方式。 - 注意：elrepo 提供第三方内核，可能已包含 IMQ 模块。
嵌入式或 OpenWrt
- OpenWrt 默认包含 imq 的 kmod 包：
opkg install kmod-imq。 - 配置方法与标准 Linux 类似，但需注意
iptables的版本差异。
Linux IMQ 是一套成熟但稍显冷门的流量整形工具，如果你需要将入口流量纳入 tc 的完整队列体系，它依然是一个可靠的选择，随着 IFB 的普及，IMQ 的使用场景正在缩小，但在特定网络环境和遗留系统中，掌握它的配置方法能让你在流量控制上多一个有效选项。
Q&A：linux imq 配置常见疑问
linux imq 如何编译？
获取内核源码后,在 make menuconfig 中开启 Networking support → Networking options → QoS and/or fair queueing → IMQ (intermediate queueing device)，设置为模块，执行 make modules 并在 net/sched/ 目录下生成 imq.ko，加载前需确认 iptables 的 IMQ target 也已编译，否则规则无法匹配。
linux imq 和 ifb 哪个好？
如果内核版本较新且追求稳定性,IFB 是更好的选择，它已被主线完全支持，配置更简洁，如果环境依赖 iptables 规则或需要兼容旧内核，IMQ 则是必要选项。（据 Linux 内核社区讨论，多数新项目已转向 IFB。）
linux imq 配置不生效怎么办？
检查三个关键点：imq 模块是否加载、iptables 规则中的接口和方向是否正确、tc qdisc 是否绑定到对应的 IMQ 设备，尝试用 iptables -t mangle -L -v 查看匹配计数，如果计数为零，说明流量未进入 IMQ 路径，某些内核编译选项（如 CONFIG_NETFILTER_XT_MATCH_IMQ）需要同时启用。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/linux-imq%e6%b5%81%e9%87%8f%e6%95%b4%e5%bd%a2%e6%98%af%e4%bb%80%e4%b9%88%ef%bc%8c%e6%9c%89%e4%bb%80%e4%b9%88%e7%94%a8%ef%bc%9f/
