【3分钟上手】coco-server 小白级图文安装指南：从0到1搭建你的AI知识库
项目地址: https://gitcode.com/infinilabs/coco-server 为什么选择coco-server？
你是否遇到过这些痛点？
- 想搭建AI知识库却被Python依赖搞得头大？
- 开源项目文档太复杂，小白看不懂？
- 服务器配置步骤繁琐，动不动就报错？
coco-server作为极限实验室推出的轻量级AI服务端，彻底解决了这些问题！它内置各类数据源连接器和大模型RAG Pipeline，完全不需要Python依赖，下载解压即可运行。今天我们就用最通俗的语言，带你3分钟从零搭建属于自己的AI知识库。
安装前准备
系统要求
| 环境 | 最低配置 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows/macOS/Linux | Linux/Ubuntu 20.04+ |
| CPU | 双核 | 四核 |
| 内存 | 4GB | 8GB |
| 硬盘 | 10GB空闲空间 | SSD 20GB+空闲空间 |
| 网络 | 能访问镜像仓库 | 稳定网络连接 |
你需要准备
- 电脑一台（本教程以Linux系统为例，Windows/macOS操作类似）
- 终端工具（Windows推荐PowerShell，macOS/Linux直接使用终端）
- 浏览器（Chrome/Firefox/Edge最新版）
两种安装方法对比
| 安装方式 | 操作难度 | 适合人群 | 优点 | 缺点 |
|---|---|---|---|---|
| 容器一键安装 | ⭐⭐⭐⭐⭐ | 小白用户 | 3分钟完成，自动配置 | 自定义配置稍复杂 |
| 手动安装 | ⭐⭐⭐ | 开发者/高级用户 | 高度自定义 | 需要手动配置依赖 |
方法一：容器一键安装（推荐小白）
步骤1：安装容器引擎
如果你的电脑还没有安装容器引擎，请先根据系统类型安装：
Windows/macOS用户：
下载容器引擎桌面版：https://www.docker.com/products/docker-desktop
安装完成后启动容器引擎，在终端输入以下命令验证：
docker --version
Linux用户：
# Ubuntu/Debian
sudo apt-get update && sudo apt-get install docker.io -y
# 启动容器引擎服务
sudo systemctl start docker && sudo systemctl enable docker
# 验证安装
docker --version
步骤2：一键启动coco-server
打开终端，复制粘贴以下命令，然后按下回车：
docker run -d \
--name cocoserver \
-p 9000:9000 \
-v data:/app/easysearch/data \
-v config:/app/easysearch/config \
-v logs:/app/easysearch/logs \
infinilabs/coco:0.7.0
⚠️ 安全提示：首次启动会自动生成随机管理员密码，需要从日志中获取
步骤3：获取初始密码
运行以下命令查看容器日志，找到管理员密码：
docker logs cocoserver | grep "admin:"
你会看到类似这样的输出：
[INF] admin: your-initial-password-here
步骤4：访问管理界面
打开浏览器，输入地址：http://localhost:9000
使用用户名admin和刚刚获取的密码登录系统。
方法二：手动安装（适合开发者）
如果你需要自定义更多配置，可以选择手动安装方式。
步骤1：安装Easysearch
docker run -itd \
--name easysearch -p 9200:9200 \
-v data:/app/easysearch/data \
-v config:/app/easysearch/config \
-v logs:/app/easysearch/logs \
infinilabs/easysearch:1.14.1
获取Easysearch初始密码：
docker logs easysearch | grep "admin:"
步骤2：下载coco-server源码
git clone https://gitcode.com/infinilabs/coco-server.git
cd coco-server
步骤3：配置环境变量
# 设置Easysearch密码
export ES_PASSWORD=你的Easysearch密码
# 设置大模型模型（可选）
export MODEL=deepseek-r1:1.5b
步骤4：启动服务
# Linux/macOS
./bin/coco
# Windows
bin\coco.exe
启动成功后，你会看到类似以下输出：
___ ___ ___ ___ _ _____
/ __\/___\/ __\/___\ /_\ \_ \
/ / // // / // // //_\\ / /\/
/ /__/ \_// /__/ \_// / _ \/\/ /_
\____|___/\____|___/ \_/ \_/\____/
[COCO] Coco AI - search, connect, collaborate – all in one place.
[COCO] 1.0.0_SNAPSHOT#001, 2024-10-23 08:37:05, 2025-12-31 10:10:10
[INF] coco is up and running now.
访问管理界面
无论使用哪种安装方式，启动成功后，打开浏览器访问：
http://localhost:9000
首次登录后，系统会引导你完成初始设置，包括：
- 修改管理员密码
- 配置数据源
- 连接大模型
- 创建第一个知识库
常见问题解决
问题1：端口9000被占用
# 查看占用进程
sudo lsof -i:9000
# 终止进程（替换PID）
sudo kill -9 PID
# 或修改映射端口
docker run -d --name cocoserver -p 9001:9000 ...
问题2：忘记管理员密码
# 停止容器
docker stop cocoserver
# 删除容器
docker rm cocoserver
# 重新启动（会生成新密码）
docker run -d --name cocoserver -p 9000:9000 ...
问题3：容器启动失败
检查容器引擎服务是否运行：
# Linux
sudo systemctl status docker
# 启动容器引擎
sudo systemctl start docker
升级coco-server
当有新版本发布时，升级步骤非常简单：
# 拉取新版本镜像
docker pull infinilabs/coco:最新版本号
# 停止旧容器
docker stop cocoserver
# 删除旧容器
docker rm cocoserver
# 启动新容器（使用原来的命令）
docker run -d --name cocoserver ...
⚠️ 注意：升级时不要删除数据卷，否则会丢失所有数据！
总结
通过本教程，你已经学会了两种安装coco-server的方法：
- 容器一键安装：适合小白用户，3分钟即可完成
- 手动安装：适合开发者，可高度自定义配置
现在你可以开始探索coco-server的强大功能了，比如连接Notion、GitHub、本地文件等数据源，搭建属于自己的AI知识库。
如果你在使用过程中遇到问题，可以查阅官方文档或加入社区寻求帮助。祝你使用愉快！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
