Manticore Search 服务器可以根据安装类型使用不同的方法启动。

安装后，Manticore Search 服务不会自动启动。要启动 Manticore，请运行以下命令：

sudo systemctl start manticore

要停止 Manticore，请运行以下命令：

sudo systemctl stop manticore

Manticore 服务设置为开机启动。您可以通过运行以下命令检查：

sudo systemctl is-enabled manticore

如果您想禁用 Manticore 开机启动，请运行：

sudo systemctl disable manticore

要使 Manticore 开机启动，请运行：

sudo systemctl enable manticore

searchd 进程会将启动信息记录在 systemd 日志中。如果启用了 systemd 日志记录，您可以使用以下命令查看记录的信息：

sudo journalctl -u manticore

systemctl set-environment _ADDITIONAL_SEARCHD_PARAMS 允许您指定 Manticore Search 守护进程启动时应使用的自定义启动参数。完整列表请参见这里。

例如，要以调试日志级别启动 Manticore，您可以运行：

systemctl set-environment _ADDITIONAL_SEARCHD_PARAMS='--logdebug'
systemctl restart manticore

要撤销该操作，运行：

systemctl set-environment _ADDITIONAL_SEARCHD_PARAMS=''
systemctl restart manticore

注意，systemd 环境变量在服务器重启时会被重置。

可以使用 service 命令启动和停止 Manticore：

sudo service manticore start
sudo service manticore stop

在 RedHat 系统上启用 sysV 服务开机启动，请运行：

chkconfig manticore on

在 Debian 系统（包括 Ubuntu）上启用 sysV 服务开机启动，请运行：

update-rc.d manticore defaults

请注意，searchd 由 init 系统以 manticore 用户身份启动，服务器创建的所有文件都将归该用户所有。如果 searchd 以例如 root 用户身份启动，文件权限将被更改，这可能导致再次以服务方式运行 searchd 时出现问题。

您也可以通过直接调用 searchd（Manticore Search 服务器二进制文件）来启动 Manticore Search：

searchd [OPTIONS]

请注意，如果不指定配置文件路径，searchd 会根据操作系统在多个位置尝试查找配置文件。

searchd 在所有操作系统中可用的选项有：

• --help（简写为 -h）列出您当前构建的 searchd 中可用的所有参数。

• --version（简写为 -v）显示 Manticore Search 版本信息。

• --config <file>（简写为 -c <file>）告诉 searchd 使用指定的文件作为配置文件。

• --stop 用于异步停止 searchd，使用 Manticore 配置文件中指定的 PID 文件详情。因此，您可能还需要通过 --config 选项确认 searchd 使用哪个配置文件。示例：

  $ searchd --config /etc/manticoresearch/manticore.conf --stop

• --stopwait 用于同步停止 searchd。--stop 本质上是告诉正在运行的实例退出（通过发送 SIGTERM 信号），然后立即返回。--stopwait 还会尝试等待正在运行的 searchd 实例实际完成关闭（例如保存所有待处理的属性更改）并退出。示例：

  $ searchd --config /etc/manticoresearch/manticore.conf --stopwait

  可能的退出代码如下：

  • 成功时返回 0
  • 连接到正在运行的 searchd 服务器失败时返回 1
  • 服务器在关闭期间报告错误时返回 2
  • 服务器在关闭期间崩溃时返回 3

• --status 命令用于使用（可选提供的）配置文件中的连接详情查询正在运行的 searchd 实例状态。它将尝试使用配置文件中找到的第一个 UNIX 套接字或 TCP 端口连接到正在运行的实例。成功后，它将查询多个状态和性能计数器值并打印出来。您也可以使用 SHOW STATUS 命令通过 SQL 协议访问相同的计数器。示例：

  $ searchd --status
  $ searchd --config /etc/manticoresearch/manticore.conf --status

• --pidfile 用于显式强制使用 PID 文件（存储 searchd 进程标识号的文件），无视任何其他调试选项（例如 --console）。这是一个调试选项。

  $ searchd --console --pidfile

