随着人工智能技术的迅猛发展，Coco AI 作为一款开源、跨平台的统一搜索与生产力工具，凭借其智能搜索、数据连接和企业级协作功能，受到越来越多用户和企业的青睐。
本文将为您提供 Windows 环境下 Coco AI 的最全面部署指南，涵盖服务端和客户端的安装与配置，以及部署过程中的注意事项。
无论你是个人用户还是企业使用，本指南都将帮助你快速上手 Coco AI，释放其强大潜力。
1. Coco AI 核心组成
Coco AI 分为两个主要组件：
1.1 服务端（Coco Server）：
负责核心功能，包括数据源、API token、嵌入组件、设置等。
它通过 API 与 Easysearch 交互，并支持私有部署以确保数据安全。
1.2 客户端（Coco App）
提供用户友好的界面，用于搜索、聊天（智能问答），支持跨平台使用（Windows、macOS、Linux）。
Easysearch 作用特别说明
Coco AI 的底层架构依赖 Easysearch，这是一个强大的搜索和数据管理引擎。Easysearch 负责整合 AI 服务、数据源管理和 API 接口，确保系统能够高效处理来自多种数据源的查询和索引请求。它是服务端运行的关键依赖，直接影响搜索性能和数据连接能力。
如何快速搭建高可用 Easysearch 集群 ？Ubuntu 多节点部署指南
Elasticsearch 国产化替代方案之一 Easysearch 的介绍与部署指南
在 Windows 环境下部署 Coco AI，需要确保服务端正确配置 Easysearch，并与客户端无缝对接。以下将详细介绍部署步骤。
2. Coco AI 部署
2.1 前置条件
在 Windows 下部署 Coco AI 服务端之前，请确保满足以下要求：
操作系统：Windows 10/11 或 Windows Server 2019/2022（64 位）。
硬件要求：至少 8GB 内存；双核 CPU，SSD 存储。
依赖软件：
这里可能读者会问，用 Elasticsearch 可以不？ 当然可以，只不过一些插件比如分词器需要自己部署配齐。
2.2 Easysearch 部署
官方文档地址：
https://docs.infinilabs.com/easysearch/main/docs/getting-started/install/windows/
我个人建议直接下载安装包，手动部署。
2.2.1 下载安装包
下载地址：https://release.infinilabs.com/easysearch/stable/
2.2.2 修改 easysearch.yml 配置
建议禁用安装选型。
#用记事本打开 config/easysearch.yml，并修改配置。
security.enabled: false复制
很多读者可能不解？为啥？不是推荐安全吗？
一方面：简化部署，我们本来是内网，不对外映射的，安全自己可控。 另一方面：官方文档也提到了“由于 Windows 环境下默认没有 openssl，生成证书不太方便”。
最终配置参考：
#cluster.name: my-application
#node.name: node-1
#node.attr.rack: r1
#path.data: path/to/data
#path.logs: path/to/logs
#bootstrap.memory_lock: true
#network.host: 192.168.0.1
#http.port: 9200
#discovery.seed_hosts: ["host1", "host2"]
#cluster.initial_master_nodes: ["node-1", "node-2"]
#gateway.recover_after_nodes: 3
#action.destructive_requires_name: true
#cluster.routing.allocation.disk.threshold_enabled: false
#node.max_local_storage_nodes: 3
#bootstrap.system_call_filter: false
#elasticsearch.api_compatibility: true
#elasticsearch.api_compatibility_version: "8.9.0"
security.enabled: false复制
也就是说，我们只修改了安全选型，其他默认没有动。
2.2.3 一键部署 Easysearch 插件
bin/initialize.sh复制
实话说，这个脚本我本地执行失败了。
windows 下不方便搞清原因，我的诉求是安装插件，怎么都是安装。我选择，手动挨个安装插件。
打开脚本可以看到脚本执行的内容，本质就是这个函数。
function install_esplugins() {
plugins=(sql analysis-ik analysis-pinyin analysis-stconvert index-management ingest-common ingest-geoip ingest-user-agent mapper-annotated-text mapper-murmur3 mapper-size transport-nio knn)
for p in${plugins[@]}; do
if [[ "$OSTYPE" = "msys" ]]; then
echo y | ${ES_HOME}/bin/easysearch-plugin.bat install $p
else
echo y | ${ES_HOME}/bin/easysearch-plugin install $p
fi
done
echo
echo"All easysearch plugins have been installed."
}复制
建议手动逐个安装，也不复杂，我整理后如下：
/bin/easysearch-plugin.bat install analysis-ik
/bin/easysearch-plugin.bat install analysis-pinyin
/bin/easysearch-plugin.bat install analysis-stconvert
/bin/easysearch-plugin.bat install index-management
/bin/easysearch-plugin.bat install ingest-common
/bin/easysearch-plugin.bat install ingest-geoip
/bin/easysearch-plugin.bat install ingest-user-agent
/bin/easysearch-plugin.bat install mapper-annotated-text
/bin/easysearch-plugin.bat install mapper-murmur3
/bin/easysearch-plugin.bat install mapper-size
/bin/easysearch-plugin.bat install transport-nio
/bin/easysearch-plugin.bat install knn复制
建议挨个执行一下即可。
执行后，查看插件列表清单如下图所示：
2.2.4 启动 easysearch.bat
cmd 命令行窗口启动 easysearch.bat 即可。
如果不执行 2.2.3 安装插件，直接执行 2.2.4 启动脚本，然后再直接执行 coco AI 服务端，会有报错如下：
[04-03 11:06:58] [ERR] [app.go:397] panic: failed to init schema,{"error":{"root_cause":[{"type":"illegal_argument_exception","reason":"analyzer [combined_text_analyzer]has not been configured in mappings"}],"type":"illegal_argument_exception","reason":"analyzer [combined_text_analyzer]has not been configured in mappings"},"status":400}复制
原因是：缺少分词器。
怎么办？还得少不了 2.2.3 的步骤。
这一步我摸索了不少时间，希望大家能避开弯路！
执行成功标志如下图所示：
2.3 Coco AI 服务端部署
2.3.1 Coco AI 服务端下载地址
截图见官网：
下载地址：
https://release.infinilabs.com/coco/server/stable/
2.3.2 解压后修改配置
为啥要改配置，想一下咱们说 coco AI 底层依赖是 Easysearch，那可不得配置一下呀！
配置文件名称：coco.yml, 核心改动如下：
env:
。。。。省略的未动......
ES_ENDPOINT: http://localhost:9200
#ES_USERNAME: admin
#ES_PASSWORD:复制
改动上述 http://localhost:9200
的地址其实是 Easysearch 地址。
用户名和密码都注释掉，因为咱们前文说了，我们安全禁用了。
2.3.3 命令行下启动 Coco AI server 端
建议命令行下执行，而非直接双击！命令行启动如下图所示。
启动成功标志如下图所示。
2.3.4 浏览器访问 Coco AI 服务端完成基础配置
首次访问需要输入账号和密码、邮箱等信息。
接下来会进入配置界面。
左侧导航栏很清晰，建议至少要配置：数据源和设置部分。
数据源核心就是咱们未来要检索和智能问答的数据源头。默认支持的四大核心如下：
我这里以语雀文档为例完成配置。
语雀 token （个人版付费才可以获取）获取办法参考：
2.4 Coco AI 客户端部署
2.4.1 Coco AI 客户端下载地址
截图见官网：
下载地址：
https://release.infinilabs.com/coco/app/stable/
3. 小结
通过以上步骤，我们已在 Windows 环境下成功部署了 Coco AI 服务端和客户端。服务端依赖 Easysearch 提供强大的搜索和数据管理能力，而客户端则为用户提供了直观的交互界面。
Coco AI 的开源特性和高度可定制性使其适用于各种场景，从个人知识管理到企业级协作。
立即开始体验 Coco AI，有问题欢迎留言探讨交流。
更短时间更快习得更多干货！
和全球超2000+ Elastic 爱好者一起精进！
elastic6.cn——ElasticStack进阶助手
抢先一步学习进阶干货！
