如何为Docker部署的Elasticsearch容器设置http.max_content_length参数

1 核心问题：环境变量配置格式错误 #

Elasticsearch 7.x 版本通过环境变量传递配置参数时，需要遵循以下转换规则：

• 给配置项添加ES_前缀
• 把配置项中的.替换为_
• 所有字母转为大写
  你原来写的http.max_content_length=3000mb不符合环境变量的识别规则，所以没有生效。

2 正确的配置方式（二选一即可） #

方式1：使用符合规则的环境变量 #

修改docker-compose.yml中es01的environment配置，替换原来的http.max_content_length行：

environment:
  # 其他原有配置全部保留
  - ES_HTTP_MAX_CONTENT_LENGTH=3000mb

方式2：通过启动命令传递参数 #

直接在es01服务下添加command参数，优先级更高：

es01:
  image: docker.elastic.co/elasticsearch/elasticsearch:7.12.0
  container_name: es01
  # 新增下面这行即可，其他原有配置全部保留
  command: elasticsearch -Ehttp.max_content_length=3000mb

3 配置生效及验证步骤 #

• 修改完docker-compose.yml后，执行以下命令重启容器：

docker-compose down && docker-compose up -d

• 验证配置是否生效，执行以下API调用：

curl -u elastic:你的ES密码 http://你的ES地址/_cluster/settings?include_defaults=true | grep http.max_content_length

如果返回值为3000mb则说明配置生效。

4 其他排查点 #

• 确认Nginx的client_max_body_size配置确实生效：进入nginx-proxy容器执行nginx -T，检查对应站点的配置中是否存在client_max_body_size 0;，如果只在http块配置没有在server块覆盖也可以生效，但要确保没有其他配置覆盖该值。
• 确认你使用的Elasticsearch客户端没有单独设置请求体大小上限，部分客户端默认会限制单请求的最大大小，需要同步调整客户端配置。

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