Hướng dẫn cài đặt n8n bằng Docker trên VPS (A-Z)

NỘI DUNG

Tự động hóa quy trình làm việc giúp doanh nghiệp và cá nhân tiết kiệm thời gian, tối ưu hóa nguồn lực hiệu quả. Bài viết này cung cấp hướng dẫn toàn diện, từ A-Z, về cách cài đặt n8n, một công cụ tự động hóa mạnh mẽ, bằng Docker trên máy chủ riêng ảo (VPS), giúp bạn làm chủ công nghệ này một cách nhanh chóng và bảo mật.

Tại sao nên cài đặt n8n bằng Docker?

Sử dụng Docker để triển khai n8n mang lại nhiều lợi ích thiết thực. Docker cô lập môi trường ứng dụng, đảm bảo n8n hoạt động ổn định, không xung đột với các phần mềm khác trên VPS của bạn. Quá trình cài đặt và cập nhật n8n trở nên đơn giản hơn rất nhiều.

Với Docker, bạn có thể dễ dàng di chuyển n8n giữa các máy chủ khác nhau mà không cần cấu hình lại từ đầu. Cộng đồng người dùng Docker và n8n rất lớn, cung cấp nguồn tài liệu và hỗ trợ phong phú khi bạn gặp vấn đề. Phương pháp này cũng giúp quản lý tài nguyên hệ thống tốt hơn.

Chuẩn bị trước khi cài đặt n8n với Docker

Trước khi bắt đầu quá trình cài đặt n8n bằng Docker, việc chuẩn bị kỹ lưỡng sẽ đảm bảo quá trình diễn ra suôn sẻ và hiệu quả. Bạn cần một số yếu tố nền tảng về hạ tầng và kiến thức cơ bản.

Yêu cầu về VPS

Để n8n hoạt động ổn định qua Docker, VPS của bạn cần đáp ứng một số yêu cầu cấu hình tối thiểu. Khuyến nghị ít nhất 1 CPU core, 2GB RAM và 20GB dung lượng ổ cứng SSD. Cấu hình này đủ cho các quy trình tự động hóa vừa và nhỏ. Với nhu cầu lớn hơn, bạn nên cân nhắc nâng cấp tài nguyên.

Cài đặt Docker & Docker Compose

Docker là nền tảng container hóa, và Docker Compose là công cụ giúp định nghĩa và chạy các ứng dụng Docker đa container. Hầu hết các nhà cung cấp VPS đều có hướng dẫn cài đặt Docker và Docker Compose trên các hệ điều hành phổ biến như Ubuntu hoặc CentOS. Bạn cần đảm bảo cả hai đã được cài đặt và hoạt động chính xác trên VPS.

XEM THÊM: Action Node trong n8n là gì? Chức năng, vai trò & cách hoạt động

Ví dụ, trên Ubuntu, bạn có thể cài Docker bằng lệnh: sudo apt update sudo apt install docker.io Sau đó, cài Docker Compose: sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose (Lưu ý: Luôn kiểm tra phiên bản Docker Compose mới nhất từ trang chủ Docker.)

Kiến thức Docker cơ bản

Hiểu một số khái niệm Docker cốt lõi sẽ giúp bạn dễ dàng theo dõi hướng dẫn. Image (ảnh Docker) là một khuôn mẫu chỉ đọc chứa các chỉ dẫn để tạo một container. Container (bộ chứa) là một thực thể chạy của image. Volume (phân vùng lưu trữ) dùng để lưu trữ dữ liệu cố định cho container. Port (cổng) mapping cho phép truy cập ứng dụng trong container từ bên ngoài.

Các bước cài đặt n8n bằng Docker (Sử dụng Docker Compose)

Sử dụng Docker Compose là phương pháp khuyến nghị để cài đặt và quản lý n8n, vì nó cho phép bạn định nghĩa toàn bộ cấu hình ứng dụng trong một file duy nhất, dễ dàng quản lý và tái sử dụng.

Bước 1: Tạo thư mục lưu trữ cho n8n

Dữ liệu của n8n, bao gồm các workflows và credentials, cần được lưu trữ cố định ngay cả khi container khởi động lại. Chúng ta sẽ tạo một thư mục trên VPS để Docker volume có thể ánh xạ vào đó.

