FlashPanel

n8n ​

n8n là công cụ tự động hóa quy trình (workflow automation) mã nguồn mở, kết nối hàng trăm dịch vụ bằng giao diện kéo thả. FlashPanel cài n8n thành một website độc lập và cung cấp trang quản lý n8n ngay trong bảng điều khiển.

Yêu cầu ​

  • Máy chủ thuộc gói trả phí. Mục n8n hiển thị biểu tượng khóa nếu máy chủ chưa nâng cấp.
  • Một cơ sở dữ liệu cho n8n: PostgreSQL (cài từ trang Ứng dụng) hoặc SQLite (không cần cài trước). FlashPanel tự cài Docker nếu máy chủ chưa có.
  • Một website mới dành riêng cho n8n (ví dụ n8n.domain.com). Mã nguồn hiện có của website sẽ bị ghi đè.
  • Một cổng còn trống để chạy n8n. Cổng không được trùng với Proxy Port của website khác trên máy chủ và không được là 80, 443, 2022.

Cài đặt ​

  1. Tạo website mới rồi bấm vào tên website trong danh sách để mở trang quản lý.
  2. Nên cài SSL cho website trước, để n8n dùng địa chỉ https:// cho webhook ngay từ đầu.
  3. Bấm menu Cài đặt Mã nguồn, rồi bấm vào biểu tượng n8n.
  4. Nhập Cổng (mặc định 5678). FlashPanel tự đặt Proxy Port của website theo cổng này.
  5. Chọn Cơ sở dữ liệu: PostgreSQL (nếu đã cài) hoặc SQLite.
  6. Tùy chọn: thêm biến môi trường của n8n vào ô Biến môi trường (.env), mỗi dòng một biến dạng TEN_BIEN=gia_tri.
  7. Đọc cảnh báo, đánh dấu ô Đúng, làm đi! rồi bấm Cài đặt n8n.

Theo dõi tiến trình ở menu Sự kiện của website. Khi cài xong, truy cập website và tạo tài khoản chủ sở hữu ở màn hình thiết lập đầu tiên của n8n. Menu n8n xuất hiện trong menu của website.

Quản lý n8n ​

Bấm menu n8n của website. Đầu trang hiển thị phiên bản n8n đang chạy và các nút thao tác:

NútChức năng
Khởi động lại n8nKhởi động lại n8n và cập nhật lại địa chỉ webhook theo trạng thái SSL hiện tại
Nâng cấp n8nChỉ hiện khi có phiên bản mới, kèm phiên bản hiện tại ▶ phiên bản mới. Nâng cấp lên phiên bản ổn định mới nhất
Đặt lại quản lý người dùngXóa tất cả tài khoản n8n, dùng khi quên mật khẩu. Sau đó truy cập website để tạo lại tài khoản chủ sở hữu
Xóa LicenseXóa giấy phép và đưa n8n về các tính năng mặc định
Vô hiệu hóa 2FA/MFAChọn Email của tài khoản rồi bấm Vô hiệu hóa để tắt xác thực hai lớp của tài khoản đó
LDAP ClearXóa cấu hình kết nối LDAP cho một người dùng, một dự án hoặc toàn bộ
Thông tin LicenseXem thông tin giấy phép n8n
ExportXuất dữ liệu n8n, xem Xuất dữ liệu

Workflows ​

Tab Workflows liệt kê các workflow với tên, dự án, trạng thái, thời gian tạo và cập nhật.

  • Bật/tắt công tắc ở cột Trạng thái để kích hoạt hoặc bỏ kích hoạt một workflow.
  • Bấm Hành động hàng loạt rồi chọn Kích hoạt tất cả workflow hoặc Bỏ kích hoạt tất cả workflow.
  • Bấm Import workflow để tải lên tệp .json hoặc .zip chứa workflow.
  • Ở cột Hành động, bấm nút chạy (Start workflow) để chạy workflow hoặc nút tải xuống (Export Workflow) để xuất riêng workflow đó.

Credentials ​

