可选基础设施

功能说明

介绍如何通过 Docker 可选启动 Meilisearch（搜索）与 Gorse（推荐）等组件；不包含 应用主程序、MySQL、Redis。

前置条件

• 服务器已安装 Docker 与 Docker Compose（或 docker compose 插件）。
• 灵萌应用已至少启动过一次，以便释放部署文件到服务器目录。
• 由 运维 执行命令；管理员只需知道「启用了什么」并在后台 搜索索引 中查看状态。

管理后台配置步骤

管理员 无需 在后台填写 Docker 参数。运维完成部署后，您只需：

1. 打开 系统监控 → 搜索索引，确认 Meilisearch 状态为在线
2. 若启用推荐，打开 系统监控 → 相关推荐评估 查看是否连通
3. 搜索功能异常时，将 搜索索引 页错误截图发给运维

密钥一致性（Meilisearch Master Key、Gorse API Key）须与服务器配置文件相同，由运维维护，管理员不要自行修改生产密钥。

区域配置

Docker 栈为 全站级，无区域菜单。启用后所有区域共享同一搜索 / 推荐集群。

验证是否生效

运维侧：

cd static/deploy
cp .env.example .env   # 首次：编辑密钥与端口
bash up.sh             # 启动栈，等价于 docker compose up -d

管理员侧：

• 系统监控 → 搜索索引 显示已连接、文档数 > 0
• 客户端搜索能命中新内容（见 搜索与推荐）

停止栈（运维执行）：在同一目录运行 bash down.sh。

包含与不包含

组件	默认端口	用途
Meilisearch	7700	全文搜索
Gorse	8087 / 8088	相关推荐
NebulaGraph	9669	社交图（高级，可选）

WARNING

Docker Compose 不提供 MySQL、Redis 和灵萌应用本身，这些须单独安装或使用云服务。

同机部署多套站点时，修改 .env 中的端口与栈名称，避免冲突（详见 static/deploy/.env.example 说明）。

常见问题

up.sh 找不到

• 先启动灵萌应用，部署文件会展开到运行目录下的 static/deploy/。

搜索索引仍离线

• 运维检查容器是否运行：docker ps
• Master Key 是否与 config.yaml 中 meilisearch 段一致

可以不装 Meilisearch 吗

• 可以；小规模可用内置能力。用户量大或搜索延迟高时再启用 Docker 版。

Gorse 必须装吗

• 否；仅当需要个性化 相关推荐 时可选安装。

相关文档

• 搜索与推荐
• 系统监控入口