自托管（Self-Hosted）AI 自动化平台

通过一条命令部署 30+ AI 和自动化工具。 这个开源的 Docker Compose 模板创建了一个完整的自托管（Self-Hosted）环境，包含 n8n（工作流自动化）、Flowise（AI 代理）、Ollama（本地大语言模型 / Local LLMs）、向量数据库（Vector Databases）（Qdrant、Weaviate）、RAG 引擎、Supabase、监控栈（Monitoring Stack）等——所有服务均预配置在 Caddy 反向代理（Reverse Proxy）之后，并支持自动 HTTPS。此外，安装过程中还可选择导入 300+ 社区工作流！

Table of Contents

• 主要功能
• 为什么选择此方案？
• 包含内容
• 安装
• 快速开始与使用
• 升级
• 快捷命令
• 故障排除
• 许可证

主要功能

• 私有 AI 家庭实验室（Private AI Homelab） —— 使用 Ollama 本地运行大语言模型（LLMs），将数据保留在自己的服务器上
• ChatGPT 替代品 —— Open WebUI 为本地 AI 模型提供熟悉的聊天界面
• 工作流自动化 —— n8n 拥有 400+ 集成，可扩展的基于队列的架构
• AI 代理与 RAG —— Flowise, Dify, LangChain, 向量数据库（Qdrant, Weaviate）
• 一键安装 —— 交互式向导，自动生成密钥，零手动配置
• 自动 HTTPS —— Caddy 反向代理，配备自动 Let's Encrypt 证书
• 内置监控 —— 包含 Grafana + Prometheus 栈
• 生产就绪 —— 可扩展的工作者（Workers），健康检查，正确的服务依赖
• 免费且开源 —— 无供应商锁定，Apache 2.0 许可证

---

为什么选择此方案？

此安装程序帮助您创建自己强大、私有的 AI 工作室。想象一下，您手边有一套工具可以：

• 自动化重复性任务。
• 构建量身定制的智能助手。
• 分析信息并获得洞察。
• 生成创意内容。

此设置提供了一套全面的尖端服务，所有服务均预配置为协同工作。主要优势包括：

• 丰富的工具集： 获取精选的强大开源工具集合，用于 AI 开发、自动化和监控，全部集中在一个地方。
• 可扩展的 n8n 性能： n8n 默认以 `queue` 模式运行，利用 Redis 进行任务管理，Postgres 进行数据存储。您可以在安装期间动态指定 n8n 工作者（Workers）和任务运行器的数量，从而实现对工作流的稳健并行处理，以应对高负载需求。
• 完全控制： 所有内容均由您托管，让您完全掌控数据、操作以及资源分配方式。

包含内容

✅ Caddy, Postgres 和 Redis - Web 代理、数据库和缓存的核心服务，始终包含在内。

安装程序还允许您通过设置过程中的交互式向导选择并部署以下强大的开源工具：

✅ Appsmith - 一个开源低代码平台，用于构建内部工具、仪表板和 Admin 面板，配备拖拽式 UI（用户界面）构建器。

✅ n8n - 一个拥有超过 400 种集成和高级 AI 组件的低代码平台，用于自动化工作流。

✅ ComfyUI - 一个功能强大、基于节点的 Stable Diffusion 工作流 UI。可视化构建和运行图像生成管道，支持自定义节点和扩展。

✅ Crawl4ai - 专为 AI 设计的灵活网络爬虫，使您能够从网站提取数据以用于项目。

✅ Docling - 通用文档转换器，可将 PDF、DOCX、PPTX、XLSX、HTML 和图像转换为干净的 Markdown 或 JSON。具备高级 PDF 解析、OCR（光学字符识别）支持和带有可选 Web UI 的 REST API（接口）。非常适合 n8n 工作流中的文档处理。

✅ Dify - 一个开源 AI 应用开发平台，提供全面的 LLMOps（大语言模型运维）能力，包括工作流管理、提示词工程、RAG（检索增强生成）管道和 AI Agent（智能体）编排。非常适合构建生产级 AI 应用。

✅ Flowise - 一个无代码/低代码 AI Agent 构建器，与 n8n 完美互补，让您轻松创建复杂的 AI 应用。

