Tin tức

Hướng dẫn cài đặt n8n trên Ubuntu 24.04 chi tiết từng bước

Đăng vào bởi DCT CSKH

Bạn từng tự hỏi có thể tự động hóa hàng loạt tác vụ lặp đi lặp lại chỉ bằng một công cụ nguồn mở nhẹ nhàng? N8n chính là thứ khiến cộng đồng kỹ thuật “mê mẩn” suốt vài năm gần đây. Bài viết này sẽ hướng dẫn chi tiết cài đặt n8n trên Ubuntu 24.04 – bản LTS mới nhất. Dù bạn mới tiếp xúc hệ Linux hay đã quen với CI/CD, mình cam đoan bạn sẽ nhìn thấy mọi điểm vướng, từ thiết lập ban đầu cho tới khi n8n hoạt động chuẩn xác – không còn phải mò mẫm lệnh lạ, lỗi ẩn hay cách chạy nền để job không bị ngắt quãng nửa chừng!

Chuẩn bị môi trường trước khi cài đặt n8n trên Ubuntu 24.04

Dù bạn cài n8n để test trên VM nhỏ hay triển khai trên Cloud Server thực chiến, việc chuẩn bị thật sạch môi trường Ubuntu 24.04 là yếu tố quyết định. Ubuntu 24.04 vừa mới ra mắt nên nhiều hệ thống vẫn dùng các gói snap/apt chưa quá ổn định với mọi package phụ thuộc. Hãy bắt đầu từ kernel mới, full update các gói và kiểm tra lại các port dịch vụ thường dùng bởi n8n (5678/tcp default, kèm theo các API external) để tránh xung đột.

  • Đảm bảo bạn đang đăng nhập với user có sudo và biết root password.
  • Check hệ thống đáp ứng tối thiểu: 2 vCPU, 2GB RAM (quy mô prod nên gấp đôi).
  • Kiểm tra port 5678/tcp đã mở, firewall định tuyến chính xác (sudo ufw status/iptables…)

Thực tế, nhiều bạn triển khai nhưng quên kiểm tra sẵn những port này dẫn tới setup xong rồi thấy truy cập bị chặn hoặc service khởi động báo lỗi. Nếu dùng colocation hoặc server trong data center, đừng bỏ qua việc kiểm tra NAT/firewall edge ngoài hệ thống nội bộ Ubuntu.

terminal cài đặt n8n trên Ubuntu 24.04 bằng Docker

Cài đặt n8n trên Ubuntu 24.04: từng bước đầy đủ và lệnh mẫu

Có nhiều cách triển khai n8n: npm, Docker, snap, cài binary trực tiếp. Phổ biến nhất và an toàn cho cả prod/dev là Docker (tách biệt, rollback nhanh, tăng bảo mật), nhưng mình sẽ hướng dẫn cả hai trường hợp npm và Docker để bạn dễ chọn theo chính sách môi trường mình quản lý.

Cài n8n bằng Docker Compose (Khuyên dùng)

# 1. Cài Docker & Docker Compose
sudo apt update
sudo apt install -y docker.io docker-compose
# Kiểm tra Docker
sudo systemctl status docker
# 2. Tạo thư mục chứa file cấu hình
mkdir ~/n8n && cd ~/n8n
# 3. Tạo file docker-compose.yml
cat < docker-compose.yml
version: '3'
services:
  n8n:
    image: n8nio/n8n:latest
    restart: always
    ports:
      - 5678:5678
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=youruser
      - N8N_BASIC_AUTH_PASSWORD=yourpassword
      - N8N_HOST=localhost
      - N8N_PORT=5678
      - WEBHOOK_URL=https://domain-cua-ban.com/
    volumes:
      - ./n8n_data:/home/node/.n8n
EOF
# 4. Chạy n8n
sudo docker-compose up -d

Output mẫu khi chạy thành công:
Creating network "n8n_default" ... done
Creating n8n_n8n_1 ... done

Cài n8n trực tiếp qua npm (Không khuyên cho prod)

