跳转到主要内容

在 Ubuntu 上安装 n8n

本指南介绍如何在 Ubuntu 24.04 LTS 服务器上安装和配置 n8n。n8n 是开源的工作流自动化工具：通过可视化节点界面连接服务（API、数据库、Webhook）并自动化任务，支持无代码或低代码。

部署使用 Docker、Docker Compose，Nginx 作为反向代理，Let's Encrypt 提供 HTTPS。

订购服务器​

HostMyServers 提供多种托管 n8n 的方案：Performance VPS、NVMe VPS、经济型与性能型专用服务器。

前提条件​

  • SSH root 或 sudo，Ubuntu 24.04 LTS
  • 域名（如 n8n.您的域名.com）有 A 记录
  • 80 和 443 端口可访问

安装 Docker 与 Docker Compose​

添加官方 Docker 仓库，安装 docker-ce 与 docker-compose-plugin。可选：将用户加入 docker 组并执行 newgrp docker。

n8n 目录结构​

mkdir -p ~/n8n
cd ~/n8n
mkdir n8n-data local-files
sudo chown -R 1000:1000 n8n-data local-files

n8n 的 Docker Compose 配置​

创建 docker-compose.yml，使用镜像 n8nio/n8n:latest，设置环境变量：N8N_HOST、N8N_PORT、N8N_PROTOCOL=https、WEBHOOK_URL、N8N_EDITOR_BASE_URL、GENERIC_TIMEZONE（如 Asia/Shanghai），挂载 n8n-data 和 local-files。将 n8n.您的域名.com 替换为您的域名。

Nginx​

安装 Nginx，在 /etc/nginx/sites-available/n8n.conf 中配置 proxy_pass http://localhost:5678，支持 WebSocket 和较长超时（proxy_read_timeout 300s）。启用站点、测试配置并重载 Nginx。

防火墙与 Certbot​

在 UFW 中开放 80 和 443。安装 certbot 与 python3-certbot-nginx，申请证书：sudo certbot --nginx -d n8n.您的域名.com --email admin@example.com --agree-tos --non-interactive。

启动 n8n​

cd ~/n8n
docker compose up -d
docker compose ps
docker logs n8n

访问​

打开 https://n8n.您的域名.com，创建管理员账号（邮箱、姓名、密码），进入工作流编辑器。

Webhooks

Webhook 的基址由 WEBHOOK_URL 指定。请确保域名与 HTTPS 配置正确。

容器管理​

  • 查看日志：docker logs -f n8n
  • 停止：docker compose down
  • 重启：docker compose restart
  • 更新：docker compose pull && docker compose up -d

参考​