MacOS 环境下使用 Easysearch #

目前，有多种方案可以在 MacOS 下体验 Easysearch。可以选择使用 Docker 方式安装，或者使用本地安装包进行安装。

前置要求 #

macOS 10.15 (Catalina) 或更高版本
JDK 11+（推荐 JDK 17）。Bundle 包已内置 JDK，无需单独安装。
至少 4 GB 可用内存

方案一：Docker 安装（推荐） #

如果您的 MacOS 环境上有 Docker（Docker Desktop、OrbStack 等），可以用最简单的方式启动 Easysearch：

docker run -d --name easysearch \
  -p 9200:9200 \
  -e "EASYSEARCH_INITIAL_ADMIN_PASSWORD=EasysearchP@ssw0rd!" \
  -e "ES_JAVA_OPTS=-Xms512m -Xmx512m" \
  infinilabs/easysearch:latest

详细 Docker 配置请参考 Docker 环境下使用 Easysearch。

方案二：本地安装 #

使用一键安装脚本进行安装，请按照以下步骤操作：

# 打开终端，使用 bash 执行以下命令
mkdir -p /Users/$(whoami)/data/easysearch

# 下载最新版本的 Easysearch 并安装
curl -sSL http://get.infini.cloud | bash -s -- -p easysearch -d /Users/$(whoami)/data/easysearch

# 进入 Easysearch 目录
cd /Users/$(whoami)/data/easysearch

# 初始化 Easysearch
bin/initialize.sh -s

# 运行 Easysearch
bin/easysearch -d -p pid

注意：初始化过程中会生成随机密码，并不会保存到日志文件中，只会在终端显示一次，请妥善保存。

验证安装 #

# 使用初始化时输出的密码
curl -ku admin:YOUR_PASSWORD https://localhost:9200

# 预期输出包含
# "cluster_name" : "easysearch",
# "tagline" : "You Know, For Easy Search!"

常见问题 #

忘记 admin 密码 #

# 使用密码重置脚本
cd /Users/$(whoami)/data/easysearch
bin/reset_admin_password.sh

macOS 安全提示 #

如果通过 Chrome 等浏览器下载并解压安装包，macOS 可能会给解压后的文件附加 com.apple.quarantine 隔离标签。此时启动时可能出现 "java" cannot be opened because the developer cannot be verified 或“无法验证开发者”的提示，即使 bundled JDK 的代码签名本身是合法的。

bin/initialize.sh 会在 macOS 上自动检测并清理 Easysearch 启动脚本和 bundled JDK 可执行文件上的隔离标签。正常情况下只需要重新执行初始化脚本：

bin/initialize.sh

如需手动确认某个文件是否带有隔离标签，可以执行：

xattr -p com.apple.quarantine jdk/Contents/Home/bin/java

如果初始化脚本提示自动清理失败，可手动清理相关可执行文件的隔离标签，例如：

xattr -d com.apple.quarantine bin/easysearch
xattr -d com.apple.quarantine jdk/Contents/Home/bin/java

停止 Easysearch #

# 使用 PID 文件停止
kill $(cat /Users/$(whoami)/data/easysearch/pid)