n8n 3.0 có gì mới? Việc cần làm trước khi nâng cấp

n8n 3.0 là bản lớn tiếp theo của n8n, dự kiến ra trong tháng 10/2026: chỉ phát hành qua Docker, xóa hàng loạt node cũ như Cron, Function, Item Lists, Read PDF và siết các mặc định bảo mật. Ngày 09/10/2026, bản này chưa ra chính thức; bản ổn định vẫn là 2.42.5.

Những điều cần nắm trước khi đọc tiếp:

• Không còn cài bằng npm install n8n hay npx n8n cho bản mới, chỉ dùng Docker.

• Workflow dùng node bị xóa vẫn mở được nhưng node hiện thành dấu hỏi và không Publish được. Mình thử trên bản nightly, lỗi là Unrecognized node type: n8n-nodes-base.cron.

• Bản 2.x đã có sẵn trang Settings → Migration report liệt kê workflow và cấu hình sẽ bị ảnh hưởng, kèm cách sửa.

• Một số mặc định đổi: community package chưa xác minh bị tắt, giới hạn giải nén giảm từ 2GiB xuống 256MiB, thời gian chờ của task runner giảm từ 5 phút xuống 1 phút.

n8n 3.0 đã ra chưa?#

Chưa. Mình xem danh sách release trên GitHub của n8n ngày 08/10/2026: bản ổn định là n8n 2.42.5, bản beta 2.43.2, nhánh 1.x vẫn được vá (1.123.84), chưa có tag n8n@3 nào. Trang thay đổi của bản 3.0 ghi bản này "scheduled for October 2026".

Docker Hub đã có image n8nio/n8n:v3-nightly dựng hằng ngày. Mình kéo về chạy thử thì nó tự báo phiên bản 2.43.0, nhưng đã bỏ các node cũ theo kế hoạch của 3.0. Khi 3.0 ra chính thức, AIDev sẽ cài lại và cập nhật bài này.

Bản 3.0 thay đổi những gì?#

Tóm tắt từ trang thay đổi chính thức, nhóm theo việc bạn phải làm:

Trong đó thay đổi về thư mục lưu file dễ làm n8n không khởi động: nếu bạn mount volume vào ~/.n8n/binaryData, phải đổi sang ~/.n8n/storage hoặc đặt N8N_STORAGE_PATH. Tài liệu ghi nếu cả hai thư mục cùng tồn tại thì n8n không chạy.

Node nào bị xóa và thay bằng gì?#

Danh sách đầy đủ ở trang thay đổi; đây là những node mình thấy trong nhiều workflow cũ, kèm node thay thế tài liệu đưa ra:

AI Transform là node duy nhất trong danh sách được n8n tự chuyển khi nâng cấp. Các node còn lại bạn phải thay tay trước, nếu không workflow ngừng chạy.

Kiểm tra trước bằng Migration report#

Trên n8n 2.42.5, vào Settings → Migration report. Với hai workflow mình dựng bằng node đời mới, trang báo cả hai đã tương thích với 3.0.0:

Tab Instance issues liệt kê 4 thay đổi cấu hình ảnh hưởng tới cả máy, kèm mức độ:

Thời gian chờ 60 giây đáng để ý nếu bạn có node Code xử lý file lớn hay gọi API chậm: đoạn code chạy quá 1 phút sẽ bị dừng. Muốn giữ như cũ thì đặt N8N_RUNNERS_TASK_TIMEOUT=300.

Để xem trang này bắt lỗi thế nào, mình tạo một workflow "kiểu cũ" gồm Cron, Function và Item Lists. Báo cáo hiện đủ 3 node với mức Medium, ghi cách thay và số workflow bị ảnh hưởng:

Có một chỗ lạ: sau khi thêm workflow kiểu cũ, dòng tóm tắt đổi thành "0 of your 3 workflows are already compatible", dù hai workflow kia vẫn không có vấn đề gì. Đọc danh sách chi tiết bên dưới thay vì chỉ nhìn dòng tóm tắt.

Chạy thử bản nightly trên bản sao dữ liệu#

Mình không muốn đụng bản đang chạy, nên chép volume dữ liệu sang một volume mới rồi chạy image v3-nightly trên đó, ở cổng 5679:

docker volume create n8n-v3-copy
docker run --rm -v n8n_n8n-data:/from:ro -v n8n-v3-copy:/to alpine sh -c "cp -a /from/. /to/"
docker pull n8nio/n8n:v3-nightly
docker run -d --name n8n-v3 -p 127.0.0.1:5679:5678 -e N8N_RUNNERS_ENABLED=true \
  -v n8n-v3-copy:/home/node/.n8n n8nio/n8n:v3-nightly
docker logs -f n8n-v3

Kéo image mất 54 giây. Lúc khởi động, n8n chạy thêm 8 migration trên dữ liệu và ghi nhận nâng từ 2.42.5:

Migration chỉ đi một chiều. Sau khi bản mới đã chạy trên dữ liệu, đừng quay lại bản cũ với cùng volume đó; đây cũng là lý do mình chạy trên bản sao.