Tab Credentials liệt kê các thông tin xác thực (credential) với tên, dự án, loại, thời gian tạo và cập nhật.

  • Bấm Import Credential để tải lên tệp .json hoặc .zip chứa credential.
  • Bấm nút tải xuống trên từng dòng để xuất riêng credential đó.

Xuất dữ liệu ​

  1. Bấm nút Export ở đầu trang n8n.
  2. Đánh dấu All Workflows, All Credentials hoặc cả hai (số trong ngoặc là số lượng hiện có).
  3. Bấm Export.
  4. Khi xuất xong, mở lại hộp thoại Export và bấm Tải Về để tải tệp về máy. Nút Export có dấu tích xanh khi đã có tệp xuất.

Gỡ cài đặt ​

DANGER

Gỡ cài đặt sẽ xóa toàn bộ dữ liệu n8n trên máy chủ. Hãy xuất dữ liệu và tải về trước khi gỡ.

  1. Bấm menu Trang chủ của website.
  2. Trong nhóm Khu vực nguy hiểm, bấm Xóa code.
  3. Nếu dùng PostgreSQL, ô Xóa cơ sở dữ liệu và Xóa người dùng cơ sở dữ liệu được đánh dấu sẵn. Bỏ đánh dấu nếu muốn giữ lại cơ sở dữ liệu.
  4. Đánh dấu Khôi phục về trang mặc định? để xóa tệp cấu hình n8n và đưa website về trang mặc định.
  5. Đánh dấu Đúng, làm đi! rồi bấm Xóa code.

Lưu ý ​

  • Nếu cài SSL sau khi đã cài n8n, bấm Khởi động lại n8n để n8n chuyển địa chỉ webhook sang https://.
  • Để thêm hoặc sửa biến môi trường sau khi cài, mở trang Trang chủ của website, bấm mục .env trong nhóm Tiện ích, lưu thay đổi rồi bấm Khởi động lại n8n.
  • n8n chạy trong Docker. Không tự xóa container hoặc volume của n8n ở trang Docker, vì sẽ làm mất dữ liệu.

Khắc phục sự cố ​

Lỗi "toomanyrequests" khi cài đặt ​

Cài đặt hoặc nâng cấp n8n thất bại với lỗi:

text
Error response from daemon: toomanyrequests: You have reached your unauthenticated pull rate limit. https://www.docker.com/increase-rate-limit

Docker Hub giới hạn số image người dùng ẩn danh được tải từ một địa chỉ IP, và các máy chủ dùng chung dải IP thường chạm giới hạn này. Hãy đăng nhập máy chủ vào một tài khoản Docker Hub miễn phí để lượt tải được tính cho tài khoản của bạn. Mục Giải pháp trong chi tiết sự kiện sẽ dẫn tới phần này.

  1. Tạo tài khoản Docker Hub nếu chưa có.

  2. Mở terminal của máy chủ với quyền root (hoặc kết nối SSH bằng root) và chạy:

    bash
    docker login docker.n8n.io

    Nhập tên đăng nhập và mật khẩu Docker Hub (hoặc personal access token).

  3. Cài lại n8n, hoặc bấm lại Nâng cấp n8n nếu lỗi xảy ra khi nâng cấp.

Nâng cao: cài đặt thủ công ​

Cách này chỉ dành cho người cần tự kiểm soát n8n. Website cài thủ công không có trang quản lý n8n như trên.

  1. Cài ứng dụng Node.js và PM2 từ trang Ứng dụng.

  2. Tạo website n8n.domain.com với Proxy Port là 5678, rồi cài SSL cho website.

  3. Mở terminal của máy chủ, cài và khởi động n8n (thay n8n.domain.com bằng tên miền của bạn):

    bash
    npm -g install n8n
WEBHOOK_URL=https://n8n.domain.com pm2 start n8n
pm2 save

    Nếu website chưa có SSL, dùng N8N_SECURE_COOKIE=false WEBHOOK_URL=http://n8n.domain.com pm2 start n8n thay cho lệnh thứ hai.

  4. Truy cập https://n8n.domain.com để tạo tài khoản. Quản lý tiến trình n8n ở trang PM2.