• CentOS 8, RHEL 8, Oracle Linux 8, CentOS Stream 8
• Amazon Linux 2
• CentOS 9, RHEL 9, AlmaLinux 9
• AlmaLinux 10, 其他基于 RHEL 10 的发行版

在 RedHat/CentOS 上安装 Manticore 最简单的方法是使用我们的 YUM 软件仓库：

安装软件仓库：

sudo yum install https://repo.manticoresearch.com/manticore-repo.noarch.rpm

然后安装 Manticore Search：

sudo yum install manticore manticore-extra

如果您正在从旧版本升级到 Manticore 6，建议先移除旧的软件包，以避免因更新的软件包结构导致的冲突：

sudo yum remove manticore*

这不会移除您的数据和配置文件。

如果您偏好使用“Nightly”（开发）版本，请执行：

sudo yum -y install https://repo.manticoresearch.com/manticore-repo.noarch.rpm && \
sudo yum -y --enablerepo manticore-dev install manticore manticore-extra manticore-common manticore-server manticore-server-core manticore-tools manticore-executor manticore-buddy manticore-backup manticore-columnar-lib manticore-server-core-debuginfo manticore-tools-debuginfo manticore-columnar-lib-debuginfo  manticore-icudata manticore-galera manticore-galera-debuginfo manticore-language-packs manticore-load

要从 Manticore 软件仓库下载独立的 RPM 文件，请按照 https://manticoresearch.com/install/ 上的说明操作。

如果您计划使用 indexer 从外部源创建表，您需要确保已安装相应的客户端库，以便您想要使用的索引源可用。下面这行命令将一次性安装所有库；您可以原样使用它，或者缩减它只安装您需要的库（对于仅 MySQL 源 - 仅 mysql-libs 应该就足够了，并且 unixODBC 不是必需的）。

sudo yum install mysql-libs postgresql-libs expat unixODBC

在 CentOS Stream 8 中，您可能需要运行：

dnf install mariadb-connector-c

如果您在尝试从 MySQL 构建普通表时遇到错误 sql_connect: MySQL source wasn't initialized. Wrong name in dlopen?。

该词形还原器需要 Python 3.9+。请确保您已安装它，并且它是使用 --enable-shared 配置的。

以下是在 Centos 8 中安装 Python 3.9 和乌克兰语词形还原器的方法：

# install Manticore Search and UK lemmatizer from YUM repository
yum -y install https://repo.manticoresearch.com/manticore-repo.noarch.rpm
yum -y install manticore manticore-lemmatizer-uk
# install packages needed for building Python
yum groupinstall "Development Tools" -y
yum install openssl-devel libffi-devel bzip2-devel wget -y
# download, build and install Python 3.9
cd ~
wget https://www.python.org/ftp/python/3.9.2/Python-3.9.2.tgz
tar xvf Python-3.9.2.tgz
cd Python-3.9*/
./configure --enable-optimizations --enable-shared
make -j8 altinstall
# update linker cache
ldconfig
# install pymorphy2 and UK dictionary
pip3.9 install pymorphy2[fast]
pip3.9 install pymorphy2-dicts-uk

• Debian

  • 11.0 (Bullseye)
  • 12.0 (Bookworm)
  • 13.0 (Trixie)

• Ubuntu

  • 18.04 (Bionic)
  • 20.04 (Focal)
  • 21.04 (Hirsute Hippo)
  • 22.04 (Jammy)
  • 24.04 (Noble)

• Mint

  • 19
  • 20
  • 21

在 Ubuntu/Debian/Mint 中安装 Manticore 最简单的方法是使用我们的 APT 仓库。

安装仓库：

wget https://repo.manticoresearch.com/manticore-repo.noarch.deb
sudo dpkg -i manticore-repo.noarch.deb
sudo apt update

（如果未安装 wget，请安装它；如果 apt-key 失败，请安装 gnupg2）。

然后安装 Manticore Search：

sudo apt install manticore manticore-extra

如果你要从旧版本升级到 Manticore 6，建议先删除旧的包，以避免因包结构更新导致的冲突：

sudo apt remove manticore*

这不会删除你的数据和配置文件。

如果你想要使用“Nightly”（开发）版本，请执行：

