self-hosted-ai-starter-kit

环境要求

• 已安装 Docker 与 Docker Compose（支持通过 compose 文件编排多容器）
• 已安装 git 用于克隆仓库
• 本地可访问 5678 端口的浏览器
• 足够的磁盘空间与网络，用于首次拉取镜像和下载本地模型

安装与启动步骤

1. 1克隆仓库

   把官方模板仓库完整克隆到本地，得到包含 Docker Compose 配置的目录。

   git clone https://github.com/n8n-io/self-hosted-ai-starter-kit.git

   复制

2. 2进入项目目录

   切换到刚克隆的目录，后续所有操作都在该目录内执行。

   cd self-hosted-ai-starter-kit

   复制

3. 3生成环境文件

   从示例文件复制出 .env，供 Docker Compose 读取各项配置。

   cp .env.example .env

   复制

4. 4修改密钥与密码

   按 README 提示，用编辑器打开 .env，把示例中的密钥和密码改成自己的强密码后再启动。

5. 5启动所有服务

   在仓库根目录用 Docker Compose 按 README 的“Running n8n using Docker Compose”章节启动，一次拉起 n8n、Ollama、Qdrant 与 PostgreSQL。README 节选未给出

6. 6初始化 n8n

   浏览器打开本地 5678 端口，完成只需做一次的 n8n 初始账号设置。

7. 7打开内置工作流

   访问仓库自带的工作流链接，点击画布底部的 Chat 按钮即可试跑。

8. 8等待模型下载

   首次运行会由 Ollama 下载 Llama3.2，未完成前对话无响应，可查看 Docker 控制台日志确认进度。

关键配置

如何确认成功

浏览器访问 http://localhost:5678/ 能打开 n8n 并完成初始化，即表示服务已启动成功。

常见问题

注意事项

• 复制 .env.example 后务必先改密钥和密码，不要沿用示例值。
• 内置工作流地址为 http://localhost:5678/workflow/srOnR8PAY3u4RSwb，n8n 初始化完成后即可打开。
• 该模板定位为快速起步，官方明确说明未针对生产环境做完整优化。
• 所有组件（n8n、Ollama、Qdrant、PostgreSQL）通过一个 Compose 文件编排，网络与存储已预配置。