Docker部署Meilisearch是最主流轻量方式,需先安装Docker(19.03+)和Docker Compose;执行docker pull与docker run命令即可启动服务,支持端口映射、数据持久化及开发/生产环境配置,并可通过docker-compose.yml统一管理。

用 Docker 部署 Meilisearch 是最主流、最轻量的方式,整个过程不依赖复杂环境,几分钟就能跑起来。
准备前提条件
确保系统已安装 Docker(19.03+)和 Docker Compose(可选但推荐)。Ubuntu/Debian 用户可用 apt install docker.io docker-compose;macOS 或 Windows 用户建议直接安装 Docker Desktop。验证运行:docker --version 和 docker-compose --version。
拉取镜像并启动容器
执行以下两步命令即可启动服务:
- 拉取最新稳定版镜像:docker pull getmeili/meilisearch:latest
- 运行容器(后台常驻 + 数据持久化):
docker run -d \
--name meilisearch \
-p 7700:7700 \
-v $(pwd)/meili-data:/data.ms \
-e MEILI_ENV=development \
getmeili/meilisearch:latest
说明:-p 7700:7700 映射本地 7700 端口;-v 将当前目录下的 meili-data 文件夹作为数据卷挂载,避免重启后索引丢失;MEILI_ENV=development 启用开发模式(自动创建 API 密钥、开放 CORS 等),生产环境建议改用 production 并配置 MEILI_MASTER_KEY。
验证与访问
启动后等待约 5–10 秒,执行 docker logs meilisearch 查看日志,出现 "Server is listening on: http://0.0.0.0:7700" 即表示就绪。
在浏览器中打开:http://localhost:7700(本机)或 http://[服务器IP]:7700(局域网其他设备),就能看到 Meilisearch 的 Mini Dashboard 页面。
首次访问会提示设置主密钥(Master Key),默认为 masterKey(仅 development 模式下生效),后续所有 API 请求需带上:
Authorization: Bearer masterKey
进阶:用 Docker Compose 管理(推荐长期使用)
新建 docker-compose.yml 文件:
version: '3.8'
services:
meilisearch:
image: getmeili/meilisearch:latest
container_name: meilisearch
ports:
- "7700:7700"
volumes:
- ./meili-data:/data.ms
environment:
- MEILI_ENV=production
- MEILI_MASTER_KEY=your_strong_secret_key_here
restart: unless-stopped然后执行:docker-compose up -d 启动,docker-compose down 停止。这种方式更易维护、升级和集成进项目工作流。


















