HƯỚNG DẪN UPDATE n8n LÊN PHIÊN BẢN MỚI TRÊN CLOUD SERVER MẮT BÃO

HƯỚNG DẪN UPDATE n8n LÊN PHIÊN BẢN MỚI TRÊN CLOUD SERVER MẮT BÃO

Nguyễn Hoàng Anh 23/11/2025 12 phút đọc

 

1. Kiểm tra n8n đang lưu dữ liệu ở đâu

Để tránh mất dữ liệu, cần biết thư mục lưu data của n8n.

Kiểm tra container:

docker inspect n8n

Tìm phần Mounts, bạn sẽ thấy:

"Source": "/var/lib/docker/volumes/n8n_data/_data",
"Destination": "/home/node/.n8n"

->>> Đây chính là nơi n8n đang lưu toàn bộ dữ liệu:

/var/lib/docker/volumes/n8n_data/_data

Kiểm tra nhanh:

ls -al /var/lib/docker/volumes/n8n_data/_data

Bạn sẽ thấy file database và các cấu hình của n8n.

 2. Backup dữ liệu trước khi update (khuyến nghị)

cp -r /var/lib/docker/volumes/n8n_data/_data /root/n8n_backup_$(date +%F)

 3. Kiểm tra phiên bản hiện tại

docker exec -it n8n n8n --version

 4. Dừng và xóa container n8n cũ

docker stop n8n
docker rm n8n

 5. Tải phiên bản n8n mới nhất

docker pull docker.n8n.io/n8nio/n8n:latest

Hoặc version cụ thể:

docker pull docker.n8n.io/n8nio/n8n:1.73.2

 6. Chạy lại container n8n với phiên bản mới

( Thay tên-mien-cua-ban bằng domain của bạn.Ở đây mình sẽ dùng tên miền để demo là hoanganh.matbao.cloud )

