Laradock中集成Laravel Scout与MeiliSearch的容器连接被拒问题

Docker容器内部的localhost指向的是容器自身的网络环境，而非运行Docker服务的宿主机，这是该连接报错的本质原因：你在本地bash里访问localhost:7700命中的是宿主机映射出来的MeiliSearch端口，但进入workspace容器后，localhost指代的是workspace容器自己的7700端口，这个端口没有任何服务监听，自然会返回Connection refused。

方案1：使用Laradock内置Docker服务名寻址（最稳定，推荐） #

• 确认Laradock根目录下的.env文件已开启MeiliSearch服务：设置MEILISEARCH=true
• 重启对应服务让两个容器加入同一个默认Docker网络：
  在Laradock目录下执行命令：docker-compose up -d workspace meilisearch
• 修改Laravel项目环境配置，把MeiliSearch的Host地址从http://localhost:7700替换为Docker内置服务名地址：
  在项目根目录.env文件中配置：MEILISEARCH_HOST=http://meilisearch:7700
  同网络下的Docker容器会自动把meilisearch这个域名解析到对应服务的容器内网IP，不需要额外配置hosts。

方案2：通过宿主机Docker网关地址访问（适合MeiliSearch独立部署场景） #

如果你的MeiliSearch不是Laradock内置服务，是独立运行的Docker容器，不需要把服务迁入Laradock网络的话：

• 保持MeiliSearch端口在宿主机的7700端口正常映射
• 把Laravel项目的MEILISEARCH_HOST配置为Docker默认桥接网关地址：http://172.17.0.1:7700
  这个地址在所有Docker容器内都会映射到宿主机的网络接口，可以直接访问宿主机上所有已对外暴露的端口。
• 如果需要把独立运行的MeiliSearch容器加入Laradock网络：
  在宿主机执行命令：docker network connect laradock_default <你的MeiliSearch容器ID/名称>，之后同样可以直接用http://meilisearch:7700做服务地址。

所有配置改完后，进入workspace容器执行连通性测试：

1. 进入workspace容器命令行：docker-compose exec workspace bash
2. 执行健康检查命令：curl http://meilisearch:7700/health
3. 返回{"status":"available"}即代表连接打通，可以正常初始化Scout的MeiliSearch驱动。

• 不要使用宿主机局域网IP（如192.168.x.x）作为MeiliSearch的Host地址，这类地址在办公网络、家庭网络切换时会失效，稳定性远低于Docker内置服务名寻址
• 如果workspace容器内配置了全局HTTP代理，需要把meilisearch域名、172.17.0.1地址加入代理的NO_PROXY白名单，避免代理拦截内网请求

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