> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Qdrant 集群部署

## 要求

* 三台安装了 Docker 的虚拟机
* 已安装 Docker
  * [安装 Docker](https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository)
  * [以非 root 用户身份管理 Docker](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user)
* 在虚拟机上开放 6333 和 6335 端口
  * 6333：用于与 qdrant 节点进行外部通信的端口。
  * 6335：用于 qdrant 节点之间内部通信的端口。不要暴露给公众。

## 安装

### `QDRANT__SERVICE__API_KEY` 是必需的环境变量

你可以使用以下命令生成一个随机的 32 字节十六进制字符串：

```bash theme={null}
openssl rand -hex 32
```

复制并粘贴生成的字符串，替换 `docker-compose.yml` 文件中的 `#REPLACE_ME#`。

### \[第一台虚拟机] 为第一台虚拟机创建 `docker-compose.yml` 文件

* 将命令中的 `--uri` 选项替换为当前虚拟机地址

```bash theme={null}
version: "3.8"
services:
  qdrant:
    image: langgenius/qdrant:v1.7.3
    command: "./qdrant --uri 'http://dify-qdrant-node-01:6335'"
    network_mode: "host"
    restart: always
    volumes:
      - /data/qdrant/data/:/qdrant/storage
    environment:
      QDRANT__SERVICE__API_KEY: #REPLACE_ME#
      QDRANT__CLUSTER__ENABLED: 'true'
```

### \[第二台虚拟机] 为第二台虚拟机创建 `docker-compose.yml` 文件

* 将命令中的 `--bootstrap` 选项替换为第一台虚拟机地址，`--uri` 选项替换为当前虚拟机地址

```bash theme={null}
version: "3.8"
services:
  qdrant:
    image: langgenius/qdrant:v1.7.3
    command: "./qdrant --bootstrap 'http://dify-qdrant-node-01:6335' --uri 'http://dify-qdrant-node-02:6335'"
    network_mode: "host"
    restart: always
    volumes:
      - /data/qdrant/data/:/qdrant/storage
    environment:
      QDRANT__SERVICE__API_KEY: #REPLACE_ME#
      QDRANT__CLUSTER__ENABLED: 'true'
```

### \[第三台虚拟机] 为第三台虚拟机创建 `docker-compose.yml` 文件

* 将命令中的 `--bootstrap` 选项替换为第一台虚拟机地址，`--uri` 选项替换为当前虚拟机地址

```bash theme={null}
version: "3.8"
services:
  qdrant:
    image: langgenius/qdrant:v1.7.3
    command: "./qdrant --bootstrap 'http://dify-qdrant-node-01:6335' --uri 'http://dify-qdrant-node-03:6335'"
    network_mode: "host"
    restart: always
    volumes:
      - /data/qdrant/data/:/qdrant/storage
    environment:
      QDRANT__SERVICE__API_KEY: #REPLACE_ME#
      QDRANT__CLUSTER__ENABLED: 'true'
```

## 检查集群状态

登录其中一台虚拟机并运行以下命令来检查集群状态。

```bash theme={null}
curl -H 'api-key: <QDRANT__SERVICE__API_KEY>' localhost:6333/cluster | python3 -m json.tool
```

运行上述命令后，你应该看到以下示例输出：

```json theme={null}
{
    "result": {
        "status": "enabled",
        "peer_id": 2978525476254873,
        "peers": {
            "8497171801402828": {
                "uri": "http://172.206.68.136:6335/"
            },
            "2978525476254873": {
                "uri": "http://172.206.71.251:6335/"
            },
            "530461904384369": {
                "uri": "http://20.85.121.81:6335/"
            }
        },
        "raft_info": {
            "term": 1,
            "commit": 7,
            "pending_operations": 0,
            "leader": 530461904384369,
            "role": "Follower",
            "is_voter": true
        },
        "consensus_thread_status": {
            "consensus_thread_status": "working",
            "last_update": "2024-06-30T15:13:23.508350153Z"
        },
        "message_send_failures": {}
    },
    "status": "ok",
    "time": 8.7e-06
}
```

## 添加负载均衡器

* 部署 qdrant 集群后，你可以添加一个负载均衡器来分配请求到 qdrant 节点。
* 负载均衡器应配置为在 6333 端口上分配请求到 qdrant 节点。
* 6335 端口仅用于内部通信，无需暴露给公众。

## 参考资料

* [qdrant 分布式部署](https://qdrant.tech/documentation/guides/distributed_deployment/)