Skip to content

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.

fix(deploy): bump paradedb image to v0.25.11-pg17 (#4120)

LuckVd3c36cb19a2bb
diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml
index 39f9031b5..014404ede 100644
--- a/docker-compose.dev.yml
+++ b/docker-compose.dev.yml
@@ -2,7 +2,7 @@
services:
# 只启动依赖的基础设施服务
postgres:
- image: paradedb/paradedb:v0.22.6-pg17
+ image: paradedb/paradedb:v0.25.11-pg17
container_name: WeKnora-postgres-dev
ports:
- "${DB_PORT:-5432}:5432"
@@ -382,7 +382,7 @@ services:
# ---------------------------------------------------------------------------
# 复用 dev 已有的 ParadeDB 镜像,不额外拉 postgres 镜像
langfuse-db-init:
- image: paradedb/paradedb:v0.22.6-pg17
+ image: paradedb/paradedb:v0.25.11-pg17
container_name: WeKnora-langfuse-db-init-dev
depends_on:
postgres:
diff --git a/docker-compose.yml b/docker-compose.yml
index cfd23f4ab..dcf5539eb 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -541,7 +541,7 @@ services:
# 修改的PostgreSQL配置
postgres:
- image: paradedb/paradedb:v0.22.6-pg17
+ image: paradedb/paradedb:v0.25.11-pg17
container_name: WeKnora-postgres
environment:
- POSTGRES_USER=${DB_USER}
@@ -819,7 +819,7 @@ services:
# 一次性初始化脚本:在已有的 WeKnora-postgres 里创建 langfuse 数据库(幂等,数据库已存在则跳过)
# 复用 WeKnora-postgres 的 ParadeDB 镜像,避免多拉一个 postgres 镜像
langfuse-db-init:
- image: paradedb/paradedb:v0.22.6-pg17
+ image: paradedb/paradedb:v0.25.11-pg17
container_name: WeKnora-langfuse-db-init
depends_on:
postgres:
diff --git a/internal/application/repository/chunk_image_assets_test.go b/internal/application/repository/chunk_image_assets_test.go
index ec938497a..d21fb42f6 100644
--- a/internal/application/repository/chunk_image_assets_test.go
+++ b/internal/application/repository/chunk_image_assets_test.go
@@ -20,7 +20,7 @@ import (
// both spellings need the same assertions. For example:
//
// docker run -d --rm -e POSTGRES_PASSWORD=pg -e POSTGRES_DB=weknora -p 55432:5432 \
-// paradedb/paradedb:v0.22.6-pg17
+// paradedb/paradedb:v0.25.11-pg17
// WEKNORA_REPOSITORY_TEST_POSTGRES_DSN=postgres://postgres:pg@localhost:55432/weknora?sslmode=disable
//
// Both runs apply the real chunk_images migration, so the triggers and the
diff --git a/internal/database/migration_postgres_test.go b/internal/database/migration_postgres_test.go
index 575dae01e..e735f0a1e 100644
--- a/internal/database/migration_postgres_test.go
+++ b/internal/database/migration_postgres_test.go
@@ -18,7 +18,7 @@ import (
// at a disposable database, for example:
//
// docker run -d --rm -e POSTGRES_PASSWORD=pg -e POSTGRES_DB=weknora -p 55432:5432 \
-// paradedb/paradedb:v0.22.6-pg17
+// paradedb/paradedb:v0.25.11-pg17
// WEKNORA_MIGRATION_TEST_POSTGRES_DSN=postgres://postgres:pg@localhost:55432/weknora?sslmode=disable
//
// It checks what SQLite cannot: that 000106 builds its index CONCURRENTLY
diff --git a/migrations/versioned/000099_pg_search_0226.up.sql b/migrations/versioned/000099_pg_search_0226.up.sql
index c1a257d2a..7c3a26f4c 100644
--- a/migrations/versioned/000099_pg_search_0226.up.sql
+++ b/migrations/versioned/000099_pg_search_0226.up.sql
@@ -21,6 +21,15 @@ BEGIN
SELECT 1 FROM pg_available_extension_versions
WHERE name = 'pg_search' AND version = '0.22.6'
) THEN
+ -- Newer images only ship the latest install script; 000115 upgrades
+ -- them directly. Updating the catalog to 0.22.6 there would mismatch
+ -- the shared library.
+ IF EXISTS (
+ SELECT 1 FROM pg_available_extension_versions
+ WHERE name = 'pg_search' AND version = '0.25.11'
+ ) THEN
+ RETURN;
+ END IF;
RAISE NOTICE 'pg_search 0.22.6 is not available; update the server image and run ALTER EXTENSION pg_search UPDATE TO ''0.22.6'' manually';
RETURN;
END IF;
diff --git a/migrations/versioned/000115_pg_search_02511.down.sql b/migrations/versioned/000115_pg_search_02511.down.sql
new file mode 100644
index 000000000..18f51c6d7
--- /dev/null
+++ b/migrations/versioned/000115_pg_search_02511.down.sql
@@ -0,0 +1,2 @@
+-- No-op: extension SQL upgrades cannot be reversed by a schema rollback.
+-- Restore a pre-upgrade database backup together with the matching old image.
diff --git a/migrations/versioned/000115_pg_search_02511.up.sql b/migrations/versioned/000115_pg_search_02511.up.sql
new file mode 100644
index 000000000..12ea9ce43
--- /dev/null
+++ b/migrations/versioned/000115_pg_search_02511.up.sql
@@ -0,0 +1,34 @@
+-- Complete the SQL side of the ParadeDB v0.22.x -> v0.25.11 image upgrade.
+-- A catalog left at an older version than the server's shared library can
+-- crash the whole server when its SQL functions are called (for example
+-- paradedb.version_info()), so the catalog must follow the image.
+DO $$
+DECLARE
+ search_version TEXT;
+ vector_version TEXT;
+BEGIN
+ IF current_setting('app.skip_embedding', true) = 'true' THEN
+ RETURN;
+ END IF;
+
+ -- Leave absent extensions and other release lines under operator control.
+ -- Do not downgrade a newer extension or upgrade an external server to its
+ -- potentially incompatible default version.
+ SELECT extversion INTO search_version FROM pg_extension WHERE extname = 'pg_search';
+ IF search_version ~ '^0\.(22|23|24|25)\.[0-9]+$' AND search_version <> '0.25.11'
+ AND EXISTS (
+ SELECT 1 FROM pg_available_extension_versions
+ WHERE name = 'pg_search' AND version = '0.25.11'
+ ) THEN
+ ALTER EXTENSION pg_search UPDATE TO '0.25.11';
+ END IF;
+
+ SELECT extversion INTO vector_version FROM pg_extension WHERE extname = 'vector';
+ IF vector_version IN ('0.8.0', '0.8.1', '0.8.2', '0.8.3')
+ AND EXISTS (
+ SELECT 1 FROM pg_available_extension_versions
+ WHERE name = 'vector' AND version = '0.8.4'
+ ) THEN
+ ALTER EXTENSION vector UPDATE TO '0.8.4';
+ END IF;
+END $$;
diff --git a/scripts/test_paradedb_upgrade.py b/scripts/test_paradedb_upgrade.py
index 5aa020e37..ca2748fa0 100644
--- a/scripts/test_paradedb_upgrade.py
+++ b/scripts/test_paradedb_upgrade.py
@@ -1,7 +1,7 @@
"""Verify a ParadeDB patch upgrade using disposable Docker volumes and real migrations.
Requires Python 3 and Docker; no database credentials or running WeKnora needed.
-Run: python3 scripts/test_paradedb_upgrade.py
+Run: python3 scripts/test_paradedb_upgrade.py [--to 0.25.11|0.22.6]
Artifacts (snapshots, plans, logs and a synthetic-data backup) are kept in /tmp.
"""
import argparse
@@ -17,6 +17,12 @@ import uuid
ROOT = pathlib.Path(__file__).resolve().parents[1]
OUT = None
CONTAINER = 'weknora-pdb-upgrade-' + uuid.uuid4().hex[:12]
+# target pg_search version -> (image, expected vector version or None if unchanged)
+TARGETS = {
+ '0.22.6': ('paradedb/paradedb:v0.22.6-pg17', None),
+ '0.25.11': ('paradedb/paradedb:v0.25.11-pg17', '0.8.4'),
+}
+UPGRADES = ['000099_pg_search_0226.up.sql', '000115_pg_search_02511.up.sql']
def sql(query, db='weknora'):
p = subprocess.run(['docker', 'exec', '-i', CONTAINER, 'psql', '-X', '-qAt', '-U', 'postgres', '-d', db, '-v', 'ON_ERROR_STOP=1'], input=query, text=True, capture_output=True)
@@ -126,7 +132,9 @@ def migrate(db, paths, label):
with (OUT/(label+'.log')).open('w') as log:
for path in paths:
log.write(path.name+'\n')
- sql('BEGIN;\n'+path.read_text()+'\nCOMMIT;', db)
+ text = path.read_text()
+ # CONCURRENTLY cannot run in a transaction block; golang-migrate does not add one either.
+ sql(text if 'CONCURRENTLY' in text else 'BEGIN;\n'+text+'\nCOMMIT;', db)
print(f'{label}: {len(paths)} SQL migrations passed', flush=True)
@@ -149,6 +157,7 @@ def main():
global OUT
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument('--output-dir', type=pathlib.Path)
+ parser.add_argument('--to', choices=sorted(TARGETS), default='0.25.11', help='target pg_search version')
args = parser.parse_args()
OUT = args.output_dir or pathlib.Path(tempfile.mkdtemp(prefix='weknora-pdb-upgrade-'))
OUT.mkdir(parents=True, exist_ok=True)
@@ -156,19 +165,26 @@ def main():
raise RuntimeError('Use an empty output directory')
print('Evidence: '+str(OUT), flush=True)
volume = CONTAINER+'-data'
- old, new = 'paradedb/paradedb:v0.22.2-pg17', 'paradedb/paradedb:v0.22.6-pg17'
+ old = 'paradedb/paradedb:v0.22.2-pg17'
+ target = args.to
+ new, vector_target = TARGETS[target]
paths = sorted((ROOT/'migrations/versioned').glob('*.up.sql'))
baseline = [p for p in paths if int(p.name.split('_')[0]) < 99]
- upgrade = ROOT/'migrations/versioned/000099_pg_search_0226.up.sql'
+ upgrade = [ROOT/'migrations/versioned'/name for name in UPGRADES]
+ upgrade_sql = '\n'.join(p.read_text() for p in upgrade)
+ search_version = "SELECT extversion FROM pg_extension WHERE extname='pg_search'"
+ vector_version = "SELECT extversion FROM pg_extension WHERE extname='vector'"
# Only resources created by this invocation are ever removed.
docker('volume', 'create', volume)
try:
start(old, volume)
migrate('weknora', baseline, 'old-migrations')
- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'
+ assert sql(search_version) == '0.22.2'
+ old_vector = sql(vector_version)
# Older external servers without the target package must remain usable.
- migrate('weknora', [upgrade], 'unavailable-target')
- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'
+ migrate('weknora', upgrade, 'unavailable-target')
+ assert sql(search_version) == '0.22.2'
+ assert sql(vector_version) == old_vector
seed()
snapshot('before')
with (OUT/'before.dump').open('wb') as backup:
@@ -177,12 +193,14 @@ def main():
docker('rm', CONTAINER)
start(new, volume)
# Replacing the image alone leaves the SQL catalog at the old version.
- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'
- sql("BEGIN; SET LOCAL app.skip_embedding='true';\n"+upgrade.read_text()+"\nCOMMIT;")
- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'
- migrate('weknora', [upgrade, upgrade], 'extension-upgrade-and-idempotence')
- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.6'
- assert sql('SELECT version FROM paradedb.version_info()') == '0.22.6'
+ assert sql(search_version) == '0.22.2'
+ sql("BEGIN; SET LOCAL app.skip_embedding='true';\n"+upgrade_sql+"\nCOMMIT;")
+ assert sql(search_version) == '0.22.2'
+ migrate('weknora', upgrade + upgrade, 'extension-upgrade-and-idempotence')
+ assert sql(search_version) == target
+ assert sql(vector_version) == (vector_target or old_vector)
+ # Calls into the shared library crash the server if the catalog lags behind it.
+ assert sql('SELECT version FROM paradedb.version_info()') == target
snapshot('after')
docker('restart', '-t', '60', CONTAINER)
for _ in range(60):
@@ -195,10 +213,10 @@ def main():
check_writes()
sql('CREATE DATABASE upgrade_fresh TEMPLATE template0')
# The new migration must not install pg_search on non-search databases.
- migrate('upgrade_fresh', [upgrade], 'absent-extension')
- assert sql("SELECT count(*) FROM pg_extension WHERE extname='pg_search'", 'upgrade_fresh') == '0'
+ migrate('upgrade_fresh', upgrade, 'absent-extension')
+ assert sql("SELECT count(*) FROM pg_extension WHERE extname IN ('pg_search','vector')", 'upgrade_fresh') == '0'
migrate('upgrade_fresh', paths, 'fresh-migrations')
- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'", 'upgrade_fresh') == '0.22.6'
+ assert sql(search_version, 'upgrade_fresh') == target
sql("INSERT INTO embeddings(source_id,source_type,content,dimension) VALUES ('fresh',0,'新安装检索',1024)", 'upgrade_fresh')
assert sql("SELECT count(*) FROM embeddings WHERE content ||| '检索'", 'upgrade_fresh') == '1'
print('PASS: fresh install and Chinese BM25 query', flush=True)
diff --git a/website-docs/01-getting-started/02-installation.md b/website-docs/01-getting-started/02-installation.md
index ca86f3ab5..a05182c66 100644
--- a/website-docs/01-getting-started/02-installation.md
+++ b/website-docs/01-getting-started/02-installation.md
@@ -43,7 +43,7 @@ flowchart TB
- **源码编译**:Go 1.26(见 `docker/Dockerfile.app` builder 阶段 `golang:1.26-bookworm`)、CGO(依赖 `libsqlite3-dev`)、Node.js + npm(前端)、Python 3.10 + uv(docreader)。
- **Kubernetes**:>= 1.25.0(`helm/Chart.yaml`)。
-Compose 默认 ParadeDB `v0.22.6-pg17` 的 x86 CPU 基线为 `x86-64-v2`(包括 SSE4.2、POPCNT),不再强制要求 AVX2。这不代表所有 ARM CPU 或其他可选服务均兼容。
+Compose 默认 ParadeDB 镜像自 `v0.22.6-pg17` 起 x86 CPU 基线为 `x86-64-v2`(包括 SSE4.2、POPCNT),不再强制要求 AVX2;更高镜像版本的基线以 ParadeDB 官方发布说明为准。这不代表所有 ARM CPU 或其他可选服务均兼容。
## 一、Docker Compose 标准部署(docker-compose.yml)
@@ -88,7 +88,7 @@ docker compose up -d
| `frontend` | `wechatopenai/weknora-ui:${WEKNORA_VERSION:-latest}` | `${FRONTEND_PORT:-80}:80` | app(healthy) | Nginx 托管 SPA 并反代到 app;`APP_HOST`/`APP_BACKEND_PORT`/`APP_SCHEME` 可指向远程后端 |
| `app` | `wechatopenai/weknora-app` | `${APP_PORT:-8080}:8080` | postgres(healthy)、redis、docreader(healthy) | Go 后端;挂载 `./config/config.yaml`、`data-files` 卷;健康检查 `GET /health` |
| `docreader` | `wechatopenai/weknora-docreader` | 仅 `expose: 50051`(不发布到宿主机) | — | 文档解析 gRPC 服务;健康检查 `grpc_health_probe`;与 app 共享 `docreader-tmp` 卷传递图片 |
-| `postgres` | `paradedb/paradedb:v0.22.6-pg17` | 不映射宿主端口 | — | ParadeDB = PostgreSQL 17 + BM25/向量扩展,默认检索引擎 |
+| `postgres` | `paradedb/paradedb:v0.25.11-pg17` | 不映射宿主端口 | — | ParadeDB = PostgreSQL 17 + BM25/向量扩展,默认检索引擎 |
| `redis` | `redis:7.0-alpine` | 不映射宿主端口 | — | `--appendonly yes --requirepass ${REDIS_PASSWORD}` |
### 可选服务与 profiles
diff --git a/website-docs/01-getting-started/06-paradedb-upgrade.md b/website-docs/01-getting-started/06-paradedb-upgrade.md
index 53741552a..320e7e6a6 100644
--- a/website-docs/01-getting-started/06-paradedb-upgrade.md
+++ b/website-docs/01-getting-started/06-paradedb-upgrade.md
@@ -1,6 +1,11 @@
# ParadeDB 存量库升级
-仓库的生产与开发 Compose 使用 `paradedb/paradedb:v0.22.6-pg17`。本文处理 **0.22.2 → 0.22.6、PostgreSQL 主版本保持 17** 的升级;不适用于 PostgreSQL 跨主版本升级,也不代表 Helm 中其他旧版本可以直接套用。
+仓库的生产与开发 Compose 使用 `paradedb/paradedb:v0.25.11-pg17`。本文处理 **0.22.x → 0.25.11、PostgreSQL 主版本保持 17** 的升级;不适用于 PostgreSQL 跨主版本升级,也不代表 Helm 中其他旧版本可以直接套用。
+
+该版本线相对 `v0.22.6-pg17` 带来 PostgreSQL 17.9 → 17.11、pgvector 0.8.1 → 0.8.4(修复并行 HNSW 构建缓冲区溢出与 HNSW vacuum 期间的索引损坏)以及 pg_search 基于 WAL 的崩溃恢复(0.24.0 起,见 paradedb#4901)。
+
+> [!WARNING]
+> 替换镜像后**必须**把扩展 catalog 升级到与镜像一致的版本。catalog 停留在旧版本时,部分扩展 SQL 函数(例如 `paradedb.version_info()`)会因签名与新二进制不匹配而触发段错误,导致整个 PostgreSQL 实例崩溃并进入恢复。也**不要**在新镜像上执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`,它同样会造成上述不匹配。
## 升级步骤
@@ -31,35 +36,39 @@
docker compose up -d --no-deps --wait postgres
```
-4. 完成扩展的 SQL 升级。仅替换镜像不会更新已有数据库内的 `pg_extension` 版本。
+4. 完成扩展的 SQL 升级。仅替换镜像不会更新已有数据库内的 `pg_extension` 版本。新镜像自带 0.22.x 起的完整升级脚本链,任意 0.22.x 都可以一步升级到镜像默认版本:
```bash
docker compose exec -T postgres sh -c 'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -v ON_ERROR_STOP=1' <<'SQL'
- ALTER EXTENSION pg_search UPDATE TO '0.22.6';
+ ALTER EXTENSION pg_search UPDATE;
+ ALTER EXTENSION vector UPDATE;
SELECT extname, extversion FROM pg_extension WHERE extname IN ('pg_search', 'vector');
SELECT * FROM paradedb.version_info();
SQL
```
- 在**其他已安装 `pg_search` 的数据库**中同样执行,包括安装过该扩展的 `postgres`、模板库或 Langfuse 库。不要为了升级而向原本不需要的数据库安装扩展。catalog 与 `paradedb.version_info()` 应均报告 0.22.6。
+ 在**其他已安装 `pg_search` 或 `vector` 的数据库**中同样执行,包括安装过该扩展的 `postgres`、模板库或 Langfuse 库。不要为了升级而向原本不需要的数据库安装扩展。`pg_search` 的 catalog 与 `paradedb.version_info()` 应均报告 0.25.11,`vector` 应为 0.8.4。
-5. 恢复原先运行的写入服务,确认数据库迁移状态,执行有代表性的关键词与向量检索。这个补丁升级无需专门重建全部索引或重新导入文档;保留备份直到验证完成。
+5. 恢复原先运行的写入服务,确认数据库迁移状态,执行有代表性的关键词与向量检索。已有的 BM25 与 HNSW 索引在新版本下可继续读写,无需专门重建全部索引或重新导入文档;如遇异常可 `REINDEX`。保留备份直到验证完成。
## 自动迁移的范围
-迁移 `000099` 仅在 WeKnora 数据库内执行扩展升级:已安装版本须为 0.22.2–0.22.5,且服务器提供 0.22.6 扩展包。它遵守 `app.skip_embedding`,不安装缺失的扩展,也不处理其他版本线。
+WeKnora 启动时的迁移只在 WeKnora 数据库内升级扩展,遵守 `app.skip_embedding`,不安装缺失的扩展,也不降级或处理其他版本线:
+
+- `000115`:已安装的 `pg_search` 为 0.22.0–0.25.10 且服务器提供 0.25.11 时,升级到 0.25.11;已安装的 `vector` 为 0.8.0–0.8.3 且服务器提供 0.8.4 时,升级到 0.8.4。
+- `000099`:历史迁移,仅在服务器提供 0.22.6 扩展包(即仍使用 `v0.22.6-pg17` 镜像)时把 0.22.2–0.22.5 升级到 0.22.6;新镜像上会跳过,交给 `000115`。
-如果这条迁移在替换数据库镜像**之前**已经执行,安装新镜像后不会自动再跑一次,需要手动执行上面的 SQL。没有 `000099` 的旧应用也需手工升级。其他数据库的扩展不能靠 WeKnora 的迁移代管。
+如果这些迁移在替换数据库镜像**之前**已经执行,安装新镜像后不会自动再跑一次,需要手动执行上面的 SQL。没有对应迁移的旧应用也需手工升级。其他数据库的扩展不能靠 WeKnora 的迁移代管。
## 回滚与复现验证
-回滚需要将升级前备份/快照恢复到独立数据卷,配合旧镜像使用。仅把镜像标签改回旧版不会撤销扩展 SQL 变更,`000099` 的 down 文件也不会尝试降级扩展。
+回滚只能将升级前备份/快照恢复到独立数据卷,配合旧镜像使用。仅把镜像标签改回旧版不会撤销扩展 SQL 变更;而且 pg_search 0.24 起会向 WAL 写入自定义资源管理器记录,旧镜像无法重放这些记录。迁移的 down 文件也不会尝试降级扩展。
-仓库提供隔离验证脚本:
+仓库提供隔离验证脚本,默认验证 0.22.2 → 0.25.11,也可用 `--to 0.22.6` 验证历史补丁升级:
```bash
docker pull paradedb/paradedb:v0.22.2-pg17
-docker pull paradedb/paradedb:v0.22.6-pg17
+docker pull paradedb/paradedb:v0.25.11-pg17
python3 scripts/test_paradedb_upgrade.py
```
diff --git a/website-docs/02-architecture/01-overview.md b/website-docs/02-architecture/01-overview.md
index d37691ad0..81ad9fa99 100644
--- a/website-docs/02-architecture/01-overview.md
+++ b/website-docs/02-architecture/01-overview.md
@@ -13,7 +13,7 @@ WeKnora 采用"主服务 + 前端 + 文档解析微服务"的三进程核心架
| `app` | `wechatopenai/weknora-app`(`docker/Dockerfile.app`,Go) | `8080` | 主后端:REST API、RAG 检索、Agent 引擎、异步任务 worker、IM/Embed 渠道接入。健康检查 `GET /health` |
| `frontend` | `wechatopenai/weknora-ui`(`frontend/`,NGINX + Vue3 静态产物) | `80` | Web UI;NGINX 同时充当反向代理,将 `/api` 转发到 `app`(`APP_HOST`/`APP_BACKEND_PORT`/`APP_SCHEME` 可指向远端后端) |
| `docreader` | `wechatopenai/weknora-docreader`(`docker/Dockerfile.docreader`,Python) | `50051`(仅 compose 网络内 expose,不映射宿主机) | 文档解析微服务:gRPC 服务端,PDF/DOCX/Excel/EPUB/网页等 25+ 格式解析与页面渲染。健康检查 `grpc_health_probe` |
-| `postgres` | `paradedb/paradedb:v0.22.6-pg17` | `5432`(网络内) | 主数据库。ParadeDB 发行版自带 BM25 全文检索与 pgvector 向量能力,因此**默认部署无需独立向量库**(`RETRIEVE_DRIVER=postgres`) |
+| `postgres` | `paradedb/paradedb:v0.25.11-pg17` | `5432`(网络内) | 主数据库。ParadeDB 发行版自带 BM25 全文检索与 pgvector 向量能力,因此**默认部署无需独立向量库**(`RETRIEVE_DRIVER=postgres`) |
| `redis` | `redis:7.0-alpine`(`appendonly` + `requirepass`) | `6379`(网络内) | Asynq 任务队列、SSE 流管理(跨实例)、system_settings 发布订阅、限流与分布式模型并发闸门 |
| `sandbox` | `wechatopenai/weknora-sandbox`(`docker/Dockerfile.sandbox`) | — | WeKnora 标准运行镜像;可直接用于空间 Docker 后端,接入 CubeSandbox/E2B 时则通过模板 API 自动注册并用于 Agent Skills |
diff --git a/website-docs/06-development/01-dev-guide.md b/website-docs/06-development/01-dev-guide.md
index 296f3beff..3e81b2cb0 100644
--- a/website-docs/06-development/01-dev-guide.md
+++ b/website-docs/06-development/01-dev-guide.md
@@ -64,7 +64,7 @@ make dev-restart # 重启
| 服务 | 镜像 | 端口(默认) | 启动条件 |
| --- | --- | --- | --- |
-| `postgres` | `paradedb/paradedb:v0.22.6-pg17`(自带 pg_search/BM25) | `5432` | 默认启动 |
+| `postgres` | `paradedb/paradedb:v0.25.11-pg17`(自带 pg_search/BM25) | `5432` | 默认启动 |
| `redis` | `redis:7.0-alpine`(`--requirepass`) | `6379` | 默认启动 |
| `docreader` | 本地构建 `docker/Dockerfile.docreader` | `50051`(gRPC) | 默认启动 |
| `searxng`(+`searxng-init`) | `searxng/searxng:latest` | `127.0.0.1:8888` | `--searxng` / `--full`(compose profile `searxng`) |
diff --git a/website-docs/06-development/02-database-schema.md b/website-docs/06-development/02-database-schema.md
index 415532f4c..9c1176166 100644
--- a/website-docs/06-development/02-database-schema.md
+++ b/website-docs/06-development/02-database-schema.md
@@ -413,7 +413,7 @@ make migrate-up
BM25 索引(`USING bm25`、Lindera 中文分词)只在 ParadeDB 可用;原生 Postgres 部署需保证相应迁移的条件分支生效或改用 Elasticsearch 等外部检索引擎。存量原生 Postgres 库切到 ParadeDB 可参考 `migrations/paradedb/01-migrate-to-paradedb.sql`。
-官方镜像自 v0.8.2 起为 `paradedb/paradedb:v0.22.6-pg17`。迁移 000099 只把已安装的 pg_search 0.22.2–0.22.5 升级到 0.22.6:若启动日志提示 `pg_search 0.22.6 is not available`,说明数据库镜像还没换,换镜像后手工执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`;其他版本线不会被自动升级或降级。
+官方镜像为 `paradedb/paradedb:v0.25.11-pg17`(v0.8.2 起曾为 `v0.22.6-pg17`)。迁移 000115 在服务器提供对应扩展包时,把已安装的 pg_search 0.22.0–0.25.10 升级到 0.25.11、pgvector 0.8.0–0.8.3 升级到 0.8.4;历史迁移 000099 仅在仍使用 `v0.22.6-pg17` 镜像时生效。其他版本线不会被自动升级或降级。扩展 catalog 必须与镜像版本一致,否则调用部分扩展函数会使数据库崩溃;手工升级见《ParadeDB 存量库升级》,在新镜像上不要执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`。
### 版本文件冲突 {#_7-5-版本文件冲突}