Hướng dẫn từng bước để cài đặt 8N8N

A Step-by-Step Guide to Installing 8n8n

Hướng dẫn từng bước để cài đặt N8N

Mục lục

  1. Điều kiện tiên quyết
  2. Bước 1: Yêu cầu hệ thống
  3. Bước 2: Cài đặt Node.js
  4. Bước 3: Tải xuống N8N
  5. Bước 4: Cài đặt N8N
  6. Bước 5: Thiết lập cơ sở dữ liệu
  7. Bước 6: Định cấu hình các biến môi trường
  8. Bước 7: Chạy N8N
  9. Bước 8: Truy cập N8N
  10. Bước 9: Thiết lập tùy chọn bằng Docker
  11. Khắc phục sự cố

Điều kiện tiên quyết

Trước khi bắt đầu cài đặt N8N, hãy đảm bảo bạn đáp ứng các điều kiện tiên quyết. Sự quen thuộc với các giao diện dòng lệnh, dịch vụ web và các khái niệm mạng cơ bản sẽ có lợi cho quá trình cài đặt trơn tru. Có quyền truy cập quản trị vào máy của bạn vì nó có thể được yêu cầu cài đặt phần mềm cần thiết.

Bước 1: Yêu cầu hệ thống

N8N được thiết kế để chạy trên các hệ thống khác nhau, bao gồm các môi trường giống UNIX. Để đảm bảo hiệu suất tối ưu, N8N yêu cầu:

  • Hệ điều hành: Linux, MacOS hoặc Windows (WSL khuyến nghị).
  • ĐẬP: Tối thiểu 2 GB (4 GB khuyến nghị).
  • Không gian đĩa: Ít nhất 500 MB để cài đặt và không gian bổ sung cho quy trình công việc và dữ liệu.
  • Node.js: Phiên bản 14 trở lên.

Bước 2: Cài đặt Node.js

N8N được xây dựng bằng Node.js, vì vậy bạn phải cài đặt nó trên hệ thống của mình. Thực hiện theo các bước này để cài đặt Node.js:

Cho Linux

  1. Mở thiết bị đầu cuối của bạn.
  2. Cập nhật chỉ mục gói của bạn:
    sudo apt update
  3. Cài đặt Node.js:
    sudo apt install nodejs
  4. Cài đặt Trình quản lý gói nút (NPM) nếu không bao gồm:
    sudo apt install npm

Cho macos

  1. Bạn có thể sử dụng Homebrew để cài đặt Node.js:
    brew install node

Cho Windows

  1. Tải xuống trình cài đặt Windows từ Node.js Trang web chính thức.
  2. Chạy trình cài đặt và làm theo lời nhắc.

Sau khi bạn đã cài đặt Node.js, hãy xác minh cài đặt bằng cách kiểm tra các phiên bản:

node -v
npm -v

Bước 3: Tải xuống N8N

N8N có sẵn dưới dạng gói trên NPM. Bạn có thể tải xuống bằng lệnh NPM:

npm install n8n -g

Sử dụng -g Flag Cài đặt N8N trên toàn cầu, cho phép bạn chạy nó từ bất kỳ thư mục nào.

Bước 4: Cài đặt N8N

Với N8N được tải xuống, bước tiếp theo là cài đặt nó. Có một vài phương pháp để cài đặt N8N tùy thuộc vào sở thích của bạn:

Phương pháp 1: Cài đặt cục bộ

Chạy lệnh sau trong thiết bị đầu cuối của bạn để cài đặt N8N trên toàn cầu. Điều này bao gồm tất cả các phụ thuộc:

npm install n8n -g

Phương pháp 2: Môi trường phát triển

Để thiết lập phát triển, hãy tạo một thư mục mới và điều hướng đến nó. Chạy:

mkdir n8n-project
cd n8n-project
npm init -y
npm install n8n

Bằng cách này, N8N sẽ được cài đặt trong thư mục của dự án.

Bước 5: Thiết lập cơ sở dữ liệu

N8N yêu cầu một cơ sở dữ liệu để lưu trữ quy trình công việc và dữ liệu. Bạn có thể sử dụng SQLite (mặc định), MySQL, PostgreSQL hoặc các tùy chọn khác có sẵn trong N8N. Đây là cách thiết lập một lựa chọn chung, PostgreSQL:

  1. Cài đặt PostgreSQL:

    • Cho Linux:
      sudo apt install postgresql postgresql-contrib
    • Cho các macos:
      brew install postgresql
    • Đối với Windows, tải xuống PostgreSQL từ trang web chính thức và làm theo hướng dẫn thiết lập.
  2. Tạo một cơ sở dữ liệu: Đăng nhập vào PostgreSQL và tạo cơ sở dữ liệu cho N8N:

    sudo -u postgres psql
    CREATE DATABASE n8n;
    CREATE USER n8nuser WITH ENCRYPTED PASSWORD 'password';
    GRANT ALL PRIVILEGES ON DATABASE n8n TO n8nuser;
    q

