---
title: "macOS"
date: 0001-01-01
summary: "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。
 方案二：本地安装 #  使用一键安装脚本进行安装，请按照以下步骤操作："
---


# MacOS 环境下使用 Easysearch

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

## 前置要求

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

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

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

```bash
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]({{< relref "./docker.md" >}})。

## 方案二：本地安装

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

```bash
# 打开终端，使用 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
```

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

## 验证安装

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

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

## 常见问题

### 忘记 admin 密码

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

### macOS 安全提示

如果遇到"无法验证开发者"的提示，可以在 **系统偏好设置 → 安全性与隐私** 中允许运行，或执行：

```bash
xattr -d com.apple.quarantine bin/easysearch
```

### 停止 Easysearch

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

## 延伸阅读

- [Docker 部署]({{< relref "./docker.md" >}})
- [测试环境部署]({{< relref "./test-env.md" >}})
- [系统调优]({{< relref "/docs/deployment/config/settings.md" >}})