Core本地部署教程，零基础搭建智能助手

本文手把手带你从零开始在本地Ubuntu或Debian系统上完整部署一个安全可控、数据不出域的智能助手Core，涵盖环境搭建、Ollama运行DeepSeek-R1大模型、Open WebUI图形界面配置、飞书机器人无缝接入，以及ChromaDB知识库注入与RAG检索能力启用五大关键步骤，即使毫无部署经验，也能凭借清晰指令和可复现操作，快速拥有属于自己的高性能私有AI助手。

如果您希望在本地环境中运行一个完全可控、数据不出域的智能助手，但缺乏从零开始部署的经验，则可能是由于缺少清晰的技术路径与可复现的操作指引。以下是完成Core本地部署全流程的具体步骤：

一、环境准备与基础依赖安装

该步骤旨在构建稳定、兼容的底层运行环境，确保后续模型服务与Web界面组件能正常加载与通信。需统一操作系统版本、包管理器及关键运行时版本，避免因环境碎片化导致服务启动失败。

1、确认系统为Ubuntu 22.04 LTS或Debian 12，执行lsb_release -a验证发行版信息。

2、更新系统软件包索引：执行sudo apt update && sudo apt upgrade -y。

3、安装基础工具链：执行sudo apt install -y curl wget git gnupg2 software-properties-common。

4、安装并启用Docker CE：依次执行curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg、echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null、sudo apt update、sudo apt install -y docker-ce docker-ce-cli containerd.io。

5、将当前用户加入docker组以避免每次使用sudo：执行sudo usermod -aG docker $USER，随后注销并重新登录生效。

二、Ollama服务部署与DeepSeek-R1模型拉取

此步骤通过Ollama提供轻量级模型运行时，实现本地大语言模型的即装即用。Ollama自动处理CUDA驱动适配、模型量化加载与HTTP API暴露，是Core架构中模型推理层的核心载体。

1、下载并安装Ollama：执行curl -fsSL https://ollama.com/install.sh | sh。

2、验证Ollama是否运行：执行ollama serve &后台启动，再执行ollama list确认服务响应。

3、拉取DeepSeek-R1-7B-Q4_K_M量化模型：执行ollama pull deepseek-r1:7b-q4_k_m。

4、测试模型响应能力：执行ollama run deepseek-r1:7b-q4_k_m，输入你好，请自我介绍，观察是否返回结构化应答。

5、若需GPU加速，确认NVIDIA驱动已安装且nvidia-smi可见，Ollama将自动启用cudnn后端。

三、Open WebUI服务容器化部署

该步骤引入Open WebUI作为Core的前端交互层，其基于React构建，支持多会话管理、历史持久化与插件扩展。通过Docker Compose编排，可与Ollama服务无缝对接，无需修改源码即可完成身份认证与模型路由配置。

1、创建部署目录：mkdir -p ~/core-webui && cd ~/core-webui。

2、创建docker-compose.yml文件，内容包含webui服务与ollama服务互联配置，其中OLLAMA_BASE_URL设为http://host.docker.internal:11434（Mac/Windows）或http://172.17.0.1:11434（Linux）。

3、设置管理员凭证：在docker-compose.yml中挂载./config.json，内含{"ADMIN_EMAIL":"admin@example.com","ADMIN_PASSWORD":"CoreDeploy2026!"}。

4、启动服务栈：执行docker-compose up -d。

5、检查容器状态：执行docker-compose ps，确认webui与ollama均显示Up且无重启循环。

四、飞书机器人接入与消息路由配置

此步骤将本地Core助手接入飞书组织通讯流，使用户可通过飞书群聊或单聊直接触发本地模型响应。核心在于建立飞书事件网关与本地Webhook之间的双向可信通信，绕过云端模型API调用链路。

1、登录飞书开发者后台，创建企业自建应用，获取App ID与App Secret。

2、在应用配置页启用“机器人”能力，复制生成的Verification Token与Encrypt Key。

3、在本地部署目录中新建feishu-config.yaml，填入上述密钥及WEBHOOK_URL: http://your-server-ip:8080/feishu/callback。

4、启动飞书适配服务：执行python3 -m feishu_adapter --config feishu-config.yaml（需提前安装fastapi与pydantic）。

5、在飞书客户端添加机器人至目标群组，发送@机器人 hello，观察本地终端是否打印接收到的JSON事件。

五、本地知识库注入与RAG能力启用

该步骤赋予Core助手基于私有文档的理解与引用能力，通过向量数据库实现非结构化文本的语义检索。采用ChromaDB作为嵌入存储后端，与Ollama内置的nomic-embed-text嵌入模型协同工作，形成闭环RAG流水线。

1、启动ChromaDB服务：执行docker run -d -p 8000:8000 --name chroma -e CHROMA_TELEMETRY=False chromadb/chroma。

2、安装chromadb Python包：执行pip3 install chromadb。

3、准备PDF/Markdown格式的企业知识文档，存放于~/core-data/docs/路径下。

4、执行索引脚本：python3 ingest.py --docs-dir ~/core-data/docs/ --db-path http://localhost:8000，脚本将自动分块、嵌入、写入Chroma集合。

5、在Open WebUI中启用RAG开关，并将retriever_url设为http://localhost:8000/api/v1/collections/core-kb/query。

好了，本文到此结束，带大家了解了《Core本地部署教程，零基础搭建智能助手》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多科技周边知识！