使用Typesense搭建一个http api调用的支持中文全文搜索引擎服务

使用Typesense搭建一个http api调用的全文中搜索引擎服务

Typesense 是一个高性能、开源的全文搜索引擎（类似 Algolia 的开源替代方案）。

由于 Typesense 是用 C++ 编写的单文件二进制程序，它的安装非常简单。最推荐的方式是使用 Docker，也可以直接下载二进制文件。

以下是详细的安装及通过 curl 进行基本操作的指南。

一、 安装 Typesense

方法 1：使用 Docker (最推荐)

这是最快的方法。你需要设置一个数据目录和一个 API Key。

# 创建一个文件夹存放数据
mkdir /tmp/typesense-data

# 启动容器
docker run -p 8108:8108 -v /tmp/typesense-data:/data typesense/typesense:26.0 \
  --data-dir /data \
  --api-key=xyz123 \
  --enable-cors

参数说明：

-p 8108:8108: 默认端口。

--api-key=xyz123: 这是你后续所有 curl 操作需要的验证令牌。

方法 2：直接下载二进制 (Linux/macOS)

如果你不想用 Docker：

# 下载 (以 Linux 为例，版本号请参考官网最新版)
wget https://dl.typesense.org/releases/26.0/typesense-server-26.0-linux-amd64.tar.gz
tar -xzf typesense-server-26.0-linux-amd64.tar.gz
#mkdir data
# 运行
./typesense-server --data-dir ./data --api-key=xyz123 --listen-port 8108

二、 通过 curl 使用 Typesense

Typesense 的所有 API 调用都需要在 Header 中携带 X-TYPESENSE-API-KEY。

1. 检查运行状态

curl "http://localhost:8108/health"

2. 创建集合 (Collection / Schema)

在 Typesense 中，你必须先定义“集合”的结构（类似表结构）。从 Typesense v0.25+ 开始，原生集成 jieba 中文分词器（无需插件）。

curl "http://localhost:8108/collec...

点击查看剩余70%