• --console 用于强制 searchd 进入控制台模式。通常，Manticore 作为传统服务器应用运行，并将信息记录到日志文件中（如配置文件中指定）。但是，在调试配置或服务器本身的问题，或尝试诊断难以追踪的问题时，强制其直接将信息输出到调用它的控制台/命令行可能更方便。控制台模式运行还意味着进程不会被 fork（因此搜索是顺序执行的），且不会写入日志。（需要注意的是，控制台模式并非运行 searchd 的推荐方式。）您可以这样调用：

  $ searchd --config /etc/manticoresearch/manticore.conf --console

• --logdebug、--logreplication、--logdebugv 和 --logdebugvv 选项启用服务器日志中的额外调试输出。它们的区别在于日志详细程度。这些是调试选项，通常不应启用，因为它们会大量污染日志。可根据需要临时启用以协助复杂的调试过程。

• --iostats 与日志选项配合使用（manticore.conf 中必须激活 query_log）以提供每个查询过程中输入/输出操作的更详细信息，代价是性能略有下降和日志稍大。IO 统计不包括属性的 IO 操作信息，因为属性是通过 mmap 加载的。启用方法如下：

  $ searchd --config /etc/manticoresearch/manticore.conf --iostats

• --cpustats 用于在查询日志文件（针对每个查询）和状态报告（汇总）中提供实际 CPU 时间报告（除了墙钟时间）。它依赖于 Linux 系统调用 clock_gettime()，在某些系统上会回退到精度较低的调用。您可以这样启动 searchd：

  $ searchd --config /etc/manticoresearch/manticore.conf --cpustats

• --port portnumber（简写为 -p）用于指定 Manticore 应监听的端口以接受二进制协议请求，通常用于调试。默认通常是 9312，但有时您需要在不同端口运行。命令行指定的端口会覆盖配置文件中的设置。有效范围是 0 到 65535，但编号 1024 及以下的端口通常需要特权账户运行。

  使用示例：

  $ searchd --port 9313

• --listen ( address ":" port | port | path ) [ ":" protocol ]（简写为 -l）功能类似于 --port，但允许您指定不仅是端口，还可以是完整路径、IP 地址和端口，或 searchd 将监听的 Unix 域套接字路径。换句话说，您可以指定 IP 地址（或主机名）和端口号，仅端口号，或 Unix 套接字路径。如果只指定端口号而不指定地址，searchd 将监听所有网络接口。Unix 路径以斜杠开头。作为最后一个参数，您还可以指定用于该套接字连接的协议处理程序（监听器）。支持的协议值为 'sphinx' 和 'mysql'（自 4.1 版本起使用的 MySQL 协议）。

• --force-preread 禁止服务器在表文件预读取完成之前处理任何传入连接。默认情况下，服务器启动时会在表文件懒加载到内存的同时接受连接。此选项扩展了该行为，使其等待文件加载完成后再接受连接。

• --index (--table) <table>（简写为 -i (-t) <table>）强制此 searchd 实例仅服务指定的表。与上面的 --port 类似，这通常用于调试目的；更长期的更改通常会直接应用于配置文件。

• --strip-path 从表引用的所有文件名中剥离路径名（停用词、词形变化、例外等）。这对于拾取在另一台机器上构建的、可能具有不同路径布局的表非常有用。

• --replay-flags=<OPTIONS> 开关可用于指定额外的二进制日志重放选项列表。支持的选项有：

  • accept-desc-timestamp，忽略递减的事务时间戳并仍然重放此类事务（默认行为是出现错误时退出）。
  • ignore-open-errors，忽略缺失的二进制日志文件（默认行为是出现错误时退出）。
  • ignore-trx-errors，忽略任何事务错误并跳过当前二进制日志文件（默认行为是出现错误时退出）。
  • ignore-all-errors，忽略上述任何错误（默认行为是出现错误时退出）。

  示例：

    $ searchd --replay-flags=accept-desc-timestamp

• --coredump 用于启用在服务器崩溃时保存核心文件或迷你转储。默认禁用以加快服务器崩溃后的重启速度。此选项对调试非常有用。

  $ searchd --config /etc/manticoresearch/manticore.conf --coredump

