Docker中CGROUP_CONF配置无效：内存CPU限制失效问题排查

架构老林

2026-8-4

问题原因解析

首先明确：你的配置方法本身不符合Docker的资源限制规则，和Debian 11主机、node:16-alpine镜像本身是否支持cgroup无关。

Docker并没有内置对CGROUP_CONF这个自定义环境变量的解析逻辑，容器不会自动读取这个变量来配置内存和CPU限制，所以不管你在Dockerfile里怎么定义这个ENV，都不会生效。
容器的资源限制需要通过Docker的启动参数或compose配置来设置，正确的方式包括：
- 用docker run命令启动时直接指定：
```
docker run -m 75% --cpus 0.1 your-node-api-image
```
- 用Docker Compose的话，在配置文件中添加资源限制：
```
services:
  node-api:
    image: node:16-alpine
    deploy:
      resources:
        limits:
          memory: 75%
          cpus: '0.1'
```
额外说明：Debian 11默认采用cgroup v2，node:16-alpine镜像完全支持cgroup机制，两者本身不存在兼容性问题，问题核心是你用错了配置方式。