---
title: "使用 Python Client 连接 Easysearch"
date: 0001-01-01
description: "Python 客户端快速入门，完成连接、CRUD 与搜索调用。"
summary: "Python 客户端快速入门 #  本页面帮助你快速跑通 Python 客户端连接 Easysearch 的完整流程。更深入的生产配置请参阅 Python 客户端详细指南。
推荐：Easysearch 官方 Python 客户端 #  Easysearch 提供了官方 Python 客户端 easysearch-py，基于 Apache 2.0 协议开源。
安装 #  # 从 GitHub Releases 安装（推荐） pip install https://github.com/infinilabs/easysearch-py/releases/download/v0.1.0/easysearch-0.1.0-py2.py3-none-any.whl # 如需 async/await 支持 pip install "easysearch[async] @ https://github.com/infinilabs/easysearch-py/releases/download/v0.1.0/easysearch-0.1.0-py2.py3-none-any.whl" 建立连接 #  from easysearch import Easysearch es = Easysearch( ["https://localhost:9200"], http_auth=("admin", "your_password"), verify_certs=False, # 开发环境；生产环境请配置 CA 证书 timeout=30, ) # 验证连接 print(es.info()) 生产环境（使用 CA 证书） #  from ssl import create_default_context context = create_default_context(cafile="/path/to/root-ca."
---


# Python 客户端快速入门

本页面帮助你快速跑通 Python 客户端连接 Easysearch 的完整流程。更深入的生产配置请参阅 [Python 客户端详细指南]({{< relref "/docs/integrations/clients/python.md" >}})。

## 推荐：Easysearch 官方 Python 客户端

Easysearch 提供了官方 Python 客户端 [easysearch-py](https://github.com/infinilabs/easysearch-py)，基于 Apache 2.0 协议开源。

### 安装

```bash
# 从 GitHub Releases 安装（推荐）
pip install https://github.com/infinilabs/easysearch-py/releases/download/v0.1.0/easysearch-0.1.0-py2.py3-none-any.whl

# 如需 async/await 支持
pip install "easysearch[async] @ https://github.com/infinilabs/easysearch-py/releases/download/v0.1.0/easysearch-0.1.0-py2.py3-none-any.whl"
```

### 建立连接

```python
from easysearch import Easysearch

es = Easysearch(
    ["https://localhost:9200"],
    http_auth=("admin", "your_password"),
    verify_certs=False,       # 开发环境；生产环境请配置 CA 证书
    timeout=30,
)

# 验证连接
print(es.info())
```

#### 生产环境（使用 CA 证书）

```python
from ssl import create_default_context

context = create_default_context(cafile="/path/to/root-ca.pem")
es = Easysearch(
    ["https://easysearch-host:9200"],
    ssl_context=context,
    http_auth=("admin", "your_password"),
)
```

### 索引文档

```python
doc = {
    "title": "Easysearch 入门",
    "content": "分布式搜索引擎快速上手",
    "tags": ["搜索", "教程"],
    "views": 100,
}

resp = es.index(index="articles", id=1, body=doc)
print(resp["result"])  # created
```

### 搜索

```python
resp = es.search(
    index="articles",
    body={
        "query": {"match": {"title": "Easysearch"}},
    },
)

for hit in resp["hits"]["hits"]:
    print(f'{hit["_score"]:.2f}  {hit["_source"]["title"]}')
```

### 批量写入

```python
from easysearch.helpers import bulk

actions = [
    {"_index": "articles", "_id": i, "_source": {"title": f"文章 {i}", "views": i * 10}}
    for i in range(2, 102)
]

success, errors = bulk(es, actions)
print(f"成功写入 {success} 条")
```

---

## 备选：使用 elasticsearch-py 兼容连接

Easysearch 兼容 Elasticsearch 7.10 API，也可以使用 `elasticsearch-py` 7.10.x 客户端。

```bash
pip install elasticsearch==7.10.1
```

```python
from elasticsearch import Elasticsearch

es = Elasticsearch(
    ["https://localhost:9200"],
    http_auth=("admin", "your_password"),
    verify_certs=False,
    timeout=30,
)
```

> 使用兼容客户端时，API 调用方式相同，但导入路径为 `from elasticsearch import Elasticsearch`，helpers 为 `from elasticsearch.helpers import bulk`。

## 注意事项

| 事项 | 说明 |
|------|------|
| 推荐客户端 | **`easysearch-py`**（官方客户端，包名 `easysearch`） |
| 兼容客户端 | `elasticsearch==7.10.1` 也可正常使用 |
| 证书 | 开发环境可 `verify_certs=False`；生产环境应配置 CA 证书 |
| 多节点 | 传入列表 `["https://node1:9200", "https://node2:9200"]` |

## 相关文档

- [easysearch-py GitHub](https://github.com/infinilabs/easysearch-py)
- [Python 客户端完整指南]({{< relref "/docs/integrations/clients/python.md" >}})：聚合、更新删除、连接池等完整用法
- [使用 Curl 访问 Easysearch]({{< relref "./curl.md" >}})
- [入门教程]({{< relref "../tutorial.md" >}})