Docker容器中Django连接OpenSearch超时问题排查

一、IP配置错误排查 #

• 容器间通信的正确寻址方式
  不要用Droplet的公网IP（123.456.78.9）作为OpenSearch的连接地址——容器访问公网IP会走外部网络链路，容易被防火墙拦截。正确做法：
  • 若两者通过同一Docker Compose部署，直接用OpenSearch的服务名称（比如opensearch）作为主机名，Docker会自动解析到容器内部IP。
  • 若为单独部署的容器，先获取OpenSearch容器的内部IP：

    docker inspect opensearch-container-name | grep "IPAddress"
    

    然后在Django的OPENSEARCH_DSL配置中替换为该内部IP。
  • 验证方法：在Django容器内执行curl http://<open-search-internal-ip>:9200或curl http://<opensearch-service-name>:9200，确认是否能返回OpenSearch的响应信息。

二、防火墙限制排查 #

1. DigitalOcean云防火墙
   登录DigitalOcean控制台，检查Droplet关联的云防火墙规则：
   • 公网能访问9200不代表容器内部请求能通过——云防火墙可能仅允许外部入站流量，拦截了容器向公网IP发起的出站请求。
   • 添加入站规则：允许来自Docker默认私有网段（通常为172.17.0.0/16、192.168.0.0/16）的流量访问9200端口。
2. Droplet内部防火墙（ufw/iptables）
   • 登录Droplet终端，执行ufw status查看规则，若存在拦截，添加允许内部网段访问的规则：

     ufw allow from 172.17.0.0/16 to any port 9200
     

   • 执行iptables -L -n检查iptables规则，确认是否有针对9200端口的DROP/REJECT规则，必要时调整。

三、OpenSearch绑定地址配置 #

检查OpenSearch的opensearch.yml配置文件：

• 确认network.host设置为0.0.0.0（允许所有地址访问），若仅绑定了公网IP，容器内部可能无法通过内部IP访问。修改后重启OpenSearch容器即可。

四、Docker网络模式排查 #

若Django与OpenSearch不在同一Docker网络，容器间无法直接通信：

• 查看Django容器所在网络：

  docker inspect myapplication-webapp | grep "Networks"
  

• 查看OpenSearch容器所在网络：

  docker inspect opensearch-container-name | grep "Networks"
  

• 若网络不同，将Django容器加入OpenSearch的网络：

  docker network connect <opensearch-network-name> myapplication-webapp
  

  之后用OpenSearch服务名即可正常通信。

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