• --new-cluster 引导复制集群并使服务器成为具有集群重启保护的参考节点。在 Linux 上，你也可以运行 manticore_new_cluster。它将通过 systemd 以 --new-cluster 模式启动 Manticore。

• --new-cluster-force 引导复制集群并使服务器成为参考节点，绕过集群重启保护。在 Linux 上，你也可以运行 manticore_new_cluster --force。它将通过 systemd 以 --new-cluster-force 模式启动 Manticore。

• --mockstack 分析并报告递归表达式求值、模式匹配操作和过滤处理所需的堆栈大小。此调试选项将计算的堆栈需求输出到控制台以便优化。输出提供了可用于配置不同操作堆栈需求的环境变量。

  示例：

  $ searchd --mockstack
  Manticore 7.4.7 e90b5afbb@25032706 dev (columnar 4.1.2 15bbcc7@25031206) (secondary 4.1.2 15bbcc7@25031206) (knn 4.1.2 15bbcc7@25031206)
  Copyright (c) 2001-2016, Andrew Aksyonoff
  Copyright (c) 2008-2016, Sphinx Technologies Inc (http://sphinxsearch.com)
  Copyright (c) 2017-2025, Manticore Software LTD (https://manticoresearch.com)
  export MANTICORE_KNOWN_CREATE_SIZE=200
  export MANTICORE_START_KNOWN_CREATE_SIZE=4504
  export MANTICORE_KNOWN_EXPR_SIZE=16
  export MANTICORE_START_KNOWN_EXPR_SIZE=200
  export MANTICORE_NONE=32
  export MANTICORE_START_NONE=104
  export MANTICORE_KNOWN_FILTER_SIZE=224
  export MANTICORE_START_KNOWN_FILTER_SIZE=11192
  export MANTICORE_KNOWN_MATCH_SIZE=320
  export MANTICORE_START_KNOWN_MATCH_SIZE=14552
  export NO_STACK_CALCULATION=1

searchd 有一些特定于 Windows 平台的选项，涉及作为服务的处理，仅在 Windows 二进制文件中可用。

请注意，在 Windows 中，除非将其安装为服务，否则 searchd 默认以 --console 模式运行。

• --install 将 searchd 安装为 Microsoft 管理控制台（控制面板 / 管理工具 / 服务）中的服务。命令行中与 --install 一起指定的其他参数也将成为服务未来启动时的命令行参数。例如，作为调用 searchd 的一部分，你可能还需要使用 --config 指定配置文件，并且你会在指定 --install 的同时指定它。调用后，通常的启动/停止功能将通过管理控制台可用，因此任何用于启动、停止和重启服务的方法也适用于 searchd。示例：

  C:\WINDOWS\system32> C:\Manticore\bin\searchd.exe --install
     --config C:\Manticore\manticore.conf

  如果你希望每次启动 searchd 时都显示 I/O 统计信息，需要在与 --install 命令同一行指定该选项，如下：

  C:\WINDOWS\system32> C:\Manticore\bin\searchd.exe --install
     --config C:\Manticore\manticore.conf --iostats

• --delete 从 Microsoft 管理控制台及其他服务注册位置移除服务，此前需使用 --install 安装。请注意，这不会卸载软件或删除表。它意味着服务将不会从服务系统调用，也不会在机器下次启动时启动。如果当前作为服务运行，当前实例不会被终止（直到下次重启或使用 --stop）。如果服务是用自定义名称安装的（使用 --servicename），卸载时也需要使用相同名称。示例：

  C:\WINDOWS\system32> C:\Manticore\bin\searchd.exe --delete

• --servicename <name> 在安装或删除服务时，将给定的名称应用于 searchd，该名称将在管理控制台中显示；默认值为 searchd，但如果部署在多个管理员可能登录系统的服务器上，或具有多个 searchd 实例的系统上，可能需要更具描述性的名称。请注意，除非与 --install 或 --delete 结合使用，否则此选项无任何作用。示例：

  C:\WINDOWS\system32> C:\Manticore\bin\searchd.exe --install
     --config C:\Manticore\manticore.conf --servicename ManticoreSearch

• --ntservice 是由 Microsoft 管理控制台传递给 searchd 的一个选项，用于在 Windows 平台上以服务方式调用它。通常不需要直接调用此选项；当服务启动时，Windows 通常会调用它，尽管理论上如果你想从命令行以常规服务方式调用它（作为 --console 的补充），也是可以的。

• --safetrace 强制 searchd 在崩溃报告中仅使用系统的 backtrace() 调用。在某些（罕见的）情况下，这可能是获取该报告的“更安全”方式。这是一个调试选项。

• --nodetach 开关（仅限 Linux）告诉 searchd 不要分离到后台。这也会导致日志条目打印到控制台。查询处理照常进行。这是一个调试选项，在你在 Docker 容器中运行 Manticore 以捕获其输出时也可能有用。

Manticore 利用 plugin_dir 来存储和使用 Manticore Buddy 插件。默认情况下，该值在标准安装中对“manticore”用户可访问。但是，如果你以不同用户手动启动 searchd 守护进程，守护进程可能无法访问 plugin_dir。为了解决此问题，请确保在公共部分指定一个运行 searchd 守护进程的用户可以写入的 plugin_dir。

searchd 支持多种信号：

• SIGTERM - 启动干净关闭。新查询将不被处理，但已开始的查询不会被强制中断。
• SIGHUP - 启动表轮换。根据 seamless_rotate 设置的值，新查询可能会短暂阻塞；客户端将收到临时错误。
• SIGUSR1 - 强制重新打开 searchd 日志和查询日志文件，允许日志文件轮换。

• MANTICORE_TRACK_DAEMON_SHUTDOWN=1 启用 searchd 关闭时的详细日志记录。当出现某些关闭问题时（例如 Manticore 关闭时间过长或关闭过程中冻结），此功能非常有用。

该镜像基于 当前版本的 Manticore 包。

默认配置包含一个示例实时表，并监听默认端口：

• 9306 用于来自 MySQL 客户端的连接
• 9308 用于通过 HTTP 的连接
• 9312 用于通过二进制协议的连接（例如在运行集群时）

该镜像附带用于从 MySQL、PostgreSQL、XML 和 CSV 文件轻松索引数据的库。

以下是启动 Manticore 容器并通过 mysql 客户端登录的最简单方法：

docker run --name manticore --rm -d manticoresearch/manticore && echo "Waiting for Manticore docker to start. Consider mapping the data_dir to make it start faster next time" && until docker logs manticore 2>&1 | grep -q "accepting connections"; do sleep 1; echo -n .; done && echo && docker exec -it manticore mysql && docker stop manticore

注意，退出 MySQL 客户端后，Manticore 容器将被停止并移除，导致数据不会被保存。有关在生产环境中使用 Manticore 的信息，请参见下文。

该镜像附带一个示例表，可以这样加载：

mysql> source /sandbox.sql

此外，mysql 客户端的历史记录中有几个示例查询，您可以在上述表上运行，只需在客户端使用上下键查看并执行它们。

为了数据持久化，文件夹 /var/lib/manticore/ 应挂载到本地存储或其他所需的存储引擎。

实例内的配置文件位于 /etc/manticoresearch/manticore.conf。对于自定义设置，应将此文件挂载到您自己的配置文件。

端口为 9306/9308/9312，分别用于 SQL/HTTP/二进制，根据您使用 Manticore 的方式暴露它们。例如：

docker run --name manticore -v $(pwd)/data:/var/lib/manticore -p 127.0.0.1:9306:9306 -p 127.0.0.1:9308:9308 -d manticoresearch/manticore

或者

docker run --name manticore -v $(pwd)/manticore.conf:/etc/manticoresearch/manticore.conf -v $(pwd)/data:/var/lib/manticore/ -p 127.0.0.1:9306:9306 -p 127.0.0.1:9308:9308 -d manticoresearch/manticore

如果您希望端口对外部主机可用，请确保移除 127.0.0.1:。

Manticore Search Docker 镜像预装了 Manticore Columnar Library 和 Manticore Buddy

在许多情况下，您可能希望将 Manticore 与 Docker Compose YAML 文件中指定的其他镜像一起使用。以下是在 docker-compose.yml 文件中为 Manticore Search 推荐的最小配置：

version: '2.2'
services:
  manticore:
    container_name: manticore
    image: manticoresearch/manticore
    restart: always
    ports:
      - 127.0.0.1:9306:9306
      - 127.0.0.1:9308:9308
    ulimits:
      nproc: 65535
      nofile:
         soft: 65535
         hard: 65535
      memlock:
        soft: -1
        hard: -1
    volumes:
      - ./data:/var/lib/manticore
#      - ./manticore.conf:/etc/manticoresearch/manticore.conf # uncomment if you use a custom config

除了使用暴露的端口 9306 和 9308，您还可以通过运行 docker-compose exec manticore mysql 登录实例。

HTTP 协议暴露在端口 9308。您可以将端口映射到本地并使用 curl 连接：

docker run --name manticore -p 9308:9308 -d manticoresearch/manticore

POST /cli -d 'CREATE TABLE testrt ( title text, content text, gid integer)'

POST /insert
-d'{"table":"testrt","id":1,"doc":{"title":"Hello","content":"world","gid":1}}'

POST /search -d '{"table":"testrt","query":{"match":{"*":"hello world"}}}'

默认情况下，服务器设置将日志发送到 /dev/stdout，可以从主机查看：

docker logs manticore

通过传递变量 QUERY_LOG_TO_STDOUT=true，查询日志可以重定向到 Docker 日志。

以下是定义两个节点集群的简单 docker-compose.yml：

version: '2.2'
services:
  manticore-1:
    image: manticoresearch/manticore
    restart: always
    ulimits:
      nproc: 65535
      nofile:
         soft: 65535
         hard: 65535
      memlock:
        soft: -1
        hard: -1
    networks:
      - manticore
  manticore-2:
    image: manticoresearch/manticore
    restart: always
    ulimits:
      nproc: 65535
      nofile:
        soft: 65535
        hard: 65535
      memlock:
        soft: -1
        hard: -1
    networks:
      - manticore
networks:
  manticore:
    driver: bridge

• 启动它：docker-compose up
• 创建集群：

  $ docker-compose exec manticore-1 mysql
  mysql> CREATE TABLE testrt ( title text, content text, gid integer);
  mysql> CREATE CLUSTER posts;
  Query OK, 0 rows affected (0.24 sec)
  mysql> ALTER CLUSTER posts ADD testrt;
  Query OK, 0 rows affected (0.07 sec)
  MySQL [(none)]> exit
  Bye

• 在第二个实例加入集群

  $ docker-compose exec manticore-2 mysql
  mysql> JOIN CLUSTER posts AT 'manticore-1:9312';
  mysql> INSERT INTO posts:testrt(title,content,gid)  VALUES('hello','world',1);
  Query OK, 1 row affected (0.00 sec)
  MySQL [(none)]> exit
  Bye

• 如果现在回到第一个实例，您将看到新记录：

  $ docker-compose exec manticore-1 mysql
  MySQL [(none)]> select * from testrt;
  +---------------------+------+-------+---------+
  | id                  | gid  | title | content |
  +---------------------+------+-------+---------+
  | 3891565839006040065 |    1 | hello | world   |
  +---------------------+------+-------+---------+
  1 row in set (0.00 sec)
  MySQL [(none)]> exit
  Bye

建议覆盖 docker 的默认 ulimits 以适应 Manticore 实例：

 --ulimit nofile=65536:65536

为了获得最佳性能，表组件可以被“mlock”锁定到内存中。当 Manticore 在 Docker 下运行时，实例需要额外权限以允许内存锁定。运行实例时必须添加以下选项：

  --cap-add=IPC_LOCK --ulimit memlock=-1:-1

如果您想使用包含表定义的自定义配置运行 Manticore，则需要将配置挂载到实例：

docker run --name manticore -v $(pwd)/manticore.conf:/etc/manticoresearch/manticore.conf -v $(pwd)/data/:/var/lib/manticore -p 127.0.0.1:9306:9306 -d manticoresearch/manticore

请注意，容器内的 Manticore search 以用户 manticore 运行。对表文件的操作（如创建或轮换普通表）也应在 manticore 用户下进行。否则文件将由 root 创建，搜索守护进程将无权打开它们。例如，以下是如何轮换所有表：

docker exec -it manticore gosu manticore indexer --all --rotate

您还可以使用 Docker 环境变量设置单独的 searchd 和 common 配置项。

设置必须以其节名称为前缀，例如对于 mysql_version_string，变量名必须为 searchd_mysql_version_string：

docker run --name manticore  -p 127.0.0.1:9306:9306  -e searchd_mysql_version_string='5.5.0' -d manticoresearch/manticore

对于 listen 指令，使用 Docker 变量 searchd_listen 可以在默认监听接口之外添加新的监听接口。可以声明多个接口，用分号 ("|") 分隔。要仅监听网络地址，可以使用 $ip（内部通过 hostname -i 获取）作为地址别名。

例如，-e searchd_listen='9316:http|9307:mysql|$ip:5443:mysql_vip' 将在默认的 9306 和 9308 端口之外，额外添加一个 9307 端口的 SQL 接口，一个仅在实例 IP 上运行的 5443 端口的 SQL VIP 监听器，以及一个 9316 端口的 HTTP 监听器。

$ docker run --rm -p 1188:9307  -e searchd_mysql_version_string='5.5.0' -e searchd_listen='9316:http|9307:mysql|$ip:5443:mysql_vip'  manticore
[Mon Aug 17 07:31:58.719 2020] [1] using config file '/etc/manticoresearch/manticore.conf' (9130 chars)...
listening on all interfaces for http, port=9316
listening on all interfaces for mysql, port=9307
listening on 172.17.0.17:5443 for VIP mysql
listening on all interfaces for mysql, port=9306
listening on UNIX socket /var/run/mysqld/mysqld.sock
listening on 172.17.0.17:9312 for sphinx
listening on all interfaces for http, port=9308
prereading 0 indexes
prereaded 0 indexes in 0.000 sec
accepting connections

要使用自定义启动标志启动 Manticore，请在使用 docker run 时将它们作为参数指定。确保不要包含 searchd 命令，并包含 --nodetach 标志。示例如下：

docker run --name manticore --rm manticoresearch/manticore:latest --replay-flags=ignore-trx-errors --nodetach

默认情况下，主 Manticore 进程 searchd 在容器内以用户 manticore 运行，但启动容器时运行的脚本是以您的默认 docker 用户身份运行的，在大多数情况下是 root。如果这不是您想要的，可以使用 docker ... --user manticore 或在 docker compose yaml 中使用 user: manticore 使所有内容都以 manticore 用户身份运行。下面会介绍您可能遇到的卷权限问题及其解决方法。

要构建自定义配置文件中指定的普通表，可以使用环境变量 CREATE_PLAIN_TABLES=1。它将在 Manticore 启动前执行 indexer --all。如果您不使用卷，并且表容易重新创建，这非常有用。

docker run -e CREATE_PLAIN_TABLES=1 --name manticore -v $(pwd)/manticore.conf:/etc/manticoresearch/manticore.conf -p 9306:9306 -p 9308:9308 -d manticoresearch/manticore

如果您以非 root 用户运行 Manticore Search docker（使用 docker ... --user manticore 或在 docker compose yaml 中使用 user: manticore），可能会遇到权限问题，例如：

FATAL: directory /var/lib/manticore write error: failed to open /var/lib/manticore/tmp: Permission denied

这是因为用于在容器内运行进程的用户可能没有权限修改您挂载到容器的目录。为了解决此问题，您可以对挂载目录执行 chown 或 chmod。如果您以用户 manticore 运行容器，需要执行：

chown -R 999:999 data

因为容器内用户 manticore 的 ID 是 999。