Cách nâng cấp n8n sử dụng Docker trên DigitalOcean

Để nâng cấp phiên bản n8n được tự host trên Droplet DigitalOcean dạng 1-Click (thường sử dụng Docker và Docker Compose), hãy làm theo hướng dẫn chi tiết từng bước dưới đây.

Hướng dẫn này giả định bạn có quyền truy cập SSH vào Droplet và có kiến thức cơ bản về dòng lệnh terminal. Việc cập nhật định kỳ là rất quan trọng để tận hưởng các tính năng mới, sửa lỗi và nâng cao bảo mật.

Yêu cầu trước khi bắt đầu

• Tài khoản DigitalOcean: Truy cập được vào bảng điều khiển DigitalOcean Cloud.
• Quyền truy cập SSH: Thông tin SSH (quyền root hoặc user có quyền sudo) hoặc sử dụng console web của DigitalOcean.
• Sao lưu: Xuất các workflow từ giao diện n8n và tạo snapshot Droplet từ dashboard của DigitalOcean để đảm bảo an toàn dữ liệu.
• Thiết lập Docker Compose: Droplet 1-Click của n8n sử dụng Docker Compose, với các file cấu hình thường nằm trong thư mục /opt/n8n-docker-caddy.

Hướng dẫn từng bước để nâng cấp n8n

1. Truy cập vào Droplet của bạn

• Mở bảng điều khiển Cloud của DigitalOcean tại cloud.digitalocean.com.
• Truy cập mục Droplets ở menu bên trái và chọn Droplet đang chạy n8n.
• Nhấn nút Console để mở terminal web hoặc kết nối SSH:

ssh root@YOUR_DROPLET_IP

Thay YOUR_DROPLET_IP bằng IP công khai của Droplet.

2. Di chuyển đến thư mục cấu hình của n8n

Thư mục cấu hình thường là /opt/n8n-docker-caddy. Chuyển đến thư mục này bằng lệnh:

cd /opt/n8n-docker-caddy

Nếu gặp lỗi "No such file or directory", hãy kiểm tra thư mục bằng:

ls /opt

Nếu thư mục không tồn tại hoặc có tên khác, hãy kiểm tra lại tài liệu cài đặt của bạn hoặc liên hệ với bộ phận hỗ trợ DigitalOcean. Thư mục này cũng có thể nằm ở /home/<TEN_USER>/n8n-docker-caddy.

3. Tải về image n8n mới nhất

Cập nhật image Docker n8n bằng:

docker compose pull

Lệnh này sẽ lấy image mới nhất được chỉ định trong file docker-compose.yml (thường là n8n:latest).

4. Dừng và xóa container n8n hiện tại

Dừng và xóa container hiện tại để chuẩn bị chạy image mới:

docker compose down

Lệnh này sẽ dừng các container n8n và Caddy nhưng không xóa dữ liệu (dữ liệu được lưu trong Docker volumes hoặc thư mục như local_files).

5. Khởi động lại n8n với image mới

Tạo lại và khởi chạy container với image mới:

docker compose up -d

Flag -d giúp chạy container ở chế độ nền. Docker Compose sẽ tự động sử dụng image mới nhất để dựng lại các container.

6. Kiểm tra cập nhật

• Mở trình duyệt và truy cập vào n8n (ví dụ: https://n8n.tenmiencuaban.com)
• Làm mới trình duyệt mạnh (Ctrl + Shift + R hoặc Cmd + Shift + R) để xóa cache.
• Kiểm tra phiên bản n8n trong mục Settings hoặc About.
• Đảm bảo các workflow vẫn còn và chạy thử vài cái để xác minh hoạt động.
• Nếu thông báo cập nhật vẫn còn, hãy làm mới trình duyệt hoặc xóa cache lại.

Tuỳ chọn: Tự động hoá việc cập nhật

Bạn có thể sử dụng Watchtower để cập nhật Docker container tự động:

docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower

Watchtower sẽ kiểm tra image mới của n8n và cập nhật container tự động. Lưu ý: tự động cập nhật có thể gây lỗi nếu có thay đổi lớn — luôn sao lưu trước khi dùng Watchtower.

Lưu ý quan trọng

• Luôn sao lưu trước khi cập nhật: Xuất workflow từ UI và tạo snapshot Droplet.
• Xem ghi chú phát hành: Đọc release notes của n8n tại GitHub n8n Releases để kiểm tra thay đổi quan trọng.
• DNS và Firewall: Đảm bảo subdomain (vd: n8n.yourdomain.com) trỏ đúng tới IP của Droplet và các cổng 80, 443 đã mở (thường đã cấu hình sẵn).
• Khắc phục sự cố:
  • Kiểm tra Docker đã cài chưa bằng:

docker --version && docker compose version

• Nếu không truy cập được n8n sau khi cập nhật, xem log container bằng:

docker compose logs

• Nếu vẫn lỗi, hãy hỏi tại cộng đồng n8n hoặc hỗ trợ DigitalOcean.

• Ghim phiên bản: File docker-compose.yml mặc định dùng n8n:latest. Nếu muốn dùng phiên bản cụ thể, hãy chỉnh lại như sau trước khi pull và up:

image: n8n:1.50.0

Nguồn tham khảo

• Hướng dẫn được tổng hợp từ tài liệu chính thức và cộng đồng n8n.
• Xem thêm tài liệu chính thức tại: n8n DigitalOcean Server Setup