Docker容器Entrypoint通过CLI传递参数的数量及限制问题

好问题！其实Docker本身并没有专门为docker run给Entrypoint传递参数设置硬性限制，但实际能传多少参数、CLI命令最长能到多少，得看几个底层的限制因素：

• 操作系统的命令行总长度限制（ARG_MAX）
  每个操作系统都有一个名为ARG_MAX的系统参数，它定义了通过exec系统调用启动进程时，参数列表加上环境变量的总长度上限。在Linux系统里，你可以用getconf ARG_MAX命令查看具体数值，通常这个值在128KB到2MB之间（不同发行版会有差异）。
  要注意的是，这个限制是参数+环境变量的总大小，如果你的Entrypoint程序本身或者容器内的环境变量已经占用了不少空间，那能传递的参数数量就会相应减少。

• Shell解析的限制（仅针对shell形式的Entrypoint）
  如果你在Dockerfile里用的是shell形式的Entrypoint（比如ENTRYPOINT ["sh", "-c", "myapp"]），那参数会先经过shell解析再传给目标程序，这时候还要受shell自身的命令行长度限制。比如bash的限制通常和系统ARG_MAX挂钩，但还会有额外的解析层面的约束。
  这种情况下，如果你需要传递大量参数，建议改用exec形式的Entrypoint（比如ENTRYPOINT ["myapp"]），这样参数会直接传递给目标程序，绕开shell的额外限制。

• Docker客户端与守护进程的通信限制
  Docker客户端会把docker run的命令参数通过API发送给守护进程，虽然Docker本身没有刻意限制这个传输的大小，但如果参数特别多或者单个参数超长，极端情况下可能会碰到HTTP请求的大小限制——不过这个场景非常少见，日常使用基本不会遇到。

实用小建议 #

如果确实需要传递大量数据或者超多参数，别硬塞在CLI里，更可靠的方式是：

• 把参数写入文件，通过挂载卷的方式把文件传到容器内，让Entrypoint程序读取文件内容
• 合理使用环境变量（但也要注意环境变量也受ARG_MAX限制）

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