企业官网建设流程全解析

3步跑通 self-hosted-ai-starter-kit：本地AI环境部署完整指南

【免费下载链接】self-hosted-ai-starter-kitThe Self-hosted AI Starter Kit is an open-source template that quickly sets up a local AI environment. Curated by n8n, it provides essential tools for creating secure, self-hosted AI workflows.项目地址: https://gitcode.com/GitHub_Trending/se/self-hosted-ai-starter-kit

self-hosted-ai-starter-kit 是 n8n 出品的开源模板，把 n8n、Ollama、Qdrant、PostgreSQL 打包进一份 docker-compose.yml，用 Docker 一键拉起后，得到一套完全自托管的本地 AI 环境：模型推理、工作流与数据全部留在自己机器上，适合"AI 调用日志不能出内网"这类数据敏感场景。

部署完成能得到什么：一条全本地 AI 工作流

先看效果。部署成功后，浏览器打开localhost:5678就是 n8n 的可视化编辑器，仓库已预置一条演示工作流：Chat Trigger 接收提问，Ollama 在本地跑 Llama 3.2 生成回复，全程不经过外部 API。

除了这条现成工作流，还附带 400 多个 n8n 集成、Qdrant 向量数据库（做 RAG）和 PostgreSQL 存储层，全部由 compose 自动拉起，无需逐个安装。

环境要求清单：部署前四项检查

第一步：拉取代码并准备 .env

git clone https://gitcode.com/GitHub_Trending/se/self-hosted-ai-starter-kit cd self-hosted-ai-starter-kit cp .env.example .env

.env存放 PostgreSQL 密码与 n8n 加密密钥，compose 强制要求该文件存在，建议趁现在就把默认值换成自己的强密码。

第二步：docker compose 启动命令

docker compose --profile cpu up

纯 CPU 机器直接用这条命令；有显卡可把 profile 换成gpu-nvidia或gpu-amd。首次启动要拉镜像并预载 llama3.2 模型，终端长时间无输出属于正常现象，不建议强制终止。

第三步：结果验证与 Ollama 日志排查

✅ 按 4 步确认部署真的成功：

1. 浏览器打开localhost:5678，完成一次性 n8n 初始化；
2. 打开预置的演示工作流，点画布下方的 Chat 按钮发一条消息；
3. 若迟迟没有回复，多半是模型还在下载，可用命令实时查看进度：

docker compose logs -f ollama

4. 编辑器中出现模型回复，说明本地推理已生效；再执行docker compose ps，确认 4 个容器均为 Up。

关键文件导读：docker-compose.yml 里的四个组件

n8n/demo-data/credentials/ 中的示例凭证会在首次启动时由导入容器自动写入 n8n；仓库的shared目录被挂载到容器内/data/shared，文件类节点读写本地文件时用这个路径。

避坑排查：三个高频故障点

⚠️ 首次部署基本都会撞上其中一条：

1. 5678 端口被占用：改 docker-compose.yml 中端口映射左侧数字后重启；
2. 启动报错提示.env缺失：漏了第一步的 cp 操作，补齐后重跑即可；
3. 工作流一直不回复：优先确认 Ollama 模型是否下载完成，而不是怀疑配置；
4. 后放入 workflows 目录的文件不会自动导入：导入容器只在首次启动、且库里没有任何工作流时执行，新增文件需到 n8n 编辑器里手动导入。

收尾动作：部署成功后的第一件事

验证通过后，先把.env里的默认密码改掉，再把自己的工作流 JSON 放入 n8n/demo-data/workflows/ 并在编辑器中导入，然后接入 Ollama 节点与 Qdrant 节点，开始搭第一条自有工作流。

【免费下载链接】self-hosted-ai-starter-kitThe Self-hosted AI Starter Kit is an open-source template that quickly sets up a local AI environment. Curated by n8n, it provides essential tools for creating secure, self-hosted AI workflows.项目地址: https://gitcode.com/GitHub_Trending/se/self-hosted-ai-starter-kit