Mở terminal của VPS và thực hiện lệnh sau: mkdir ~/n8n-data Lệnh này tạo một thư mục tên là n8n-data trong thư mục home của người dùng hiện tại. Bạn có thể chọn một vị trí khác nếu muốn.

Bước 2: Chuẩn bị file `docker-compose.yml`

File docker-compose.yml mô tả các services, networks, và volumes cho ứng dụng n8n. Tạo một file tên là docker-compose.yml trong thư mục bạn muốn (ví dụ: ~/n8n-docker) với nội dung sau:

YAML

version: '3.8'

services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n_app
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - GENERIC_TIMEZONE=Asia/Ho_Chi_Minh
      # - N8N_BASIC_AUTH_USER=your_username # Bỏ comment và thay thế nếu muốn dùng xác thực cơ bản
      # - N8N_BASIC_AUTH_PASSWORD=your_password # Bỏ comment và thay thế nếu muốn dùng xác thực cơ bản
      - N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - NODE_ENV=production
      - WEBHOOK_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
    volumes:
      - ~/n8n-data:/home/node/.n8n
    # Chú ý: Nếu VPS của bạn có ít tài nguyên, hãy giới hạn bộ nhớ cho n8n
    # deploy:
    #   resources:
    #     limits:
    #       memory: 1024M

volumes:
  n8n_data_volume: # Không dùng trực tiếp trong service này, nhưng có thể dùng nếu muốn quản lý volume qua Docker

Giải thích các tham số:

image: n8nio/n8n:latest: Sử dụng image n8n mới nhất từ Docker Hub.
restart: unless-stopped: Tự động khởi động lại n8n container trừ khi bạn chủ động dừng.
ports: - "5678:5678": Ánh xạ cổng 5678 của VPS vào cổng 5678 của n8n container.
environment: Định nghĩa các biến môi trường. GENERIC_TIMEZONE giúp n8n hiển thị thời gian chính xác. Các biến N8N_HOST, N8N_PORT, N8N_PROTOCOL, WEBHOOK_URL quan trọng khi bạn cấu hình domain riêng và SSL. Thay thế ${SUBDOMAIN}.${DOMAIN_NAME} bằng tên miền phụ và tên miền của bạn.
volumes: - ~/n8n-data:/home/node/.n8n: Ánh xạ thư mục ~/n8n-data trên VPS vào /home/node/.n8n trong container, nơi n8n lưu trữ dữ liệu.

Bước 3: Tải n8n image và khởi chạy container

Sau khi đã có file docker-compose.yml, di chuyển vào thư mục chứa file này trong terminal và thực hiện lệnh:

docker-compose up -d

Lệnh này sẽ tự động tải image n8n (nếu chưa có trên VPS của bạn) và khởi chạy container ở chế độ nền (-d là detached mode). Quá trình tải image có thể mất vài phút tùy thuộc vào tốc độ mạng của VPS.

XEM THÊM: So Sánh n8n vs Zapier | Lựa Chọn Nào Tốt Hơn? [2025]

Bước 4: Kiểm tra trạng thái hoạt động của n8n

Để kiểm tra xem n8n container đã chạy thành công hay chưa, bạn có thể sử dụng các lệnh sau:

docker-compose ps hoặc docker ps Lệnh này sẽ hiển thị danh sách các container đang chạy. Bạn sẽ thấy container n8n_app (hoặc tên bạn đặt) với trạng thái “Up”.

Để xem log của n8n container (hữu ích cho việc gỡ lỗi): docker-compose logs n8n

Sau khi xác nhận container đã chạy, bạn có thể truy cập n8n qua trình duyệt web bằng địa chỉ IP của VPS và cổng 5678: http://<YOUR_VPS_IP>:5678.

Cấu hình n8n sau khi cài đặt qua Docker

Khi n8n đã khởi chạy thành công, có một vài bước cấu hình ban đầu và tùy chọn nâng cao bạn nên xem xét để tối ưu hóa trải nghiệm sử dụng và bảo mật.

Truy cập n8n lần đầu và tạo tài khoản admin

