下载与安装

Vchord 扩展套件（vchord、vchord_bm25 与 pg_tokenizer）已面向 16 个 Linux 发行版与 CPU 架构目标（el8、el9、el10、d12、d13、u22、u24、u26 × x86_64 / aarch64）以及 PostgreSQL 14、15、16、17、18 五个大版本构建并发布原生 RPM 与 DEB 软件包（共计 240 个预编译二进制包）。

快速安装指南

1 · 使用 PIG 包管理器安装（推荐）

我们强烈推荐使用由 PGSTY 社区维护的 PostgreSQL 专属包管理器 pig 安装 Vchord 扩展套件。pig 是零依赖的静态编译 Go 命令行工具，能够自动识别当前 Linux 发行版与 CPU 架构、一键配置 PGDG 与 Pigsty 软件源（内置中国大陆镜像加速），并自动处理 pgvector 等扩展依赖关系。

# 1. 使用中国大陆镜像安装 pig 命令行包管理器
curl -fsSL https://repo.pigsty.cc/pig | bash

# 2. 添加 PGDG + Pigsty PGSQL 软件仓库（自动启用中国大陆 CDN 镜像）并刷新缓存
pig repo add pgsql -u -r china

# 3. 安装 vchord、vchord_bm25 与 pg_tokenizer（自动匹配当前 PG 版本，或通过 -v 18 指定）
pig install vchord vchord_bm25 pg_tokenizer

# 1. 安装 pig 命令行包管理器
curl -fsSL https://repo.pigsty.io/pig | bash

# 2. 添加 PGDG + Pigsty PGSQL 软件仓库并刷新缓存
pig repo add pgsql -u

# 3. 安装 vchord、vchord_bm25 与 pg_tokenizer（可通过 -v 18 显式指定 PostgreSQL 大版本）
pig install vchord vchord_bm25 pg_tokenizer

# 配置好 Pigsty APT 软件源后，按 PostgreSQL 大版本直接安装（以 PG 18 为例）：
sudo apt-get update
sudo apt-get install -y \
  postgresql-18-vchord \
  postgresql-18-vchord-bm25 \
  postgresql-18-pg-tokenizer

# 配置好 Pigsty YUM 软件源后，按 PostgreSQL 大版本直接安装（以 PG 18 为例）：
sudo dnf install -y \
  vchord_18 \
  vchord_bm25_18 \
  pg_tokenizer_18

2 · 配置预加载库并启用扩展

三个扩展均需在 shared_preload_libraries 中注册动态库并重启 PostgreSQL 服务后，方可在数据库内执行 CREATE EXTENSION：

-- 1. 通过 ALTER SYSTEM 将扩展动态库写入 postgresql.auto.conf
ALTER SYSTEM SET shared_preload_libraries = 'vchord.so, vchord_bm25.so, pg_tokenizer.so';

重启 PostgreSQL 实例（例如 sudo systemctl restart postgresql-18 或 pig pg restart），随后连接目标数据库启用扩展：

-- 2. 在目标数据库中创建扩展（CASCADE 会为 vchord 自动启用 pgvector 依赖）
CREATE EXTENSION IF NOT EXISTS vchord CASCADE;
CREATE EXTENSION IF NOT EXISTS vchord_bm25 CASCADE;
CREATE EXTENSION IF NOT EXISTS pg_tokenizer CASCADE;

3 · Docker 容器镜像与 GitHub 发行版

如果用于本地快速评估、CI 流水线或容器化部署，可以直接运行已预装并配置好预加载库的官方 Docker 镜像：

# 预装并启用 PostgreSQL 18 + pgvector + vchord + vchord_bm25 + pg_tokenizer
docker run -d \
  --name vchord-suite \
  -e POSTGRES_PASSWORD=postgres \
  -p 5432:5432 \
  tensorchord/vchord-suite:pg18-latest

# 预装并启用 PostgreSQL 18 + pgvector + vchord v1.1.1
docker run -d \
  --name vchord-postgres \
  -e POSTGRES_PASSWORD=postgres \
  -p 5432:5432 \
  ghcr.io/tensorchord/vchord-postgres:pg18-v1.1.1

1 · vchord —— 可扩展向量检索引擎

vchord（v1.1.1）是套件的核心向量相似性检索扩展，提供 vchordrq（RaBitQ 倒排索引）与 vchordg（单层图索引）两种访问方法，依赖基础扩展 vector（pgvector）。

可用性矩阵 (vchord)

软件包下载列表 (vchord)

2 · vchord_bm25 —— 原生 BM25 全文排序索引

vchord_bm25（v0.3.0）在 PostgreSQL 内提供原生 Okapi BM25 全文相关性排序索引（USING bm25）与 Block-WeakAnd 块级剪枝扫描（<&> 操作符）。

可用性矩阵 (vchord_bm25)

软件包下载列表 (vchord_bm25)

3 · pg_tokenizer —— 多语言文本分析与分词器

pg_tokenizer（v0.1.1）提供可组合的数据库内多语言文本分析流水线、预分词器（Unicode、结巴中文、Lindera 日文）、词干提取、停用词/同义词过滤器与词表编码模型。

可用性矩阵 (pg_tokenizer)

软件包下载列表 (pg_tokenizer)

签名校验与构建仓库

Pigsty PGSQL 软件仓库中的所有 RPM 与 DEB 软件包均使用 GPG 密钥签名；通过 pig repo add pgsql 完成配置后，dnf 与 apt 会自动校验签名完整性。所有软件包均由开源构建规范透明构建：