✅ Gost - 多功能 HTTP/HTTPS 代理，用于将 AI 服务的出站流量路由到中央代理点。

✅ Gotenberg - 一个无状态 API（接口），用于将 HTML、Markdown、Word、Excel 和其他文档转换为 PDF、PNG 或 JPEG。仅在 Docker（容器平台）网络内可用，供 n8n 工作流和其他服务内部使用。

✅ Grafana - 一个开源平台，用于可视化监控数据，帮助您一目了然地了解系统性能。

✅ Langfuse - 一个开源平台，帮助您观察和理解 AI Agent 的性能表现，使其更易于调试和改进。

✅ Letta - 一个开源 Agent 服务器和 SDK（软件开发工具包），可连接到各种 LLM（大语言模型）API 后端（OpenAI、Anthropic、Ollama 等），使您能够构建和管理 AI Agent。

✅ LightRAG - 一个简单快速的基于图的 RAG（检索增强生成）系统，具有自动知识图谱提取、双层检索机制和增量更新功能。支持多种存储后端（PostgreSQL、Neo4j、JSON）和嵌入模型。

✅ LibreTranslate - 自托管翻译 API（支持 50+ 种语言）。

✅ Neo4j - 一个图数据库管理系统，允许您将数据建模、存储和查询为节点和关系组成的网络。

✅ NocoDB - 一个开源的 Airtable 替代品，可将任何数据库转变为智能电子表格，并提供无代码界面以构建协作应用。

✅ Ollama - 在本地运行 Llama 3、Mistral、Gemma 和其他大语言模型。

✅ Open WebUI - 一个用户友好、类似 ChatGPT 的界面，用于私密地与您的 AI 模型和 n8n Agent 交互。

✅ PaddleOCR - 由 PaddleX Basic Serving 驱动的 CPU 就绪型 OCR API。

✅ Portainer - 一个轻量级、安全的 Web UI，用于轻松管理您的 Docker 环境（容器、镜像、卷、网络）。

✅ Databasus - 带有自托管 UI 的数据库备份和监控。

✅ Postiz - 一个开源社交媒体排期和发布平台。

✅ Prometheus - 一个开源监控和告警工具包，用于关注系统健康状态。

✅ Qdrant - 一个高性能开源向量存储库，专为 AI 设计。虽然 Supabase 也提供向量功能，但 Qdrant 因其速度而被包含在内，是要求苛刻的 AI 任务的理想选择。

✅ RAGApp - 开源应用程序，用于基于您的数据构建 RAG（检索增强生成）助手。提供用于聊天的 Web UI 和用于与工作流集成的 HTTP API。

✅ RAGFlow - 一个基于深度文档理解的开源 RAG 引擎，采用 Elasticsearch 后端，提供基于复杂格式化数据的可靠引用和真实问答能力。

✅ SearXNG - 一个免费、开源的互联网元搜索引擎。它聚合来自众多搜索服务的结果，不跟踪或分析您，确保您的隐私。

✅ Supabase - 一个开源的 Firebase 替代品，提供数据库存储、用户认证等功能。它是 AI 应用的热门选择。

✅ Uptime Kuma - 带有通知功能的自托管正常运行时间监控工具。

✅ WAHA - 可一键配置的 WhatsApp HTTP API（REST API 接口）！3 个引擎：WEBJS（基于浏览器）、NOWEB（websocket nodejs）、GOWS（websocket go）。

✅ Weaviate - 一个开源的 AI 原生向量数据库，专注于可扩展性和易用性。可用于 RAG、混合搜索等。

包含的社区工作流

利用庞大的预构建自动化库快速上手（设置期间可选择导入）！此集合包含超过 300 个工作流，涵盖广泛的使用场景：

🚦 包含什么？

• AI Agent 和聊天机器人： RAG、LLM、LangChain、Ollama、OpenAI、Claude、Gemini 等
• Gmail 和 Outlook： 智能标签、自动回复、PDF 处理和邮件转 Notion
• HR、电子商务、IT、安全、研究等！
• Notion、Airtable、Google Sheets： 数据同步、AI 摘要、知识库
• PDF、图像、音频、视频： 提取、摘要、字幕、语音转文字
• Slack、Mattermost： 工单、反馈分析、通知
• 社交媒体： LinkedIn、Pinterest、Instagram、Twitter/X、YouTube、TikTok 自动化
• Telegram、WhatsApp、Discord： 机器人、通知、语音和图像工作流
• WordPress、WooCommerce： AI 内容、聊天机器人、自动标签

