MacOS Catalina下docker-compose启动web服务的OCI运行时sysctl报错

该报错和项目本身的Dockerfile、Compose业务配置无直接关联，是特定版本环境下的引擎兼容问题，触发链路完全明确：

• Docker 20.10.0 版本开始，容器引擎默认会在初始化阶段自动调整非特权端口绑定阈值，调整方式就是向运行环境的/proc/sys/net/ipv4/ip_unprivileged_port_start路径写入参数值0，允许容器内普通用户绑定1024以下的特权端口。
• 当前使用的Docker 20.10.5 版本，在MacOS Catalina上内置的Linuxkit轻量内核存在路径缺失问题，系统中根本不存在ip_unprivileged_port_start对应的proc文件，强制写入操作自然会抛出文件不存在的OCI运行时错误。
• 即使你启动的web服务映射的是8000端口，本来不需要触发特权端口调整逻辑，引擎的默认初始化流程也是强制执行的，无论业务配置是什么都会走到这一步。

• 显式覆盖默认sysctl规则：在docker-compose.yml的web服务配置中新增sysctls配置块，将端口阈值的调整动作限制在容器自身的网络命名空间内，绕开宿主机内核的路径缺失问题。修改后的核心配置片段：

  services:
    web:
      build: .
      command: python manage.py runserver 0.0.0.0:8000
      volumes:
        - .
      ports: 
        - "8000:8000"
      env_file: 
        - ./.env
      sysctls:
        net.ipv4.ip_unprivileged_port_start: 0
  

  配置生效原理：显式声明sysctls参数后，Docker会跳过对宿主机proc路径的写入操作，转而在容器独立网络栈中设置该参数，完全适配当前缺失proc路径的内核环境。
• 升级Docker Desktop到稳定兼容版本：20.10.5是MacOS Catalina环境下的已知问题版本，升级到20.10.11及以上稳定版后，内置的Linuxkit内核会补全缺失的proc路径，默认的初始化流程可以正常执行，无需修改项目配置。
• 应急降级方案：如果暂时无法升级Docker版本，可以将Docker引擎回退到20.10.2及更早版本，该版本还未加入强制自动调整非特权端口阈值的默认逻辑，不会触发对应的sysctl写入操作。

内容的提问来源于stack exchange，提问作者Rodragon