Hướng dẫn cài đặt n8n trên ubuntu VPS từ A-Z

Dưới đây là hướng dẫn cài đặt n8n (một công cụ workflow automation mã nguồn mở) trên Ubuntu VPS (20.04/22.04/24.04) từ A-Z:

🚀 Tổng quan#

• n8n có thể chạy độc lập hoặc qua Docker.

• Cài đặt qua Docker + Docker Compose là cách phổ biến và dễ quản lý nhất.

• Sử dụng domain + SSL (Let's Encrypt) để bảo mật.

🔧 Bước 1: Cập nhật hệ thống#

sudo apt update && sudo apt upgrade -y

🐳 Bước 2: Cài Docker & Docker Compose#

sudo apt install -y docker.io docker-compose sudo systemctl enable docker sudo systemctl start docker

Kiểm tra:

docker -v docker-compose -v

📁 Bước 3: Tạo thư mục dự án#

mkdir ~/n8n && cd ~/n8n

🧾 Bước 4: Tạo file docker-compose.yml#

` version: "3.8"

services: n8n: image: n8nio/n8n restart: always ports: - "5678:5678" environment: - GENERIC_TIMEZONE=Asia/Ho_Chi_Minh - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=your_strong_password - WEBHOOK_TUNNEL_URL=https://yourdomain.com volumes: - n8n_data:/home/node/.n8n

volumes: n8n_data: `

✅ Thay your_strong_password và yourdomain.com bằng thông tin của bạn.

🌍 Bước 5: Mở port tường lửa (nếu cần)#

sudo ufw allow 5678/tcp

▶️ Bước 6: Khởi động n8n#

docker-compose up -d

🔒 Bước 7 (Khuyên dùng): Cài reverse proxy với SSL (Nginx + Let's Encrypt)#

7.1. Cài Nginx#

sudo apt install nginx -y

7.2. Tạo file cấu hình Nginx#

sudo nano /etc/nginx/sites-available/n8n

Nội dung ví dụ:

` server { listen 80; server_name yourdomain.com;

location / {
    proxy_pass http://localhost:5678;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

} `

sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/ sudo nginx -t && sudo systemctl reload nginx

7.3. Cài SSL với Certbot#

sudo apt install certbot python3-certbot-nginx -y sudo certbot --nginx -d yourdomain.com

✅ Truy cập giao diện n8n#

• Mở trình duyệt và truy cập https://yourdomain.com

• Đăng nhập với tài khoản admin và mật khẩu bạn đã đặt

🛠 Một số lệnh quản lý#

• Xem logs:

docker-compose logs -f

• Dừng dịch vụ:

docker-compose down

• Cập nhật image mới nhất:

docker-compose pull docker-compose up -d

📌 Gợi ý nâng cao#

• Sử dụng PostgreSQL hoặc MySQL để thay SQLite mặc định

• Bật xác thực OAuth nếu triển khai cho nhiều người dùng

• Backup thư mục ~/.n8n thường xuyên