安装

安装前的准备工作

1. 域名： 您需要一个已注册的域名（例如 yourdomain.com）。
2. DNS 配置（域名系统）： 在运行安装脚本之前，您必须为您的域名配置 DNS A 记录，指向您将安装此系统的服务器的公网 IP 地址。将 yourdomain.com 替换为您实际的域名：
   • 泛解析记录： A *.yourdomain.com -> YOUR_SERVER_IP
3. VPS（虚拟专用服务器）： 需要一台带有公网 IP 地址的专用 VPS。不支持家庭服务器、共享主机或本地主机（localhost）设置。
   • 操作系统： Ubuntu 24.04 LTS（长期支持版），64 位
   • 对于包含 n8n、监控、Databasus 和 Portainer 的最小化设置：4 GB 内存 / 2 核 CPU / 40 GB 磁盘空间
   • 用于运行 所有可用服务：至少需要 20 GB 内存 / 4 核 CPU / 60 GB 磁盘空间

运行安装

推荐的安装方式是使用提供的主安装脚本。

1. 通过 SSH（安全外壳协议）连接到您的服务器。

2. 运行以下命令：

   git clone https://github.com/kossakovsky/n8n-install && cd n8n-install && sudo bash ./scripts/install.sh
   

此单一命令可自动化整个设置过程，包括：

• 准备您的系统（更新、防火墙配置以及基本的安全增强措施，如暴力破解防护）。
• 安装 Docker 和 Docker Compose（用于在隔离环境中运行应用程序的工具）。
• 生成包含必要密钥和您域名设置的配置文件（.env）。
• 启动所有服务。

在安装过程中，脚本将提示您输入：

1. 您的 主域名（必需，例如 yourdomain.com）。这是您已配置泛解析记录的域名。
2. 您的 电子邮件地址（必需，用于 Flowise、Supabase 仪表板、Grafana 等服务登录，以及用于 Let's Encrypt 的 SSL（安全套接层）证书注册）。
3. 可选的 OpenAI API（应用程序接口）密钥（非必需。如果提供，可用于 Supabase AI 功能和 Crawl4ai。按 Enter 键跳过）。
4. 您是否要 导入约 300 个现成的 n8n 社区工作流（y/n，可选。根据服务器和网络速度，这可能需要 20-30 分钟）。
5. 您想要运行的 n8n Worker 数量（必需，例如 1, 2, 3, 4。这决定了可以并行处理多少个工作流。每个 Worker 会自动获得其专用的任务运行器侧边车 (sidecar) 以执行 Code 节点。如果未指定，默认为 1）。
6. 随后将出现 服务选择向导，允许您选择要部署的可用服务（如 Flowise、Supabase、Qdrant、Open WebUI 等）。核心服务（Caddy、Postgres、Redis）将为您所选的服务进行设置。

安装成功完成后，脚本将显示一份摘要报告。该报告包含已部署服务的访问 URL（统一资源定位符）和凭据。请将此信息保存在安全的地方！

快速开始与使用

安装成功后，您的服务即可正常运行！以下是入门指南：

