groonga/mroonga

Mroonga Docker镜像文档

概述

Mroonga是一个专为MySQL设计的全文搜索存储引擎，旨在提供高效、多语言支持的全文检索能力。该Docker镜像封装了Mroonga与MySQL的集成环境，可快速部署具备强大全文搜索功能的MySQL服务，由Groonga开发团队持续维护更新。

核心功能与特性

• 高性能全文搜索：采用优化的索引结构，支持亚秒级全文检索响应
• 多语言支持：内置中文、日文、英文等30+语言的分词与搜索能力
• 原生MySQL集成：作为存储引擎直接运行于MySQL进程内，无需额外中间件
• 数据效率：支持索引压缩与数据压缩，降低存储占用
• 事务兼容性：完全支持MySQL事务ACID特性，保障数据一致性
• 实时索引更新：数据写入/更新时自动同步索引，确保检索结果实时性

使用场景

• 内容管理系统（CMS）的文章/新闻全文检索
• 文档管理平台的多格式文件内容搜索
• 多语言电商网站的商品信息检索
• 企业知识库与文档库的快速查询系统
• 日志分析平台的结构化文本检索

使用方法

快速启动

bash
docker run -d \
  --name mroonga \
  -e MYSQL_ROOT_PASSWORD=your_secure_password \
  -p 3306:3306 \
  groonga/mroonga:latest

环境变量配置

Docker Compose配置示例

yaml
version: '3.8'
services:
  mroonga:
    image: groonga/mroonga:8.0
    container_name: mroonga
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: secure_password_123
      MYSQL_DATABASE: blog_db
      MYSQL_USER: editor
      MYSQL_PASSWORD: editor_pass
      MROONGA_DEFAULT_TABLE: 1
    ports:
      - "3306:3306"
    volumes:
      - mroonga_data:/var/lib/mysql
      - ./conf.d:/etc/mysql/conf.d  # 自定义配置挂载
    networks:
      - app_network

networks:
  app_network:
    driver: bridge

volumes:
  mroonga_data:
    driver: local

数据持久化

通过挂载卷/var/lib/mysql实现数据持久化，避免容器重启导致数据丢失。生产环境建议配合定期备份策略（如使用mysqldump）。

自定义配置

可通过挂载/etc/mysql/conf.d目录添加自定义配置文件，示例配置（mroonga.cnf）：

ini
[mysqld]
# 设置默认存储引擎为Mroonga
default-storage-engine=mroonga
# 配置中文分词
mroonga_tokenizer=TokenMecab  # 日文分词
# mroonga_tokenizer=TokenBigram  # 中文/英文分词

注意事项

• 镜像标签对应MySQL版本（如:8.0对应MySQL 8.0，:5.7对应MySQL 5.7）
• 首次启动需30-60秒初始化数据库，可通过docker logs mroonga查看进度
• 生产环境建议配置资源限制（--memory/--cpus）与健康检查
• 高并发场景需调优innodb_buffer_pool_size与mroonga_cache_size参数

参考链接

• 官方文档
• https://github.com/mroonga/docker
• MySQL兼容性矩阵