Hai workflow đời mới vẫn chạy và giữ trạng thái Published. Workflow kiểu cũ thì mở được, nhưng cả 3 node đều hiện thành dấu hỏi:

Bấm Publish thì bị từ chối, chi tiết lỗi ở mục ngay dưới.

Lỗi và cảnh báo mình gặp khi thử bản nightly#

Publish workflow còn node Cron, n8n trả nguyên văn:

{"code":0,"message":"Unrecognized node type: n8n-nodes-base.cron"}

Log khởi động có hai cảnh báo: biến N8N_RUNNERS_ENABLED đã thừa từ 2.0, và chế độ task runner nội bộ sắp bị bỏ:

There are deprecations related to your n8n setup. Please take the recommended actions to update your configuration:
 - N8N_RUNNERS_ENABLED -> Remove this environment variable; it is no longer needed.
 - N8N_RUNNERS_MODE -> Internal task runner mode is deprecated and will be removed in a future version.

Vì chạy container đơn không có Python, log còn báo không khởi động được runner Python:

Failed to start Python task runner in internal mode. because Python 3 is missing from this system.

Nếu bạn cài bằng lệnh get.n8n.io, bộ cài đã chạy task runner ở container riêng (chế độ external) nên không dính cảnh báo thứ hai. Cảnh báo này chủ yếu dành cho ai tự viết lệnh docker run như hướng dẫn cũ.

Chuẩn bị nâng cấp từng bước#

Thứ tự mình sẽ làm khi 3.0 ra chính thức:

1. Sao lưu nguyên volume dữ liệu, không chỉ export workflow. Cách làm và lý do có trong bài tự host n8n trên VPS.

2. Mở Migration report, thay hết node bị xóa cho tới khi tab Workflow issues trống.

3. Kiểm tra cấu hình có đụng các thay đổi của 3.0 không. Trên máy mình, lệnh dưới không in ra dòng nào vì bộ cài get.n8n.io không dùng các biến này:

grep -nE "binaryData|N8N_PRE_EXECUTE_ERROR_CREATES_EXECUTION|N8N_DEFAULT_BINARY_DATA_MODE|N8N_RUNNERS_ENABLED" n8n/compose.yml n8n/.env

1. Ghi lại các node cộng đồng đang dùng; node chưa được n8n xác minh cần đặt N8N_UNVERIFIED_PACKAGES_ENABLED=true.

2. Chạy bản mới trên bản sao volume như ở trên, bấm thử từng workflow quan trọng.

3. Ghim phiên bản trong n8n/.env, nâng có chủ đích thay vì để tự nhảy lên bản lớn. Dòng này trên máy mình hiện là:

N8N_VERSION=2.42.5

Thử xong thì dọn bản thử, volume dữ liệu thật không bị đụng tới:

docker rm -f n8n-v3
docker volume rm n8n-v3-copy

Ai đang chạy n8n bằng npm thì việc đầu tiên là chuyển sang Docker trước khi nghĩ tới 3.0. Bộ cài một dòng curl -fsSL https://get.n8n.io | sh dựng xong trong khoảng một phút trên máy mình.

Có nên lên n8n 3.0 ngay khi ra không?#

Nếu n8n chỉ chạy vài workflow cá nhân, lên sớm để quen cũng được, miễn đã sao lưu volume. Nếu n8n đang chạy việc thật cho công ty, mình sẽ chờ thêm vài bản vá: nhánh 2.x hiện vẫn ra bản mới liên tục, và ngay cả nhánh 1.x vẫn còn được vá vào ngày 08/10/2026.

Câu hỏi thường gặp#

Cài n8n bằng npm có còn dùng được không?#

Bản đang cài bằng npm vẫn chạy, nhưng từ 3.0 n8n không phát hành gói npm chạy được nữa. Tài liệu nói hướng dẫn chuyển từ npm sang Docker sẽ có sau.

Workflow cũ có tự chuyển khi lên 3.0 không?#

Chỉ node AI Transform được tự chuyển thành node Code. Các node khác trong danh sách bị xóa phải thay tay trước khi nâng cấp.

n8n 3.0 có tính phí không?#

Thay đổi trong 3.0 là về kỹ thuật và bảo mật. Trang thay đổi không nhắc tới giá hay giấy phép; bản tự host vẫn theo giấy phép Sustainable Use License như 2.x.

Đọc tiếp#

• n8n là gì: workflow đầu tiên, trợ lý AI chạy Ollama, số đo tốc độ.

• Tự host n8n bằng Docker trên VPS: khóa cổng, HTTPS, sao lưu volume, nâng cấp bằng get.n8n.io.

Muốn thử n8n trên một máy riêng mà không đụng máy đang chạy, AIDev Cloud cho thuê máy theo giờ; máy Tesla P40 mình dùng có giá 7.000 đồng/giờ ngày 08/10/2026.

Thử trên máy Tesla P40 của AIDev Cloud ngày 08/10/2026: n8n 2.42.5 và image n8nio/n8n:v3-nightly dựng ngày 08/10/2026 (tự báo 2.43.0), Docker 29.6.1, Ubuntu 24.04.