1. 访问您的服务： 安装脚本提供了一份包含所有访问 URL 和凭据的摘要报告。请参考该报告。主要服务将在以下地址可用（将 yourdomain.com 替换为您实际的域名）：

   • n8n： n8n.yourdomain.com（使用您在安装期间提供的电子邮件地址和摘要报告中的初始密码登录。首次登录时可能会被要求更改此密码。）
   • Appsmith： appsmith.yourdomain.com（低代码应用构建器）
   • ComfyUI： comfyui.yourdomain.com（基于节点的 Stable Diffusion UI（用户界面））
   • Databasus： databasus.yourdomain.com
   • Dify： dify.yourdomain.com（具有全面 LLMOps 能力的 AI 应用程序开发平台）
   • Docling： docling.yourdomain.com（带有 REST API 的通用文档转换器；Web UI 位于 /ui）
   • Flowise： flowise.yourdomain.com（使用您在安装期间提供的电子邮件地址和摘要报告中的初始密码登录。）
   • Grafana： grafana.yourdomain.com
   • Langfuse： langfuse.yourdomain.com
   • Letta： letta.yourdomain.com
   • LibreTranslate： translate.yourdomain.com
   • LightRAG： lightrag.yourdomain.com
   • Neo4j： neo4j.yourdomain.com
   • NocoDB： nocodb.yourdomain.com
   • Open WebUI： webui.yourdomain.com
   • PaddleOCR： paddleocr.yourdomain.com
   • Portainer： portainer.yourdomain.com（受 Caddy 基本认证保护；首次登录时，完成 Portainer 管理员设置）
   • Postiz： postiz.yourdomain.com
   • Prometheus： prometheus.yourdomain.com（通常用作 Grafana 的数据源）
   • Qdrant： qdrant.yourdomain.com
   • RAGApp： ragapp.yourdomain.com
   • RAGFlow： ragflow.yourdomain.com
   • SearXNG： searxng.yourdomain.com
   • Supabase（仪表板）： supabase.yourdomain.com
   • Uptime Kuma： uptime-kuma.yourdomain.com（在线监控仪表板）
   • WAHA： waha.yourdomain.com（WhatsApp HTTP API；引擎：WEBJS, NOWEB, GOWS）
   • Weaviate： weaviate.yourdomain.com

可选内部工具：Python Runner

• 它是什么：一个仅限内部使用的服务，用于在与您的其他服务（n8n、Postgres、Qdrant 等）相同的 Docker 网络内运行您的自定义 Python 代码。不暴露任何外部端口，也不由 Caddy 代理。
• 如何启用：在安装/更新期间的“服务选择向导”中选择"Python Runner"，或手动添加配置文件：COMPOSE_PROFILES=...,python-runner。
• 代码存放位置：将您的 Python 文件放置在 python-runner/ 目录中。默认入口点是 python-runner/main.py。
• 依赖项：将它们添加到 python-runner/requirements.txt；它们将在容器启动时自动安装。

2. 探索 n8n：

   • 登录您的 n8n 实例。这是您工作流自动化的中心枢纽。
   • 如果您在安装期间选择导入社区工作流，您将在“工作流”部分找到超过 300 个示例。这些是学习和获取灵感的好方法。
   • 开始构建您的第一个工作流！您可以访问超过 400 种集成和强大的 AI 工具。

3. 利用集成的 AI 工具：

   • 将 n8n 与向量存储（Vector Stores）连接：使用 n8n 连接到 Qdrant（如有需要可通过其自有端点访问，通常是 qdrant.yourdomain.com）、Supabase 或 Weaviate（weaviate.yourdomain.com），以存储和检索信息用于您的 AI 任务，如检索增强生成（RAG）。
   • 使用 Flowise 构建：在 flowise.yourdomain.com 访问 Flowise 以创建 AI 代理（Agents）和应用。您可以从 n8n 触发 Flowise 代理，反之亦然。
   • 与 Open WebUI 交互：在 webui.yourdomain.com 使用 Open WebUI 作为您本地 AI 模型或 n8n 代理的聊天界面（例如，如果已配置，可使用 n8n_pipe 集成）。
   • 配置大语言模型（LLMs）：如果您希望使用来自 OpenAI、Anthropic 等提供商的大型语言模型（LLMs），或通过 Ollama（如果已安装）本地使用，您可以在 n8n 节点内或在 Flowise 和 Open WebUI 等服务中轻松配置凭证和连接。

4. 检查监控（可选）：

   • 访问 Grafana（grafana.yourdomain.com）查看监控系统性能的仪表板（数据源自 Prometheus）。

使用 Cloudflare Tunnel 进行安全访问（可选）

Cloudflare Tunnel 提供对您服务的零信任（Zero-trust）访问，而无需在服务器上暴露任何端口。所有流量都通过 Cloudflare 的安全网络路由，提供分布式拒绝服务（DDoS）防护并隐藏服务器的 IP 地址。

优势