Lần đầu tiên truy cập n8n, bạn sẽ được yêu cầu thiết lập tài khoản quản trị (owner account). Hãy làm theo hướng dẫn trên màn hình để tạo tên người dùng và mật khẩu mạnh. Đây là tài khoản quan trọng nhất để quản lý instance n8n của bạn.

(Tùy chọn) Cấu hình Domain và SSL (HTTPS)

Truy cập n8n qua địa chỉ IP không an toàn cho môi trường sản xuất. Bạn nên sử dụng tên miền riêng và cài đặt chứng chỉ SSL (Secure Sockets Layer) để mã hóa dữ liệu (HTTPS). Cách phổ biến là sử dụng một reverse proxy như Nginx, Caddy, hoặc Nginx Proxy Manager.

Ví dụ, Nginx Proxy Manager là một công cụ quản lý reverse proxy qua giao diện web, dễ sử dụng và tích hợp sẵn Let’s Encrypt để cấp SSL miễn phí. Bạn có thể chạy Nginx Proxy Manager như một Docker container khác và cấu hình nó trỏ đến container n8n của bạn.

(Tùy chọn) Thiết lập biến môi trường nâng cao

n8n cung cấp nhiều biến môi trường để tùy chỉnh hoạt động. Ví dụ:

N8N_ENCRYPTION_KEY: Một khóa bí mật để mã hóa credentials. Việc thiết lập biến này rất quan trọng để tăng cường bảo mật cho các thông tin nhạy cảm.
DB_TYPE, DB_POSTGRESDB_HOST, etc.: Nếu bạn muốn sử dụng một cơ sở dữ liệu bên ngoài (như PostgreSQL) thay vì SQLite mặc định để tăng hiệu năng và khả năng mở rộng.
WEBHOOK_URL: Cần thiết lập chính xác URL này (ví dụ: https://n8n.yourdomain.com/) để các webhook hoạt động đúng, đặc biệt khi n8n được đặt sau reverse proxy.

Những biến này được khai báo trong phần environment của file docker-compose.yml.

Lưu ý về persistant data (dữ liệu cố định)

Đảm bảo rằng bạn đã cấu hình volume ánh xạ chính xác trong docker-compose.yml (~/n8n-data:/home/node/.n8n). Điều này cực kỳ quan trọng vì nếu không có persistent storage, tất cả workflows, credentials và cài đặt của bạn sẽ bị mất khi container được tạo lại hoặc xóa.

Cập nhật phiên bản n8n Docker

Việc cập nhật n8n lên phiên bản mới nhất giúp bạn tiếp cận các tính năng mới và bản vá bảo mật. Với Docker Compose, quá trình này khá đơn giản.

Các bước cập nhật an toàn

Backup dữ liệu (Quan trọng): Trước khi cập nhật, hãy sao lưu thư mục dữ liệu n8n của bạn (ví dụ ~/n8n-data).
Tải image mới nhất: Mở terminal, di chuyển đến thư mục chứa file docker-compose.yml và chạy lệnh: docker-compose pull n8n Lệnh này sẽ tải về phiên bản image mới nhất của n8n từ Docker Hub.
Khởi động lại container với image mới: docker-compose up -d --remove-orphans Lệnh này sẽ dừng container cũ, tạo container mới với image vừa tải về, và khởi động lại. --remove-orphans giúp dọn dẹp các container không cần thiết.

XEM THÊM: Workflow Automation Là Gì? Cách hoạt động, lợi ích & ví dụ thực tế

Sau khi cập nhật, kiểm tra lại hoạt động của n8n và các workflow.

Lựa chọn VPS tối ưu để chạy n8n với Docker

Việc chọn một nhà cung cấp và gói VPS phù hợp đóng vai trò quan trọng trong việc đảm bảo n8n hoạt động ổn định, hiệu quả và an toàn.

Các yếu tố cần cân nhắc khi chọn VPS cho n8n

Hiệu năng (CPU, RAM, SSD): n8n có thể tiêu tốn tài nguyên tùy thuộc vào số lượng và độ phức tạp của workflows. Ổ cứng SSD mang lại tốc độ truy xuất dữ liệu nhanh hơn đáng kể.
Uptime: Chọn nhà cung cấp có cam kết uptime cao (thường là 99.9% trở lên).
Hỗ trợ Docker: Đảm bảo VPS hỗ trợ tốt Docker và không có giới hạn nào cản trở.
Băng thông (Bandwidth): Nếu workflows của bạn xử lý nhiều dữ liệu hoặc có nhiều trigger từ bên ngoài, băng thông lớn là cần thiết.
Hỗ trợ kỹ thuật: Nhà cung cấp có đội ngũ hỗ trợ nhanh chóng, am hiểu về VPS và Docker là một lợi thế lớn.

Tại sao nên chọn VPS InterData cho n8n?

InterData cung cấp các giải pháp VPS được tối ưu hóa cho các ứng dụng hiện đại như n8n chạy trên Docker. Hệ thống máy chủ của InterData sử dụng 100% ổ cứng SSD NVMe tốc độ cao, đảm bảo hiệu năng vượt trội cho các tác vụ của n8n. Chúng tôi cam kết uptime 99.9% và hỗ trợ kỹ thuật 24/7.

Đối với việc cài đặt n8n, nhiều người dùng ưu tiên các giải pháp đơn giản hóa quy trình. Một số nhà cung cấp, như InterData, cung cấp các gói VPS n8n với hệ điều hành Ubuntu đã tích hợp sẵn n8n, giúp việc triển khai ban đầu trở nên nhanh chóng hơn đáng kể.

Gợi ý các gói VPS phù hợp

Tại InterData, bạn có thể bắt đầu với các gói VPS Cloud có cấu hình từ 2GB RAM, 2 CPU Cores. Đối với nhu cầu cao hơn, các gói VPS Pro với tài nguyên mạnh mẽ hơn sẽ là lựa chọn lý tưởng để đảm bảo n8n xử lý lượng lớn workflows một cách mượt mà.

Câu hỏi thường gặp (FAQ) khi cài đặt n8n bằng Docker

Dưới đây là một số câu hỏi người dùng thường gặp trong quá trình cài đặt và sử dụng n8n với Docker, cùng với câu trả lời ngắn gọn.

Lỗi port conflict giải quyết thế nào?

Lỗi này xảy ra khi cổng 5678 (hoặc cổng bạn cấu hình cho n8n) đã được sử dụng bởi một ứng dụng khác trên VPS. Trả lời: Bạn có thể thay đổi cổng mapping trong file docker-compose.yml. Ví dụ, đổi ports: - "5678:5678" thành ports: - "5679:5678". Khi đó, bạn sẽ truy cập n8n qua cổng 5679.

Làm sao để n8n khởi động cùng VPS?

Khi sử dụng Docker Compose và thiết lập restart: unless-stopped hoặc restart: always trong file docker-compose.yml cho service n8n, Docker sẽ tự động khởi động lại container n8n khi VPS khởi động hoặc khi container bị dừng không mong muốn.

n8n có tốn nhiều tài nguyên VPS không?

Mức tiêu thụ tài nguyên của n8n phụ thuộc vào số lượng workflows, tần suất chạy, và độ phức tạp của các node trong workflow. Trả lời: Đối với các tác vụ cơ bản, n8n không quá tốn tài nguyên. Tuy nhiên, với nhiều workflows phức tạp chạy song song, bạn cần VPS có cấu hình CPU và RAM cao hơn. Theo dõi tài nguyên VPS thường xuyên là điều cần thiết.

Cách backup dữ liệu n8n khi dùng Docker?

Dữ liệu n8n được lưu trong volume mà bạn đã ánh xạ (ví dụ: ~/n8n-data). Trả lời: Để backup, bạn chỉ cần sao chép toàn bộ thư mục này đến một nơi an toàn khác (ví dụ: ổ cứng ngoài, cloud storage). Nên dừng container n8n trước khi thực hiện backup để đảm bảo tính toàn vẹn dữ liệu.

Việc cài đặt n8n bằng Docker trên VPS mở ra khả năng tự động hóa không giới hạn, giúp bạn kiểm soát hoàn toàn dữ liệu và quy trình của mình. Bằng cách tuân theo hướng dẫn này và lựa chọn một nhà cung cấp VPS uy tín như InterData, bạn đã sẵn sàng để khai thác tối đa sức mạnh của n8n.