Sao lưu workflow n8n và khôi phục lại khi mất máy chủ

Máy chủ chạy n8n hỏng ổ cứng. Đội kỹ thuật dựng lại VPS mới trong vài giờ. Nhưng khi import lại file workflow đã export trước đó, các node HTTP Request báo lỗi thiếu credential. Lịch sử chạy của ba tháng trước cũng biến mất sạch. Sao lưu workflow n8n mà chỉ export file JSON là sao lưu nửa vời, vì workflow n8n không nằm gọn trong một file duy nhất.

Sao lưu workflow n8n gồm những phần nào

Sao lưu workflow n8n đúng cách phải tách riêng ba phần: file workflow dạng JSON, database PostgreSQL chứa credential và lịch sử execution, và khoá mã hoá dùng để giải mã credential đó. Thiếu một trong ba, bản khôi phục hoặc không import được, hoặc import được nhưng mọi kết nối API đều rỗng.

Nhiều đội chỉ backup phần dễ thấy nhất. Export workflow ra JSON rồi coi như xong. Vấn đề nằm ở chỗ file JSON đó chỉ mô tả cấu trúc node và luồng dữ liệu, không mang theo giá trị thật của credential. Muốn workflow chạy lại đúng như trước, ba mảnh này phải khớp với nhau. Không mảnh nào thay thế được mảnh còn lại.

Theo tài liệu n8n, workflow export ra JSON chỉ tham chiếu credential bằng ID, không nhúng giá trị API key hay token thật vào file. Import file này lên máy chủ mới, mỗi node cần credential sẽ hiện cảnh báo thiếu, phải gán lại thủ công từng cái. Với workflow có 5 đến 10 credential khác nhau, việc gán lại tay mất nhiều thời gian hơn phần dựng lại logic node.

Xuất workflow qua giao diện

Chọn workflow, vào menu ba chấm, chọn Download để tải file JSON về máy. Cách này phù hợp khi chỉ cần sao lưu một vài workflow quan trọng, làm thủ công từng cái.

Xuất hàng loạt qua CLI

Lệnh n8n export:workflow --all --output=./backup/ xuất toàn bộ workflow đang có trên instance ra một thư mục, mỗi file một workflow. Cách này chạy được trong cron job, không cần mở giao diện. Điều kiện là máy chạy n8n phải giữ được lịch cron qua mỗi lần khởi động lại. VPS n8n cài sẵn đã cấu hình sẵn phần này. Phù hợp để lên lịch chạy tự động mỗi ngày.

Đồng bộ Git để có lịch sử thay đổi workflow

Đồng bộ Git giữ lại từng phiên bản workflow qua thời gian, cho phép quay lại bản trước khi một thay đổi làm hỏng luồng xử lý. Export JSON đơn thuần chỉ cho một bản chụp tại thời điểm chạy lệnh. Không biết ai sửa gì, sửa lúc nào.

Đưa thư mục export vào một repository Git, commit sau mỗi lần export theo lịch, là cách rẻ nhất để có audit trail. Khi một workflow đột nhiên gửi email sai định dạng, xem lại diff giữa hai commit gần nhất thường lộ ra ngay node nào bị đổi. n8n bản Enterprise có tính năng source control tích hợp sẵn. Bản tự host thì ghép cron export với git commit là đủ dùng cho phần lớn doanh nghiệp.

Sao lưu PostgreSQL n8n mới giữ được credential và lịch sử chạy

Sao lưu PostgreSQL n8n là bước bắt buộc để giữ credential, cấu hình biến môi trường workflow và lịch sử execution, những thứ không nằm trong file JSON export. Bỏ qua bước này, khôi phục xong workflow vẫn đứng đó nhưng không có gì để chạy.

Database lưu bảng credentials_entity ở dạng đã mã hoá, bảng workflow_entity lưu bản mới nhất của từng workflow trong hệ thống, và bảng execution_entity giữ lịch sử mỗi lần workflow đã chạy kèm dữ liệu input, output. Với workflow xử lý đơn hàng hay giao dịch, lịch sử execution nhiều khi quan trọng hơn cả bản thân workflow, vì đó là bằng chứng dữ liệu đã đi qua hệ thống đúng cách.