• 无暴露端口 - 80/443 端口可以完全关闭
• DDoS 防护 - 内置 Cloudflare 保护
• IP 隐藏 - 服务器的真实 IP 永远不会暴露
• 零信任安全 - 可选的 Cloudflare Access 集成
• 无需公网 IP - 适用于私有网络

设置说明

请参阅 Cloudflare Tunnel 指南：cloudflare-instructions.md

在 n8n 代码节点中使用库 (v2.0+)

n8n v2.0 使用外部任务运行器在代码节点中执行 JavaScript 和 Python 代码。此设置通过 n8n/Dockerfile.runner 和 n8n/n8n-task-runners.json 预配置了以下库：

JavaScript 库：

• cheerio：用于解析和操作 HTML/XML（例如网页抓取）。
• axios：基于 Promise 的 HTTP 客户端，用于向外部 API 发起请求。
• moment：用于解析、验证、操作和显示日期/时间。
• lodash：用于常见编程任务（数组、对象、字符串等）的工具库。

n8n 中预安装的系统工具

自定义 n8n Docker 镜像（n8n/Dockerfile.n8n）包含以下系统级工具：

• ffmpeg：强大的多媒体框架，用于转换、录制和流式传输音频和视频。通过 n8n 工作流中的 Execute Command 节点使用它来执行任务，例如：
  • 转换视频/音频格式（例如 MP4 转 MP3）
  • 从视频文件中提取音频
  • 调整媒体文件大小或压缩
  • 从视频中生成缩略图

升级

要将所有组件（n8n、Open WebUI 等）更新到最新版本并纳入此安装程序项目的最新更改：

make update

对于 Fork：如果您维护带有自定义更改的 Fork 并希望合并来自上游的更新而不是重置：

make git-pull

此脚本将：

1. 从 Git 仓库获取安装程序的最新更新。
2. 暂时停止当前运行的服务。
3. 下载所有服务的 Docker 镜像最新版本。
4. 询问您是否要重新运行 n8n 工作流导入（如果您在初始安装时跳过了此步骤或想刷新社区工作流，这很有用）。
5. 使用新更新重启所有服务。

清理 Docker

如果您需要释放磁盘空间，可以运行 Docker 清理命令。这将移除所有未使用的 Docker 容器、镜像和卷。

make clean

这对于移除旧镜像和释放空间很有用，但请注意它将移除所有未使用的数据。

快速命令 (Makefile)

该项目包含一个用于简化命令执行的 Makefile：

安装与更新

命令	描述
make install	完整安装
make update	更新系统和服 务（重置为原始版本）
make update-preview	预览可用更新而不应用（试运行）
make git-pull	针对 Fork 的更新（从 upstream/main 合并）
make clean	移除未使用的 Docker 资源

监控与日志

命令	描述
make logs	查看日志（所有服务）
make logs s=<service>	查看特定服务的日志（例如 make logs s=n8n）
make status	显示容器状态
make monitor	实时 CPU/内存监控
make restart	重启所有服务
make stop	停止所有服务
make start	启动所有服务
make show-restarts	显示每个容器的重启次数
make import	从备份导入 n8n 工作流
make import n=10	仅导入前 N 个工作流

诊断与配置

命令	描述
make doctor	运行系统诊断（检查 DNS（域名系统）、SSL（安全套接层）、容器、磁盘、内存）
make setup-tls	为企业/内部使用配置自定义 TLS（传输层安全）证书

运行 make help 以获取所有可用命令的完整列表。

社区移植版本

• n8n-installer-arch 由 @ndrewpj 提供 - 适用于基于 Arch 的 Linux 发行版（Arch Linux, CachyOS, Manjaro）

重要链接

• 基于 coleam00 的项目
• n8n 团队提供的 原始入门套件

故障排除

以下是您可能遇到的一些常见问题的解决方案：

即使遵循说明后网站仍无法加载

• 症状： 尽管您已完成所有安装步骤，但您的域名/网站仍无法打开或返回错误。
• 可能原因： 您的 VPS（虚拟专用服务器）资源不足以支持您选择的服务集。
• 尝试方法：
  1. 检查当前的 CPU 和 RAM 使用情况（例如使用 top/htop, free -h, 和 docker stats）。如果资源已饱和，请升级服务器或减少运行的服务数量。
  2. 尝试最小化配置 —— 仅启动 n8n 并验证其是否正常运行。如果在此最小设置下工作正常，请在监控负载的同时逐步启用其他服务。