# 1. Cài NodeJS v18 trở lên
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs
# 2. Cài n8n global
sudo npm install n8n -g
# 3. Chạy n8n
n8n start

Output khởi chạy:
n8n ready on 0.0.0.0, port 5678

  • Lệnh xác nhận container đang chạy:
    sudo docker ps
  • Lệnh kiểm tra trạng thái n8n (npm):
    ps aux | grep n8n

Lưu ý đáng bỏ túi: Dù bạn chọn Docker hay npm, hãy lên kế hoạch lưu trữ dataflow ngoài container (volume/backup định kỳ).

sơ đồ kiến trúc workflow automation với n8n trên Ubuntu 24.04

Xử lý lỗi thường gặp khi cài n8n Ubuntu 24.04

Cài đặt n8n tưởng đơn giản, nhưng thực tế trên Ubuntu 24.04 bạn sẽ vô tình gặp các lỗi khó chịu nếu không nắm kỹ thông báo và nguyên nhân phía sau.
Ba lỗi phổ biến:

  • 1. Error: EACCES: permission denied when writing to /n8n_data
    Nguyên nhân: Quyền user Docker không sở hữu thư mục volume hoặc file cấu hình tạo khi sudo/fork user. Xử lý: sudo chown -R 1000:1000 ./n8n_data
  • 2. n8n: command not found (cài bằng npm)
    Nguyên nhân: npm global không link tới user đang dùng. Xử lý: xác nhận npm global path đã có trong $PATH, nếu chưa: export PATH=$PATH:$(npm config get prefix)/bin
  • 3. Port 5678 already in use
    Nguyên nhân: Port n8n hoặc app khác đã giữ. Xử lý: sudo lsof -i:5678 để kiểm tra, đổi port hoặc kill process.

Cách giữ n8n chạy nền và tự khởi động lại khi reboot

Dù bạn cài n8n bằng Docker hay npm, điểm thường bị xem nhẹ là thiết lập auto-restart. Không ít bạn cài xong, SSH thoát ra thì process “bốc hơi” hoặc reboot xong quên recovery. Nếu Docker, chỉ cần để “restart: always” trong docker-compose là xong. Với npm thì bạn nên dùng pm2:

# Cài pm2
sudo npm install pm2 -g
pm2 start $(which n8n) -- start
pm2 save
pm2 startup

Bật HTTPS & bảo mật cơ bản cho n8n Ubuntu 24.04

Triển khai thật thì traffic HTTP truyền plain text cực nguy hiểm, đặc biệt với API workflow hoặc webhook có data nhạy cảm. n8n mặc định không hỗ trợ HTTPS trực tiếp – cần reverse proxy Apache/Nginx cấu hình SSL. Lưu ý: Nếu triển khai Private Cloud hoặc trên môi trường test bảo mật nghiêm ngặt, nên dùng proxy SSL kèm cấu hình bảo vệ mật khẩu HTTP basic hoặc OAuth2.

Kết luận: cài n8n trên Ubuntu 24.04 có gì khác biệt?

Tóm lại, Ubuntu 24.04 giúp việc cài n8n được hưởng lợi nhờ phiên bản phần mềm mới, nhưng kéo theo nhiều điểm “ngã ngựa” nếu không để ý quyền file, package phụ thuộc hoặc cách chạy nền. Bài viết này là kinh nghiệm thực tế giúp bạn triển khai tiết kiệm thời gian, hạn chế sai sót – từng bước đều kiểm chứng. Để mở rộng sang cluster hoặc HA, bạn có thể tìm hiểu thêm về các mô hình tích hợp hệ thống hoặc tham khảo tài liệu chính thức của n8n.

Nếu bạn gặp vướng mắc khi triển khai n8n trên Ubuntu 24.04, hoặc muốn mở rộng lên mô hình đa server, HA, hãy liên hệ với DCT Technology. Đội ngũ kỹ thuật luôn sẵn sàng chia sẻ thêm kinh nghiệm hoặc hỗ trợ thiết lập hạ tầng tự động hóa cho doanh nghiệp bạn. Liên hệ: dct.vn · 0913320866 · [email protected]

DCT CSKH