N8n MCP Agents

n8n Ollama WebUI堆栈

该存储库提供了一个完整的自托管工作流自动化和人工智能环境，具有以下特点：

• n8n –可视化工作流自动化
• 奥拉马 –本地LLM模型服务器
• 打开WebUI –用于与Ollama模特聊天的浏览器用户界面
• PostgreSQL –n8n的持久数据库后端
• Nginx -TLS终止所有服务的反向代理

所有服务均在上运行 乌班图 使用Docker Compose，并为Ollama提供可选的GPU支持。

______________________________________________________________________

目录布局

.
├── docker-compose.yml        # All services: n8n, postgres, ollama, open-webui, nginx
├── nginx/
│   └── default.conf          # Nginx reverse proxy config
├── certs/
│   ├── fullchain.pem         # SSL certificate
│   └── privkey.pem           # SSL private key
├── .env                      # Environment variables
├── db_data/                  # Postgres volume
├── n8n_data/                 # n8n persistent data
├── webui_data/               # Open-WebUI data
└── ollama/                   # Ollama model and config cache

______________________________________________________________________

先决条件

• Ubuntu 22.04+主机
• Docker引擎+Docker编写插件
• 公共接口上的IPv4连接（IPv6可能仅用于管理）
• 有效的TLS证书和密钥 certs/ （或自行签名测试）

______________________________________________________________________

快速启动

1.克隆此存储库

git clone https://github.com//n8n-ollama-stack.git
cd n8n-mcp-agents

2.准备环境文件

复制 .env.template → .env 并编辑：

POSTGRES_USER=n8n
POSTGRES_PASSWORD=n8n
POSTGRES_DB=n8n

# Random secret for n8n encryption
N8N_ENCRYPTION_KEY=$(openssl rand -hex 32)

# Timezone and hostname
TZ=America/New_York
N8N_HOST=localhost
WEBHOOK_URL=https://:8443/
MODEL_NAME=llama3

3.启动堆栈

docker compose up -d

第一次启动将提取图像并初始化Postgres和Ollama。

______________________________________________________________________

服务端点

注意：Nginx内部代理 127.0.0.1 （IPv4）。确保您的主机网络首选IPv4（见下文）。

______________________________________________________________________

GPU支持（可选）

如果您的主机安装了NVIDIA GPU和驱动程序：

docker compose up -d ollama

这 ollama 服务已经包括：

deploy:
  resources:
    reservations:
      devices:
        - capabilities: [gpu]

因此Docker将自动传递GPU设备（如果可用）。

______________________________________________________________________

日志和故障排除

docker compose logs -f nginx
docker compose logs -f n8n
docker compose logs -f open-webui
docker compose logs -f ollama

测试上游可达性：

curl -vk https:///ollama/api/tags
curl -vk https:///
curl -vk https:///webui/

如果 502 Bad Gateway 出现时，请验证：

• Nginx proxy_pass 用途 127.0.0.1 （不是 localhost)
• 服务正在监听 0.0.0.0 或 127.0.0.1 端口
• IPv4首选项(/etc/gai.conf)已应用

______________________________________________________________________

停机和清理

docker compose down

要删除卷（擦除Postgres/n8n数据）：

docker compose down -v

______________________________________________________________________

许可证

麻省理工学院许可证©2025 Komal Thareja