搜索与推荐

功能说明

维护全站内容搜索索引，查看 Meilisearch 同步状态；相关推荐依赖可选推荐服务（如 Gorse）。

前置条件

搜索能力已在授权或部署中启用。
可选：若使用独立 Meilisearch 容器，需先完成可选基础设施部署，并由运维将密钥写入服务器配置。
账号具备 系统监控 相关读权限。

管理后台配置步骤

搜索索引

路径：系统监控 → 搜索索引

页面通常展示：

Meilisearch 连接状态（在线 / 离线）
各索引文档数量、最后同步时间
手动重建 / 全量同步 按钮（慎用，高峰期可能增加负载）

管理员职责：

上线新区域或大批量导入内容后，查看索引数量是否增长
若客户端搜索明显缺失新内容，在运维确认 Meilisearch 正常后，使用页面提供的 重建索引（若有）
持续失败时记录页面错误信息并联系运维

相关推荐（可选）

路径：系统监控 → 相关推荐评估

若部署了 Gorse 等推荐引擎，可在此查看推荐效果指标。未部署时菜单可能为空或提示未连接。

推荐服务为 可选组件，不影响基础搜索；启动方式见可选基础设施。

区域配置

搜索索引一般为 全站统一，文档内带有 region_id 字段供客户端过滤；不需要在区域管理单独开开关。

区域只影响「用户能看到哪些内容」，索引本身仍包含全站文档。

验证是否生效

发布一条带独特关键词的测试笔记，等待数分钟（或触发同步后）。
客户端搜索该关键词，能命中刚发布的笔记。
系统监控 → 搜索索引 中文档总数与最近同步时间合理更新。

常见问题

搜索无结果但内容存在

搜索索引 页 Meilisearch 是否离线；联系运维启动 Docker 栈或检查密钥。
笔记是否未审核通过或被区域距离过滤（客户端层）。

重建索引很慢

大数据量正常；建议在低峰操作，并由运维监控服务器 CPU / 内存。

没有搜索索引菜单

当前账号无监控权限；或搜索模块未启用。

Meilisearch 是否必须

小规模可依赖内置能力；生产环境建议独立 Meilisearch 以保障性能，详见可选基础设施。

相关文档