QuasarDB容器部署后Python连接报Connection refused的原因排查

以下是几种常见的导致连接被拒绝的原因：

• 容器端口未正确映射
  QuasarDB默认使用2836端口提供服务，若启动容器时未添加端口映射参数，主机无法访问容器内的服务。检查你的docker run命令是否包含-p 2836:2836，正确的启动命令示例应为：docker run -p 2836:2836 quasardb/qdb-server。

• Python代码连接地址错误
  确认代码中的连接字符串是否正确：本地连接时应使用qdb://localhost:2836，若误写为容器内部IP（如172.x.x.x）或错误端口，主机无法建立连接。

• 容器内服务未完全就绪
  容器状态显示"正常"仅代表容器进程运行，不代表QuasarDB服务已完成初始化。可等待1-2分钟后重试，或进入容器执行qdb-admin status命令确认服务是否已启动完成。

• 主机防火墙/安全组拦截请求
  主机的防火墙或系统安全组可能拦截了2836端口的通信。检查防火墙规则，确保允许主机与容器之间通过2836端口进行数据传输。

• Docker网络配置异常
  若使用自定义Docker网络，需确认该网络配置允许主机访问容器；若使用host网络模式，需确保主机2836端口未被其他进程占用，且服务确实在该端口监听。

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