浏览器中临时的“危险网站”警告

• 症状： 部署服务后立即，当您尝试访问服务时，浏览器（如 Chrome）可能会显示“危险网站”或类似的安全警告。此警告通常在一段时间后消失（例如几小时内或第二天）。
• 原因： 这可能由以下几个原因导致：
  1. 短暂使用自签名证书： 当 Caddy（管理您 SSL 证书的 Web 服务器）为新域名启动时，在向 Let's Encrypt（证书颁发机构）请求并获得有效 SSL 证书的过程中，它可能会短暂使用临时的自签名证书。
  2. 应用新证书的延迟： 从 Let's Encrypt 获得的新证书完全应用并被所有系统识别之前，可能会有短暂的延迟。
• 解决方案： 这通常是一个临时问题，会自动解决。请耐心等待。如果警告持续超过 24 小时，请检查您的 Caddy 日志是否有与证书获取相关的错误，并确保您的 DNS（域名系统）设置正确地将域名指向服务器的 IP 地址。您也可以尝试清除浏览器缓存或使用无痕/隐私窗口重新检查。

一般问题

• VPN 冲突： 使用 VPN 可能会干扰 Docker（容器引擎）镜像的下载。如果您在拉取镜像时遇到问题，请尝试暂时禁用 VPN。
• 服务器要求： 如果您遇到意外问题，请确保您的服务器满足“安装前先决条件”部分中指定的最低硬件和操作系统要求（包括版本）。

更新脚本无法工作

• 症状： make update 命令失败、显示错误或未应用最新更改。

• 原因： 如果您的本地仓库与上游分支出现分歧、存在未提交的更改或处于不一致状态，可能会发生这种情况。

• 解决方案： 运行以下命令强制将本地安装与最新版本同步：

  git config pull.rebase true && git fetch origin && git checkout main && git reset --hard "origin/main" && make update
  

  警告： 这将丢弃您对安装程序文件所做的任何本地更改。如果您已自定义任何脚本或配置，请先备份它们。

推荐阅读

n8n 提供了出色的资源以帮助初学者掌握其 AI 功能：

• 面向开发者的 AI 代理：从理论到实践与 n8n
• 教程：在 n8n 中构建 AI 工作流
• n8n 中的 Langchain 概念（Langchain 是 n8n 用于某些 AI 功能的框架）
• 代理与工作链关键差异演示
• 什么是向量数据库（Vector Databases）？（更详细地解释了 Supabase 和 Qdrant 等工具）

更多 AI 模板

如需更多 AI 工作流创意，请访问 官方 n8n AI 模板画廊。在每个工作流中，选择 Use workflow 按钮即可自动将其导入到您的 n8n 实例中。

AI 模板（来自 n8n.io 的示例）

• AI 代理聊天
• 使用任意数据源进行 AI 聊天（使用 n8n 工作流工具）
• 与 OpenAI Assistant 聊天（通过添加记忆功能）
• 使用开源 LLM（大语言模型）（通过 HuggingFace）
• 使用 AI 与 PDF 文档聊天（引用来源）
• 可抓取网页的 AI 代理
• 税法代码助手
• 使用 MistralAI 和 Qdrant 将文档分解为学习笔记
• 使用 Qdrant 和 MistralAI 的财务文档助手
• 使用 Qdrant 和 Mistral 的食谱推荐

技巧与窍门

访问服务器上的文件

安装程序 (installer) 会创建一个 shared 文件夹（默认位于您运行安装脚本的同一目录中）。此文件夹可供 n8n 应用程序访问。 当您在 n8n 中构建需要读取或写入服务器上文件的自动化流程时，请在您的 n8n 工作流 (workflows) 中使用路径 /data/shared。n8n 中的此路径指向服务器上的 shared 文件夹。

与服务器文件系统 (filesystem) 交互的 n8n 组件：

• 从磁盘读/写文件
• 本地文件触发器（在文件更改时启动工作流）
• 执行命令（运行命令行工具）

贡献者