Bước 6: Định cấu hình các biến môi trường

Để định cấu hình N8N để kết nối với cơ sở dữ liệu của bạn, hãy thiết lập các biến môi trường của bạn. Tạo a .env Tệp trong thư mục N8N của bạn:

touch .env
nano .env

Thêm các dòng sau để đặt thông tin xác thực cơ sở dữ liệu và các cấu hình khác:

DB_TYPE=postgresdb
DB_POSTGRESDB_DATABASE=n8n
DB_POSTGRESDB_USER=n8nuser
DB_POSTGRESDB_PASSWORD=password
DB_POSTGRESDB_HOST=localhost

Bạn cũng có thể đặt các tham số khác như N8N_HOSTThì N8N_PORTThì N8N_PROTOCOLN8N_ENCRYPTION_KEY.

Bước 7: Chạy N8N

Bây giờ bạn đã cài đặt N8N và định cấu hình cơ sở dữ liệu, bạn có thể bắt đầu ứng dụng. Để chạy N8N, hãy sử dụng lệnh sau:

n8n start

Nếu mọi thứ được cấu hình chính xác, N8N sẽ khởi chạy và bạn sẽ thấy một nhật ký giao diện điều khiển cho biết nó đang chạy.

Bước 8: Truy cập N8N

Để truy cập giao diện N8N, hãy mở trình duyệt web của bạn và điều hướng đến:

https://localhost:5678

Bạn sẽ xem trình soạn thảo quy trình làm việc N8N. Từ đây, bạn có thể bắt đầu tạo quy trình công việc bằng cách kéo và thả các nút khác nhau.

Bước 9: Thiết lập tùy chọn bằng Docker

Chạy N8N trong container Docker có thể cung cấp thêm các lợi ích như triển khai đơn giản hóa và quản lý phụ thuộc dễ dàng hơn. Đây là cách thiết lập nó bằng cách sử dụng Docker:

  1. Đảm bảo bạn đã cài đặt Docker. Thực hiện theo các bước cài đặt từ Trang web chính thức của Docker.

  2. Sử dụng lệnh sau để kéo hình ảnh N8N Docker:

docker pull n8nio/n8n
  1. Bắt đầu một thùng chứa Docker mới với cơ sở dữ liệu và cấu hình:
docker run -d --name n8n 
  -e DB_TYPE=postgresdb 
  -e DB_POSTGRESDB_DATABASE=n8n 
  -e DB_POSTGRESDB_USER=n8nuser 
  -e DB_POSTGRESDB_PASSWORD=password 
  -p 5678:5678 
  n8nio/n8n
  1. Truy cập N8N trong trình duyệt web của bạn tại https://localhost:5678.

Khắc phục sự cố

Nếu bạn gặp sự cố trong quá trình cài đặt hoặc chạy N8N, hãy xem xét các mẹo khắc phục sự cố phổ biến sau đây:

  • Các vấn đề kết nối cơ sở dữ liệu: Đảm bảo cơ sở dữ liệu của bạn đang chạy và thông tin đăng nhập của bạn trong .env Tệp là chính xác.

  • Cài đặt tường lửa: Kiểm tra xem tường lửa cục bộ của bạn có chặn cổng 5678 không, đó là cổng mặc định của N8N. Điều chỉnh cài đặt phù hợp.

  • Tương thích Node.js: Xác minh phiên bản Node.js của bạn. Nếu nó đã lỗi thời, hãy xem xét nâng cấp lên phiên bản 14 trở lên.

  • Kiểm tra nhật ký: Nếu N8N không bắt đầu đúng, việc kiểm tra nhật ký console có thể đưa ra gợi ý về những gì đã sai.

Với các bước này, bạn nên có một phiên bản N8N hoạt động đầy đủ, cho phép bạn tự động hóa và quản lý quy trình công việc một cách hiệu quả. Mỗi lệnh đủ đơn giản để thực hiện ngay cả đối với người mới bắt đầu, trong khi thiết lập Docker tùy chọn cung cấp sự mạnh mẽ cho người dùng nâng cao hơn.