Lệnh pg_dump chạy theo lịch cron là cách phổ biến nhất: pg_dump -U n8n_user n8n_db > backup.sql, nén lại và đẩy ra nơi lưu trữ ngoài máy chủ đang chạy. Sao lưu ngay trên ổ đĩa cùng máy chủ coi như không sao lưu, vì máy hỏng thì mất luôn cả bản gốc lẫn bản backup.

Khoá mã hoá n8n giữ ở đâu là an toàn

Khoá mã hoá n8n dùng để giải mã giá trị credential lưu trong database, mất khoá này thì dữ liệu credential trong bản sao lưu database trở thành chuỗi ký tự vô nghĩa, không đọc lại được. Đây là phần hay bị bỏ sót nhất trong ba mảnh cần sao lưu.

Mặc định khoá này nằm trong file cấu hình trên máy chủ, tách biệt hoàn toàn với database. Sao lưu database mà quên sao lưu file cấu hình chứa khoá, đến lúc khôi phục trên máy mới, n8n tự sinh khoá mới, và toàn bộ credential cũ trở thành dữ liệu chết. Cách xử lý đúng: copy file chứa khoá mã hoá ra một nơi lưu trữ riêng, tách khỏi bản sao lưu database, và ghi lại rõ khoá nào đi với bản database nào. Trộn khoá mã hoá của lần backup này với database của lần backup khác cũng cho ra kết quả tương tự, không giải mã được.

Khôi phục n8n theo đúng thứ tự sau khi mất máy chủ

Khôi phục n8n sau khi mất máy chủ phải làm theo đúng thứ tự: dựng lại khoá mã hoá trước, phục hồi database, rồi mới import workflow JSON nếu cần bổ sung bản mới hơn bản trong database. Đảo thứ tự này thường ra kết quả workflow hiện đủ nhưng credential báo lỗi xác thực.

Bước 3 là chỗ nên dừng lại kiểm tra kỹ trước khi làm tiếp. Một credential mở lên báo lỗi ngay tại đây nghĩa là khoá và database đang lệch nhau. Tiếp tục import workflow chỉ khiến việc dò lỗi phức tạp hơn.

Sao lưu tự động qua cron job phù hợp với workflow xử lý dữ liệu hàng ngày. Chạy tay chỉ nên dùng cho workflow ít thay đổi hoặc môi trường thử nghiệm. Doanh nghiệp có từ ba workflow trở lên đang chạy sản xuất nên chuyển sang lịch tự động ngay, vì nhớ chạy tay đều đặn là việc dễ quên nhất trong danh sách vận hành.

Một lịch hợp lý: export workflow JSON và commit Git mỗi ngày, dump database mỗi ngày kèm nén và đẩy ra lưu trữ ngoài máy. File khoá mã hoá chỉ cần lưu lại một lần, kiểm tra định kỳ mỗi khi đổi cấu hình máy chủ. Đội không có người chuyên trách theo dõi lịch này thường để lệch cả tháng mới phát hiện cron job đã dừng chạy từ lâu. Lúc đó bản sao lưu mới nhất cũng đã quá cũ để dùng.

Với những đội chưa có ai phụ trách riêng phần vận hành máy chủ, dịch vụ quản trị máy chủ của BizMaC nhận theo dõi các tác vụ định kỳ này, phát hiện sớm khi một cron job dừng chạy thay vì để tới lúc cần khôi phục mới biết bản sao lưu đã hỏng.

Câu hỏi thường gặp về sao lưu workflow n8n

Tip tham khảo

• Sao lưu workflow n8n đúng cách cần ba phần tách riêng: file JSON, database PostgreSQL, khoá mã hoá.
• File JSON chỉ tham chiếu credential bằng ID, không mang giá trị thật, nên riêng nó không đủ để khôi phục.
• Mất khoá mã hoá, mọi credential trong database sao lưu đều thành dữ liệu không đọc được.
• Khôi phục theo đúng thứ tự: khoá mã hoá trước, database sau, workflow JSON bổ sung cuối cùng.
• Đồng bộ Git giữ lại lịch sử thay đổi workflow, hữu ích khi cần quay về bản trước một lỗi.