想看看谁为这个项目做出了贡献？查看 GitHub 贡献者页面！

遥测 (Telemetry)

此安装程序通过 Scarf 收集匿名使用统计数据，以帮助改进项目。不收集任何个人数据。

收集的数据：

• 事件类型（安装/更新开始/完成）
• 安装程序版本
• 选定的服务
• 操作系统类型（例如：ubuntu-24.04）
• 随机安装 ID（用于关联开始/完成事件）
• 国家（由 Scarf 根据 IP 确定，我们不会存储）

要退出，请在安装后将以下内容添加到您的 .env 文件中：

SCARF_ANALYTICS=false

许可证 (License)

本项目（最初由 n8n 团队创建，后续由贡献者开发 - 参见“重要链接”）根据 Apache License 2.0（Apache 许可证 2.0）许可。详见 LICENSE 文件。

n8n-install 快速上手指南

n8n-install 是一个自托管的 AI 自动化平台部署工具。它通过一条命令即可在服务器上一键部署包含 n8n、Flowise、Ollama、向量数据库等在内的 30+ 种 AI 与自动化工具，并自动配置 Caddy 反向代理与 HTTPS。

环境准备

在开始安装之前，请确保您的服务器满足以下要求：

1. 操作系统

• 推荐系统: Ubuntu 24.04 LTS (64-bit)
• 不支持: 家庭服务器、共享主机或 localhost 环境。

2. 网络与域名

• 公网 IP: 必须拥有具有公网 IP 的 VPS。
• 域名配置: 需拥有一个已注册的域名，并在 DNS 服务商处配置 泛解析记录 (Wildcard A Record)：
  • 记录类型：A
  • 主机记录：*
  • 记录值：YOUR_SERVER_IP (替换为您的服务器公网 IP)
  • 示例：*.yourdomain.com -> 1.2.3.4

3. 硬件资源

根据您计划部署的服务规模，建议配置如下：

• 最小配置 (仅核心服务 n8n, Monitoring, Databasus, Portainer):
  • 内存：4 GB
  • CPU: 2 核
  • 磁盘：40 GB
• 全量配置 (运行所有可用服务):
  • 内存：至少 20 GB
  • CPU: 4 核
  • 磁盘：60 GB

注意: 由于涉及从 GitHub 和 Docker Hub 拉取镜像，请确保服务器网络连接稳定。如遇国内网络访问问题，可考虑配置网络加速。

安装步骤

1. SSH 连接服务器 使用终端工具登录到您的 Ubuntu 服务器。

2. 执行安装脚本 复制并运行以下命令。该脚本会自动更新系统、安装 Docker、生成配置文件并启动所有服务。

   git clone https://github.com/kossakovsky/n8n-install && cd n8n-install && sudo bash ./scripts/install.sh
   

3. 跟随交互式向导 脚本运行过程中会提示您输入以下信息：

   • Primary Domain Name: 您配置的域名（例如 yourdomain.com）。
   • Email Address: 用于服务登录及 SSL 证书注册（如 Let's Encrypt）。
   • 其他配置: 根据提示确认密码或特定服务选项。

   等待脚本完成所有服务的部署与初始化。

基本使用

安装完成后，您可以通过浏览器访问以下服务：

1. 访问工作流自动化平台 (n8n)

• 地址: https://yourdomain.com
• 用途: 创建和管理自动化工作流，集成 400+ 种应用。
• 初始设置: 首次访问可能需要创建管理员账户。

2. 访问本地 AI 聊天界面 (Open WebUI)

• 地址: https://yourdomain.com/open-webui (具体路径视配置而定，通常可通过主菜单跳转)
• 用途: 提供类似 ChatGPT 的界面，用于与本地运行的 Ollama 模型进行对话。

3. 导入社区工作流

• 在安装过程中或后续设置里，您可以选择导入 300+ 社区预置工作流。
• 涵盖场景包括：AI 智能体、邮件处理、Notion/Airtable 数据同步、社交媒体自动化等。

4. 监控与管理

• Portainer: 管理 Docker 容器与环境。
• Grafana/Prometheus: 查看系统性能监控数据。
• Uptime Kuma: 监控服务在线状态。

---

更多高级配置与自定义选项请参考官方完整文档。