最近学了K8S，为了测试方便测试搭了一个K3S集群，然后使用helm运行一下Easysearch。

参考文档：https://docs.infinilabs.com/easysearch/main/docs/deployment/install-guide/helm/

首先添加helm仓库并更新。

1
2

helm repo add infinilabs https://helm.infinilabs.com
helm repo update

然后新建命名空间，我这里叫做es（下同），也可以使用其他名字。

1

kubectl create namespace es

最近在用 Docker 部署 Easysearch，本以为是个简单的事情，结果在数据持久化上栽了跟头，每次停止再启动容器之后都会503，在后面成了我百思不得其解的问题，后来一直在某次的meetup中，请教了原厂的罗老师，一句话点醒梦中人，Easysearch用的具名卷，防止宿主机的数据覆盖容器里的数据。

这次排查非常典型：容器日志看起来像“卡在某一行”，Easysearch 甚至已经启动，但 Coco Server 的进程并没有真正跑起来。

最后发现根因是：磁盘剩余空间不足（< 5GB）触发 coco 自检阈值，直接 panic 退出，造成了“日志一直卡住、服务一直起不来”的假象，差不多排查了半个多小时。

背景：目标与现象

目标是在 RK3566 / Armbian 上把 cocoai-arm:test 跑起来，并通过宿主机端口访问服务：

• 宿主机映射：-p 9000:9000

• 容器挂载 volume：

  • coco_data_vol:/app/easysearch/data
  • coco_config_vol:/app/easysearch/config
  • coco_logs_vol:/app/easysearch/logs

之前在泰山派上运行了Easysearch，这次也想着是不是可以在泰山派开发板RK3566上运行Coco server，毕竟这板子功耗小，适合常开。

我的RK3566上是Armbian，但是没有配置网络环境，访问Dockerhub有问题，所以从Macbook 上下载玩，然后通过离线方式导成tar文件。我的镜像改了tag叫做cocoai-arm:test，你也可以不改。

1

docker save -o cocoai-arm_test.tar cocoai-arm:test

然后通过SCP上传到RK3566的开发板

使用 Docker 启动 Coco AI 的时候会自带一个 Easysearch，我们使用连接器连接外部数据源的时候，就会把这个数据解析到 Easysearch 里。

但是默认的话，容器不会把这个 Easysearch 的端口映射出来，那就需要我们自己做些小的技巧：在官网的命令上修改一下，把 9200 端口先映射出来。

启动命令如下：

1
2
3
4
5
6
7

docker run -d --name cocoserver \
  -p 9000:9000 \
  -p 9200:9200 \
  -v coco_data_vol:/app/easysearch/data \
  -v coco_config_vol:/app/easysearch/config \
  -v coco_logs_vol:/app/easysearch/logs \
  infinilabs/coco:0.10.0-2678

还在为记不住 Elasticsearch DSL 语法发愁？match 和 term 傻傻分不清？聚合查询写半天还报错？

今天教你用 MCP（Model Context Protocol）封装 Easysearch，让 AI 帮你操作集群。从此告别 DSL，用自然语言就能完成搜索、写入、聚合统计！

效果演示

先看看最终效果。以下是我和 Kiro 的真实对话记录：

我：集群健康吗？

Kiro：

1
2
3
4
5
6
7

{
  "cluster_name": "infinilabs",
  "status": "green",
  "number_of_nodes": 1,
  "active_shards": 2,
  "active_shards_percent_as_number": 100.0
}

🟢 集群很健康！状态 green，1 个节点，2 个活跃分片，100% 健康。

最近在群里看到不少朋友反馈，Easysearch 升级到某个版本之后，日志文件里不再能看到初始化密码了。以前版本我们可以轻松在 /app/easysearch/logs/initialize.log 中找到，比如 exec 进入容器后直接 grep curl 搜索 Easysearch URI 字段，就能定位密码所在行。但现在——无论是 grep 还是手动翻，都空空如也。

问题现象：日志里“密码不见了”

过去版本，Easysearch 初始化时会将自动生成的默认密码打印到日志文件中。
如下图所示，这样的日志路径在老版本中非常常见：

在日常使用电脑的过程中，很多人习惯安装各种效率工具、启动器、播放器或日程管理应用。但这些功能其实都能被一个智能平台集中完成——这就是 Coco AI。

除了搜索和信息整理之外，Coco AI 还提供了一个完善的 插件系统。通过插件，它几乎可以控制电脑的方方面面：

操作本地备忘录、播放音乐、查找应用，甚至取代 macOS 的导航栏。更令人惊喜的是，它还内置小游戏，比如大家熟悉的 2048。

在 Elasticsearch 或者 Easysearch 这样的搜索引擎中，写入流程是理解性能调优和搜索可见性最核心的部分之一。许多同学刚接触 ES 时，最常见的疑惑就是：“为什么我刚插入的数据查不到？”、“refresh 和 flush 有什么区别？”、“refresh_interval 设置成多少合适？”

这篇文章我们就专门讲清楚 refresh（刷新） 这一环节。它是 ES 写入流程的关键节点，既影响了数据什么时候能被搜索到，也影响了整个系统的写入性能和稳定性。

在使用 Docker 部署 Easysearch 时，通常需要在启动容器时设置初始管理员密码。如果没有预先设置密码，系统可能会使用默认值或随机生成密码，不仅增加后续管理的复杂性，也存在安全隐患。

本文将详细介绍在 docker run 启动 Easysearch 容器时，通过不同方式传入环境变量（env）来自定义密码的多种方法。每种方法都配有实用示例和说明，帮助你根据实际环境灵活选择。