wget https://repo.manticoresearch.com/manticore-dev-repo.noarch.deb && \
sudo dpkg -i manticore-dev-repo.noarch.deb && \
sudo apt -y update && \
sudo apt -y install manticore manticore-extra manticore-common manticore-server manticore-server-core manticore-tools manticore-executor manticore-buddy manticore-backup manticore-columnar-lib manticore-server-core-dbgsym manticore-tools-dbgsym manticore-columnar-lib-dbgsym manticore-icudata-65l manticore-galera manticore-galera-dbgsym manticore-language-packs manticore-load

要从 Manticore 仓库下载独立的 DEB 文件，请按照 https://manticoresearch.com/install/ 上的说明操作。

Manticore 包依赖于 zlib 和 ssl 库，除此之外没有严格要求。然而，如果你打算使用 indexer 来从外部存储创建表，则需要安装相应的客户端库。要了解 indexer 具体需要哪些库，可以运行它并查看其输出顶部：

$ sudo -u manticore indexer
Manticore 3.5.4 13f8d08d@201211 release
Copyright (c) 2001-2016, Andrew Aksyonoff
Copyright (c) 2008-2016, Sphinx Technologies Inc (http://sphinxsearch.com)
Copyright (c) 2017-2020, Manticore Software LTD (https://manticoresearch.com)
Built by gcc/clang v 5.4.0,
Built on Linux runner-0277ea0f-project-3858465-concurrent-0 4.19.78-coreos #1 SMP Mon Oct 14 22:56:39 -00 2019 x86_64 x86_64 x86_64 GNU/Linux
Configured by CMake with these definitions: -DCMAKE_BUILD_TYPE=RelWithDebInfo -DDISTR_BUILD=xenial -DUSE_SSL=ON -DDL_UNIXODBC=1 -DUNIXODBC_LIB=libodbc.so.2 -DDL_EXPAT=1 -DEXPAT_LIB=libexpat.so.1 -DUSE_LIBICONV=1 -DDL_MYSQL=1 -DMYSQL_LIB=libmysqlclient.so.20 -DDL_PGSQL=1 -DPGSQL_LIB=libpq.so.5 -DLOCALDATADIR=/var/data -DFULL_SHARE_DIR=/usr/share/manticore -DUSE_ICU=1 -DUSE_BISON=ON -DUSE_FLEX=ON -DUSE_SYSLOG=1 -DWITH_EXPAT=1 -DWITH_ICONV=ON -DWITH_MYSQL=1 -DWITH_ODBC=ON -DWITH_POSTGRESQL=1 -DWITH_RE2=1 -DWITH_STEMMER=1 -DWITH_ZLIB=ON -DGALERA_SOVERSION=31 -DSYSCONFDIR=/etc/manticoresearch

这里可以看到 libodbc.so.2、libexpat.so.1、libmysqlclient.so.20 和 libpq.so.5 的字样。

下面是一个参考表，列出了不同 Debian/Ubuntu 版本中各种客户端库的列表：

发行版	MySQL	PostgreSQL	XMLpipe	UnixODBC
Ubuntu Trusty	libmysqlclient.so.18	libpq.so.5	libexpat.so.1	libodbc.so.1
Ubuntu Bionic	libmysqlclient.so.20	libpq.so.5	libexpat.so.1	libodbc.so.2
Ubuntu Focal	libmysqlclient.so.21	libpq.so.5	libexpat.so.1	libodbc.so.2
Ubuntu Hirsute	libmysqlclient.so.21	libpq.so.5	libexpat.so.1	libodbc.so.2
Ubuntu Jammy	libmysqlclient.so.21	libpq.so.5	libexpat.so.1	libodbc.so.2
Debian Jessie	libmysqlclient.so.18	libpq.so.5	libexpat.so.1	libodbc.so.2
Debian Buster	libmariadb.so.3	libpq.so.5	libexpat.so.1	libodbc.so.2
Debian Bullseye	libmariadb.so.3	libpq.so.5	libexpat.so.1	libodbc.so.2
Debian Bookworm	libmariadb.so.3	libpq.so.5	libexpat.so.1	libodbc.so.2

要查找提供这些库的软件包，可以使用例如 apt-file：

apt-file find libmysqlclient.so.20
libmysqlclient20: /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20
libmysqlclient20: /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20.2.0
libmysqlclient20: /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20.3.6

注意，你只需要根据你打算使用的存储类型安装相应的库。所以如果你只打算从 MySQL 创建表，则只需安装 MySQL 库（上述例子中为 libmysqlclient20）。

最后，安装所需的软件包：

sudo apt-get install libmysqlclient20 libodbc1 libpq5 libexpat1

如果你根本不打算使用 indexer 工具，则无需查找和安装任何库。

为了启用 CJK 分词支持，官方包包含嵌入了 ICU 库的二进制文件并包括 ICU 数据文件。它们独立于系统中可能存在的 ICU 运行时库，且无法升级。

词干提取器需要 Python 3.9+。请确保你已安装并启用了 --enable-shared 配置的 Python。

以下是在 Debian 和 Ubuntu 上安装 Python 3.9 和乌克兰语词干提取器的方法：

# install Manticore Search and UK lemmatizer from APT repository
cd ~
wget https://repo.manticoresearch.com/manticore-repo.noarch.deb
sudo dpkg -i manticore-repo.noarch.deb
sudo apt -y update
sudo apt -y install manticore manticore-lemmatizer-uk
# install packages needed for building Python
sudo apt -y update
sudo apt -y install wget build-essential libreadline-dev libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libffi-dev zlib1g-dev
# download, build and install Python 3.9
cd ~
wget https://www.python.org/ftp/python/3.9.4/Python-3.9.4.tgz
tar xzf Python-3.9.4.tgz
cd Python-3.9.4
./configure --enable-optimizations --enable-shared
sudo make -j8 altinstall
# update linker cache
sudo ldconfig
# install pymorphy2 and UK dictionary
sudo LD_LIBRARY_PATH=~/Python-3.9.4 pip3.9 install pymorphy2[fast]
sudo LD_LIBRARY_PATH=~/Python-3.9.4 pip3.9 install pymorphy2-dicts-uk

brew install manticoresoftware/tap/manticoresearch manticoresoftware/tap/manticore-extra

将 Manticore 作为 brew 服务启动：

brew services start manticoresearch

Manticore 的默认配置文件位于 /usr/local/etc/manticoresearch/manticore.conf 或 /opt/homebrew/etc/manticoresearch/manticore.conf。

如果您计划使用 indexer 从 MySQL、PostgreSQL 或其他使用 ODBC 的数据库等来源获取数据，可能需要额外的库，如 mysql@5.7、libpq 和 unixodbc。

如果您更喜欢“Nightly”（开发）版本，请执行：

brew tap manticoresoftware/tap-dev
brew install manticoresoftware/tap-dev/manticoresearch-dev manticoresoftware/tap-dev/manticore-extra-dev manticoresoftware/tap-dev/manticore-language-packs
brew services start manticoresearch-dev

Manticore 可以通过多种方式安装在 Windows 上。我们推荐使用 WSL（Windows Subsystem for Linux），因为它支持复制且不需要 Docker。以下是推荐和替代的方法。

要在 Windows 上安装 Manticore Search，您首先需要启用 Windows 子系统 Linux。WSL2 允许您在 Windows 上原生运行 Linux 二进制文件。要使用此方法，您需要运行 Windows 10 版本 2004 及更高版本或 Windows 11。

请参考微软官方指南获取安装 WSL2 的逐步说明。

要通过 WSL2 在 Windows 上安装 Manticore，请参考Debian 和 Ubuntu 安装部分。

注意：通过 WSL2 安装 Manticore 是推荐的方法，因为它相比使用本地 Windows 软件包提供更好的兼容性。

或者，您也可以作为本地 Windows 二进制文件安装 Manticore，这种方式需要为 Manticore Buddy 使用 Docker，步骤如下：

1. 安装 Docker Desktop 并启动它。
2. 下载 Manticore Search 安装程序（可在安装页面找到链接）并运行。按照安装说明操作。
3. 选择安装目录。
4. 选择要安装的组件。我们建议全部安装。
5. Manticore 附带预配置的 RT 模式 manticore.conf 文件，无需额外配置。

注意：本地 Windows 二进制文件不支持复制。

要将 Manticore Search 服务器安装为 Windows 服务，请运行：

\path\to\searchd.exe --install --config \path\to\config --servicename Manticore

确保使用配置文件的完整路径，否则 searchd.exe 在作为服务启动时将无法找到它。

安装完成后，可以通过 Microsoft Management Console 的服务管理器启动该服务。

服务启动后，您可以通过 MySQL 命令行界面访问 Manticore：

mysql -P9306 -h127.0.0.1

请注意，在本手册的大多数示例中，我们使用 -h0 连接到本地主机，但在 Windows 上，您必须显式使用 localhost 或 127.0.0.1。