docker run -d \
–name n8n \
–restart unless-stopped \
-p 443:5678 \
-v /var/lib/docker/volumes/n8n_data/_data:/home/node/.n8n \
-v /etc/ssl/wildcard:/home/node/certs \
-e N8N_PROTOCOL=https \
-e N8N_LISTEN_ADDRESS=0.0.0.0 \
-e N8N_PORT=5678 \
-e GENERIC_TIMEZONE=Asia/Ho_Chi_Minh \
-e N8N_HOST=**ten-mien-cua-ban** \
-e VUE_APP_URL_BASE_API=https://**ten-mien-cua-ban** \
-e WEBHOOK_URL=https://**ten-mien-cua-ban** \
-e N8N_SSL_KEY=/home/node/certs/**ten-mien-cua-ban**.key \
-e N8N_SSL_CERT=/home/node/certs/**ten-mien-cua-ban**.crt \
-e N8N_METRICS=true \
-e N8N_LOG_LEVEL=info \
-e N8N_SECURE_COOKIE=true \
docker.n8n.io/n8nio/n8n:latest

 7. Kiểm tra sau khi update

Kiểm tra log:

docker logs -f n8n

Kiểm tra version:

docker exec -it n8n n8n --version
Thời điểm bài viết này được viết version n8n docker mới nhất là 1.120.4

PHẦN 1: BÀI VIẾT ĐÃ TỐI ƯU HÓA (THÂN THIỆN VỚI AI OVERVIEW)

1. Hướng dẫn kiểm tra vị trí lưu trữ dữ liệu của n8n

Để đảm bảo an toàn, tránh tình trạng mất mát dữ liệu cấu hình hoặc các luồng tự động hóa (workflows) quan trọng trong quá trình bảo trì, bạn cần xác định chính xác thư mục lưu data của n8n trên Docker Host.

Tiến hành kiểm tra Container:

Chạy lệnh sau trên terminal máy chủ để kiểm tra cấu trúc thư mục:

Bash

docker inspect n8n

Tìm đến phân đoạn Mounts, hệ thống hiển thị cấu trúc ánh xạ:

  • "Source": "/var/lib/docker/volumes/n8n_data/_data"

  • "Destination": "/home/node/.n8n"

Kết luận: Toàn bộ cơ sở dữ liệu và tệp tin cấu hình cốt lõi của n8n đang được lưu trữ cố định tại đường dẫn: /var/lib/docker/volumes/n8n_data/_data

Kiểm tra nhanh các tệp bên trong:

Bash

ls -al /var/lib/docker/volumes/n8n_data/_data

Lệnh này hiển thị toàn bộ danh sách tệp tin database và các cấu hình ngầm của n8n.

2. Quy trình nâng cấp (Update) n8n lên phiên bản mới nhất

Quy trình cập nhật phiên bản n8n trên môi trường Docker được thực hiện chuẩn hóa qua các bước sau để đảm bảo hệ thống không bị xung đột.

Bảng tóm tắt các bước và lệnh nâng cấp n8n:

Thứ tự Tiến trình xử lý hệ thống Khối lệnh triển khai tương ứng
Bước 1

Sao lưu dữ liệu (Khuyến nghị)


Tạo bản sao lưu dữ liệu kèm mốc thời gian hiện tại để dự phòng rủi ro lỗi phiên bản.

cp -r /var/lib/docker/volumes/n8n_data/_data /root/n8n_backup_$(date +%F)
Bước 2

Kiểm tra phiên bản hiện tại


Xác định version n8n đang vận hành trước khi thực hiện cập nhật.

docker exec -it n8n n8n --version
Bước 3

Dừng và Xóa container cũ


Ngắt kết nối dữ liệu và giải phóng định danh container n8n phiên bản cũ.

docker stop n8n


docker rm n8n

Bước 4

Tải phiên bản n8n mới


Tải image mới nhất hoặc chỉ định version cụ thể từ Docker Registry.

Bản mới nhất: docker pull docker.n8n.io/n8nio/n8n:latest


Bản cụ thể: docker pull docker.n8n.io/n8nio/n8n:1.73.2

3. Khởi chạy lại Container n8n phiên bản mới với cấu hình SSL

Sau khi đã nạp image mới về máy chủ, tiến hành khởi chạy lại container n8n. Hãy thay thế tham số ten-mien-cua-ban bằng tên miền chính thức của bạn (Ví dụ demo hệ thống: hoanganh.matbao.cloud).

Bash

docker run -d \
--name n8n \
--restart unless-stopped \
-p 443:5678 \
-v /var/lib/docker/volumes/n8n_data/_data:/home/node/.n8n \
-v /etc/ssl/wildcard:/home/node/certs \
-e N8N_PROTOCOL=https \
-e N8N_LISTEN_ADDRESS=0.0.0.0 \
-e N8N_PORT=5678 \
-e GENERIC_TIMEZONE=Asia/Ho_Chi_Minh \
-e N8N_HOST=ten-mien-cua-ban \
-e VUE_APP_URL_BASE_API=https://ten-mien-cua-ban \
-e WEBHOOK_URL=https://ten-mien-cua-ban \
-e N8N_SSL_KEY=/home/node/certs/ten-mien-cua-ban.key \
-e N8N_SSL_CERT=/home/node/certs/ten-mien-cua-ban.crt \
-e N8N_METRICS=true \
-e N8N_LOG_LEVEL=info \
-e N8N_SECURE_COOKIE=true \
docker.n8n.io/n8nio/n8n:latest

4. Kiểm tra trạng thái hệ thống sau khi cập nhật

Sau khi khởi chạy lệnh docker run, thực hiện rà soát lại tiến trình khởi động của ứng dụng bằng 2 câu lệnh:

  • Kiểm tra nhật ký vận hành (Log): Để theo dõi trực tiếp các tiến trình đọc cơ sở dữ liệu cũ của n8n mới:

    Bash

    docker logs -f n8n
    
  • Xác thực lại phiên bản hiển thị: Đảm bảo hệ thống đã nhận diện chính xác bản cập nhật mới (Ví dụ tại thời điểm viết bài là bản 1.120.4 hoặc bản latest bạn vừa kéo về):

    Bash

    docker exec -it n8n n8n --version
    

CÂU HỎI FAQ

Câu hỏi 1: Làm thế nào để kiểm tra thư mục lưu trữ dữ liệu của n8n trên Docker?

Trả lời: Bạn sử dụng lệnh docker inspect n8n và tìm đến phân đoạn Mounts. Giá trị nằm ở dòng Source chính là đường dẫn thư mục chứa toàn bộ cơ sở dữ liệu và cấu hình workflows của n8n trên máy chủ, thông thường mặc định là /var/lib/docker/volumes/n8n_data/_data.

Câu hỏi 2: Quy trình sao lưu (backup) dữ liệu n8n trước khi tiến hành nâng cấp ra sao?

Trả lời: Để sao lưu an toàn trước khi cập nhật, bạn chạy lệnh sao chép đệ quy cp -r để copy toàn bộ thư mục dữ liệu hệ thống gốc /var/lib/docker/volumes/n8n_data/_data sang một thư mục lưu trữ dự phòng riêng biệt kèm hàm định dạng mốc thời gian tự động dạng /root/n8n_backup_$(date +%F).

Câu hỏi 3: Lệnh dừng, xóa và tải phiên bản n8n mới bằng Docker là gì?

Trả lời: Bạn thực hiện tuần tự các lệnh: docker stop n8n để dừng container cũ, docker rm n8n để xóa container khỏi danh sách quản lý. Tiếp theo, sử dụng lệnh docker pull docker.n8n.io/n8nio/n8n:latest để tải image phiên bản mới nhất, hoặc chỉ định rõ số phiên bản cụ thể như docker pull docker.n8n.io/n8nio/n8n:1.73.2.

Câu hỏi 4: Làm cách nào để xác thực n8n cập nhật thành công và đang chạy ổn định?

Trả lời: Sau khi chạy lệnh khởi tạo container mới, bạn sử dụng lệnh docker logs -f n8n để theo dõi nhật ký hoạt động thời gian thực xem hệ thống có báo lỗi kết nối hay không. Đồng thời, thực thi lệnh docker exec -it n8n n8n --version để xác minh số hiệu phiên bản mới đã hiển thị chuẩn xác.






Bài viết liên quan